

 O Amazon Forecast não está mais disponível para novos clientes. Os clientes existentes do Amazon Forecast podem continuar usando o serviço normalmente. [Saiba mais](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/)

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

A análise de hipóteses é uma técnica de modelagem de cenários em que você faz uma alteração hipotética em uma série temporal e compara as previsões geradas por essas alterações com a série temporal inalterada de linha de base. É importante lembrar que o objetivo de uma análise de hipóteses é entender como uma previsão pode mudar devido às diferentes modificações na série temporal de linha de base.

**Importante**  
O Amazon Forecast não está mais disponível para novos clientes. Os clientes existentes do Amazon Forecast podem continuar usando o serviço normalmente. [Saiba mais](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 

Por exemplo, imagine que você é um varejista de roupas que está considerando uma promoção de final de temporada para abrir espaço para novos estilos. Após criar uma previsão básica, você pode usar uma análise de hipóteses para investigar como diferentes táticas de vendas podem afetar suas metas.

Você pode criar um cenário em que tudo receba uma redução de 25% e outro em que tudo receba uma redução fixa em dólar. Você pode criar um cenário em que a venda dure uma semana e outro em que a venda dure um mês. Com uma análise de hipóteses, você pode comparar vários cenários diferentes entre si.

Observe que uma análise de hipóteses serve para mostrar o que o modelo de previsão aprendeu e como ele se comportará nos cenários que você está avaliando. Não use cegamente os resultados da análise de hipóteses para tomar decisões de negócios. Por exemplo, as previsões podem não ser precisas nos novos cenários em que não há referência disponível para determinar se uma previsão é boa.

O objeto [TimeSeriesSelector](API_TimeSeriesSelector.md) define os itens que você deseja na análise de hipóteses.

**nota**  
Para criar uma análise de hipóteses, seus dados devem estar no formato CSV (valores separados por vírgula).

## Sintaxe da solicitação
<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 da solicitação
<a name="API_CreateWhatIfAnalysis_RequestParameters"></a>

A solicitação aceita os dados a seguir no formato JSON.

 ** [ForecastArn](#API_CreateWhatIfAnalysis_RequestSyntax) **   <a name="forecast-CreateWhatIfAnalysis-request-ForecastArn"></a>
O nome do recurso da Amazon (ARN) da previsão de linha de base.  
Tipo: string  
Restrições de tamanho: o tamanho máximo é 256.  
Padrão: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
Obrigatório: Sim

 ** [Tags](#API_CreateWhatIfAnalysis_RequestSyntax) **   <a name="forecast-CreateWhatIfAnalysis-request-Tags"></a>
Uma lista de [tags](https://docs.aws.amazon.com/forecast/latest/dg/tagging-forecast-resources.html) a ser aplicada à previsão de hipóteses.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Membros da matriz: número mínimo de 0 itens. Número máximo de 200 itens.  
Obrigatório: não

 ** [TimeSeriesSelector](#API_CreateWhatIfAnalysis_RequestSyntax) **   <a name="forecast-CreateWhatIfAnalysis-request-TimeSeriesSelector"></a>
Define o conjunto de séries temporais usadas na análise de hipóteses com um objeto `TimeSeriesIdentifiers`. As análises de hipóteses são realizadas somente para as séries temporais desse objeto.  
O objeto `TimeSeriesIdentifiers` deve ter as seguintes informações:  
+  `DataSource` 
+  `Format` 
+  `Schema` 
Tipo: objeto [TimeSeriesSelector](API_TimeSeriesSelector.md)  
Obrigatório: não

 ** [WhatIfAnalysisName](#API_CreateWhatIfAnalysis_RequestSyntax) **   <a name="forecast-CreateWhatIfAnalysis-request-WhatIfAnalysisName"></a>
O nome da análise de hipóteses. Cada nome deve ser exclusivo.  
Tipo: string  
Restrições de tamanho: o tamanho mínimo é 1. O tamanho máximo é 63.  
Padrão: `^[a-zA-Z][a-zA-Z0-9_]*`   
Obrigatório: sim

## Sintaxe da resposta
<a name="API_CreateWhatIfAnalysis_ResponseSyntax"></a>

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

## Elementos de resposta
<a name="API_CreateWhatIfAnalysis_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [WhatIfAnalysisArn](#API_CreateWhatIfAnalysis_ResponseSyntax) **   <a name="forecast-CreateWhatIfAnalysis-response-WhatIfAnalysisArn"></a>
O nome do recurso da Amazon (ARN) da análise de hipóteses.  
Tipo: string  
Restrições de tamanho: o tamanho máximo é 256.  
Padrão: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

## Erros
<a name="API_CreateWhatIfAnalysis_Errors"></a>

 ** InvalidInputException **   
Não podemos processar a solicitação porque ela inclui um valor inválido ou um valor que excede o intervalo válido.  
Código de status HTTP: 400

 ** LimitExceededException **   
O limite do número de recursos por conta foi excedido.  
Código de status HTTP: 400

 ** ResourceAlreadyExistsException **   
Já existe um recurso com esse nome. Tente novamente com outro nome.  
Código de status HTTP: 400

 ** ResourceInUseException **   
O recurso especificado está em uso.  
Código de status HTTP: 400

 ** ResourceNotFoundException **   
Não conseguimos encontrar um recurso com esse nome do recurso da Amazon (ARN). Verifique o ARN e tente novamente.  
Código de Status HTTP: 400

## Consulte também
<a name="API_CreateWhatIfAnalysis_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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) 