DescribeDataset - Amazon Forecast

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.

DescribeDataset

Beschreibt einen Amazon-Forecast-Datensatz, der mit der -CreateDatasetOperation erstellt wurde.

Diese Operation listet nicht nur die in der CreateDataset Anforderung angegebenen Parameter auf, sondern enthält auch die folgenden Datensatzeigenschaften:

  • CreationTime

  • LastModificationTime

  • Status

Anforderungssyntax

{ "DatasetArn": "string" }

Anforderungsparameter

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

DatasetArn

Der Amazon-Ressourcenname (ARN) des Datensatzes.

Typ: Zeichenfolge

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

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

Erforderlich: Ja

Antwortsyntax

{ "CreationTime": number, "DataFrequency": "string", "DatasetArn": "string", "DatasetName": "string", "DatasetType": "string", "Domain": "string", "EncryptionConfig": { "KMSKeyArn": "string", "RoleArn": "string" }, "LastModificationTime": number, "Schema": { "Attributes": [ { "AttributeName": "string", "AttributeType": "string" } ] }, "Status": "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.

CreationTime

Wann der Datensatz erstellt wurde.

Typ: Zeitstempel

DataFrequency

Die Häufigkeit der Datenerhebung.

Gültige Intervalle sind Y (Jahr), M (Monat), W (Woche), D (Tag), H (Stunde), 30min (30 Minuten), 15min (15 Minuten), 10min (10 Minuten), 5min (5 Minuten) und 1min (1 Minute). Beispielsweise gibt „M“ jeden Monat und „30 min“ alle 30 Minuten an.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge von 5.

Pattern: ^Y|M|W|D|H|30min|15min|10min|5min|1min$

DatasetArn

Der Amazon-Ressourcenname (ARN) des Datensatzes.

Typ: Zeichenfolge

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

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

DatasetName

Der Name des Datensatzes.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 63 Zeichen.

Pattern: ^[a-zA-Z][a-zA-Z0-9_]*

DatasetType

Der Datensatztyp.

Typ: Zeichenfolge

Zulässige Werte: TARGET_TIME_SERIES | RELATED_TIME_SERIES | ITEM_METADATA

Domain

Die dem Datensatz zugeordnete Domain.

Typ: Zeichenfolge

Zulässige Werte: RETAIL | CUSTOM | INVENTORY_PLANNING | EC2_CAPACITY | WORK_FORCE | WEB_TRAFFIC | METRICS

EncryptionConfig

Der AWS Key Management Service (KMS)-Schlüssel und die AWS Identity and Access Management (IAM)-Rolle, die Amazon Forecast annehmen kann, um auf den Schlüssel zuzugreifen.

Typ: EncryptionConfig Objekt

LastModificationTime

Wenn Sie einen Datensatz erstellen, LastModificationTime ist mit identischCreationTime. Während Daten in den Datensatz importiert werden, LastModificationTime ist der aktuelle Zeitpunkt des DescribeDataset Aufrufs. Nachdem ein CreateDatasetImportJob Vorgang abgeschlossen ist, LastModificationTime ist der Zeitpunkt, an dem der Importauftrag abgeschlossen wurde oder fehlgeschlagen ist.

Typ: Zeitstempel

Schema

Ein Array von SchemaAttribute Objekten, die die Datensatzfelder angeben. Jeder SchemaAttribute gibt den Namen und den Datentyp eines Felds an.

Typ: Schema Objekt

Status

Der Status des Datensatzes. Zu den Staaten gehören:

  • ACTIVE

  • CREATE_PENDING, CREATE_IN_PROGRESS, CREATE_FAILED

  • DELETE_PENDING, DELETE_IN_PROGRESS, DELETE_FAILED

  • UPDATE_PENDING, UPDATE_IN_PROGRESS, UPDATE_FAILED

Die UPDATE Zustände gelten, während Daten aus einem Aufruf der -CreateDatasetImportJobOperation in den Datensatz importiert werden, und geben den Status des Datensatz-Importauftrags wieder. Wenn der Status des Importauftrags beispielsweise lautetCREATE_IN_PROGRESS, lautet der Status des Datensatzes UPDATE_IN_PROGRESS.

Anmerkung

Der Status des Datensatzes muss sein, ACTIVE bevor Sie Trainingsdaten importieren können.

Typ: Zeichenfolge

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

Fehler

InvalidInputException

Wir können die Anforderung nicht verarbeiten, da sie einen ungültigen Wert oder einen Wert enthält, der den gültigen Bereich überschreitet.

HTTP Status Code: 400

ResourceNotFoundException

Es ist nicht möglich, eine Ressource mit diesem Amazon-Ressourcennamen (ARN) zu finden. Überprüfen Sie den ARN und versuchen Sie es erneut.

HTTP Status Code: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter: