Amazon Forecast ya no está disponible para nuevos clientes. Los clientes actuales de Amazon Forecast pueden seguir utilizando el servicio con normalidad. [Más información](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/)

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# QueryWhatIfForecast
<a name="API_forecastquery_QueryWhatIfForecast"></a>

Recupera una previsión condicional

## Sintaxis de la solicitud
<a name="API_forecastquery_QueryWhatIfForecast_RequestSyntax"></a>

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

## Parámetros de la solicitud
<a name="API_forecastquery_QueryWhatIfForecast_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [EndDate](#API_forecastquery_QueryWhatIfForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryWhatIfForecast-request-EndDate"></a>
La fecha de finalización de la previsión condicional. Especifique la fecha con este formato: yyyy-MM-dd 't'HH:MM:SS (formato ISO 8601). Por ejemplo, 2015-01-01T20:00:00.   
Tipo: cadena  
Requerido: no

 ** [Filters](#API_forecastquery_QueryWhatIfForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryWhatIfForecast-request-Filters"></a>
Los criterios de filtrado que se aplicarán al recuperar la previsión. Por ejemplo, para obtener la previsión de `client_21` en el conjunto de datos de consumo de electricidad, especifique lo siguiente:  
 `{"item_id" : "client_21"}`   
Para obtener el pronóstico hipotético completo, utilice la operación. [CreateForecastExportJob](https://docs.aws.amazon.com/en_us/forecast/latest/dg/API_CreateWhatIfForecastExport.html)  
Tipo: mapa de cadena a cadena  
Entradas de mapa: número máximo de 50 artículos.  
Limitaciones de longitud de clave: longitud máxima de 256.  
Patrón de clave: `^[a-zA-Z0-9\_\-]+$`   
Limitaciones de longitud de valor: longitud máxima de 256.  
Obligatorio: sí

 ** [NextToken](#API_forecastquery_QueryWhatIfForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryWhatIfForecast-request-NextToken"></a>
Si el resultado de la solicitud anterior se truncó, la respuesta incluye un `NextToken`. Para recuperar el siguiente conjunto de resultados, utilice el token en la siguiente solicitud. Los tokens caducan tras 24 horas.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 3000.  
Obligatorio: no

 ** [StartDate](#API_forecastquery_QueryWhatIfForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryWhatIfForecast-request-StartDate"></a>
La fecha de inicio de la previsión condicional. Especifique la fecha con este formato: yyyy-MM-dd 't'HH:mm:ss (formato ISO 8601). Por ejemplo, 2015-01-01T08:00:00.  
Tipo: cadena  
Requerido: no

 ** [WhatIfForecastArn](#API_forecastquery_QueryWhatIfForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryWhatIfForecast-request-WhatIfForecastArn"></a>
El nombre de recurso de Amazon (ARN) de la previsión condicional que consultar.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 300.  
Patrón: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_forecastquery_QueryWhatIfForecast_ResponseSyntax"></a>

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

## Elementos de respuesta
<a name="API_forecastquery_QueryWhatIfForecast_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [Forecast](#API_forecastquery_QueryWhatIfForecast_ResponseSyntax) **   <a name="forecast-forecastquery_QueryWhatIfForecast-response-Forecast"></a>
Proporciona información sobre una previsión. Se devuelven como parte de la respuesta de [QueryForecast](API_forecastquery_QueryForecast.md).  
Tipo: objeto [Forecast](API_forecastquery_Forecast.md)

## Errores
<a name="API_forecastquery_QueryWhatIfForecast_Errors"></a>

 ** InvalidInputException **   
El valor no es válido o es demasiado largo.  
Código de estado HTTP: 400

 ** InvalidNextTokenException **   
El token no es válido. Los tokens caducan tras 24 horas.  
Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha excedido el límite en el número de solicitudes por segundo.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No podemos encontrar ese recurso. Compruebe la información que ha proporcionado e inténtelo de nuevo.  
Código de estado HTTP: 400

## Véase también
<a name="API_forecastquery_QueryWhatIfForecast_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos, consulta lo siguiente: AWS SDKs
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/forecastquery-2018-06-26/QueryWhatIfForecast) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecastquery-2018-06-26/QueryWhatIfForecast)