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
-
Usuarios
-
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_PROGRESS > ACTIVE -o- CREATE FAILED
-
DELETE PENDING
Para obtener el estado del grupo de conjuntos de datos, llame DescribeDatasetGroup. 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.
API que requieren un ARN de grupo de conjuntos de datos en la solicitud
API relacionadas
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
-
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_DEMANDObligatorio: no
- kmsKeyArn
-
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
-
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
-
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
-
Lista de etiquetas que se aplican al grupo de conjuntos 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
{
"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
-
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
-
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 AWS SDK específicos del idioma, consulta lo siguiente:
