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
<a name="API_CreateDatasetExportJob"></a>

 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](https://docs.aws.amazon.com/personalize/latest/dg/export-data.html) 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\$1PROGRESS > ACTIVE ou CREATE FAILED

 Para obter o status do trabalho de exportação [DescribeDatasetExportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetExportJob.html), 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
<a name="API_CreateDatasetExportJob_RequestSyntax"></a>

```
{
   "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 name="API_CreateDatasetExportJob_RequestParameters"></a>

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

 ** [datasetArn](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-datasetArn"></a>
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:.*:.*:.+`   
Obrigatório: Sim

 ** [ingestionMode](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-ingestionMode"></a>
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](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-jobName"></a>
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\-_]*`   
Obrigatório: Sim

 ** [jobOutput](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-jobOutput"></a>
O caminho do bucket do Amazon S3 no qual a saída do trabalho é armazenada.  
Tipo: objeto [DatasetExportJobOutput](API_DatasetExportJobOutput.md)  
Obrigatório: Sim

 ** [roleArn](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-roleArn"></a>
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+=,.@\-_/]+`   
Obrigatório: Sim

 ** [tags](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-tags"></a>
Uma lista de [tags](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) a serem aplicadas ao trabalho de exportação do conjunto de dados.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Membros da matriz: número mínimo de 0 itens. Número máximo de 200 itens.  
Obrigatório: não

## Sintaxe da resposta
<a name="API_CreateDatasetExportJob_ResponseSyntax"></a>

```
{
   "datasetExportJobArn": "string"
}
```

## Elementos de resposta
<a name="API_CreateDatasetExportJob_ResponseElements"></a>

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

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

 ** [datasetExportJobArn](#API_CreateDatasetExportJob_ResponseSyntax) **   <a name="personalize-CreateDatasetExportJob-response-datasetExportJobArn"></a>
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
<a name="API_CreateDatasetExportJob_Errors"></a>

 ** 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
<a name="API_CreateDatasetExportJob_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateDatasetExportJob)