Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# CreateDatasetExportJob
<a name="API_CreateDatasetExportJob"></a>

 Crea un trabajo que exporta datos desde su conjunto de datos a un bucket de Amazon S3. Para permitir que Amazon Personalize exporte los datos de entrenamiento, debe especificar un rol de IAM vinculado al servicio que otorgue a Amazon Personalize permisos de `PutObject` para su bucket de Amazon S3. Para obtener más información, consulte [Exportación de un conjunto de datos](https://docs.aws.amazon.com/personalize/latest/dg/export-data.html) en la guía para desarrolladores de Amazon Personalize. 

 **Estado** 

Un trabajo de exportación de conjunto de datos puede aparecer en uno de los siguientes estados:
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED

 Para obtener el estado del trabajo de exportación [DescribeDatasetExportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetExportJob.html), llama y especifica el nombre de recurso de Amazon (ARN) del trabajo de exportación del conjunto de datos. La exportación del conjunto de datos finaliza cuando el estado es ACTIVE. Si el estado muestra CREATE FAILED, la respuesta incluye una clave `failureReason` que describe el motivo del error en el trabajo. 

## Sintaxis de la solicitud
<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 de la solicitud
<a name="API_CreateDatasetExportJob_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [datasetArn](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-datasetArn"></a>
El nombre de recurso de Amazon (ARN) del conjunto de datos que contiene los datos que se van a exportar.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

 ** [ingestionMode](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-ingestionMode"></a>
Los datos que se van a exportar, en función de cómo los haya importado. Puede optar por exportar solo `BULK` los datos que haya importado mediante un trabajo de importación de conjuntos de datos, solo `PUT` los datos que haya importado de forma incremental (mediante la consola PutUsers y PutItems las operaciones) o `ALL` para ambos tipos. PutEvents El valor predeterminado es `PUT`.   
Tipo: cadena  
Valores válidos: `BULK | PUT | ALL`   
Obligatorio: no

 ** [jobName](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-jobName"></a>
Nombre para el trabajo de exportación del conjunto de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: sí

 ** [jobOutput](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-jobOutput"></a>
La ruta al bucket de Amazon S3 donde se almacena el resultado del trabajo.  
Tipo: objeto [DatasetExportJobOutput](API_DatasetExportJobOutput.md)  
Obligatorio: sí

 ** [roleArn](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-roleArn"></a>
El nombre de recurso de Amazon (ARN) del rol de servicio de IAM que tiene permisos para añadir datos al bucket de Amazon S3 de salida.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`   
Obligatorio: sí

 ** [tags](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-tags"></a>
Lista de [etiquetas](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) que se aplican al trabajo de exportación del conjunto de datos.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_CreateDatasetExportJob_ResponseSyntax"></a>

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

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

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [datasetExportJobArn](#API_CreateDatasetExportJob_ResponseSyntax) **   <a name="personalize-CreateDatasetExportJob-response-datasetExportJobArn"></a>
El nombre de recurso de Amazon (ARN) del trabajo de exportación del conjunto de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errores
<a name="API_CreateDatasetExportJob_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha excedido el límite en el número de solicitudes por segundo.  
Código de estado HTTP: 400

 ** ResourceAlreadyExistsException **   
El recurso especificado ya existe.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

 ** TooManyTagsException **   
Ha superado el número máximo de etiquetas que puede aplicar a este recurso.   
Código de estado HTTP: 400

## Véase también
<a name="API_CreateDatasetExportJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos 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)