

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

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

Uma previsão de hipóteses é uma previsão criada a partir de uma versão modificada da previsão de linha de base. Cada previsão de hipóteses incorpora um conjunto de dados substituto ou um conjunto de transformações no conjunto de dados original. 

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

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

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

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

 ** [TimeSeriesReplacementsDataSource](#API_CreateWhatIfForecast_RequestSyntax) **   <a name="forecast-CreateWhatIfForecast-request-TimeSeriesReplacementsDataSource"></a>
O conjunto de dados de séries temporais de substituição, que contém as linhas que você deseja alterar no conjunto de dados de séries temporais relacionadas. Uma série temporal de substituição não precisa conter todas as linhas que estão na série temporal relacionada de linha de base. Inclua somente as linhas (combinações de medidas e dimensões) que você deseja incluir na previsão de hipóteses.  
Este conjunto de dados é mesclado com a série temporal original para criar um conjunto de dados transformado usado na análise de hipóteses.  
Este conjunto de dados deve conter os itens a serem modificados (como item\$1id ou workforce\$1type), todas as dimensões relevantes, a coluna de carimbo de data e hora e pelo menos uma das colunas de série temporal relacionada. Este arquivo não deve conter carimbos de data/hora duplicados para a mesma série temporal. Este arquivo deve estar no formato CSV.  
Os carimbos de data/hora e item\$1ids não incluídos nesse conjunto de dados não estão incluídos na análise de hipóteses.   
Tipo: objeto [TimeSeriesReplacementsDataSource](API_TimeSeriesReplacementsDataSource.md)  
Obrigatório: não

 ** [TimeSeriesTransformations](#API_CreateWhatIfForecast_RequestSyntax) **   <a name="forecast-CreateWhatIfForecast-request-TimeSeriesTransformations"></a>
As transformações aplicadas à série temporal de linha de base. Cada transformação contém uma ação e um conjunto de condições. Uma ação é aplicada somente quando todas as condições são atendidas. Se nenhuma condição for fornecida, a ação será aplicada a todos os itens.  
Tipo: matriz de objetos [TimeSeriesTransformation](API_TimeSeriesTransformation.md)  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 30 itens.  
Obrigatório: não

 ** [WhatIfAnalysisArn](#API_CreateWhatIfForecast_RequestSyntax) **   <a name="forecast-CreateWhatIfForecast-request-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:.*:.*:.+`   
Obrigatório: Sim

 ** [WhatIfForecastName](#API_CreateWhatIfForecast_RequestSyntax) **   <a name="forecast-CreateWhatIfForecast-request-WhatIfForecastName"></a>
O nome da previsão de hipóteses. Os nomes devem ser exclusivos em cada análise de hipóteses.  
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_CreateWhatIfForecast_ResponseSyntax"></a>

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

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

 ** [WhatIfForecastArn](#API_CreateWhatIfForecast_ResponseSyntax) **   <a name="forecast-CreateWhatIfForecast-response-WhatIfForecastArn"></a>
O nome do recurso da Amazon (ARN) da previsão de hipóteses.  
Tipo: string  
Comprimentos de tamanho: comprimento máximo de 300.  
Padrão: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

## Erros
<a name="API_CreateWhatIfForecast_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_CreateWhatIfForecast_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/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) 