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 la section Suppression d'utilisateurs.
-
Votre fichier d'entrée doit être un fichier CSV avec une seule colonne USER_ID répertoriant les utilisateurs. IDs 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
ListBucketautorisationsGetObjectet 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.
Une fois que vous avez 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.
Relié APIs
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 : String
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 : String
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 : String
Contraintes de longueur : longueur maximale de 256.
Modèle :
arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+Obligatoire : oui
-
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 : String
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 langages spécifiques AWS SDKs, consultez ce qui suit :
