As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# CreateIngestion
<a name="API_CreateIngestion"></a>

Cria e inicia uma nova ingestão de SPICE para um conjunto de dados. Você pode atualizar manualmente os conjuntos de dados em uma conta da edição Enterprise 32 vezes em um período de 24 horas. Você pode atualizar manualmente os conjuntos de dados em uma conta da edição Standard 8 vezes em um período de 24 horas. Cada período de 24 horas é medido a partir de 24 horas antes da data e hora atuais.

Todas as ingestões que operam em conjuntos de dados marcados herdam as mesmas tags automaticamente para uso no controle de acesso. Para ver um exemplo, consulte[Como faço para criar uma política do IAM para controlar o acesso aos recursos do Amazon EC2 usando tags?](https://aws.amazon.com/premiumsupport/knowledge-center/iam-ec2-resource-tags/)noAWSCentral de conhecimento da. As tags são visíveis no conjunto de dados marcado, mas não no recurso de ingestão.

## Sintaxe da solicitação
<a name="API_CreateIngestion_RequestSyntax"></a>

```
PUT /accounts/AwsAccountId/data-sets/DataSetId/ingestions/IngestionId HTTP/1.1
Content-type: application/json

{
   "IngestionType": "string"
}
```

## Parâmetros da solicitação de URI
<a name="API_CreateIngestion_RequestParameters"></a>

A solicitação usa os parâmetros de URI a seguir.

 ** [AwsAccountId](#API_CreateIngestion_RequestSyntax) **   <a name="QS-CreateIngestion-request-AwsAccountId"></a>
O ID da conta da AWS.  
Restrições de tamanho: Comprimento fixo de 12.  
Padrão: `^[0-9]{12}$`   
Obrigatório: Sim

 ** [DataSetId](#API_CreateIngestion_RequestSyntax) **   <a name="QS-CreateIngestion-request-DataSetId"></a>
O ID do conjunto de dados usado na ingestão.  
Obrigatório: Sim

 ** [IngestionId](#API_CreateIngestion_RequestSyntax) **   <a name="QS-CreateIngestion-request-IngestionId"></a>
Uma identificação para a ingestão.  
Restrições de tamanho: Tamanho mínimo de 1. Tamanho máximo de 128.  
Padrão: `^[a-zA-Z0-9-_]+$`   
Obrigatório: Sim

## Corpo da solicitação
<a name="API_CreateIngestion_RequestBody"></a>

A solicitação aceita os dados a seguir no formato JSON.

 ** [IngestionType](#API_CreateIngestion_RequestSyntax) **   <a name="QS-CreateIngestion-request-IngestionType"></a>
O tipo de ingestão que você deseja criar.  
Type: String  
Valores válidos:` INCREMENTAL_REFRESH | FULL_REFRESH`   
Obrigatório: Não

## Sintaxe da resposta
<a name="API_CreateIngestion_ResponseSyntax"></a>

```
HTTP/1.1 Status
Content-type: application/json

{
   "Arn": "string",
   "IngestionId": "string",
   "IngestionStatus": "string",
   "RequestId": "string"
}
```

## Elementos de resposta
<a name="API_CreateIngestion_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará a resposta HTTP a seguir.

 ** [Status](#API_CreateIngestion_ResponseSyntax) **   <a name="QS-CreateIngestion-response-Status"></a>
O status HTTP da solicitação.

Os seguintes dados são retornados no formato JSON pelo serviço.

 ** [Arn](#API_CreateIngestion_ResponseSyntax) **   <a name="QS-CreateIngestion-response-Arn"></a>
O nome de recurso da Amazon (ARN) para a ingestão de dados.  
Type: String

 ** [IngestionId](#API_CreateIngestion_ResponseSyntax) **   <a name="QS-CreateIngestion-response-IngestionId"></a>
Uma identificação para a ingestão.  
Type: String  
Restrições de tamanho: Tamanho mínimo de 1. Tamanho máximo de 128.  
Padrão: `^[a-zA-Z0-9-_]+$` 

 ** [IngestionStatus](#API_CreateIngestion_ResponseSyntax) **   <a name="QS-CreateIngestion-response-IngestionStatus"></a>
O status da ingestão.  
Type: String  
Valores válidos:` INITIALIZED | QUEUED | RUNNING | FAILED | COMPLETED | CANCELLED` 

 ** [RequestId](#API_CreateIngestion_ResponseSyntax) **   <a name="QS-CreateIngestion-response-RequestId"></a>
OAWSID da solicitação para essa operação.  
Type: String

## Erros
<a name="API_CreateIngestion_Errors"></a>

Para obter informações sobre os erros que são comuns a todas as ações, consulte[Erros comuns](CommonErrors.md).

 ** AccessDeniedException **   
Você não tem acesso a esse item. Não foi possível validar as credenciais fornecidas. Talvez você não tenha permissão para executar a solicitação. Verifique se sua conta está autorizada a usar a Amazon QuickSight , se as suas políticas têm as permissões corretas e se você está usando as chaves de acesso corretas.  
Código de status HTTP: 401

 ** InternalFailureException **   
Ocorreu um erro interno.  
Código de status HTTP: 500

 ** InvalidParameterValueException **   
Um ou mais parâmetros têm um valor que não é válido.  
Código de status HTTP: 400

 ** LimitExceededException **   
Um limite foi excedido.  
Código de status HTTP: 409

 ** ResourceExistsException **   
O recurso especificado já existe.   
Código de status HTTP: 409

 ** ResourceNotFoundException **   
Não foi possível encontrar um ou mais recursos.  
Código de status HTTP: 404

 ** ThrottlingException **   
O acesso é limitado.  
Código de status HTTP: 429

## Exemplos
<a name="API_CreateIngestion_Examples"></a>

### Exemplo
<a name="API_CreateIngestion_Example_1"></a>

Este exemplo ilustra um uso de CreateIngestion.

#### Exemplo de solicitação
<a name="API_CreateIngestion_Example_1_Request"></a>

```
PUT /accounts/*AwsAccountId*/data-sets/*DataSetID*/ingestions/*IngestionID* HTTP/1.1
```

## Consulte também
<a name="API_CreateIngestion_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos de linguagem, consulte o seguinte:
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/CreateIngestion) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/CreateIngestion) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/CreateIngestion) 
+  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/CreateIngestion) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/CreateIngestion) 
+  [AWSSDK para o JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/CreateIngestion) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/CreateIngestion) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/CreateIngestion) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/CreateIngestion)