DescribeDatasetImportJob - Amazon Forecast
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.

DescribeDatasetImportJob

Beschreibt einen Datensatzimportauftrag, der mit der -CreateDatasetImportJobOperation erstellt wurde.

Diese Operation listet nicht nur die in der CreateDatasetImportJob Anforderung bereitgestellten Parameter auf, sondern enthält auch die folgenden Eigenschaften:

  • CreationTime

  • LastModificationTime

  • DataSize

  • FieldStatistics

  • Status

  • Message – Wenn ein Fehler aufgetreten ist, Informationen über den Fehler.

Anforderungssyntax

{
   "DatasetImportJobArn": "string"
}

Anforderungsparameter

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

DatasetImportJobArn

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

Typ: Zeichenfolge

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

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

Erforderlich: Ja

Antwortsyntax

{
   "CreationTime": number,
   "DatasetArn": "string",
   "DatasetImportJobArn": "string",
   "DatasetImportJobName": "string",
   "DataSize": number,
   "DataSource": { 
      "S3Config": { 
         "KMSKeyArn": "string",
         "Path": "string",
         "RoleArn": "string"
      }
   },
   "EstimatedTimeRemainingInMinutes": number,
   "FieldStatistics": { 
      "string" : { 
         "Avg": number,
         "Count": number,
         "CountDistinct": number,
         "CountDistinctLong": number,
         "CountLong": number,
         "CountNan": number,
         "CountNanLong": number,
         "CountNull": number,
         "CountNullLong": number,
         "Max": "string",
         "Min": "string",
         "Stddev": number
      }
   },
   "Format": "string",
   "GeolocationFormat": "string",
   "ImportMode": "string",
   "LastModificationTime": number,
   "Message": "string",
   "Status": "string",
   "TimestampFormat": "string",
   "TimeZone": "string",
   "UseGeolocationForTimeZone": boolean
}

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-Importauftrag erstellt wurde.

Typ: Zeitstempel

DatasetArn

Der Amazon-Ressourcenname (ARN) des Datensatzes, in den die Trainingsdaten importiert wurden.

Typ: Zeichenfolge

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

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

DatasetImportJobArn

Der ARN des Datensatz-Import-Auftrags.

Typ: Zeichenfolge

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

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

DatasetImportJobName

Der Name des Datensatz-Importauftrags.

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_]*

DataSize

Die Größe des Datensatzes in Gigabyte (GB), nachdem der Importauftrag abgeschlossen ist.

Type: Double

DataSource

Der Speicherort der zu importierenden Trainingsdaten und eine AWS Identity and Access Management (IAM)-Rolle, die Amazon Forecast für den Zugriff auf die Daten übernehmen kann.

Wenn Verschlüsselung verwendet wird, DataSource enthält einen AWS Key Management Service (KMS)-Schlüssel.

Typ: DataSource Objekt

EstimatedTimeRemainingInMinutes

Die geschätzte verbleibende Zeit in Minuten, bis der Datensatz-Importauftrag abgeschlossen ist.

Type: Long

FieldStatistics

Statistische Informationen über jedes Feld in den Eingabedaten.

Typ: Zeichenfolge-zu-StatisticsObjekt-Zuweisung

Einschränkungen der Schlüssellänge: Maximale Länge von 256.

Schlüssel-Muster: ^[a-zA-Z0-9\_]+$

Format

Das Format der importierten Daten, CSV oder PARQUET.

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge von 7.

Pattern: ^CSV|PARQUET$

GeolocationFormat

Das Format des Geolocation-Attributs. Gültige Werte: "LAT_LONG" und "CC_POSTALCODE".

Typ: Zeichenfolge

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

Pattern: ^[a-zA-Z0-9_]+$

ImportMode

Der Importmodus des Datensatz-Importauftrags, FULL oder INCREMENTAL.

Typ: Zeichenfolge

Zulässige Werte: FULL | INCREMENTAL

LastModificationTime

Das letzte Mal, dass die Ressource geändert wurde. Der Zeitstempel hängt vom Status des Auftrags ab:

  • CREATE_PENDING – Die CreationTime.

  • CREATE_IN_PROGRESS – Der aktuelle Zeitstempel.

  • CREATE_STOPPING – Der aktuelle Zeitstempel.

  • CREATE_STOPPED – Wann der Auftrag beendet wurde.

  • ACTIVE oder CREATE_FAILED – Wenn der Auftrag abgeschlossen wurde oder fehlgeschlagen ist.

Typ: Zeitstempel

Message

Wenn ein Fehler aufgetreten ist, wird eine Informationsmeldung über den Fehler angezeigt.

Typ: Zeichenfolge

Status

Der Status des Datensatz-Importauftrags. Zu den Staaten gehören:

  • ACTIVE

  • CREATE_PENDING, CREATE_IN_PROGRESS, CREATE_FAILED

  • DELETE_PENDING, DELETE_IN_PROGRESS, DELETE_FAILED

  • CREATE_STOPPING, CREATE_STOPPED

Typ: Zeichenfolge

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

TimestampFormat

Das Format der Zeitstempel im Datensatz. Das Format, das Sie angeben, hängt vom DataFrequency angegebenen ab, als der Datensatz erstellt wurde. Die folgenden Formate werden unterstützt

  • „jjjjjj-MM-TT“

    Für die folgenden Datenfrequenzen: Y, M, W und D

  • "jjjj-MM-tt HH:mm:ss"

    Für die folgenden Datenfrequenzen: H, 30 Min., 15 Min. und 1 Min. und optional für: Y, M, W und D

Typ: Zeichenfolge

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

Pattern: ^[a-zA-Z0-9\-\:\.\,\'\s]+$

TimeZone

Die einzelne Zeitzone, die auf jedes Element im Datensatz angewendet wird

Typ: Zeichenfolge

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

Pattern: ^[a-zA-Z0-9\/\+\-\_]+$

UseGeolocationForTimeZone

Ob automatisch vom Geolocation-Attribut abgeleitet TimeZone wird.

Typ: Boolesch

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: