View a markdown version of this page

ListForecasts - Amazon Forecast
AnforderungssyntaxAnforderungsparameterAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

Amazon Forecast ist für Neukunden nicht mehr verfügbar. Bestehende Kunden von Amazon Forecast können den Service weiterhin wie gewohnt nutzen. Erfahren Sie mehr“

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.

ListForecasts

Gibt eine Liste von Prognosen zurück, die mit der CreateForecast Operation erstellt wurden. Für jede Prognose gibt diese Operation eine Zusammenfassung ihrer Eigenschaften zurück, einschließlich des Amazon-Ressourcennamens (ARN). Um den vollständigen Satz von Eigenschaften abzurufen, geben Sie den ARN bei der DescribeForecast Operation an. Sie können die Liste mithilfe einer Reihe von Filter Objekten filtern.

Wichtig

Amazon Forecast ist für Neukunden nicht mehr verfügbar. Bestehende Kunden von Amazon Forecast können den Service weiterhin wie gewohnt nutzen. Erfahren Sie mehr“

Anforderungssyntax

{
   "Filters": [ 
      { 
         "Condition": "string",
         "Key": "string",
         "Value": "string"
      }
   ],
   "MaxResults": number,
   "NextToken": "string"
}

Anforderungsparameter

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

Filters

Eine Reihe von Filtern. Für jeden Filter geben Sie eine Bedingung und eine Match-Anweisung an. Die Bedingung lautet entweder IS oder. Sie gibt anIS_NOT, ob die Prognosen, die der Aussage entsprechen, in die Liste aufgenommen bzw. aus der Liste ausgeschlossen werden sollen. Die Match-Anweisung besteht aus einem Schlüssel und einem Wert.

Eigenschaften filtern

  • Condition- Die anzuwendende Bedingung. Gültige Werte sind IS und IS_NOT. Um die Prognosen einzubeziehen, die der Aussage entsprechen, geben Sie Folgendes anIS. Um übereinstimmende Prognosen auszuschließen, geben Sie Folgendes anIS_NOT.

  • Key— Der Name des Parameters, nach dem gefiltert werden soll. Gültige Werte sind DatasetGroupArn, PredictorArn und Status.

  • Value- Der Wert, der übereinstimmen soll.

Um beispielsweise alle Prognosen aufzulisten, deren Status NICHT AKTIV ist, würden Sie Folgendes angeben:

"Filters": [ { "Condition": "IS_NOT", "Key": "Status", "Value": "ACTIVE" } ]

Typ: Array von Filter-Objekten

Erforderlich: Nein

MaxResults

Die Anzahl der Elemente, die in der Antwort zurückgegeben werden sollen.

Typ: Ganzzahl

Gültiger Bereich: Mindestwert 1. Maximalwert 100.

Erforderlich: Nein

NextToken

Wenn das Ergebnis der vorherigen Anfrage gekürzt wurde, enthält die Antwort eineNextToken. Verwenden Sie das Token in der nächsten Anfrage, um die nächsten Ergebnisse abzurufen. Die Token laufen nach 24 Stunden ab.

Typ: Zeichenfolge

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

Pattern: .+

Erforderlich: Nein

Antwortsyntax

{
   "Forecasts": [ 
      { 
         "CreatedUsingAutoPredictor": boolean,
         "CreationTime": number,
         "DatasetGroupArn": "string",
         "ForecastArn": "string",
         "ForecastName": "string",
         "LastModificationTime": number,
         "Message": "string",
         "PredictorArn": "string",
         "Status": "string"
      }
   ],
   "NextToken": "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.

Forecasts

Eine Reihe von Objekten, die die Eigenschaften der einzelnen Prognosen zusammenfassen.

Typ: Array von ForecastSummary-Objekten

NextToken

Wenn die Antwort gekürzt wird, gibt Amazon Forecast dieses Token zurück. Verwenden Sie das Token in der nächsten Anfrage, um die nächsten Ergebnisse abzurufen.

Typ: Zeichenfolge

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

Pattern: .+

Fehler

InvalidInputException

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

HTTP-Statuscode: 400

InvalidNextTokenException

Das Token ist nicht gültig. Die Token laufen nach 24 Stunden ab.

HTTP-Statuscode: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS SDKs finden Sie im Folgenden: