CreateDatasetGroup - Amazon Personalize
Syntaxe de la requêteParamètres de demandeSyntaxe de la réponseEléments de réponseErreursconsultez aussi

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.

CreateDatasetGroup

Crée un groupe de jeux de données vide. Un groupe de jeux de données est un conteneur pour les ressources Amazon Personalize. Un groupe de jeux de données peut contenir au maximum trois ensembles de données, un pour chaque type d'ensemble de données :

  • Interactions entre objets

  • Éléments

  • Users

  • Actions

  • Interactions entre les actions

Un groupe de jeux de données peut être un groupe de jeux de données de domaine, dans lequel vous spécifiez un domaine et utilisez des ressources préconfigurées telles que des recommandations, ou un groupe de jeux de données personnalisé, dans lequel vous utilisez des ressources personnalisées, telles qu'une solution avec une version de solution, que vous déployez dans le cadre d'une campagne. Si vous commencez avec un groupe de jeux de données de domaine, vous pouvez toujours ajouter des ressources personnalisées telles que des solutions et des versions de solutions conçues à l'aide de recettes pour des cas d'utilisation personnalisés et déployées dans le cadre de campagnes.

Un groupe de jeux de données peut se trouver dans l'un des états suivants :

  • CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -ou- CREATE FAILED

  • SUPPRIMER EN ATTENTE

Pour obtenir le statut du groupe de jeux de données, appelez DescribeDatasetGroup. Si le statut est CREATE FAILED, la réponse inclut une failureReason clé expliquant pourquoi la création a échoué.

Note

Vous devez attendre que le nom du groupe status de jeux de données soit présent ACTIVE avant d'ajouter un ensemble de données au groupe.

Vous pouvez spécifier une clé AWS Key Management Service (KMS) pour chiffrer les ensembles de données du groupe. Si vous spécifiez une clé KMS, vous devez également inclure un rôle AWS Identity and Access Management (IAM) autorisé à accéder à la clé.

API qui nécessitent un ARN de groupe de données dans la demande
API associées

Syntaxe de la requête

{
   "domain": "string",
   "kmsKeyArn": "string",
   "name": "string",
   "roleArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}

Paramètres de demande

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

domain

Le domaine du groupe de jeux de données. Spécifiez un domaine pour créer un groupe de jeux de données de domaine. Le domaine que vous spécifiez détermine les schémas par défaut pour les ensembles de données et les cas d'utilisation disponibles pour les recommandeurs. Si vous ne spécifiez pas de domaine, vous créez un groupe de jeux de données personnalisé avec des versions de solutions que vous déployez dans le cadre d'une campagne.

Type : chaîne

Valeurs valides : ECOMMERCE | VIDEO_ON_DEMAND

Obligatoire : non

kmsKeyArn

Le nom de ressource Amazon (ARN) d'une clé AWS Key Management Service (KMS) utilisée pour chiffrer les ensembles de données.

Type : chaîne

Contraintes de longueur : longueur maximale de 2048.

Modèle : arn:aws.*:kms:.*:[0-9]{12}:key/.*

Obligatoire : non

name

Nom du nouveau groupe de jeux 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

roleArn

L'ARN du rôle AWS Identity and Access Management (IAM) autorisé à accéder à la clé AWS Key Management Service (KMS). La fourniture d'un rôle IAM n'est valide que si vous spécifiez également une clé KMS.

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 : non

tags

Liste des balises à appliquer au groupe de jeux 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

{
   "datasetGroupArn": "string",
   "domain": "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.

datasetGroupArn

Le nom de ressource Amazon (ARN) du nouveau groupe de données.

Type : chaîne

Contraintes de longueur : longueur maximale de 256.

Modèle : arn:([a-z\d-]+):personalize:.*:.*:.+

domain

Le domaine du nouveau groupe de jeux de données de domaine.

Type : chaîne

Valeurs valides : ECOMMERCE | VIDEO_ON_DEMAND

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

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 :