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.

# CreateBatchSegmentJob
<a name="API_CreateBatchSegmentJob"></a>

Erstellt einen Batch-Segment-Job. Der Vorgang kann bis zu 50 Millionen Datensätze verarbeiten und die Eingabedatei muss im JSON-Format vorliegen. Weitere Informationen finden Sie unter [Batch-Empfehlungen und Benutzersegmente abrufen](https://docs.aws.amazon.com/personalize/latest/dg/recommendations-batch.html).

## Anforderungssyntax
<a name="API_CreateBatchSegmentJob_RequestSyntax"></a>

```
{
   "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"
      }
   ]
}
```

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

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [filterArn](#API_CreateBatchSegmentJob_RequestSyntax) **   <a name="personalize-CreateBatchSegmentJob-request-filterArn"></a>
Der ARN des Filters, der auf den Batch-Segment-Job 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_CreateBatchSegmentJob_RequestSyntax) **   <a name="personalize-CreateBatchSegmentJob-request-jobInput"></a>
Der Amazon S3 S3-Pfad für die Eingabedaten, die zur Generierung des Batch-Segment-Jobs verwendet wurden.  
Typ: [BatchSegmentJobInput](API_BatchSegmentJobInput.md) Objekt  
Erforderlich: Ja

 ** [jobName](#API_CreateBatchSegmentJob_RequestSyntax) **   <a name="personalize-CreateBatchSegmentJob-request-jobName"></a>
Der Name des zu erstellenden Batch-Segment-Jobs.  
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_CreateBatchSegmentJob_RequestSyntax) **   <a name="personalize-CreateBatchSegmentJob-request-jobOutput"></a>
Der Amazon S3 S3-Pfad für den Bucket, in dem die Ausgabe des Jobs gespeichert wird.  
Typ: [BatchSegmentJobOutput](API_BatchSegmentJobOutput.md) Objekt  
Erforderlich: Ja

 ** [numResults](#API_CreateBatchSegmentJob_RequestSyntax) **   <a name="personalize-CreateBatchSegmentJob-request-numResults"></a>
Die Anzahl der prognostizierten Benutzer, die durch den Batch-Segment-Job für jede Zeile von Eingabedaten generiert wurden. Die maximale Anzahl von Benutzern pro Segment beträgt 5 Millionen.  
Typ: Ganzzahl  
Erforderlich: Nein

 ** [roleArn](#API_CreateBatchSegmentJob_RequestSyntax) **   <a name="personalize-CreateBatchSegmentJob-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_CreateBatchSegmentJob_RequestSyntax) **   <a name="personalize-CreateBatchSegmentJob-request-solutionVersionArn"></a>
Der Amazon-Ressourcenname (ARN) der Lösungsversion, die der Batch-Segment-Job zur Generierung von Batchsegmenten verwenden soll.  
Typ: Zeichenfolge  
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.  
Pattern: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Erforderlich: Ja

 ** [tags](#API_CreateBatchSegmentJob_RequestSyntax) **   <a name="personalize-CreateBatchSegmentJob-request-tags"></a>
Eine Liste von [Tags](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html), die auf den Batch-Segment-Job 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

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

```
{
   "batchSegmentJobArn": "string"
}
```

## Antwortelemente
<a name="API_CreateBatchSegmentJob_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.

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

## Fehler
<a name="API_CreateBatchSegmentJob_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_CreateBatchSegmentJob_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/CreateBatchSegmentJob) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateBatchSegmentJob) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateBatchSegmentJob) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateBatchSegmentJob) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateBatchSegmentJob) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateBatchSegmentJob) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateBatchSegmentJob) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateBatchSegmentJob) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateBatchSegmentJob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateBatchSegmentJob)