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à.

# QueryForecast
<a name="API_forecastquery_QueryForecast"></a>

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 diverso da timestamp e non target) dal `TARGET_TIME_SERIES` set di dati o da 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'[CreateForecastExportJob](https://docs.aws.amazon.com/en_us/forecast/latest/dg/API_CreateForecastExportJob.html)operazione.

**Nota**  
Le previsioni generate da Amazon Forecast si trovano nello stesso fuso orario del set di dati utilizzato per creare il predittore.

## Sintassi della richiesta
<a name="API_forecastquery_QueryForecast_RequestSyntax"></a>

```
{
   "EndDate": "string",
   "Filters": { 
      "string" : "string" 
   },
   "ForecastArn": "string",
   "NextToken": "string",
   "StartDate": "string"
}
```

## Parametri della richiesta
<a name="API_forecastquery_QueryForecast_RequestParameters"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [EndDate](#API_forecastquery_QueryForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryForecast-request-EndDate"></a>
La data di fine della previsione. Specificare la data utilizzando questo formato: yyyy-MM-dd 't'HH:mm:ss (formato ISO 8601). Ad esempio, 2015-01-01T 20:00:00.   
▬Tipo: stringa  
Obbligatorio: no

 ** [Filters](#API_forecastquery_QueryForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryForecast-request-Filters"></a>
I criteri di filtro da applicare per il recupero della previsione. Ad esempio, per ottenere la previsione `client_21` nel set di dati sull'utilizzo dell'elettricità, specificare quanto segue:  
 `{"item_id" : "client_21"}`   
Per ottenere la previsione completa, utilizzare l'[CreateForecastExportJob](https://docs.aws.amazon.com/en_us/forecast/latest/dg/API_CreateForecastExportJob.html)operazione.  
Tipo: mappatura stringa a stringa  
Voci sulla mappa: numero massimo di 50 elementi.  
Limiti di lunghezza della chiave: lunghezza massima di 256.  
Modello di chiave:`^[a-zA-Z0-9\_\-]+$`   
Limiti di lunghezza del valore: lunghezza massima di 256.  
Obbligatorio: sì

 ** [ForecastArn](#API_forecastquery_QueryForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryForecast-request-ForecastArn"></a>
L'Amazon Resource Name (ARN) della previsione da interrogare.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
Obbligatorio: sì

 ** [NextToken](#API_forecastquery_QueryForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryForecast-request-NextToken"></a>
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.  
Obbligatorio: no

 ** [StartDate](#API_forecastquery_QueryForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryForecast-request-StartDate"></a>
La data di inizio della previsione. Specificare la data utilizzando questo formato: yyyy-MM-dd 't'HH:mm:ss (formato ISO 8601). Ad esempio, 2015-01-01T 08:00:00.  
▬Tipo: stringa  
Obbligatorio: no

## Sintassi della risposta
<a name="API_forecastquery_QueryForecast_ResponseSyntax"></a>

```
{
   "Forecast": { 
      "Predictions": { 
         "string" : [ 
            { 
               "Timestamp": "string",
               "Value": number
            }
         ]
      }
   }
}
```

## Elementi di risposta
<a name="API_forecastquery_QueryForecast_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [Forecast](#API_forecastquery_QueryForecast_ResponseSyntax) **   <a name="forecast-forecastquery_QueryForecast-response-Forecast"></a>
La previsione.  
Tipo: oggetto [Forecast](API_forecastquery_Forecast.md)

## Errori
<a name="API_forecastquery_QueryForecast_Errors"></a>

 ** 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
<a name="API_forecastquery_QueryForecast_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/forecastquery-2018-06-26/QueryForecast) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecastquery-2018-06-26/QueryForecast) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecastquery-2018-06-26/QueryForecast) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecastquery-2018-06-26/QueryForecast) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecastquery-2018-06-26/QueryForecast) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecastquery-2018-06-26/QueryForecast) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecastquery-2018-06-26/QueryForecast) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecastquery-2018-06-26/QueryForecast) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/forecastquery-2018-06-26/QueryForecast) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecastquery-2018-06-26/QueryForecast)