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.

# CreateDatasetExportJob
<a name="API_CreateDatasetExportJob"></a>

 Erstellt einen Job, der Daten aus Ihrem Datensatz in einen Amazon S3 S3-Bucket exportiert. Damit Amazon Personalize die Trainingsdaten exportieren kann, müssen Sie eine serviceverknüpfte IAM-Rolle angeben, die Amazon Personalize `PutObject` Personalize-Berechtigungen für Ihren Amazon S3 S3-Bucket erteilt. Weitere Informationen finden Sie unter [Exportieren eines Datensatzes](https://docs.aws.amazon.com/personalize/latest/dg/export-data.html) im Amazon Personalize Personalize-Entwicklerhandbuch. 

 **Status** 

Ein Datensatz-Exportauftrag kann sich in einem der folgenden Zustände befinden:
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -oder- CREATE FAILED

 Um den Status des Exportjobs abzurufen [DescribeDatasetExportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetExportJob.html), rufen Sie den Amazon-Ressourcennamen (ARN) des Datensatz-Exportjobs auf und geben Sie ihn an. Der Datensatz-Export ist abgeschlossen, wenn der Status als AKTIV angezeigt wird. Wenn der Status CREATE FAILED lautet, enthält die Antwort einen `failureReason` Schlüssel, der beschreibt, warum der Job fehlgeschlagen ist. 

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

```
{
   "datasetArn": "string",
   "ingestionMode": "string",
   "jobName": "string",
   "jobOutput": { 
      "s3DataDestination": { 
         "kmsKeyArn": "string",
         "path": "string"
      }
   },
   "roleArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}
```

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

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [datasetArn](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-datasetArn"></a>
Der Amazon-Ressourcenname (ARN) des Datensatzes, der die zu exportierenden Daten enthält.  
Typ: Zeichenfolge  
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.  
Pattern: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Erforderlich: Ja

 ** [ingestionMode](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-ingestionMode"></a>
Die zu exportierenden Daten, basierend darauf, wie Sie die Daten importiert haben. Sie können wählen, ob Sie nur `BULK` Daten exportieren möchten, die Sie mithilfe eines Datensatz-Importjobs importiert haben, nur `PUT` Daten, die Sie inkrementell importiert haben (mithilfe der Konsole PutUsers und der PutItems Operationen), oder `ALL` für beide Typen. PutEvents Der Standardwert ist `PUT`.   
Typ: Zeichenfolge  
Zulässige Werte: `BULK | PUT | ALL`   
Erforderlich: Nein

 ** [jobName](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-jobName"></a>
Der Name für den Datensatz-Exportauftrag.  
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_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-jobOutput"></a>
Der Pfad zum Amazon S3 S3-Bucket, in dem die Ausgabe des Jobs gespeichert ist.  
Typ: [DatasetExportJobOutput](API_DatasetExportJobOutput.md) Objekt  
Erforderlich: Ja

 ** [roleArn](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-roleArn"></a>
Der Amazon-Ressourcenname (ARN) der IAM-Servicerolle, die berechtigt ist, Daten zu Ihrem Amazon S3-Ausgabe-Bucket hinzuzufügen.  
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

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

```
{
   "datasetExportJobArn": "string"
}
```

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

 ** [datasetExportJobArn](#API_CreateDatasetExportJob_ResponseSyntax) **   <a name="personalize-CreateDatasetExportJob-response-datasetExportJobArn"></a>
Der Amazon-Ressourcenname (ARN) des Datensatz-Exportjobs.  
Typ: Zeichenfolge  
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.  
Pattern: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

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