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.
CreateBatchSegmentJob
Crée une tâche segmentée par lots. L'opération peut gérer jusqu'à 50 millions d'enregistrements et le fichier d'entrée doit être au format JSON. Pour plus d'informations, voir Obtenir des recommandations par lots et des segments d'utilisateurs.
Syntaxe de la requête
{
"filterArn": "string",
"jobInput": {
"s3DataSource": {
"kmsKeyArn": "string",
"path": "string"
}
},
"jobName": "string",
"jobOutput": {
"s3DataDestination": {
"kmsKeyArn": "string",
"path": "string"
}
},
"numResults": number,
"roleArn": "string",
"solutionVersionArn": "string",
"tags": [
{
"tagKey": "string",
"tagValue": "string"
}
]
}Paramètres de demande
Cette demande accepte les données suivantes au format JSON.
- filterArn
-
L'ARN du filtre à appliquer à la tâche de segmentation par lots. Pour plus d'informations sur l'utilisation des filtres, consultez la section Recommandations relatives au filtrage par lots.
Type : Chaîne
Contraintes de longueur : longueur maximale de 256.
Modèle :
arn:([a-z\d-]+):personalize:.*:.*:.+Obligatoire : non
- jobInput
-
Le chemin Amazon S3 pour les données d'entrée utilisées pour générer la tâche de segment par lots.
Type : objet BatchSegmentJobInput
Obligatoire : oui
- jobName
-
Nom de la tâche de segment par lots à créer.
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
- jobOutput
-
Le chemin Amazon S3 pour le compartiment dans lequel la sortie de la tâche sera stockée.
Type : objet BatchSegmentJobOutput
Obligatoire : oui
- numResults
-
Le nombre d'utilisateurs prévus générés par la tâche de segmentation par lots pour chaque ligne de données d'entrée. Le nombre maximum d'utilisateurs par segment est de 5 millions.
Type : Integer
Obligatoire : non
- roleArn
-
L'ARN du rôle Amazon Identity and Access Management qui est autorisé à lire et à écrire dans vos compartiments Amazon S3 d'entrée et de sortie respectivement.
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
- solutionVersionArn
-
Le nom de ressource Amazon (ARN) de la version de solution que vous souhaitez que la tâche de segment par lots utilise pour générer des segments par lots.
Type : Chaîne
Contraintes de longueur : longueur maximale de 256.
Modèle :
arn:([a-z\d-]+):personalize:.*:.*:.+Obligatoire : oui
-
Liste des balises à appliquer à la tâche de segmentation par lots.
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
{
"batchSegmentJobArn": "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.
- batchSegmentJobArn
-
L'ARN de la tâche de segment par lots.
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 :
