CreateDataset - Amazon Personalize

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 CreateDatasetImportJobpour importer vos données d'entraînement dans un ensemble de données.

Il existe 5 types de jeux de données :

  • Interactions entre les objets

  • Éléments

  • Users

  • Interactions entre les 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_PROGRESS > ACTIVE -ou- CREATE FAILED

  • DELETE PENDING > DELETE IN_PROGRESS

Pour obtenir le statut de l'ensemble de données, appelez DescribeDataset.

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

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

Type de jeu de données.

L'une des valeurs suivantes (sans distinction majuscules/majuscules) :

  • Interactions

  • Éléments

  • Users

  • Actions

  • Action_Interactions

Type : chaîne

Contraintes de longueur : longueur maximale de 256.

Obligatoire : oui

name

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

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

Liste des balises à appliquer à l'ensemble de données.

Type : tableau d’objets Tag

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

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

consultez aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS SDK spécifiques au langage, consultez les pages suivantes :