CreateDataset - Amazon Personalize

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.

CreateDataset

Crea un conjunto de datos vacío y lo agrega al grupo de conjuntos de datos especificado. Se utiliza CreateDatasetImportJobpara importar los datos de entrenamiento a un conjunto de datos.

Existen 5 tipos de conjuntos de datos:

  • Interacciones de elementos

  • Items

  • Usuarios

  • Interacciones de acción

  • Acciones

Cada conjunto de datos tiene asociado un esquema con los tipos de campo necesarios. Solo es necesario el conjunto de datos Item interactions para entrenar un modelo (también denominado creación de una solución).

Un conjunto de datos puede tener uno de los siguientes estados:

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

  • DELETE PENDING > DELETE IN_PROGRESS

Para obtener el estado del conjunto de datos, llama DescribeDataset.

Sintaxis de la solicitud

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

Parámetros de la solicitud

La solicitud acepta los siguientes datos en formato JSON.

datasetGroupArn

El nombre de recurso de Amazon (ARN) del grupo de conjunto de datos al que se va a agregar el conjunto de datos.

Tipo: cadena

Limitaciones de longitud: longitud máxima de 256.

Patrón: arn:([a-z\d-]+):personalize:.*:.*:.+

Obligatorio: sí

datasetType

El tipo de conjunto de datos.

Uno de los siguientes valores (no se distingue entre mayúsculas y minúsculas):

  • Interacciones

  • Items

  • Usuarios

  • Acciones

  • Action_Interactions

Tipo: cadena

Limitaciones de longitud: longitud máxima de 256 caracteres.

Obligatorio: sí

name

Nombre del conjunto de datos.

Tipo: string

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í

schemaArn

El ARN del esquema que se debe asociar al conjunto de datos. El esquema define los campos de un conjunto de datos.

Tipo: cadena

Limitaciones de longitud: longitud máxima de 256.

Patrón: arn:([a-z\d-]+):personalize:.*:.*:.+

Obligatorio: sí

tags

Lista de etiquetas que se aplican al 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.

Obligatorio: no

Sintaxis de la respuesta

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

datasetArn

El ARN 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 uno de los AWS SDK específicos del idioma, consulta lo siguiente: