

 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.

# ListForecasts
<a name="API_ListForecasts"></a>

Renvoie la liste des prévisions créées à l'aide de l'[CreateForecast](API_CreateForecast.md)opération. Pour chaque prévision, cette opération renvoie un résumé de ses propriétés, y compris son Amazon Resource Name (ARN). Pour récupérer l'ensemble complet des propriétés, spécifiez l'ARN avec l'[DescribeForecast](API_DescribeForecast.md)opération. Vous pouvez filtrer la liste à l'aide d'un tableau d'[Filter](API_Filter.md)objets.

**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_ListForecasts_RequestSyntax"></a>

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

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

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

 ** [Filters](#API_ListForecasts_RequestSyntax) **   <a name="forecast-ListForecasts-request-Filters"></a>
Un ensemble de filtres. Pour chaque filtre, vous devez fournir une condition et un énoncé de correspondance. La condition est soit`IS_NOT`, `IS` soit, qui indique s'il faut inclure ou exclure de la liste les prévisions correspondant à l'énoncé, 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 prévisions qui correspondent à l'énoncé, spécifiez`IS`. Pour exclure les prévisions correspondantes, spécifiez`IS_NOT`.
+  `Key`- Le nom du paramètre à filtrer. Les valeurs valides sont `DatasetGroupArn`, `PredictorArn` et `Status`.
+  `Value`- La valeur à égaler.
Par exemple, pour répertorier toutes les prévisions dont le statut n'est pas ACTIF, vous devez spécifier :  
 `"Filters": [ { "Condition": "IS_NOT", "Key": "Status", "Value": "ACTIVE" } ]`   
Type : tableau d’objets [Filter](API_Filter.md)  
Obligatoire : non

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

 ** [NextToken](#API_ListForecasts_RequestSyntax) **   <a name="forecast-ListForecasts-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.  
Modèle : `.+`   
Obligatoire : non

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

```
{
   "Forecasts": [ 
      { 
         "CreatedUsingAutoPredictor": boolean,
         "CreationTime": number,
         "DatasetGroupArn": "string",
         "ForecastArn": "string",
         "ForecastName": "string",
         "LastModificationTime": number,
         "Message": "string",
         "PredictorArn": "string",
         "Status": "string"
      }
   ],
   "NextToken": "string"
}
```

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

 ** [Forecasts](#API_ListForecasts_ResponseSyntax) **   <a name="forecast-ListForecasts-response-Forecasts"></a>
Tableau d'objets qui récapitule les propriétés de chaque prévision.  
Type : tableau d’objets [ForecastSummary](API_ForecastSummary.md)

 ** [NextToken](#API_ListForecasts_ResponseSyntax) **   <a name="forecast-ListForecasts-response-NextToken"></a>
Si la réponse est tronquée, Amazon Forecast renvoie ce jeton. Pour récupérer le prochain ensemble de résultats, utilisez le jeton dans la demande suivante.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 3 000.  
Modèle : `.+` 

## Erreurs
<a name="API_ListForecasts_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_ListForecasts_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/forecast-2018-06-26/ListForecasts) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/ListForecasts) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ListForecasts) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/ListForecasts) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/ListForecasts) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListForecasts) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/ListForecasts) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/ListForecasts) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/ListForecasts) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListForecasts) 