CreateDataset - Amazon Personalize

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 vazio e o adiciona ao grupo de conjuntos de dados especificado. Use CreateDatasetImportJobpara importar seus dados de treinamento para um conjunto de dados.

Há cinco tipos de conjunto de dados:

  • Interações com itens

  • Itens

  • Usuários

  • Interações com ações

  • Ações

Cada tipo de conjunto de dados tem um esquema associado com tipos de campos necessários. Somente o conjunto de dados Item interactions é necessário para treinar um modelo (também conhecido como criação de uma solução).

Um conjunto de dados pode estar em um dos seguintes estados:

  • CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -ou- CREATE FAILED

  • DELETE PENDING > DELETE IN_PROGRESS

Para obter o status do conjunto de dados, ligue para DescribeDataset.

Sintaxe da Solicitação

{ "datasetGroupArn": "string", "datasetType": "string", "name": "string", "schemaArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] }

Parâmetros da solicitação

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

datasetGroupArn

O nome do recurso da Amazon (ARN) do grupo de conjuntos de dados ao qual o conjunto de dados será adicionado.

Tipo: string

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

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

Exigido: Sim

datasetType

O tipo de conjunto de dados.

Um dos seguintes valores (não diferencia maiúsculas e minúsculas):

  • Interações

  • Itens

  • Usuários

  • Ações

  • Action_Interactions

Tipo: string

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

Obrigatório: Sim

name

O nome do conjunto de dados.

Tipo: string

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

Padrão: ^[a-zA-Z0-9][a-zA-Z0-9\-_]*

Exigido: Sim

schemaArn

O ARN do esquema ao qual o conjunto de dados será associado. O esquema define os campos do conjunto de dados.

Tipo: string

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

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

Exigido: Sim

tags

Uma lista de tags a serem aplicadas ao conjunto de dados.

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 tiver êxito, o serviço enviará de volta uma resposta HTTP 200.

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

datasetArn

O ARN do conjunto de dados.

Tipo: string

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

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

Erros

InvalidInputException

Forneça um valor válido para o campo ou parâmetro.

Código de Status HTTP: 400

LimitExceededException

O limite de número de solicitações por segundo foi excedido.

Código de Status HTTP: 400

ResourceAlreadyExistsException

O recurso especificado já existe.

Código de Status HTTP: 400

ResourceInUseException

O recurso especificado está em uso.

Código de Status HTTP: 400

ResourceNotFoundException

Não foi possível encontrar o recurso especificado.

Código de Status HTTP: 400

TooManyTagsException

Você excedeu o número máximo de tags que pode aplicar a esse recurso.

Código de Status HTTP: 400

Consulte também

Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos da linguagem, consulte o seguinte: