Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# CreateBatchInferenceJob
<a name="API_CreateBatchInferenceJob"></a>

Generiert Batch-Empfehlungen auf der Grundlage einer Liste von Artikeln oder Benutzern, die in Amazon S3 gespeichert sind, und exportiert die Empfehlungen in einen Amazon S3 S3-Bucket.

Um Batch-Empfehlungen zu generieren, geben Sie den ARN einer Lösungsversion und einen Amazon S3 S3-URI für die Eingabe- und Ausgabedaten an. Für Benutzerpersonalisierung, beliebte Artikel und personalisierte Rankinglösungen generiert der Batch-Inferenz-Job eine Liste mit empfohlenen Elementen für jede Benutzer-ID in der Eingabedatei. Bei Lösungen für verwandte Artikel generiert der Job eine Liste mit empfohlenen Elementen für jede Element-ID in der Eingabedatei.

Weitere Informationen finden Sie unter [Einen Batch-Inferenzjob](https://docs.aws.amazon.com/personalize/latest/dg/getting-batch-recommendations.html) erstellen.

 Wenn Sie das Rezept für ähnliche Artikel verwenden, kann Amazon Personalize den Batch-Empfehlungen beschreibende Themen hinzufügen. Um Themen zu generieren, setzen Sie den Auftragsmodus auf `THEME_GENERATION` und geben Sie den Namen des Felds an, das Artikelnamen in den Eingabedaten enthält.

 Weitere Informationen zum Generieren von Themes finden Sie unter [Batch-Empfehlungen mit Themes aus dem Content Generator](https://docs.aws.amazon.com/personalize/latest/dg/themed-batch-recommendations.html). 

Mit Trending-Now oder Next-Best-Action Rezepten können Sie keine Batch-Empfehlungen erhalten.

## Anforderungssyntax
<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"
      }
   }
}
```

## Anforderungsparameter
<a name="API_CreateBatchInferenceJob_RequestParameters"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [batchInferenceJobConfig](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-batchInferenceJobConfig"></a>
Die Konfigurationsdetails eines Batch-Inferenzjobs.  
Typ: [BatchInferenceJobConfig](API_BatchInferenceJobConfig.md) Objekt  
Erforderlich: Nein

 ** [batchInferenceJobMode](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-batchInferenceJobMode"></a>
Der Modus des Batch-Inferenzjobs. Um beschreibende Themen für Gruppen ähnlicher Elemente zu generieren, stellen Sie den Jobmodus auf ein. `THEME_GENERATION` Wenn Sie keine Themen generieren möchten, verwenden Sie die Standardeinstellung`BATCH_INFERENCE`.  
 Wenn Sie Batch-Empfehlungen mit Themen erhalten, fallen zusätzliche Kosten an. Weitere Informationen finden Sie unter [Amazon Personalize Personalize-Preise](https://aws.amazon.com/personalize/pricing/).   
Typ: Zeichenfolge  
Zulässige Werte: `BATCH_INFERENCE | THEME_GENERATION`   
Erforderlich: Nein

 ** [filterArn](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-filterArn"></a>
Der ARN des Filters, der auf den Batch-Inferenzjob angewendet werden soll. Weitere Informationen zur Verwendung von Filtern finden Sie unter [Empfehlungen zum Filtern von Batches](https://docs.aws.amazon.com/personalize/latest/dg/filter-batch.html).  
Typ: Zeichenfolge  
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.  
Pattern: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Erforderlich: Nein

 ** [jobInput](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-jobInput"></a>
Der Amazon S3 S3-Pfad, der zur Eingabedatei führt, auf der Ihre Empfehlungen basieren sollen. Das Eingabematerial muss im JSON-Format vorliegen.  
Typ: [BatchInferenceJobInput](API_BatchInferenceJobInput.md) Objekt  
Erforderlich: Ja

 ** [jobName](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-jobName"></a>
Der Name des zu erstellenden Batch-Inferenzjobs.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 63 Zeichen.  
Pattern: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Erforderlich: Ja

 ** [jobOutput](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-jobOutput"></a>
Der Pfad zum Amazon S3 S3-Bucket, in dem die Ausgabe des Jobs gespeichert wird.  
Typ: [BatchInferenceJobOutput](API_BatchInferenceJobOutput.md) Objekt  
Erforderlich: Ja

 ** [numResults](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-numResults"></a>
Die Anzahl der abzurufenden Empfehlungen.  
Typ: Ganzzahl  
Erforderlich: Nein

 ** [roleArn](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-roleArn"></a>
Der ARN der Amazon Identity and Access Management-Rolle, die über Lese- und Schreibberechtigungen für Ihre Eingabe- bzw. Ausgabe-Amazon S3-Buckets verfügt.  
Typ: Zeichenfolge  
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.  
Pattern: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`   
Erforderlich: Ja

 ** [solutionVersionArn](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-solutionVersionArn"></a>
Der Amazon-Ressourcenname (ARN) der Lösungsversion, die zur Generierung der Batch-Inferenzempfehlungen verwendet wird.  
Typ: Zeichenfolge  
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.  
Pattern: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Erforderlich: Ja

 ** [tags](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-tags"></a>
Eine Liste von [Tags](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html), die auf den Batch-Inferenzjob angewendet werden sollen.  
Typ: Array von [Tag](API_Tag.md)-Objekten  
Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 200 Elemente.  
Erforderlich: Nein

 ** [themeGenerationConfig](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-themeGenerationConfig"></a>
Geben Sie für Jobs zur Themengenerierung den Namen der Spalte in Ihrem Artikeldatensatz an, die die Namen der einzelnen Elemente enthält.  
Typ: [ThemeGenerationConfig](API_ThemeGenerationConfig.md) Objekt  
Erforderlich: Nein

## Antwortsyntax
<a name="API_CreateBatchInferenceJob_ResponseSyntax"></a>

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

## Antwortelemente
<a name="API_CreateBatchInferenceJob_ResponseElements"></a>

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

 ** [batchInferenceJobArn](#API_CreateBatchInferenceJob_ResponseSyntax) **   <a name="personalize-CreateBatchInferenceJob-response-batchInferenceJobArn"></a>
Der ARN des Batch-Inferenzjobs.  
Typ: Zeichenfolge  
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.  
Pattern: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Fehler
<a name="API_CreateBatchInferenceJob_Errors"></a>

 ** InvalidInputException **   
Geben Sie einen gültigen Wert für das Feld oder den Parameter an.  
HTTP-Statuscode: 400

 ** LimitExceededException **   
Das Limit für die Anzahl der Anfragen pro Sekunde wurde überschritten.  
HTTP-Statuscode: 400

 ** ResourceAlreadyExistsException **   
Die angegebene Ressource ist bereits vorhanden.  
HTTP-Statuscode: 400

 ** ResourceInUseException **   
Die angegebene Ressource wird verwendet.  
HTTP-Statuscode: 400

 ** ResourceNotFoundException **   
Die angegebene Ressource konnte nicht gefunden werden.  
HTTP-Statuscode: 400

 ** TooManyTagsException **   
Sie haben die maximale Anzahl von Tags überschritten, die Sie auf diese Ressource anwenden können.   
HTTP-Statuscode: 400

## Weitere Informationen finden Sie unter:
<a name="API_CreateBatchInferenceJob_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+  [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateBatchInferenceJob)