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

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

CreateDatasetExportJob

Cria um trabalho que exporta dados de seu conjunto de dados para um bucket do Amazon S3. Para permitir que o Amazon Personalize exporte os dados de treinamento, você deve especificar um perfil do IAM vinculado ao serviço que dê permissões PutObject ao Amazon Personalize para seu bucket do Amazon S3. Para obter informações, consulte Exportação de um conjunto de dados no guia do desenvolvedor do Amazon Personalize.

Status

Um trabalho de exportação do conjunto de dados pode estar em um dos seguintes estados:

  • CREATE PENDING > CREATE IN_PROGRESS > ACTIVE ou CREATE FAILED

Para obter o status do trabalho de exportação DescribeDatasetExportJob, chame e especifique o Amazon Resource Name (ARN) do trabalho de exportação do conjunto de dados. A exportação do conjunto de dados estará concluída quando o status for ACTIVE. Se o status for exibido como CREATE FAILED, a resposta incluirá uma chave failureReason que descreve por que o trabalho falhou.

Sintaxe da Solicitação

{
   "datasetArn": "string",
   "ingestionMode": "string",
   "jobName": "string",
   "jobOutput": { 
      "s3DataDestination": { 
         "kmsKeyArn": "string",
         "path": "string"
      }
   },
   "roleArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}

Parâmetros da solicitação

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

datasetArn

O nome do recurso da Amazon (ARN) do conjunto de dados que contém os dados para exportação.

Tipo: string

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

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

Exigido: Sim

ingestionMode

Os dados a serem exportados, com base em como você importou os dados. Você pode optar por exportar somente BULK os dados importados usando um trabalho de importação de conjunto de dados, somente PUT os dados importados de forma incremental (usando o console PutUsers e PutItems as operações) ou ALL para os dois tipos. PutEvents O valor padrão é PUT.

Tipo: string

Valores Válidos: BULK | PUT | ALL

Obrigatório: não

jobName

O nome do trabalho de exportação 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

jobOutput

O caminho do bucket do Amazon S3 no qual a saída do trabalho é armazenada.

Tipo: objeto DatasetExportJobOutput

Obrigatório: Sim

roleArn

O nome do recurso da Amazon (ARN) de um perfil de serviço do IAM com permissões para adicionar dados ao bucket do Amazon S3 de saída.

Tipo: string

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

Padrão: arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+

Exigido: Sim

tags

Uma lista de tags a serem aplicadas ao trabalho de exportação do 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

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

datasetExportJobArn

O nome do recurso da Amazon (ARN) do trabalho de exportação 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: