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 de segmentation 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, consultez la section 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 segmentation 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 du compartiment dans lequel les résultats de la tâche seront stockés.
Type : objet BatchSegmentJobOutput
Obligatoire : oui
- numResults
-
Nombre d'utilisateurs prédits 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 : entier
Obligatoire : non
- roleArn
-
L'ARN du rôle Amazon Identity and Access Management autorisé à lire et à écrire respectivement sur vos compartiments Amazon S3 d'entrée et de sortie.
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 segmentation 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 segmentation par lots.
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 :
