View a markdown version of this page

CreateDatasetExportJob - Amazon Personalize
AnforderungssyntaxAnforderungsparameterAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

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

Erstellt einen Job, der Daten aus Ihrem Datensatz in einen Amazon S3-Bucket exportiert. Damit Amazon Personalize die Trainingsdaten exportieren kann, müssen Sie eine serviceverknüpfte IAM-Rolle angeben, die Amazon PutObject Personalize-Berechtigungen für Ihren Amazon S3-Bucket erteilt. Weitere Informationen finden Sie im Amazon Personalize-Entwicklerhandbuch unter Exportieren eines Datensatzes.

Status

Ein Auftrag zum Exportieren von Datensätzen kann sich in einem der folgenden Zustände befinden:

  • CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -oder- CREATE FAILED

Um den Status des Exportauftrags abzurufen DescribeDatasetExportJob, rufen Sie auf und geben Sie den Amazon-Ressourcennamen (ARN) des Datensatz-Exportauftrags an. Der Datensatzexport ist abgeschlossen, wenn der Status als AKTIV angezeigt wird. Wenn als Status CREATE FAILED angezeigt wird, enthält die Antwort einen failureReason Schlüssel, der beschreibt, warum der Job fehlgeschlagen ist.

Anforderungssyntax

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

Anforderungsparameter

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

datasetArn

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

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 mit einem Datensatz-Importauftrag importiert haben, nur PUT Daten, die Sie inkrementell (mithilfe der Konsole PutUsers und PutItems Operationen) importiert haben, oder ALL für beide Typen. PutEvents Der Standardwert ist PUT.

Typ: Zeichenfolge

Zulässige Werte: BULK | PUT | ALL

Erforderlich: Nein

jobName

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

Der Pfad zum Amazon S3-Bucket, in dem die Ausgabe des Jobs gespeichert wird.

Typ: DatasetExportJobOutput Objekt

Erforderlich: Ja

roleArn

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

Eine Liste von Tags, die auf den Datensatz-Exportauftrag angewendet werden sollen.

Typ: Array von Tag-Objekten

Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 200 Elemente.

Erforderlich: Nein

Antwortsyntax

{
   "datasetExportJobArn": "string"
}

Antwortelemente

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

Der Amazon-Ressourcenname (ARN) des Datensatz-Exportauftrags.

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.

Pattern: arn:([a-z\d-]+):personalize:.*:.*:.+

Fehler

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:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS SDKs finden Sie im Folgenden: