CreateDatasetExportJob - Amazon Personalize
Sintaxis de la solicitudParámetros de la solicitudSintaxis de la respuestaElementos de respuestaErroresVéase también

CreateDatasetExportJob

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 en la guía para desarrolladores de Amazon Personalize.

Status

Un trabajo de exportación de conjunto de datos puede aparecer en uno de los siguientes estados:

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

Para obtener el estado del trabajo de exportación, llame a DescribeDatasetExportJob y especifique el nombre de recurso de Amazon (ARN) del trabajo de exportación de 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

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

Parámetros de la solicitud

La solicitud acepta los siguientes datos en formato JSON.

datasetArn

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

Los datos que se van a exportar, en función de cómo los haya importado. Puede optar por exportar solo los datos BULK que haya importado mediante un trabajo de importación de conjuntos de datos, solo los datos PUT que haya importado de forma incremental (mediante las operaciones de consola, PutEvents, PutUsers y PutItems) o ALL para ambos tipos. El valor predeterminado es PUT.

Tipo: cadena

Valores válidos: BULK | PUT | ALL

Requerido: no

jobName

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

La ruta al bucket de Amazon S3 donde se almacena el resultado del trabajo.

Tipo: objeto DatasetExportJobOutput

Obligatorio: sí

roleArn

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

Lista de etiquetas que se aplican al trabajo de exportación del conjunto de datos.

Tipo: matriz de objetos Tag

Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.

Requerido: no

Sintaxis de la respuesta

{
   "datasetExportJobArn": "string"
}

Elementos de respuesta

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

El servicio devuelve los datos siguientes en formato JSON.

datasetExportJobArn

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

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

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte: