CreateDataDeletionJob - 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.

CreateDataDeletionJob

Crée un traitement par lots qui supprime par lots toutes les références à des utilisateurs spécifiques d'un groupe de jeux de données Amazon Personalize. Vous spécifiez les utilisateurs à supprimer dans un fichier CSV contenant des identifiants d'utilisateur dans un compartiment Amazon S3. Une fois qu'une tâche est terminée, Amazon Personalize ne s'entraîne plus sur les données des utilisateurs et ne prend plus en compte les utilisateurs lors de la génération de segments d'utilisateurs. Pour plus d'informations sur la création d'une tâche de suppression de données, consultez Supprimer des utilisateurs.

  • Votre fichier d'entrée doit être un fichier CSV avec une seule colonne USER_ID répertoriant les identifiants des utilisateurs. Pour plus d'informations sur la préparation du fichier CSV, consultez Préparation de votre fichier de suppression de données et chargement de celui-ci sur Amazon S3.

  • Pour autoriser Amazon Personalize à accéder à votre fichier CSV d'entrée UserIds, vous devez spécifier un rôle de service IAM autorisé à lire depuis la source de données. Ce rôle nécessite des ListBucket autorisations GetObject et des autorisations pour le bucket et son contenu. Ces autorisations sont identiques à celles relatives à l'importation de données. Pour plus d'informations sur l'octroi de l'accès à votre compartiment Amazon S3, consultez Giving Amazon Personalize Access to Amazon S3 Resources.

Après avoir créé une tâche, la suppression de toutes les références aux utilisateurs dans les ensembles de données et les modèles peut prendre jusqu'à un jour. Jusqu'à ce que le travail soit terminé, Amazon Personalize continue d'utiliser les données lors de la formation. Et si vous utilisez une recette de segmentation utilisateur, les utilisateurs peuvent apparaître dans des segments d'utilisateurs.

Statut

Une tâche de suppression de données peut avoir l'un des statuts suivants :

  • EN ATTENTE > EN COURS > TERMINÉ OU ÉCHEC

Pour connaître l'état de la tâche de suppression des données, appelez DescribeDataDeletionJobl'opération API et spécifiez l'Amazon Resource Name (ARN) de la tâche. Si le statut est FAILED, la réponse inclut une failureReason clé qui décrit la raison de l'échec de la tâche.

API associées

Syntaxe de la requête

{
   "datasetGroupArn": "string",
   "dataSource": { 
      "dataLocation": "string"
   },
   "jobName": "string",
   "roleArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}

Paramètres de demande

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

datasetGroupArn

Le nom de ressource Amazon (ARN) du groupe de données contenant les ensembles de données dont vous souhaitez supprimer des enregistrements.

Type : chaîne

Contraintes de longueur : longueur maximale de 256.

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

Obligatoire : oui

dataSource

Le compartiment Amazon S3 qui contient la liste des UserID des utilisateurs à supprimer.

Type : objet DataSource

Obligatoire : oui

jobName

Nom de la tâche de suppression des 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

Le nom de ressource Amazon (ARN) du rôle IAM autorisé à lire depuis la source de données Amazon S3.

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

Liste des balises à appliquer à la tâche de suppression des 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

{
   "dataDeletionJobArn": "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.

dataDeletionJobArn

Le nom de ressource Amazon (ARN) de la tâche de suppression des 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 :