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. # CreateDataset Crée un jeu de données vide et l'ajoute au groupe de jeux de données spécifié. Utilisez-le [CreateDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetImportJob.html)pour importer vos données d'entraînement dans un ensemble de données. Il existe 5 types de jeux de données : + Interactions entre objets + Éléments + Utilisateurs + Interactions entre actions + Actions Chaque type de jeu de données a un schéma associé avec des types de champs obligatoires. Seul le jeu de données `Item interactions` est nécessaire pour entraîner un modèle (également appelé création d'une solution). Un jeu de données peut avoir l'un des états suivants : + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -ou- CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS Pour obtenir le statut de l'ensemble de données, appelez [DescribeDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataset.html). **Connexe APIs** + [CreateDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetGroup.html) + [ListDatasets](https://docs.aws.amazon.com/personalize/latest/dg/API_ListDatasets.html) + [DescribeDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataset.html) + [DeleteDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteDataset.html) ## Syntaxe de la requête ``` { "datasetGroupArn": "string", "datasetType": "string", "name": "string", "schemaArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## Paramètres de demande Cette demande accepte les données suivantes au format JSON. ** [datasetGroupArn](#API_CreateDataset_RequestSyntax) ** Nom de ressource Amazon (ARN) du groupe de jeux de données auquel ajouter l'ensemble de données. Type : Chaîne Contraintes de longueur : longueur maximale de 256. Modèle : `arn:([a-z\d-]+):personalize:.*:.*:.+` Obligatoire : oui ** [datasetType](#API_CreateDataset_RequestSyntax) ** Type de jeu de données. L'une des valeurs suivantes (sans distinction majuscules/majuscules) : + Interactions + Éléments + Utilisateurs + Actions + Interactions par action Type : Chaîne Contraintes de longueur : longueur maximale de 256. Modèle : `^[A-Za-z_]+$` Obligatoire : oui ** [name](#API_CreateDataset_RequestSyntax) ** Le nom 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 ** [schemaArn](#API_CreateDataset_RequestSyntax) ** L'ARN du schéma à associer à l'ensemble de données. Le schéma définit les champs du jeu de données. Type : Chaîne Contraintes de longueur : longueur maximale de 256. Modèle : `arn:([a-z\d-]+):personalize:.*:.*:.+` Obligatoire : oui ** [tags](#API_CreateDataset_RequestSyntax) ** Liste des [balises](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) à appliquer à 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 ``` { "datasetArn": "string" } ``` ## Eléments de réponse 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. ** [datasetArn](#API_CreateDataset_ResponseSyntax) ** L'ARN de l'ensemble de données. Type : Chaîne Contraintes de longueur : longueur maximale de 256. Modèle : `arn:([a-z\d-]+):personalize:.*:.*:.+` ## Erreurs ** 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 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/CreateDataset) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateDataset) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateDataset) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateDataset) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateDataset) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateDataset) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateDataset) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateDataset) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateDataset) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateDataset)