

 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.

# CreateWhatIfForecast
<a name="API_CreateWhatIfForecast"></a>

Una previsión condicional es una previsión que se crea a partir de una versión modificada de la previsión de referencia. Cada previsión condicional incorpora un conjunto de datos de reemplazo o un conjunto de transformaciones en el conjunto de datos original. 

**importante**  
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/) 

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

```
{
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TimeSeriesReplacementsDataSource": { 
      "Format": "string",
      "S3Config": { 
         "KMSKeyArn": "string",
         "Path": "string",
         "RoleArn": "string"
      },
      "Schema": { 
         "Attributes": [ 
            { 
               "AttributeName": "string",
               "AttributeType": "string"
            }
         ]
      },
      "TimestampFormat": "string"
   },
   "TimeSeriesTransformations": [ 
      { 
         "Action": { 
            "AttributeName": "string",
            "Operation": "string",
            "Value": number
         },
         "TimeSeriesConditions": [ 
            { 
               "AttributeName": "string",
               "AttributeValue": "string",
               "Condition": "string"
            }
         ]
      }
   ],
   "WhatIfAnalysisArn": "string",
   "WhatIfForecastName": "string"
}
```

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

La solicitud acepta los siguientes datos en formato JSON.

 ** [Tags](#API_CreateWhatIfForecast_RequestSyntax) **   <a name="forecast-CreateWhatIfForecast-request-Tags"></a>
Lista de [etiquetas](https://docs.aws.amazon.com/forecast/latest/dg/tagging-forecast-resources.html) que se aplican a la previsión condicional.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.  
Obligatorio: no

 ** [TimeSeriesReplacementsDataSource](#API_CreateWhatIfForecast_RequestSyntax) **   <a name="forecast-CreateWhatIfForecast-request-TimeSeriesReplacementsDataSource"></a>
El conjunto de datos de series temporales de reemplazo, que contiene las filas que desea cambiar en el conjunto de datos de series temporales relacionadas. No es necesario que una serie temporal de reemplazo contenga todas las filas que se encuentran en la serie temporal relacionada con la referencia. Incluya solo las filas (combinaciones de medidas y dimensiones) que desee incluir en la previsión condicional.  
Este conjunto de datos se fusiona con la serie temporal original para crear un conjunto de datos transformado que se utiliza para el análisis condicional.  
Este conjunto de datos debe contener los artículos que se van a modificar (como id\$1artículo o tipo\$1personal), cualquier dimensión relevante, la columna de fecha y hora y al menos una de las columnas de series temporales relacionadas. Este archivo no debe contener marcas temporales duplicadas para la misma serie temporal. Este archivo debe estar en formato CSV.  
Las marcas temporales y los id\$1artículo no incluidos en este conjunto de datos no se incluyen en el análisis condicional.   
Tipo: objeto [TimeSeriesReplacementsDataSource](API_TimeSeriesReplacementsDataSource.md)  
Obligatorio: no

 ** [TimeSeriesTransformations](#API_CreateWhatIfForecast_RequestSyntax) **   <a name="forecast-CreateWhatIfForecast-request-TimeSeriesTransformations"></a>
Las transformaciones que se aplican a la serie temporal de referencia. Cada transformación contiene una acción y un conjunto de condiciones. Una acción se aplica solo cuando se cumplen todas las condiciones. Si no se proporciona ninguna condición, la acción se aplica a todos los artículos.  
Tipo: matriz de objetos [TimeSeriesTransformation](API_TimeSeriesTransformation.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 30 artículos.  
Obligatorio: no

 ** [WhatIfAnalysisArn](#API_CreateWhatIfForecast_RequestSyntax) **   <a name="forecast-CreateWhatIfForecast-request-WhatIfAnalysisArn"></a>
El nombre de recurso de Amazon (ARN) del análisis condicional.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
Obligatorio: sí

 ** [WhatIfForecastName](#API_CreateWhatIfForecast_RequestSyntax) **   <a name="forecast-CreateWhatIfForecast-request-WhatIfForecastName"></a>
El nombre de la previsión condicional. Los nombres deben ser únicos dentro de cada análisis condicional.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z][a-zA-Z0-9_]*`   
Obligatorio: sí

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

```
{
   "WhatIfForecastArn": "string"
}
```

## Elementos de respuesta
<a name="API_CreateWhatIfForecast_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.

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

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

 ** InvalidInputException **   
No podemos procesar la solicitud porque incluye un valor no válido o un valor que supera el rango válido.  
Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha superado el límite en el número de recursos por cuenta.  
Código de estado HTTP: 400

 ** ResourceAlreadyExistsException **   
Ya existe un recurso con este nombre. Inténtelo de nuevo con un nombre diferente.  
Código de estado HTTP: 400

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

 ** ResourceNotFoundException **   
No podemos encontrar un recurso con ese nombre de recurso de Amazon (ARN). Compruebe el ARN e inténtelo de nuevo.  
Código de estado HTTP: 400

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

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