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 une tâche par lots qui supprime toutes les références à des utilisateurs spécifiques d'un groupe de données Amazon Personalize par lots. Vous spécifiez les utilisateurs à supprimer dans un fichier CSV contenant des ID utilisateur dans un compartiment Amazon S3. Une fois une tâche 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 ID des utilisateurs. Pour plus d'informations sur la préparation du fichier CSV, consultez Préparer votre fichier de suppression de données et le charger sur Amazon S3.
-
Pour autoriser Amazon Personalize à accéder à votre fichier CSV d'entrée contenant les identifiants utilisateur, vous devez spécifier un rôle de service IAM autorisé à lire à partir de la source de données. Ce rôle a besoin d'
ListBucketautorisationsGetObjectet d'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 la section Donner à Amazon un accès personnalisé aux ressources Amazon S3.
Une fois que vous avez créé une tâche, la suppression de toutes les références aux utilisateurs des jeux de données et des modèles peut prendre jusqu'à un jour. Jusqu'à la fin de la tâche, Amazon Personalize continue d'utiliser les données lors de la formation. Et si vous utilisez une recette de segmentation des utilisateurs, les utilisateurs peuvent apparaître dans les 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 de données, appelez DescribeDataDeletionJob API operation 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 pourquoi la tâche a échoué.
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 jeux de données contenant les jeux 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 ID utilisateur des utilisateurs à supprimer.
Type : objet DataSource
Obligatoire : oui
- jobName
-
Le nom de la tâche de suppression 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
-
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
-
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
-
Fournissez une valeur valide pour le champ ou le paramètre.
Code d’état HTTP : 400
- LimitExceededException
-
La limite du nombre de requêtes 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 AWS kits SDK spécifiques à une langue, consultez les rubriques suivantes :
