

 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.

# ListWhatIfForecasts
<a name="API_ListWhatIfForecasts"></a>

Renvoie une liste de prévisions hypothétiques créées à l'aide de l'[CreateWhatIfForecast](API_CreateWhatIfForecast.md)opération. Pour chaque prévision hypothétique, cette opération renvoie un résumé de ses propriétés, y compris son Amazon Resource Name (ARN). Vous pouvez récupérer l'ensemble complet des propriétés en utilisant l'ARN de prévision hypothétique associé à l'[DescribeWhatIfForecast](API_DescribeWhatIfForecast.md)opération.

**Important**  
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/) 

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

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

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

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

 ** [Filters](#API_ListWhatIfForecasts_RequestSyntax) **   <a name="forecast-ListWhatIfForecasts-request-Filters"></a>
Une gamme de filtres. Pour chaque filtre, vous indiquez une condition et un énoncé de correspondance. La condition est soit `IS` ou`IS_NOT`, qui spécifie s'il faut inclure ou exclure les tâches d'exportation prévues hypothétiques qui correspondent à l'instruction de la liste, respectivement. L'instruction match se compose d'une clé et d'une valeur.  
 **Propriétés du filtre **   
+  `Condition`- La condition à appliquer. Les valeurs valides sont `IS` et `IS_NOT`. Pour inclure les tâches d'exportation prévues qui correspondent à l'instruction, spécifiez`IS`. Pour exclure les tâches d'exportation de prévisions correspondantes, spécifiez`IS_NOT`.
+  `Key`- Le nom du paramètre sur lequel filtrer. Les valeurs valides sont `WhatIfForecastArn` et `Status`.
+  `Value`- La valeur à égaler.
Par exemple, pour répertorier toutes les tâches qui exportent une prévision nommée * électricité WhatIfForecast*, spécifiez le filtre suivant :  
 `"Filters": [ { "Condition": "IS", "Key": "WhatIfForecastArn", "Value": "arn:aws:forecast:us-west-2:<acct-id>:forecast/electricityWhatIfForecast" } ]`   
Type : tableau d’objets [Filter](API_Filter.md)  
Obligatoire : non

 ** [MaxResults](#API_ListWhatIfForecasts_RequestSyntax) **   <a name="forecast-ListWhatIfForecasts-request-MaxResults"></a>
Le nombre d'éléments à renvoyer dans la réponse.  
Type : entier  
Plage valide : valeur minimum de 1. Valeur maximale fixée à 100.  
Obligatoire : non

 ** [NextToken](#API_ListWhatIfForecasts_RequestSyntax) **   <a name="forecast-ListWhatIfForecasts-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 la prochaine série de résultats, utilisez le jeton dans la prochaine  demande. Les jetons expirent au bout de 24 heures.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 3 000.  
Modèle : `.+`   
Obligatoire : non

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

```
{
   "NextToken": "string",
   "WhatIfForecasts": [ 
      { 
         "CreationTime": number,
         "LastModificationTime": number,
         "Message": "string",
         "Status": "string",
         "WhatIfAnalysisArn": "string",
         "WhatIfForecastArn": "string",
         "WhatIfForecastName": "string"
      }
   ]
}
```

## Eléments de réponse
<a name="API_ListWhatIfForecasts_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.

 ** [NextToken](#API_ListWhatIfForecasts_ResponseSyntax) **   <a name="forecast-ListWhatIfForecasts-response-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 la prochaine série de résultats, utilisez le jeton dans la prochaine  demande. Les jetons expirent au bout de 24 heures.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 3 000.  
Modèle : `.+` 

 ** [WhatIfForecasts](#API_ListWhatIfForecasts_ResponseSyntax) **   <a name="forecast-ListWhatIfForecasts-response-WhatIfForecasts"></a>
Tableau d'`WhatIfForecasts`objets qui décrivent les prévisions correspondantes.  
Type : tableau d’objets [WhatIfForecastSummary](API_WhatIfForecastSummary.md)

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

 ** InvalidInputException **   
Nous ne pouvons pas traiter la demande car elle contient une valeur non valide ou une valeur qui dépasse la plage valide.  
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

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

Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS kits SDK spécifiques à une langue, consultez les rubriques suivantes :
+  [AWS Interface de ligne de commande V2 ](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/ListWhatIfForecasts) 
+  [AWS SDK pour .NET V4 ](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/ListWhatIfForecasts) 
+  [AWS SDK pour C\+\+ ](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ListWhatIfForecasts) 
+  [AWS SDK pour Go v2 ](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/ListWhatIfForecasts) 
+  [AWS SDK pour Java V2 ](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/ListWhatIfForecasts) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListWhatIfForecasts) 
+  [AWS SDK pour Kotlin ](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/ListWhatIfForecasts) 
+  [AWS SDK pour PHP V3 ](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/ListWhatIfForecasts) 
+  [AWS SDK pour Python (Boto3) ](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/ListWhatIfForecasts) 
+  [AWS SDK pour Ruby V3 ](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListWhatIfForecasts) 