QueryForecast - Amazon Forecast

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 ist ein Schlüssel-Wert-Paar. Der Schlüssel ist entwederitem_id(oder das äquivalente Nicht-Zeitstempel, Nicht-Zielfeld) aus demTARGET_TIME_SERIESDatensatz oder eine der prognostizierten Dimensionen, die als Teil desFeaturizationConfig-Objekt.

Der Standardwert für istQueryForecastgibt den vollständigen Datumsbereich für die gefilterte Prognose zurück. Sie können einen bestimmten Datumsbereich anfordern.

Um die vollständige Prognose zu erhalten, verwenden Sie dieCreateForecastExportJobverwenden.

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" }

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.

Type: String (Zeichenfolge)

: Erforderlich Nein

Filters

Die Filterkriterien, die beim Abrufen der Prognose angewendet werden sollen. Zum Beispiel, um die Prognose fürclient_21Geben Sie im Datensatz zum Stromverbrauch Folgendes an:

{"item_id" : "client_21"}

Um die vollständige Prognose zu erhalten, verwenden Sie dieCreateForecastExportJobverwenden.

Type: Zeichenfolge-zu-Zeichenfolge-Zuweisung

Map-Einträge: Die maximale Anzahl beträgt 50 Elemente.

Einschränkungen für die Schlüssellänge: Maximale Länge beträgt 256 Zeichen.

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

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

: Erforderlich Ja

ForecastArn

Der Amazon-Ressourcenname (ARN) der abzufragenden Prognose.

Type: String (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 Anfrage abgeschnitten wurde, enthält die Antwort eineNextTokenaus. Um den nächsten Ergebnissatz abzurufen, verwenden Sie das Token in der nächsten Anforderung. Token laufen nach 24 Stunden ab.

Type: String (Zeichenfolge)

Längenbeschränkungen: Mindestlänge 1. Maximale Länge beträgt 3000 Zeichen.

: Erforderlich Nein

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.

Type: String (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.

Forecast

Die Prognose.

Typ: Forecast Objekt

Fehler

InvalidInputException

Der Wert ist ungültig oder zu lang.

HTTP-Statuscode: 400

InvalidNextTokenException

Das Token ist ungültig. Token laufen nach 24 Stunden ab.

HTTP-Statuscode: 400

LimitExceededException

Der Grenzwert für die Anzahl der Anforderungen pro Sekunde wurde überschritten.

HTTP-Statuscode: 400

ResourceInUseException

Die angegebene Ressource wird verwendet.

HTTP-Statuscode: 400

ResourceNotFoundException

Wir können diese Ressource nicht finden. Überprüfen Sie die von Ihnen bereitgestellten Informationen und versuchen Sie es erneut.

HTTP-Statuscode: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter: