Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

Crée et démarre une nouvelle ingestion SPICE pour un ensemble de données. Vous pouvez actualiser manuellement les jeux de données d'un compte d'édition Enterprise 32 fois par période de 24 heures. Vous pouvez actualiser manuellement les jeux de données d'un compte d'édition Standard 8 fois par période de 24 heures. Chaque période de 24 heures est mesurée 24 heures avant la date et l'heure actuelles.

Toutes les acquisitions effectuées sur des jeux de données balisés héritent automatiquement des mêmes balises pour une utilisation dans le contrôle d'accès. Pour obtenir un exemple, veuillez consulter .[Comment créer une stratégie IAM pour contrôler l'accès aux ressources Amazon EC2 à l'aide de balises ?](https://aws.amazon.com/premiumsupport/knowledge-center/iam-ec2-resource-tags/)dans leAWSCentre de connaissances. Les balises sont visibles sur le jeu de données balisé, mais pas sur la ressource d'ingestion.

## Syntaxe de la demande
<a name="API_CreateIngestion_RequestSyntax"></a>

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

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

## Paramètres de demande URI
<a name="API_CreateIngestion_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [AwsAccountId](#API_CreateIngestion_RequestSyntax) **   <a name="QS-CreateIngestion-request-AwsAccountId"></a>
L'ID de compte AWS.  
Contraintes de longueur : Longueur fixe de 12.  
Modèle : `^[0-9]{12}$`   
Obligatoire : Oui

 ** [DataSetId](#API_CreateIngestion_RequestSyntax) **   <a name="QS-CreateIngestion-request-DataSetId"></a>
ID du jeu de données utilisé dans l'ingestion.  
Obligatoire : Oui

 ** [IngestionId](#API_CreateIngestion_RequestSyntax) **   <a name="QS-CreateIngestion-request-IngestionId"></a>
Un identifiant pour l'ingestion.  
Contraintes de longueur : Longueur minimale de 1. Longueur maximum de 128.  
Modèle : `^[a-zA-Z0-9-_]+$`   
Obligatoire : Oui

## Corps de la demande
<a name="API_CreateIngestion_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [IngestionType](#API_CreateIngestion_RequestSyntax) **   <a name="QS-CreateIngestion-request-IngestionType"></a>
Type d'ingestion que vous souhaitez créer.  
Type : Chaîne  
Valeurs valides :` INCREMENTAL_REFRESH | FULL_REFRESH`   
Obligatoire : Non

## Syntaxe de la réponse
<a name="API_CreateIngestion_ResponseSyntax"></a>

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

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

## Eléments de réponse
<a name="API_CreateIngestion_ResponseElements"></a>

Si l'action aboutit, le service renvoie la réponse HTTP suivante.

 ** [Status](#API_CreateIngestion_ResponseSyntax) **   <a name="QS-CreateIngestion-response-Status"></a>
Le statut HTTP de la requête.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [Arn](#API_CreateIngestion_ResponseSyntax) **   <a name="QS-CreateIngestion-response-Arn"></a>
Amazon Resource Name (ARN) pour l'ingestion de données.  
Type : Chaîne

 ** [IngestionId](#API_CreateIngestion_ResponseSyntax) **   <a name="QS-CreateIngestion-response-IngestionId"></a>
Un identifiant pour l'ingestion.  
Type : Chaîne  
Contraintes de longueur : Longueur minimale de 1. Longueur maximum de 128.  
Modèle : `^[a-zA-Z0-9-_]+$` 

 ** [IngestionStatus](#API_CreateIngestion_ResponseSyntax) **   <a name="QS-CreateIngestion-response-IngestionStatus"></a>
Le statut d'ingestion.  
Type : Chaîne  
Valeurs valides :` INITIALIZED | QUEUED | RUNNING | FAILED | COMPLETED | CANCELLED` 

 ** [RequestId](#API_CreateIngestion_ResponseSyntax) **   <a name="QS-CreateIngestion-response-RequestId"></a>
LeAWSID de demande pour cette opération.  
Type : Chaîne

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

Pour plus d'informations sur les erreurs communes à toutes les actions, consultez[Erreurs courantes](CommonErrors.md).

 ** AccessDeniedException **   
Vous n'avez pas accès à cet article. Les informations d'identification fournies n'ont pas pu être validées. Il est possible que vous ne soyez pas autorisé à effectuer la demande. Assurez-vous que votre compte est autorisé à utiliser Amazon QuickSight , que vos stratégies ont les autorisations appropriées et que vous utilisez les bonnes clés d'accès.  
Code d'état HTTP : 401

 ** InternalFailureException **   
Une défaillance interne s'est produite.  
Code d'état HTTP : 500

 ** InvalidParameterValueException **   
La valeur d'un ou de plusieurs paramètres n'est pas valide.  
Code d'état HTTP : 400

 ** LimitExceededException **   
Une limite est dépassée.  
Code d'état HTTP : 409

 ** ResourceExistsException **   
La ressource spécifiée existe déjà.   
Code d'état HTTP : 409

 ** ResourceNotFoundException **   
Une ou plusieurs ressources n'ont pas pu être trouvées.  
Code d'état HTTP : 404

 ** ThrottlingException **   
L'accès est limité.  
Code d'état HTTP : 429

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

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

Cet exemple illustre une utilisation de CreateIngestion.

#### Exemple de demande
<a name="API_CreateIngestion_Example_1_Request"></a>

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

## Voir aussi
<a name="API_CreateIngestion_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Interface de ligne de commande AWS](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/CreateIngestion) 
+  [AWS SDK pour .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/CreateIngestion) 
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/CreateIngestion) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/CreateIngestion) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/CreateIngestion) 
+  [AWSKits SDK JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/CreateIngestion) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/CreateIngestion) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/CreateIngestion) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/CreateIngestion)