Amazon Forecast non è più disponibile per i nuovi clienti. I clienti esistenti di Amazon Forecast possono continuare a utilizzare il servizio normalmente. [Scopri di più»](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/)
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# ListForecasts
Restituisce un elenco di previsioni create utilizzando l'[CreateForecast](API_CreateForecast.md)operazione. Per ogni previsione, questa operazione restituisce un riepilogo delle sue proprietà, incluso il relativo Amazon Resource Name (ARN). Per recuperare il set completo di proprietà, specificare l'ARN con [DescribeForecast](API_DescribeForecast.md) l'operazione. È possibile filtrare l'elenco utilizzando una matrice di [Filter](API_Filter.md) oggetti.
**Importante**
Amazon Forecast non è più disponibile per i nuovi clienti. I clienti esistenti di Amazon Forecast possono continuare a utilizzare il servizio normalmente. [Scopri di più»](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/)
## Sintassi della richiesta
```
{
"Filters": [
{
"Condition": "string",
"Key": "string",
"Value": "string"
}
],
"MaxResults": number,
"NextToken": "string"
}
```
## Parametri della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [Filters](#API_ListForecasts_RequestSyntax) **
Una serie di filtri. Per ogni filtro, fornisci una condizione e un'istruzione di corrispondenza. La condizione è `IS` o`IS_NOT`, che specifica se includere o escludere dall'elenco le previsioni che corrispondono al rendiconto, rispettivamente. L'istruzione match è composta da una chiave e da un valore.
**Proprietà del filtro**
+ `Condition`- La condizione da applicare. I valori validi sono `IS` e `IS_NOT`. Per includere le previsioni che corrispondono al rendiconto, specificare`IS`. Per escludere previsioni corrispondenti, specificare. `IS_NOT`
+ `Key`- Il nome del parametro in base al quale filtrare. I valori validi sono `DatasetGroupArn`, `PredictorArn` e `Status`.
+ `Value`- Il valore da abbinare.
Ad esempio, per elencare tutte le previsioni il cui stato non è ATTIVO, è necessario specificare:
`"Filters": [ { "Condition": "IS_NOT", "Key": "Status", "Value": "ACTIVE" } ]`
Tipo: matrice di oggetti [Filter](API_Filter.md)
Obbligatorio: no
** [MaxResults](#API_ListForecasts_RequestSyntax) **
Il numero di elementi da restituire nella risposta.
Tipo: numero intero
Intervallo valido: valore minimo di 1. valore massimo pari a 100.
Obbligatorio: no
** [NextToken](#API_ListForecasts_RequestSyntax) **
Se il risultato della richiesta precedente è stato troncato, la risposta include un. `NextToken` Per recuperare il prossimo set di risultati, usa il token nella richiesta successiva. I token scadono dopo 24 ore.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 3000.
Modello: `.+`
Obbligatorio: no
## Sintassi della risposta
```
{
"Forecasts": [
{
"CreatedUsingAutoPredictor": boolean,
"CreationTime": number,
"DatasetGroupArn": "string",
"ForecastArn": "string",
"ForecastName": "string",
"LastModificationTime": number,
"Message": "string",
"PredictorArn": "string",
"Status": "string"
}
],
"NextToken": "string"
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [Forecasts](#API_ListForecasts_ResponseSyntax) **
Una serie di oggetti che riepilogano le proprietà di ogni previsione.
Tipo: matrice di oggetti [ForecastSummary](API_ForecastSummary.md)
** [NextToken](#API_ListForecasts_ResponseSyntax) **
Se la risposta viene troncata, Amazon Forecast restituisce questo token. Per recuperare il prossimo set di risultati, usa il token nella richiesta successiva.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 3000.
Modello: `.+`
## Errori
** InvalidInputException **
Non possiamo elaborare la richiesta perché include un valore non valido o un valore che supera l'intervallo valido.
Codice di stato HTTP: 400
** InvalidNextTokenException **
Il token non è valido. I token scadono dopo 24 ore.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/ListForecasts)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/ListForecasts)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ListForecasts)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/ListForecasts)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/ListForecasts)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListForecasts)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/ListForecasts)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/ListForecasts)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/ListForecasts)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListForecasts)