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

CreateForecast

Cria uma previsão para cada item no conjunto de dados TARGET_TIME_SERIES usado para treinar o preditor. Isso é conhecido como inferência. Para recuperar a previsão de um único item com baixa latência, use a operação QueryForecast. Para exportar a previsão completa para o bucket do Amazon Simple Storage Service (Amazon S3), use a operação CreateForecastExportJob.

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

O intervalo da previsão é determinado pelo valor ForecastHorizon, que você especifica na solicitação CreatePredictor. Ao consultar uma previsão, você pode solicitar um intervalo de datas específico na previsão.

Para obter uma lista de todas as suas previsões, use a operação ListForecasts.

nota

As previsões geradas pelo Amazon Forecast estão no mesmo fuso horário do conjunto de dados usado para criar o preditor.

Para obter mais informações, consulte Geração de previsões.

nota

O Status da previsão deve ser ACTIVE para que você possa consultar ou exportar a previsão. Use a operação DescribeForecast para obter o status.

Por padrão, uma previsão inclui previsões para cada item (item_id) no grupo de conjuntos de dados usado para treinar o preditor. No entanto, você pode usar o objeto TimeSeriesSelector para gerar uma previsão em um subconjunto de séries temporais. A criação de previsões é ignorada em qualquer série temporal especificada que não esteja no conjunto de dados de entrada. O arquivo de exportação de previsão não conterá essas séries temporais ou seus valores previstos.

Sintaxe da Solicitação

{
   "ForecastName": "string",
   "ForecastTypes": [ "string" ],
   "PredictorArn": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TimeSeriesSelector": { 
      "TimeSeriesIdentifiers": { 
         "DataSource": { 
            "S3Config": { 
               "KMSKeyArn": "string",
               "Path": "string",
               "RoleArn": "string"
            }
         },
         "Format": "string",
         "Schema": { 
            "Attributes": [ 
               { 
                  "AttributeName": "string",
                  "AttributeType": "string"
               }
            ]
         }
      }
   }
}

Parâmetros da solicitação

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

ForecastName

Um nome para a previsão.

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

ForecastTypes

Os quantis nos quais as previsões probabilísticas são geradas. Atualmente, você pode especificar até cinco quantis por previsão. Os valores aceitos incluem 0.01 to 0.99 (somente incrementos de 0,01) e mean. A previsão média é diferente da mediana (0,50) quando a distribuição não é simétrica (por exemplo, beta e binominal negativa).

Os quantis padrão são aqueles que você especificou durante a criação do preditor. Se você não especificou quantis, os valores padrão serão ["0.1", "0.5", "0.9"].

Tipo: matriz de strings

Membros da matriz: número mínimo de 1 item. Número máximo de 20 itens.

Restrições de tamanho: o tamanho mínimo é 2. O tamanho máximo é 4.

Padrão: (^0?\.\d\d?$|^mean$)

Obrigatório: Não

PredictorArn

O Amazon Resource Name (ARN) do preditor a ser usado para gerar a previsão.

Tipo: string

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

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

Exigido: Sim

Tags

Os metadados opcionais que você aplica à previsão para categorizá-los e organizá-los. Cada tag consiste em uma chave e um valor opcional, ambos definidos por você.

As restrições básicas a seguir se aplicam a tags:

  • Número máximo de tags por recurso: 50.

  • Em todos os recursos, cada chave de tag deve ser exclusiva e possuir apenas um valor.

  • Tamanho máximo da chave - 128 caracteres Unicode em UTF -8.

  • Tamanho máximo do valor - 256 caracteres Unicode em UTF -8.

  • Caso seu esquema de marcação seja usado em vários serviços e recursos , lembre-se de que outros serviços podem possuir restrições em caracteres permitidos. Os caracteres geralmente permitidos são: letras, números e espaços representáveis em UTF -8 e os seguintes caracteres: + - =. _:/@.

  • As chaves e valores das tags diferenciam maiúsculas de minúsculas.

  • Não use aws:AWS:, ou qualquer combinação de maiúsculas ou minúsculas, como um prefixo para teclas, pois está reservado para uso. AWS Você não pode editar nem excluir chaves de tag com esse prefixo. Os valores podem ter esse prefixo. Se um valor de tag tiver aws como prefixo, mas a chave não, o Forecast o considerará uma tag de usuário e o contabilizará no limite de 50 tags. As tags que têm apenas o prefixo de chave aws não são contabilizadas entre suas tags por limite de recurso.

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 para criar as previsões em um objeto TimeSeriesIdentifiers.

O objeto TimeSeriesIdentifiers deve ter as seguintes informações:

  • DataSource

  • Format

  • Schema

Tipo: objeto TimeSeriesSelector

Obrigatório: Não

Sintaxe da Resposta

{
   "ForecastArn": "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.

ForecastArn

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

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: