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“](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/)

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.

# QueryWhatIfForecast
<a name="API_forecastquery_QueryWhatIfForecast"></a>

Ruft eine Was-wäre-wenn-Prognose ab.

## Anforderungssyntax
<a name="API_forecastquery_QueryWhatIfForecast_RequestSyntax"></a>

```
{
   "EndDate": "string",
   "Filters": { 
      "string" : "string" 
   },
   "NextToken": "string",
   "StartDate": "string",
   "WhatIfForecastArn": "string"
}
```

## Anforderungsparameter
<a name="API_forecastquery_QueryWhatIfForecast_RequestParameters"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [EndDate](#API_forecastquery_QueryWhatIfForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryWhatIfForecast-request-EndDate"></a>
Das Enddatum der Was-wäre-wenn-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  
Erforderlich: Nein

 ** [Filters](#API_forecastquery_QueryWhatIfForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryWhatIfForecast-request-Filters"></a>
Die Filterkriterien, die beim Abrufen der Prognose angewendet werden sollen. Um beispielsweise die Prognose für den Datensatz zum `client_21` Stromverbrauch abzurufen, geben Sie Folgendes an:  
 `{"item_id" : "client_21"}`   
Verwenden Sie die Operation, um die vollständige Was-wäre-wenn-Prognose zu erhalten. [CreateForecastExportJob](https://docs.aws.amazon.com/en_us/forecast/latest/dg/API_CreateWhatIfForecastExport.html)  
Typ: Abbildung einer Zeichenfolge auf eine Zeichenfolge  
Karteneinträge: Maximale Anzahl von 50 Elementen.  
Einschränkungen der Schlüssellänge: Die maximale Länge beträgt 256.  
Schlüssel-Muster: `^[a-zA-Z0-9\_\-]+$`   
Längenbeschränkungen für Werte: Maximale Länge von 256.  
Erforderlich: Ja

 ** [NextToken](#API_forecastquery_QueryWhatIfForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryWhatIfForecast-request-NextToken"></a>
Wenn das Ergebnis der vorherigen Anfrage gekürzt wurde, enthält die Antwort ein`NextToken`. Um die nächsten Ergebnisse abzurufen, verwenden Sie das Token in der nächsten Anfrage. Tokens 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](#API_forecastquery_QueryWhatIfForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryWhatIfForecast-request-StartDate"></a>
Das Startdatum für die Was-wäre-wenn-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

 ** [WhatIfForecastArn](#API_forecastquery_QueryWhatIfForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryWhatIfForecast-request-WhatIfForecastArn"></a>
Der Amazon-Ressourcenname (ARN) der Was-wäre-wenn-Prognose, die abgefragt werden soll.  
Typ: Zeichenfolge  
Längenbeschränkungen: Maximale Länge von 300.  
Pattern: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
Erforderlich: Ja

## Antwortsyntax
<a name="API_forecastquery_QueryWhatIfForecast_ResponseSyntax"></a>

```
{
   "Forecast": { 
      "Predictions": { 
         "string" : [ 
            { 
               "Timestamp": "string",
               "Value": number
            }
         ]
      }
   }
}
```

## Antwortelemente
<a name="API_forecastquery_QueryWhatIfForecast_ResponseElements"></a>

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](#API_forecastquery_QueryWhatIfForecast_ResponseSyntax) **   <a name="forecast-forecastquery_QueryWhatIfForecast-response-Forecast"></a>
Stellt Informationen zu einer Prognose bereit. Wurde als Teil der [QueryForecast](API_forecastquery_QueryForecast.md) Antwort zurückgegeben.  
Typ: [Forecast](API_forecastquery_Forecast.md) Objekt

## Fehler
<a name="API_forecastquery_QueryWhatIfForecast_Errors"></a>

 ** InvalidInputException **   
Der Wert ist ungültig oder zu lang.  
HTTP-Statuscode: 400

 ** InvalidNextTokenException **   
Das Token ist nicht gültig. Tokens laufen nach 24 Stunden ab.  
HTTP-Statuscode: 400

 ** LimitExceededException **   
Das Limit für die Anzahl der Anfragen 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 angegebenen Informationen und versuchen Sie es erneut.  
HTTP-Statuscode: 400

## Weitere Informationen finden Sie unter:
<a name="API_forecastquery_QueryWhatIfForecast_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+  [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecastquery-2018-06-26/QueryWhatIfForecast)