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. # CreateDatasetGroup Crea un grupo de conjuntos de datos vacío. Un grupo de conjuntos de datos es un contenedor para los recursos de Amazon Personalize. Un grupo de conjuntos de datos puede contener como máximo tres conjuntos de datos, uno para cada tipo de conjunto de datos: + Interacciones de elementos + Items + Users + Acciones + Interacciones de acción Un grupo de conjuntos de datos puede ser un grupo de conjuntos de datos de dominio, en el que se especifica un dominio y se utilizan recursos preconfigurados, como recomendaciones, o un grupo de conjuntos de datos personalizados, en el que se utilizan recursos personalizados, como una solución con una versión de solución, que se implementa con una campaña. Si empieza con un grupo de conjuntos de datos de dominio, puede añadir recursos personalizados, como soluciones y versiones de soluciones entrenadas con recetas para casos de uso personalizados e implementadas con campañas. Un grupo de conjuntos de datos puede tener uno de los siguientes estados: + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED + DELETE PENDING Para obtener el estado del grupo de conjuntos de datos, llame [DescribeDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetGroup.html). Si el estado muestra CREATE FAILED, la respuesta incluye una clave `failureReason` que describe el motivo del error en la creación. **nota** Debe esperar a que el valor `status` del grupo de conjuntos de datos sea `ACTIVE` antes de agregar un conjunto de datos al grupo. Puede especificar una clave AWS Key Management Service (KMS) para cifrar los conjuntos de datos del grupo. Si especifica una clave de KMS, también debe incluir un rol (de IAM) AWS Identity and Access Management que tenga permiso para acceder a la clave. **APIs que requieren un ARN de grupo de conjuntos de datos en la solicitud** + [CreateDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html) + [CreateEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateEventTracker.html) + [CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) **Relacionado APIs** + [ListDatasetGroups](https://docs.aws.amazon.com/personalize/latest/dg/API_ListDatasetGroups.html) + [DescribeDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetGroup.html) + [DeleteDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteDatasetGroup.html) ## Sintaxis de la solicitud ``` { "domain": "string", "kmsKeyArn": "string", "name": "string", "roleArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## Parámetros de la solicitud La solicitud acepta los siguientes datos en formato JSON. ** [domain](#API_CreateDatasetGroup_RequestSyntax) ** El dominio del grupo de conjuntos de datos. Especifique un dominio para crear un grupo de conjuntos de datos de dominio. El dominio que especifique determina los esquemas predeterminados de los conjuntos de datos y los casos de uso disponibles para los recomendadores. Si no especifica un dominio, creará un grupo de conjuntos de datos personalizados con versiones de soluciones que puede implementar con una campaña. Tipo: cadena Valores válidos: `ECOMMERCE | VIDEO_ON_DEMAND` Obligatorio: no ** [kmsKeyArn](#API_CreateDatasetGroup_RequestSyntax) ** El nombre de recurso de Amazon (ARN) de una clave AWS Key Management Service (KMS) utilizada para cifrar los conjuntos de datos. Tipo: cadena Limitaciones de longitud: longitud máxima de 2048 caracteres. Patrón: `arn:aws.*:kms:.*:[0-9]{12}:key/.*` Obligatorio: no ** [name](#API_CreateDatasetGroup_RequestSyntax) ** El nombre del nuevo grupo de conjuntos 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í ** [roleArn](#API_CreateDatasetGroup_RequestSyntax) ** El ARN del rol AWS Identity and Access Management (IAM) que tiene permisos para acceder a la clave AWS Key Management Service (KMS). La especificación de un rol de IAM solo es válida cuando también se especifica una clave de KMS. 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: no ** [tags](#API_CreateDatasetGroup_RequestSyntax) ** Lista de [etiquetas](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) que se aplican al grupo de conjuntos 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 ``` { "datasetGroupArn": "string", "domain": "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. ** [datasetGroupArn](#API_CreateDatasetGroup_ResponseSyntax) ** El nombre de recurso de Amazon (ARN) del nuevo grupo de conjuntos de datos. Tipo: cadena Limitaciones de longitud: longitud máxima de 256. Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+` ** [domain](#API_CreateDatasetGroup_ResponseSyntax) ** El dominio para el nuevo grupo de conjuntos de datos de dominio. Tipo: cadena Valores válidos: `ECOMMERCE | VIDEO_ON_DEMAND` ## 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 ** 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/CreateDatasetGroup) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateDatasetGroup) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateDatasetGroup) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateDatasetGroup) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateDatasetGroup) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateDatasetGroup) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateDatasetGroup) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateDatasetGroup) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateDatasetGroup) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateDatasetGroup)