Amazon Forecast n'est plus disponible pour les nouveaux clients. Les clients existants d'Amazon Forecast peuvent continuer à utiliser le service normalement. [En savoir plus »](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/)

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

Récupère une prévision hypothétique.

## Syntaxe de la requête
<a name="API_forecastquery_QueryWhatIfForecast_RequestSyntax"></a>

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

## Paramètres de demande
<a name="API_forecastquery_QueryWhatIfForecast_RequestParameters"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [EndDate](#API_forecastquery_QueryWhatIfForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryWhatIfForecast-request-EndDate"></a>
Date de fin des prévisions hypothétiques. Spécifiez la date au format suivant : yyyy-MM-dd 'T'HH:MM:SS (format ISO 8601). Par exemple, 2015-01-01T 20:00:00.   
Type : chaîne  
Obligatoire : non

 ** [Filters](#API_forecastquery_QueryWhatIfForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryWhatIfForecast-request-Filters"></a>
Les critères de filtrage à appliquer lors de la récupération des prévisions. Par exemple, pour obtenir les prévisions pour `client_21` le jeu de données sur la consommation d'électricité, spécifiez ce qui suit :  
 `{"item_id" : "client_21"}`   
Pour obtenir les prévisions hypothétiques complètes, utilisez l'[CreateForecastExportJob](https://docs.aws.amazon.com/en_us/forecast/latest/dg/API_CreateWhatIfForecastExport.html)opération.  
Type : mappage chaîne/chaîne  
Entrées cartographiques : nombre maximum de 50 éléments.  
Contraintes relatives à la longueur des clés : longueur maximale de 256.  
Modèle de clé :`^[a-zA-Z0-9\_\-]+$`   
Contraintes de longueur de valeur : longueur maximale de 256.  
Obligatoire : oui

 ** [NextToken](#API_forecastquery_QueryWhatIfForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryWhatIfForecast-request-NextToken"></a>
Si le résultat de la demande précédente a été tronqué, la réponse inclut un`NextToken`. Pour récupérer le prochain ensemble de résultats, utilisez le jeton dans la demande suivante. Les jetons expirent au bout de 24 heures.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 3 000.  
Obligatoire : non

 ** [StartDate](#API_forecastquery_QueryWhatIfForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryWhatIfForecast-request-StartDate"></a>
Date de début des prévisions hypothétiques. Spécifiez la date au format suivant : yyyy-MM-dd 'T'HH:MM:SS (format ISO 8601). Par exemple, 2015-01-01T 08:00:00.  
Type : chaîne  
Obligatoire : non

 ** [WhatIfForecastArn](#API_forecastquery_QueryWhatIfForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryWhatIfForecast-request-WhatIfForecastArn"></a>
Le nom de ressource Amazon (ARN) de la prévision hypothétique à interroger.  
Type : Chaîne  
Contraintes de longueur : longueur maximale de 300.  
Modèle : `arn:([a-z\d-]+):forecast:.*:.*:.+`   
Obligatoire : oui

## Syntaxe de la réponse
<a name="API_forecastquery_QueryWhatIfForecast_ResponseSyntax"></a>

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

## Eléments de réponse
<a name="API_forecastquery_QueryWhatIfForecast_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [Forecast](#API_forecastquery_QueryWhatIfForecast_ResponseSyntax) **   <a name="forecast-forecastquery_QueryWhatIfForecast-response-Forecast"></a>
Fournit des informations sur une prévision. Renvoyé dans le cadre de la [QueryForecast](API_forecastquery_QueryForecast.md) réponse.  
Type : objet [Forecast](API_forecastquery_Forecast.md)

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

 ** InvalidInputException **   
La valeur n'est pas valide ou est trop longue.  
Code d’état HTTP : 400

 ** InvalidNextTokenException **   
Le jeton n'est pas valide. Les jetons expirent au bout de 24 heures.  
Code d’état HTTP : 400

 ** LimitExceededException **   
La limite du nombre de demandes par seconde a été dépassée.  
Code d’état HTTP : 400

 ** ResourceInUseException **   
La ressource spécifiée est en cours d'utilisation.  
Code d’état HTTP : 400

 ** ResourceNotFoundException **   
Nous ne trouvons pas cette ressource. Vérifiez les informations que vous avez fournies et réessayez.  
Code d’état HTTP : 400

## Voir aussi
<a name="API_forecastquery_QueryWhatIfForecast_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecastquery-2018-06-26/QueryWhatIfForecast)