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.
QueryForecast
Ruft eine Prognose für ein einzelnes Element ab, gefiltert nach den bereitgestellten Kriterien.
Die Kriterien sind ein Schlüssel-Wert-Paar. Der Schlüssel ist entweder item_id
(oder das entsprechende Nicht-Zeitstempel-, Nicht-Zielfeld) aus dem TARGET_TIME_SERIES
Datensatz oder eine der Prognosedimensionen, die als Teil des FeaturizationConfig
Objekts angegeben wurden.
Standardmäßig QueryForecast
gibt den gesamten Datumsbereich für die gefilterte Prognose zurück. Sie können einen bestimmten Datumsbereich anfordern.
Um die vollständige Prognose zu erhalten, verwenden Sie die -CreateForecastExportJobOperation.
Anmerkung
Die von Amazon Forecast generierten Prognosen befinden sich in derselben Zeitzone wie der Datensatz, der zum Erstellen des Prädiktors verwendet wurde.
Anforderungssyntax
{
"EndDate": "string
",
"Filters": {
"string
" : "string
"
},
"ForecastArn": "string
",
"NextToken": "string
",
"StartDate": "string
"
}
Anforderungsparameter
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
- EndDate
-
Das Enddatum für die Prognose. Geben Sie das Datum in diesem Format an: yyyy-MM-dd'T'HH:mm:ss (Format ISO 8601). Zum Beispiel 2015-01-01T20:00:00.
Typ: Zeichenfolge
Erforderlich: Nein
- Filters
-
Die Filterkriterien, die beim Abrufen der Prognose angewendet werden sollen. Um beispielsweise die Prognose für
client_21
im Datensatz zur Stromnutzung abzurufen, geben Sie Folgendes an:{"item_id" : "client_21"}
Um die vollständige Prognose zu erhalten, verwenden Sie die -CreateForecastExportJobOperation.
Typ: Abbildung einer Zeichenfolge auf eine Zeichenfolge
Karteneinträge: Maximale Anzahl von 50 Elementen.
Einschränkungen der Schlüssellänge: Maximale Länge von 256.
Schlüssel-Muster:
^[a-zA-Z0-9\_\-]+$
Einschränkungen der Wertlänge: Maximale Länge von 256.
Erforderlich: Ja
- ForecastArn
-
Der Amazon-Ressourcenname (ARN) der abzufragenden Prognose.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.
Pattern:
arn:([a-z\d-]+):forecast:.*:.*:.+
Erforderlich: Ja
- NextToken
-
Wenn das Ergebnis der vorherigen Anforderung gekürzt wurde, enthält die Antwort eine
NextToken
. Um den nächsten Ergebnissatz abzurufen, verwenden Sie das Token in der nächsten Anfrage. Token laufen nach 24 Stunden ab.Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge von 3000.
Erforderlich: Nein
- StartDate
-
Das Startdatum für die Prognose. Geben Sie das Datum in diesem Format an: yyyy-MM-dd'T'HH:mm:ss (Format ISO 8601). Zum Beispiel 2015-01-01T08:00:00.
Typ: Zeichenfolge
Erforderlich: Nein
Antwortsyntax
{
"Forecast": {
"Predictions": {
"string" : [
{
"Timestamp": "string",
"Value": number
}
]
}
}
}
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.
Fehler
- InvalidInputException
-
Der Wert ist ungültig oder zu lang.
HTTP Status Code: 400
- InvalidNextTokenException
-
Das Token ist ungültig. Token laufen nach 24 Stunden ab.
HTTP Status Code: 400
- LimitExceededException
-
Das Limit für die Anzahl der Anforderungen pro Sekunde wurde überschritten.
HTTP Status Code: 400
- ResourceInUseException
-
Die angegebene Ressource wird verwendet.
HTTP Status Code: 400
- ResourceNotFoundException
-
Wir können diese Ressource nicht finden. Überprüfen Sie die von Ihnen angegebenen Informationen 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: