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

CreateForecastExportJob

Exportiert eine durch den CreateForecast Vorgang erstellte Prognose in Ihren Amazon Simple Storage Service (Amazon S3) -Bucket. Der Name der Prognosedatei entspricht den folgenden Konventionen:

<ForecastExportJobName>_<ExportTimestamp>_<PartNumber>

wobei sich die Komponente < ExportTimestamp > in Java befindet SimpleDateFormat (yyyy-MM-DDTHH-mm-ssz).

Sie müssen ein DataDestination Objekt angeben, das eine AWS Identity and Access Management (IAM-) Rolle enthält, die Amazon Forecast für den Zugriff auf den Amazon S3 S3-Bucket übernehmen kann. Weitere Informationen finden Sie unter Einrichten von Berechtigungen für Amazon Forecast.

Weitere Informationen finden Sie unter Prognosen generieren.

Verwenden Sie den ListForecastExportJobs Vorgang, um eine Liste all Ihrer Forecast-Exportaufträge zu erhalten.

Anmerkung

Der Status Forecast-Exportjob muss abgeschlossen sein, ACTIVE bevor Sie auf die Prognose in Ihrem Amazon S3 S3-Bucket zugreifen können. Verwenden Sie den DescribeForecastExportJob Vorgang, um den Status abzurufen.

Anforderungssyntax

{
   "Destination": { 
      "S3Config": { 
         "KMSKeyArn": "string",
         "Path": "string",
         "RoleArn": "string"
      }
   },
   "ForecastArn": "string",
   "ForecastExportJobName": "string",
   "Format": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}

Anforderungsparameter

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

Destination

Der Ort, an dem Sie die Prognose speichern möchten, und eine AWS Identity and Access Management (IAM) -Rolle, die Amazon Forecast für den Zugriff auf den Standort übernehmen kann. Die Prognose muss in einen Amazon S3 S3-Bucket exportiert werden.

Wenn Verschlüsselung verwendet wird, Destination muss ein AWS Key Management Service (KMS-) Schlüssel enthalten sein. Die IAM-Rolle muss Amazon Forecast Zugriff auf den Schlüssel gewähren.

Typ: DataDestination Objekt

Erforderlich: Ja

ForecastArn

Der Amazon-Ressourcenname (ARN) der Prognose, die Sie exportieren möchten.

Typ: Zeichenfolge

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

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

Erforderlich: Ja

ForecastExportJobName

Der Name für den Forecast-Exportjob.

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

Erforderlich: Ja

Format

Das Format der exportierten Daten, CSV oder PARQUET. Der Standardwert lautet CSV.

Typ: Zeichenfolge

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

Pattern: ^CSV|PARQUET$

Erforderlich: Nein

Tags

Die optionalen Metadaten, die Sie auf den Forecast-Exportauftrag anwenden, um sie zu kategorisieren und zu organisieren. Jeder Tag (Markierung) besteht aus einem Schlüssel und einem optionalen Wert, beides können Sie bestimmen.

Die folgenden grundlegenden Einschränkungen gelten für Tags (Markierungen):

  • Maximale Anzahl von Tags pro Ressource: 50.

  • Jeder Tag (Markierung) muss für jede Ressource eindeutig sein. Jeder Tag (Markierung) kann nur einen Wert haben.

  • Maximale Schlüssellänge: 128 Unicode-Zeichen in UTF-8.

  • Maximale Wertlänge — 256 Unicode-Zeichen in UTF-8.

  • Wenn Ihr Markierungsschema für mehrere -Services und -Ressourcen verwendet wird, denken Sie daran, dass andere Services möglicherweise Einschränkungen für zulässige Zeichen haben. Allgemein erlaubte Zeichen sind: Buchstaben, Zahlen und Leerzeichen, die in UTF-8 darstellbar sind, und die folgenden Sonderzeichen: + - = . _ : / @.

  • Bei Tag-Schlüsseln und -Werten muss die Groß- und Kleinschreibung beachtet werden.

  • Verwenden Sie nichtaws:,AWS:, oder eine Kombination von Groß- oder Kleinbuchstaben, wie z. B. ein Präfix, für Schlüssel, da es für die Verwendung reserviert ist. AWS Sie können Tag-Schlüssel mit diesem Präfix nicht bearbeiten oder löschen. Werte können dieses Präfix haben. Wenn ein Tag-Wert ein Präfix hataws, der Schlüssel jedoch nicht, betrachtet Forecast ihn als Benutzertag und wird auf das Limit von 50 Tags angerechnet. Tags, die nur das key prefix von enthalten, werden aws nicht auf Ihre Stichwörter pro Ressourcenlimit angerechnet.

Typ: Array von Tag-Objekten

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

Erforderlich: Nein

Antwortsyntax

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

ForecastExportJobArn

Der Amazon-Ressourcenname (ARN) des Exportauftrags.

Typ: Zeichenfolge

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

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

Fehler

InvalidInputException

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

HTTP Status Code: 400

LimitExceededException

Das Limit für die Anzahl der Ressourcen pro Konto wurde überschritten.

HTTP Status Code: 400

ResourceAlreadyExistsException

Es gibt bereits eine Ressource mit diesem Namen. Versuchen Sie es erneut mit einem anderen Namen.

HTTP Status Code: 400

ResourceInUseException

Die angegebene Ressource wird verwendet.

HTTP Status Code: 400

ResourceNotFoundException

Wir können keine Ressource mit diesem Amazon-Ressourcennamen (ARN) 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 im Folgenden: