

 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.

# CreateWhatIfAnalysis
<a name="API_CreateWhatIfAnalysis"></a>

El análisis condicional es una técnica de modelado de escenarios en la que se realiza un cambio hipotético en una serie temporal y se comparan las previsiones generadas por estos cambios con la serie temporal de referencia, que no ha cambiado. Es importante recordar que el objetivo de un análisis condicional es comprender cómo puede cambiar una previsión en función de las diferentes modificaciones de la serie temporal de referencia.

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

Por ejemplo, imagine que es un minorista de ropa que está considerando hacer rebajas de fin de temporada para dejar espacio a nuevos estilos. Tras crear una previsión de referencia, puede utilizar un análisis condicional para investigar cómo las distintas tácticas de venta podrían afectar a sus objetivos.

Podría crear un escenario en el que todo reciba un descuento del 25 % y otro en el que todo reciba un descuento fijo en dólares. Podría crear un escenario en el que la oferta dure una semana y otro en el que dure un mes. Con un análisis condicional, puede comparar muchos escenarios diferentes entre sí.

Tenga en cuenta que un análisis condicional tiene por objeto mostrar lo que el modelo de previsión ha aprendido y cómo se comportará en los escenarios que está evaluando. No utilice a ciegas los resultados del análisis condicional para tomar decisiones empresariales. Por ejemplo, es posible que las previsiones no sean precisas en escenarios novedosos en los que no se disponga de una referencia para determinar si una previsión es buena.

El objeto [TimeSeriesSelector](API_TimeSeriesSelector.md) define los artículos que desea incluir en el análisis condicional.

**nota**  
Los datos deben tener un formato de valores separados por comas (CSV) para poder crear un análisis condicional.

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

```
{
   "ForecastArn": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TimeSeriesSelector": { 
      "TimeSeriesIdentifiers": { 
         "DataSource": { 
            "S3Config": { 
               "KMSKeyArn": "string",
               "Path": "string",
               "RoleArn": "string"
            }
         },
         "Format": "string",
         "Schema": { 
            "Attributes": [ 
               { 
                  "AttributeName": "string",
                  "AttributeType": "string"
               }
            ]
         }
      }
   },
   "WhatIfAnalysisName": "string"
}
```

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

La solicitud acepta los siguientes datos en formato JSON.

 ** [ForecastArn](#API_CreateWhatIfAnalysis_RequestSyntax) **   <a name="forecast-CreateWhatIfAnalysis-request-ForecastArn"></a>
El nombre de recurso de Amazon (ARN) de la previsión de referencia.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
Obligatorio: sí

 ** [Tags](#API_CreateWhatIfAnalysis_RequestSyntax) **   <a name="forecast-CreateWhatIfAnalysis-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

 ** [TimeSeriesSelector](#API_CreateWhatIfAnalysis_RequestSyntax) **   <a name="forecast-CreateWhatIfAnalysis-request-TimeSeriesSelector"></a>
Define el conjunto de series temporales que se utilizan en el análisis condicional con un objeto `TimeSeriesIdentifiers`. Los análisis condicionales se realizan solo para las series temporales de este objeto.  
El objeto `TimeSeriesIdentifiers` necesita la siguiente información:  
+  `DataSource` 
+  `Format` 
+  `Schema` 
Tipo: objeto [TimeSeriesSelector](API_TimeSeriesSelector.md)  
Obligatorio: no

 ** [WhatIfAnalysisName](#API_CreateWhatIfAnalysis_RequestSyntax) **   <a name="forecast-CreateWhatIfAnalysis-request-WhatIfAnalysisName"></a>
El nombre del análisis condicional. Cada nombre debe ser único.  
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_CreateWhatIfAnalysis_ResponseSyntax"></a>

```
{
   "WhatIfAnalysisArn": "string"
}
```

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

 ** [WhatIfAnalysisArn](#API_CreateWhatIfAnalysis_ResponseSyntax) **   <a name="forecast-CreateWhatIfAnalysis-response-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:.*:.*:.+` 

## Errores
<a name="API_CreateWhatIfAnalysis_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_CreateWhatIfAnalysis_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/CreateWhatIfAnalysis) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateWhatIfAnalysis) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateWhatIfAnalysis) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateWhatIfAnalysis) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateWhatIfAnalysis) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateWhatIfAnalysis) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateWhatIfAnalysis) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateWhatIfAnalysis) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateWhatIfAnalysis) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateWhatIfAnalysis) 