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
<a name="API_CreateBatchInferenceJob"></a>

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, le travail d'inférence par lots génère une liste d'éléments recommandés pour chaque ID utilisateur dans le fichier d'entrée. Pour les solutions d'articles connexes, la tâche 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](https://docs.aws.amazon.com/personalize/latest/dg/getting-batch-recommendations.html).

 Si vous utilisez la recette Similar-Items, 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 contenant les noms d'éléments dans les données d'entrée.

 Pour plus d'informations sur la génération de thèmes, consultez la section [Recommandations par lots avec les thèmes de Content Generator](https://docs.aws.amazon.com/personalize/latest/dg/themed-batch-recommendations.html). 

Vous ne pouvez pas obtenir de recommandations par lots avec le Trending-Now ou les recettes. Next-Best-Action

## Syntaxe de la requête
<a name="API_CreateBatchInferenceJob_RequestSyntax"></a>

```
{
   "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
<a name="API_CreateBatchInferenceJob_RequestParameters"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [batchInferenceJobConfig](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-batchInferenceJobConfig"></a>
Détails de configuration d'une tâche d'inférence par lots.  
Type : objet [BatchInferenceJobConfig](API_BatchInferenceJobConfig.md)  
Obligatoire : non

 ** [batchInferenceJobMode](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-batchInferenceJobMode"></a>
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éfaut`BATCH_INFERENCE`.  
 Lorsque vous recevez des recommandations par lots avec des thèmes, vous encourez des coûts supplémentaires. Pour plus d'informations, consultez les [tarifs d'Amazon Personalize](https://aws.amazon.com/personalize/pricing/).   
Type : Chaîne  
Valeurs valides : `BATCH_INFERENCE | THEME_GENERATION`   
Obligatoire : non

 ** [filterArn](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-filterArn"></a>
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](https://docs.aws.amazon.com/personalize/latest/dg/filter-batch.html).  
Type : Chaîne  
Contraintes de longueur : longueur maximale de 256.  
Modèle : `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatoire : non

 ** [jobInput](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-jobInput"></a>
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](API_BatchInferenceJobInput.md)  
Obligatoire : oui

 ** [jobName](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-jobName"></a>
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](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-jobOutput"></a>
Le chemin d'accès au compartiment Amazon S3 dans lequel les résultats de la tâche seront stockés.  
Type : objet [BatchInferenceJobOutput](API_BatchInferenceJobOutput.md)  
Obligatoire : oui

 ** [numResults](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-numResults"></a>
Le nombre de recommandations à récupérer.  
Type : Integer  
Obligatoire : non

 ** [roleArn](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-roleArn"></a>
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](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-solutionVersionArn"></a>
Le nom de ressource Amazon (ARN) de la version de 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

 ** [tags](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-tags"></a>
Liste des [balises](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) à appliquer à la tâche d'inférence par lots.  
Type : tableau d’objets [Tag](API_Tag.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.  
Obligatoire : non

 ** [themeGenerationConfig](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-themeGenerationConfig"></a>
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](API_ThemeGenerationConfig.md)  
Obligatoire : non

## Syntaxe de la réponse
<a name="API_CreateBatchInferenceJob_ResponseSyntax"></a>

```
{
   "batchInferenceJobArn": "string"
}
```

## Eléments de réponse
<a name="API_CreateBatchInferenceJob_ResponseElements"></a>

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](#API_CreateBatchInferenceJob_ResponseSyntax) **   <a name="personalize-CreateBatchInferenceJob-response-batchInferenceJobArn"></a>
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
<a name="API_CreateBatchInferenceJob_Errors"></a>

 ** 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

## Voir aussi
<a name="API_CreateBatchInferenceJob_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateBatchInferenceJob)