CreateWhatIfAnalysis - Amazon Forecast
Sintaxe da SolicitaçãoParâmetros da solicitaçãoSintaxe da RespostaElementos de RespostaErrosConsulte também

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

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

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 define os itens que você deseja na análise de hipóteses.

nota

Seus dados devem estar no formato de valores separados por vírgula (CSV) para criar uma análise hipotética.

Sintaxe da Solicitação

{
   "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 solicitação aceita os seguintes dados no JSON formato.

ForecastArn

O nome do recurso da Amazon (ARN) da previsão básica.

Tipo: string

Restrições de tamanho: o tamanho máximo é 256.

Padrão: arn:([a-z\d-]+):forecast:.*:.*:.+

Exigido: Sim

Tags

Uma lista de tags a ser aplicada à previsão de hipóteses.

Tipo: matriz de objetos Tag

Membros da Matriz: número mínimo de 0 itens. Número máximo de 200 itens.

Obrigatório: Não

TimeSeriesSelector

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

Obrigatório: Não

WhatIfAnalysisName

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_]*

Exigido: Sim

Sintaxe da Resposta

{
   "WhatIfAnalysisArn": "string"
}

Elementos de Resposta

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

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

WhatIfAnalysisArn

O nome do recurso Amazon (ARN) da análise hipotética.

Tipo: string

Restrições de tamanho: o tamanho máximo é 256.

Padrão: arn:([a-z\d-]+):forecast:.*:.*:.+

Erros

InvalidInputException

Não podemos processar a solicitação porque ela inclui um valor inválido ou um valor que excede o intervalo válido.

HTTPCódigo de status: 400

LimitExceededException

O limite do número de recursos por conta foi excedido.

HTTPCódigo de status: 400

ResourceAlreadyExistsException

Já existe um recurso com esse nome. Tente novamente com outro nome.

HTTPCódigo de status: 400

ResourceInUseException

O recurso especificado está em uso.

HTTPCódigo de status: 400

ResourceNotFoundException

Não conseguimos encontrar um recurso com esse nome de recurso da Amazon (ARN). Verifique ARN e tente novamente.

HTTPCódigo de status: 400

Consulte também

Para obter mais informações sobre como usar isso API em um idioma específico AWS SDKs, consulte o seguinte: