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.
CreateBatchInferenceJob
Génère des recommandations par lots sur la base d'une liste d'articles ou d'utilisateurs stockés dans Amazon S3 et exporte les recommandations vers un compartiment Amazon S3.
Pour générer des recommandations par lots, spécifiez l'ARN d'une version de solution et un URI Amazon S3 pour les données d'entrée et de sortie. Pour la personnalisation des utilisateurs, les articles populaires et les solutions de classement personnalisées, la tâche d'inférence par lots génère une liste d'éléments recommandés pour chaque identifiant utilisateur dans le fichier d'entrée. Pour les solutions d'articles connexes, le job génère une liste d'éléments recommandés pour chaque ID d'article dans le fichier d'entrée.
Pour plus d'informations, consultez la section Création d'une tâche d'inférence par lots.
Si vous utilisez la Similar-Items recette, Amazon Personalize peut ajouter des thèmes descriptifs aux recommandations par lots. Pour générer des thèmes, définissez le mode de la tâche sur THEME_GENERATION et spécifiez le nom du champ qui contient les noms des éléments dans les données d'entrée.
Pour plus d'informations sur la génération de thèmes, voir Recommandations par lots avec des thèmes issus de Content Generator.
Vous ne pouvez pas obtenir de recommandations par lots avec les Next-Best-Action recettes Trending-Now ou.
Syntaxe de la requête
{
"batchInferenceJobConfig": {
"itemExplorationConfig": {
"string" : "string"
},
"rankingInfluence": {
"string" : number
}
},
"batchInferenceJobMode": "string",
"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"
}
],
"themeGenerationConfig": {
"fieldsForThemeGeneration": {
"itemName": "string"
}
}
}Paramètres de demande
Cette demande accepte les données suivantes au format JSON.
- batchInferenceJobConfig
-
Les détails de configuration d'une tâche d'inférence par lots.
Type : objet BatchInferenceJobConfig
Obligatoire : non
- batchInferenceJobMode
-
Mode de la tâche d'inférence par lots. Pour générer des thèmes descriptifs pour des groupes d'éléments similaires, définissez le mode de travail sur
THEME_GENERATION. Si vous ne souhaitez pas générer de thèmes, utilisez le thème par défautBATCH_INFERENCE.Lorsque vous recevez des recommandations par lots avec des thèmes, vous devrez payer des frais supplémentaires. Pour plus d'informations, consultez la page Amazon Personalize pricing
. Type : Chaîne
Valeurs valides :
BATCH_INFERENCE | THEME_GENERATIONObligatoire : non
- filterArn
-
L'ARN du filtre à appliquer à la tâche d'inférence 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 qui mène au fichier d'entrée sur lequel baser vos recommandations. Le matériel d'entrée doit être au format JSON.
Type : objet BatchInferenceJobInput
Obligatoire : oui
- jobName
-
Nom de la tâche d'inférence 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 d'accès au compartiment Amazon S3 dans lequel la sortie de la tâche sera stockée.
Type : objet BatchInferenceJobOutput
Obligatoire : oui
- numResults
-
Le nombre de recommandations à récupérer.
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 la solution qui sera utilisée pour générer les recommandations d'inférence 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 d'inférence par lots.
Type : tableau d’objets Tag
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.
Obligatoire : non
- themeGenerationConfig
-
Pour les tâches de génération de thèmes, spécifiez le nom de la colonne de votre jeu de données Items qui contient le nom de chaque élément.
Type : objet ThemeGenerationConfig
Obligatoire : non
Syntaxe de la réponse
{
"batchInferenceJobArn": "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.
- batchInferenceJobArn
-
L'ARN de la tâche d'inférence 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 :
