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.

# CreateDatasetExportJob
<a name="API_CreateDatasetExportJob"></a>

 Crée une tâche qui exporte les données de votre ensemble de données vers un compartiment Amazon S3. Pour permettre à Amazon Personalize d'exporter les données de formation, vous devez spécifier un rôle IAM lié à un service qui donne à Amazon Personalize `PutObject` des autorisations pour votre compartiment Amazon S3. Pour plus d'informations, consultez [Exporter un ensemble de données](https://docs.aws.amazon.com/personalize/latest/dg/export-data.html) dans le guide du développeur Amazon Personalize. 

 **Statut** 

Une tâche d'exportation d'un ensemble de données peut se trouver dans l'un des états suivants :
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -ou- CREATE FAILED

 Pour connaître le statut de la tâche d'exportation [DescribeDatasetExportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetExportJob.html), appelez et spécifiez le nom de ressource Amazon (ARN) de la tâche d'exportation de l'ensemble de données. L'exportation du jeu de données est terminée lorsque le statut indique ACTIF. Si le statut est CREATE FAILED, la réponse inclut une `failureReason` clé qui décrit la raison de l'échec de la tâche. 

## Syntaxe de la requête
<a name="API_CreateDatasetExportJob_RequestSyntax"></a>

```
{
   "datasetArn": "string",
   "ingestionMode": "string",
   "jobName": "string",
   "jobOutput": { 
      "s3DataDestination": { 
         "kmsKeyArn": "string",
         "path": "string"
      }
   },
   "roleArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}
```

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

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

 ** [datasetArn](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-datasetArn"></a>
Nom de ressource Amazon (ARN) de l'ensemble de données contenant les données à exporter.  
Type : Chaîne  
Contraintes de longueur : longueur maximale de 256.  
Modèle : `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatoire : oui

 ** [ingestionMode](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-ingestionMode"></a>
Les données à exporter, en fonction de la façon dont vous les avez importées. Vous pouvez choisir d'exporter uniquement les `BULK` données que vous avez importées à l'aide d'une tâche d'importation de jeux de données, uniquement les `PUT` données que vous avez importées de manière incrémentielle (à l'aide de la console PutUsers et PutItems des opérations), ou `ALL` pour les deux types. PutEvents La valeur par défaut est `PUT`.   
Type : Chaîne  
Valeurs valides : `BULK | PUT | ALL`   
Obligatoire : non

 ** [jobName](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-jobName"></a>
Nom de la tâche d'exportation de l'ensemble de données.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 63.  
Modèle : `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatoire : oui

 ** [jobOutput](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-jobOutput"></a>
Le chemin d'accès au compartiment Amazon S3 dans lequel les résultats de la tâche sont stockés.  
Type : objet [DatasetExportJobOutput](API_DatasetExportJobOutput.md)  
Obligatoire : oui

 ** [roleArn](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-roleArn"></a>
Le nom de ressource Amazon (ARN) du rôle de service IAM autorisé à ajouter des données à votre compartiment Amazon S3 de sortie.  
Type : Chaîne  
Contraintes de longueur : longueur maximale de 256.  
Modèle : `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`   
Obligatoire : oui

 ** [tags](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-tags"></a>
Liste des [balises](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) à appliquer à la tâche d'exportation de l'ensemble de données.  
Type : tableau d’objets [Tag](API_Tag.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.  
Obligatoire : non

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

```
{
   "datasetExportJobArn": "string"
}
```

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

Si l’action aboutit, le service renvoie une réponse HTTP 200.

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

 ** [datasetExportJobArn](#API_CreateDatasetExportJob_ResponseSyntax) **   <a name="personalize-CreateDatasetExportJob-response-datasetExportJobArn"></a>
Nom de ressource Amazon (ARN) de la tâche d'exportation de l'ensemble de données.  
Type : Chaîne  
Contraintes de longueur : longueur maximale de 256.  
Modèle : `arn:([a-z\d-]+):personalize:.*:.*:.+` 

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

 ** InvalidInputException **   
Entrez une valeur valide pour le champ ou le paramètre.  
Code d’état HTTP : 400

 ** LimitExceededException **   
La limite du nombre de demandes par seconde a été dépassée.  
Code d’état HTTP : 400

 ** ResourceAlreadyExistsException **   
La ressource spécifiée existe déjà.  
Code d’état HTTP : 400

 ** ResourceInUseException **   
La ressource spécifiée est en cours d'utilisation.  
Code d’état HTTP : 400

 ** ResourceNotFoundException **   
Impossible de trouver la ressource spécifiée.  
Code d’état HTTP : 400

 ** TooManyTagsException **   
Vous avez dépassé le nombre maximum de balises que vous pouvez appliquer à cette ressource.   
Code d’état HTTP : 400

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

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateDatasetExportJob)