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 angegebenen Kriterien.
Das Kriterium besteht aus einem Schlüssel-Wert-Paar. Der Schlüssel stammt entwederitem_id (oder das entsprechende Feld ohne Zeitstempel, kein Zielfeld) aus demTARGET_TIME_SERIES Datensatz oder aus einer der Prognosedimensionen, die als Teil desFeaturizationConfig Objekts angegeben wurden.
QueryForecastGibt standardmäßig den vollständigen Datumsbereich für die gefilterte Prognose zurück. Sie können einen bestimmten Zeitraum anfordern.
Verwenden Sie die CreateForecastExportJobOperation, um die vollständige Prognose zu erhalten.
Anmerkung
Die von Amazon Forecast generierten Prognosen befinden sich in derselben Zeitzone wie der Datensatz, der zur Erstellung des Prädiktors verwendet wurde.
Anforderungssyntax
{
"EndDate": "string",
"Filters": {
"string" : "string"
},
"ForecastArn": "string",
"NextToken": "string",
"StartDate": "string"
}Anfrageparameter
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 (ISO 8601-Format). Zum Beispiel 2015-01-01T 20:00:00.
Typ: Zeichenfolge
Required: No
- Filters
-
Die beim Abrufen der Prognose anzuwendenden Filterkriterien. Um beispielsweise die Prognose für
client_21im Datensatz zum Stromverbrauch abzurufen, geben Sie Folgendes an:{"item_id" : "client_21"}Verwenden Sie die CreateForecastExportJobOperation, um die vollständige Prognose zu erhalten.
Typ: Abbildung einer Zeichenfolge auf eine Zeichenfolge
Zuweisungseinträge: Maximale Anzahl beträgt 50 Elemente.
Beschränkungen für die Schlüssellänge: Maximale Länge von 256.
Schlüssel-Muster:
^[a-zA-Z0-9\_\-]+$Längenbeschränkungen für Werte: Maximale Länge von 256.
Erforderlich: Ja
- ForecastArn
-
Der Amazon-Ressourcenname (ARN) der Prognose, die abgefragt werden soll.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge von 256.
Pattern:
arn:([a-z\d-]+):forecast:.*:.*:.+Erforderlich: Ja
- NextToken
-
Wenn das Ergebnis der vorherigen Anfrage gekürzt wurde, enthält die Antwort eine
NextToken. Verwenden Sie das Token in der nächsten Anforderung, um die nächsten Ergebnisse abzurufen. Tokens laufen nach 24 Stunden ab.Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 3 000 Zeichen.
Required: No
- StartDate
-
Das Startdatum für die Prognose. Geben Sie das Datum in diesem Format an: yyyy-mm-DD't'HH:mm:ss (ISO 8601-Format). Zum Beispiel 2015-01-01T 08: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 nicht gültig. Tokens laufen nach 24 Stunden ab.
HTTP Status Code: 400
- LimitExceededException
-
Das Limit für die Anzahl von 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 Informationen, die Sie angegeben haben, 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:
