ListForecasts - Amazon Forecast

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'CreateForecastoperazione. 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 l'operazione. È possibile filtrare l'elenco utilizzando una matrice di Filter oggetti.

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

Una serie di filtri. Per ogni filtro, fornisci una condizione e un'istruzione di corrispondenza. La condizione è IS oIS_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, specificareIS. Per escludere le 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

Campo obbligatorio: no

MaxResults

Il numero di elementi da restituire nella risposta.

Tipo: integer

Intervallo valido: valore minimo di 1. valore massimo pari a 100.

Campo obbligatorio: no

NextToken

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: stringa

Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 3000.

Modello: .+

Campo 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

Una serie di oggetti che riepilogano le proprietà di ogni previsione.

Tipo: matrice di oggetti ForecastSummary

NextToken

Se la risposta viene troncata, Amazon Forecast restituisce questo token. Per recuperare il prossimo set di risultati, usa il token nella richiesta successiva.

▬Tipo: stringa

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 uno degli AWS SDK specifici della lingua, consulta quanto segue: