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 [CreateDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetImportJob.html)para importar los datos de entrenamiento a un conjunto de datos. Existen 5 tipos de conjuntos de datos: + Interacciones de elementos + Items + Users + 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\$1PROGRESS > ACTIVE -o- CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS Para obtener el estado del conjunto de datos, llama [DescribeDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataset.html). **Relacionado APIs** + [CreateDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetGroup.html) + [ListDatasets](https://docs.aws.amazon.com/personalize/latest/dg/API_ListDatasets.html) + [DescribeDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataset.html) + [DeleteDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteDataset.html) ## 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](#API_CreateDataset_RequestSyntax) ** 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](#API_CreateDataset_RequestSyntax) ** El tipo de conjunto de datos. Uno de los siguientes valores (no se distingue entre mayúsculas y minúsculas): + Interacciones + Items + Users + Acciones + Action\$1Interactions Tipo: cadena Limitaciones de longitud: longitud máxima de 256. Patrón: `^[A-Za-z_]+$` Obligatorio: sí ** [name](#API_CreateDataset_RequestSyntax) ** Nombre 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í ** [schemaArn](#API_CreateDataset_RequestSyntax) ** 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](#API_CreateDataset_RequestSyntax) ** Lista de [etiquetas](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) que se aplican al 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 ``` { "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](#API_CreateDataset_ResponseSyntax) ** 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 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/CreateDataset) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateDataset) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateDataset) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateDataset) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateDataset) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateDataset) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateDataset) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateDataset) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateDataset) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateDataset)