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 die -CreateForecastOperation 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 SimpleDateFormat befindet (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 annehmen kann, um auf den Amazon S3-Bucket zuzugreifen. Weitere Informationen finden Sie unter Einrichten von Berechtigungen für Amazon Forecast.
Weitere Informationen finden Sie unter Prognosen generieren.
Verwenden Sie die -ListForecastExportJobsOperation, um eine Liste aller Ihrer Prognoseexportaufträge abzurufen.
Anmerkung
Der des Status
Prognoseexportauftrags muss sein, ACTIVE
bevor Sie auf die Prognose in Ihrem Amazon S3-Bucket zugreifen können. Um den Status abzurufen, verwenden Sie die -DescribeForecastExportJobOperation.
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 annehmen kann, um auf den Standort zuzugreifen. Die Prognose muss in einen Amazon S3-Bucket exportiert werden.
Wenn die Verschlüsselung verwendet wird,
Destination
muss einen AWS Key Management Service (KMS)-Schlüssel enthalten. Die IAM-Rolle muss Amazon Forecast die Berechtigung zum Zugriff auf den Schlüssel erteilen.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 Prognoseexportauftrag.
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 Prognoseexportauftrag anwenden, um die Kategorisierung und Organisation zu erleichtern. 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 Länge des Wertes – 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 nicht
aws:
, oder eine beliebige Kombination aus Groß- und Kleinbuchstaben als Präfix für SchlüsselAWS:
, da es für die AWS Verwendung reserviert ist. 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-Wertaws
als Präfix hat, der Schlüssel jedoch nicht, betrachtet Forecast ihn als Benutzer-Tag und wird auf das Limit von 50 Tags angerechnet. Tags mit nur dem Schlüsselpräfixaws
werden nicht auf Ihre Tags 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 Anforderung nicht verarbeiten, 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
-
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: