View a markdown version of this page

DescribeDataset - Amazon Forecast
AnforderungssyntaxAnforderungsparameterAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

Amazon Forecast ist für Neukunden nicht mehr verfügbar. Bestehende Kunden von Amazon Forecast können den Service weiterhin wie gewohnt nutzen. Erfahren Sie mehr“

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 mithilfe der CreateDataset Operation erstellt wurde.

Wichtig

Amazon Forecast ist für Neukunden nicht mehr verfügbar. Bestehende Kunden von Amazon Forecast können den Service weiterhin wie gewohnt nutzen. Erfahren Sie mehr“

Dieser Vorgang listet nicht nur die in der CreateDataset Anforderung angegebenen Parameter auf, sondern umfasst 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 steht „M“ für jeden Monat und „30min“ für alle 30 Minuten.

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 für den Zugriff auf den Schlüssel übernehmen kann.

Typ: EncryptionConfig Objekt

LastModificationTime

Wenn Sie einen Datensatz erstellen, LastModificationTime ist das Gleiche wieCreationTime. Während Daten in den Datensatz importiert werden, LastModificationTime gilt die aktuelle Uhrzeit des DescribeDataset Aufrufs. Nach Abschluss eines CreateDatasetImportJob Vorgangs LastModificationTime ist das Datum, an dem der Importauftrag abgeschlossen wurde oder fehlgeschlagen ist.

Typ: Zeitstempel

Schema

Eine Reihe von SchemaAttribute Objekten, die die Datensatzfelder angeben. Jedes SchemaAttribute gibt den Namen und den Datentyp eines Feldes 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 Status gelten, solange Daten aus einem Aufruf des CreateDatasetImportJob Vorgangs 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 DatensatzesUPDATE_IN_PROGRESS.

Anmerkung

Der Status Wert des Datensatzes muss erfüllt 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 Anfrage nicht bearbeiten, da sie einen ungültigen Wert enthält oder einen Wert, der den gültigen Bereich überschreitet.

HTTP-Statuscode: 400

ResourceNotFoundException

Wir können keine Ressource mit diesem Amazon-Ressourcennamen (ARN) finden. Überprüfen Sie den ARN und versuchen Sie es erneut.

HTTP-Statuscode: 400

Weitere Informationen finden Sie unter:

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