CreateDataset - 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.

CreateDataset

Erstellt einen leeren Datensatz und fügt sie der angegebenen Datensatz-Gruppe hinzu. Wird verwendet CreateDatasetImportJob, um Ihre Trainingsdaten in einen Datensatz zu importieren.

Es gibt 5 Arten von Datensätzen:

  • Interaktionen mit Artikeln

  • Items

  • Benutzer

  • Interaktionen mit Aktionen

  • Aktionen

Jeder Datensatz-Typ besitzt ein zugehöriges Schema mit erforderlichen Feldtypen. Nur der Item interactions-Datensatz wird benötigt, um ein Modell zu trainieren (auch als Erstellen einer Lösung bezeichnet).

Ein Datensatz kann sich in einem der folgenden Zustände befinden:

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

  • DELETE PENDING > DELETE IN_PROGRESS

Rufen Sie an, um den Status des Datensatzes abzurufen DescribeDataset.

Verbundene APIs

Anforderungssyntax

{
   "datasetGroupArn": "string",
   "datasetType": "string",
   "name": "string",
   "schemaArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}

Anforderungsparameter

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

datasetGroupArn

Der Amazon-Ressourcenname (ARN) der Datensatzgruppe, zu der der Datensatz hinzugefügt werden soll.

Typ: Zeichenfolge

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

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

Erforderlich: Ja

datasetType

Der Typ des Datensatzes.

Einer der folgenden Werte (ohne Berücksichtigung von Groß- und Kleinschreibung):

  • Interaktionen

  • Items

  • Benutzer

  • Aktionen

  • Action_Interactions

Typ: Zeichenfolge

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

Erforderlich: Ja

name

Der Name für den Datensatz.

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

schemaArn

Der ARN des Schemas, das dem Datensatz zugeordnet werden soll. Das Schema definiert die Datensatzfelder.

Typ: Zeichenfolge

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

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

Erforderlich: Ja

tags

Eine Liste von Tags, die auf den Datensatz 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

{
   "datasetArn": "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.

datasetArn

Der ARN des Datensatzes.

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 Status Code: 400

LimitExceededException

Das Limit für die Anzahl der Anfragen pro Sekunde wurde überschritten.

HTTP Status Code: 400

ResourceAlreadyExistsException

Die angegebene Ressource ist bereits vorhanden.

HTTP Status Code: 400

ResourceInUseException

Die angegebene Ressource wird verwendet.

HTTP Status Code: 400

ResourceNotFoundException

Die angegebene Ressource konnte nicht gefunden werden.

HTTP Status Code: 400

TooManyTagsException

Sie haben die maximale Anzahl von Tags überschritten, die Sie auf diese Ressource anwenden können.

HTTP Status Code: 400

Weitere Informationen finden Sie unter:

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