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ù»
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à.
QueryForecast
Recupera una previsione per un singolo articolo, filtrata in base ai criteri forniti.
Il criterio è una coppia chiave-valore. La chiave è item_id (o l'equivalente campo non timestamp, non target) del TARGET_TIME_SERIES set di dati o una delle dimensioni di previsione specificate come parte dell'oggetto. FeaturizationConfig
Per impostazione predefinita, QueryForecast restituisce l'intervallo di date completo per la previsione filtrata. Puoi richiedere un intervallo di date specifico.
Per ottenere la previsione completa, usa l'CreateForecastExportJoboperazione.
Nota
Le previsioni generate da Amazon Forecast sono nello stesso fuso orario del set di dati utilizzato per creare il predittore.
Sintassi della richiesta
{
"EndDate": "string",
"Filters": {
"string" : "string"
},
"ForecastArn": "string",
"NextToken": "string",
"StartDate": "string"
}Parametri della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- EndDate
-
La data di fine della previsione. Specifica la data utilizzando questo formato: yyyy- MM-dd 'T' HH:mm:ss (formato ISO 8601). Ad esempio, 2015-01-01. T20:00:00
▬Tipo: stringa
Obbligatorio: no
- Filters
-
I criteri di filtro da applicare quando si recupera la previsione. Ad esempio, per ottenere la previsione
client_21nel set di dati sull'utilizzo dell'elettricità, specifica quanto segue:{"item_id" : "client_21"}Per ottenere la previsione completa, usa l'CreateForecastExportJoboperazione.
Tipo: mappatura stringa a stringa
Voci della mappa: numero massimo di 50 elementi.
Vincoli di lunghezza chiave: lunghezza massima di 256.
Modello di chiave:
^[a-zA-Z0-9\_\-]+$Vincoli di lunghezza del valore: lunghezza massima di 256.
Obbligatorio: sì
- ForecastArn
-
L'Amazon Resource Name (ARN) della previsione da interrogare.
Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):forecast:.*:.*:.+Obbligatorio: sì
- NextToken
-
Se il risultato della richiesta precedente è stato troncato, la risposta include un.
NextTokenPer recuperare la serie successiva 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.
Obbligatorio: no
- StartDate
-
La data di inizio della previsione. Specifica la data utilizzando questo formato: yyyy- MM-dd 'T' HH:mm:ss (formato ISO 8601). Ad esempio, 2015-01-01. T08:00:00
▬Tipo: stringa
Obbligatorio: no
Sintassi della risposta
{
"Forecast": {
"Predictions": {
"string" : [
{
"Timestamp": "string",
"Value": number
}
]
}
}
}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.
Errori
- InvalidInputException
-
Il valore non è valido o è troppo lungo.
Codice di stato HTTP: 400
- InvalidNextTokenException
-
Il token non è valido. I token scadono dopo 24 ore.
Codice di stato HTTP: 400
- LimitExceededException
-
Il limite del numero di richieste al secondo è stato superato.
Codice di stato HTTP: 400
- ResourceInUseException
-
La risorsa specificata è in uso.
Codice di stato HTTP: 400
- ResourceNotFoundException
-
Non riusciamo a trovare quella risorsa. Controlla le informazioni che hai fornito e riprova.
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:
