Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

Crea e avvia una nuova acquisizione SPICE per un set di dati. È possibile aggiornare manualmente i set di dati in un account Enterprise Edition 32 volte in un periodo di 24 ore. È possibile aggiornare manualmente i set di dati in un account dell'edizione Standard 8 volte in un periodo di 24 ore. Ogni periodo di 24 ore viene misurato a partire da 24 ore prima della data e dell'ora correnti.

Eventuali acquisizioni che operano su set di dati con tag ereditano automaticamente gli stessi tag per l'utilizzo nel controllo degli accessi. Per un esempio, consulta[Come posso creare una policy IAM per il controllo dell'accesso alle risorse Amazon EC2 utilizzando i tag?](https://aws.amazon.com/premiumsupport/knowledge-center/iam-ec2-resource-tags/)nellaAWSKnowledge Center. I tag sono visibili sul set di dati con tag, ma non sulla risorsa di inserimento.

## Sintassi della richiesta
<a name="API_CreateIngestion_RequestSyntax"></a>

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

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

## Parametri della richiesta URI:
<a name="API_CreateIngestion_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [AwsAccountId](#API_CreateIngestion_RequestSyntax) **   <a name="QS-CreateIngestion-request-AwsAccountId"></a>
ID dell'account AWS.  
Vincoli di lunghezza: Lunghezza fissa di 12.  
Modello: `^[0-9]{12}$`   
Campo obbligatorio: Sì

 ** [DataSetId](#API_CreateIngestion_RequestSyntax) **   <a name="QS-CreateIngestion-request-DataSetId"></a>
ID del set di dati utilizzato per l'inserimento.  
Campo obbligatorio: Sì

 ** [IngestionId](#API_CreateIngestion_RequestSyntax) **   <a name="QS-CreateIngestion-request-IngestionId"></a>
Un ID per l'inserimento.  
Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.  
Modello: `^[a-zA-Z0-9-_]+$`   
Campo obbligatorio: Sì

## Corpo della richiesta
<a name="API_CreateIngestion_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [IngestionType](#API_CreateIngestion_RequestSyntax) **   <a name="QS-CreateIngestion-request-IngestionType"></a>
Il tipo di inserimento che deve essere creato da.  
Type: Stringa  
Valori validi: ` INCREMENTAL_REFRESH | FULL_REFRESH`   
Campo obbligatorio: No

## Sintassi della risposta
<a name="API_CreateIngestion_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_CreateIngestion_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce la seguente risposta HTTP.

 ** [Status](#API_CreateIngestion_ResponseSyntax) **   <a name="QS-CreateIngestion-response-Status"></a>
Lo stato HTTP della richiesta.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [Arn](#API_CreateIngestion_ResponseSyntax) **   <a name="QS-CreateIngestion-response-Arn"></a>
L'Amazon Resource Name (ARN) per l'inserimento dei dati.  
Type: Stringa

 ** [IngestionId](#API_CreateIngestion_ResponseSyntax) **   <a name="QS-CreateIngestion-response-IngestionId"></a>
Un ID per l'inserimento.  
Type: Stringa  
Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.  
Modello: `^[a-zA-Z0-9-_]+$` 

 ** [IngestionStatus](#API_CreateIngestion_ResponseSyntax) **   <a name="QS-CreateIngestion-response-IngestionStatus"></a>
Lo stato di inserimento.  
Type: Stringa  
Valori validi: ` INITIALIZED | QUEUED | RUNNING | FAILED | COMPLETED | CANCELLED` 

 ** [RequestId](#API_CreateIngestion_ResponseSyntax) **   <a name="QS-CreateIngestion-response-RequestId"></a>
LaAWSID della richiesta per questa operazione.  
Type: Stringa

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

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** AccessDeniedException **   
Non hai l'accesso. Le credenziali fornite non possono essere convalidate. È possibile che non sei autorizzato a effettuare la richiesta. Assicurati che il tuo account sia autorizzato a utilizzare Amazon QuickSight , che le policy abbiano le autorizzazioni corrette e che siano utilizzate le chiavi di accesso corrette.  
Codice di stato HTTP: 401

 ** InternalFailureException **   
Si è verificato un errore interno.  
Codice di stato HTTP: 500

 ** InvalidParameterValueException **   
Uno o più parametri hanno un valore non valido.  
Codice di stato HTTP: 400

 ** LimitExceededException **   
È stato superato un limite.  
Codice di stato HTTP: 409

 ** ResourceExistsException **   
La risorsa specificata esiste già.   
Codice di stato HTTP: 409

 ** ResourceNotFoundException **   
Uno o più risorse non sono state trovate.  
Codice di stato HTTP: 404

 ** ThrottlingException **   
L'accesso è limitato.  
Codice di stato HTTP: 429

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

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

Questo esempio illustra un utilizzo di CreateIngestion.

#### Richiesta di esempio
<a name="API_CreateIngestion_Example_1_Request"></a>

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

## Vedi anche
<a name="API_CreateIngestion_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue:
+  [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/CreateIngestion) 
+  [SDK AWS per .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/CreateIngestion) 
+  [SDK AWS per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/CreateIngestion) 
+  [SDK AWS per Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/CreateIngestion) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/CreateIngestion) 
+  [AWSSDK per JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/CreateIngestion) 
+  [SDK AWS per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/CreateIngestion) 
+  [AWS SDK for 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)