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

CreateDataset

Cria um conjunto de dados do Amazon Forecast.

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

As informações fornecidas sobre o conjunto de dados ajudam o Forecast a entender como consumir os dados para treinamento de modelos. Essa transmissão inclui o seguinte:

  • DataFrequency : a frequência com a qual seus dados de séries temporais históricos são coletados.

  • Domain e DatasetType : cada conjunto de dados tem um domínio de conjunto de dados associado e um tipo dentro do domínio. O Amazon Forecast fornece uma lista de domínios e tipos predefinidos dentro de cada domínio. Para cada domínio e tipo de conjunto de dados exclusivos, o Amazon Forecast exige que os dados de entrada incluam um conjunto mínimo de campos predefinidos.

  • Schema : um esquema especifica os campos do conjunto de dados, incluindo o nome do campo e o tipo de dados.

Depois de criar um conjunto de dados, você importa os dados de treinamento nele e o adiciona a um grupo de conjuntos de dados. Você utiliza esse grupo de conjuntos de dados para criar um agente de previsão. Para obter mais informações, consulte Importar conjuntos de dados.

Para obter uma lista de todos os seus conjuntos de dados, use a ListDatasetsoperação.

Por exemplo, conjuntos de dados do Forecast, consulte o GitHubrepositório Amazon Forecast Sample.

nota

O Status de um conjunto de dados deve ser ACTIVE antes que você possa importar dados de treinamento. Use a DescribeDatasetoperação para obter o status.

Sintaxe da Solicitação

{
   "DataFrequency": "string",
   "DatasetName": "string",
   "DatasetType": "string",
   "Domain": "string",
   "EncryptionConfig": { 
      "KMSKeyArn": "string",
      "RoleArn": "string"
   },
   "Schema": { 
      "Attributes": [ 
         { 
            "AttributeName": "string",
            "AttributeType": "string"
         }
      ]
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}

Parâmetros da solicitação

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

DataFrequency

A frequência da coleta de dados. Esse parâmetro é necessário para SERIES conjuntos de dados RELATED TIME _ _.

Os intervalos válidos são um número inteiro seguido de Y (ano), M (mês), W (semana), D (dia), H (hora) e min (minuto). Por exemplo, "1D" indica todos os dias e "15min" indica a cada 15 minutos. Você não pode especificar um valor que se sobreporia à próxima frequência maior. Isso significa, por exemplo, que você não pode especificar uma frequência de 60 minutos, porque isso equivale a 1 hora. Os valores válidos para cada frequência são os seguintes:

  • Minute (Minuto): 1 a 59

  • Hour (Hora): 1 a 23

  • Day (Dia): 1 a 6

  • Week (Semana): 1 a 4

  • Month (Mês): 1 a 11

  • Year (Ano): 1

Assim, se você quiser previsões a cada duas semanas, especifique "2W". Ou, se quiser previsões trimestrais, especifique "3M".

Tipo: string

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

Padrão: ^Y|M|W|D|H|30min|15min|10min|5min|1min$

Obrigatório: Não

DatasetName

Um nome para o conjunto de dados.

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

DatasetType

O tipo de conjunto de dados. Os valores válidos dependem do Domain escolhido.

Tipo: string

Valores Válidos: TARGET_TIME_SERIES | RELATED_TIME_SERIES | ITEM_METADATA

Obrigatório: Sim

Domain

O domínio associado ao conjunto de dados. Quando você adiciona um conjunto de dados a um grupo de conjuntos de dados, esse valor e o valor especificado para o Domain parâmetro da CreateDatasetGroupoperação devem corresponder.

O Domain e o DatasetType que você escolhe para determinar os campos que devem estar presentes nos dados de treinamento importados para um conjunto de dados. Por exemplo, se você escolher o domínio RETAIL e TARGET_TIME_SERIES como DatasetType, o Amazon Forecast exigirá que os campos item_id, timestamp e demand estejam presentes nos seus dados. Para obter mais informações, consulte Importar conjuntos de dados.

Tipo: string

Valores Válidos: RETAIL | CUSTOM | INVENTORY_PLANNING | EC2_CAPACITY | WORK_FORCE | WEB_TRAFFIC | METRICS

Obrigatório: Sim

EncryptionConfig

Uma chave AWS Key Management Service (KMS) e a função AWS Identity and Access Management (IAM) que o Amazon Forecast pode assumir para acessar a chave.

Tipo: objeto EncryptionConfig

Obrigatório: Não

Schema

O esquema do conjunto de dados. Os atributos do esquema e sua ordem devem corresponder aos campos nos seus dados. O conjunto de dados Domain e DatasetType que você escolher para determinar os campos mínimos obrigatórios nos seus dados de treinamento. Para saber mais sobre os campos obrigatórios de um domínio e tipo de conjunto de dados específicos, consulte Domínios e tipos de conjunto de dados.

Tipo: objeto Schema

Obrigatório: Sim

Tags

Os metadados opcionais que você aplica ao conjunto de dados 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

Sintaxe da Resposta

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

DatasetArn

O nome do recurso Amazon (ARN) do conjunto de dados.

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

Consulte também

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