As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
CreateDatasetGroup
Cria um grupo de conjuntos de dados vazio. Um grupo do conjunto de dados é um contêiner para recursos do Amazon Personalize. Um grupo de conjuntos de dados pode conter no máximo três conjuntos de dados, um para cada tipo de conjunto de dados:
-
Interações com itens
-
Itens
-
Usuários
-
Ações
-
Interações com ações
Um grupo de conjuntos de dados pode ser um grupo de conjuntos de dados de domínio, em que você especifica um domínio e usa recursos pré-configurados, como recomendações, ou um grupo de conjuntos de dados personalizados, em que você usa recursos personalizados, como uma solução com uma versão da solução, que você implanta com uma campanha. Se começar com um grupo de conjunto de dados de domínio, você ainda pode adicionar recursos personalizados, como soluções e versões de soluções treinadas com fórmulas para casos de uso personalizados e implantadas com campanhas.
Um grupo de conjuntos de dados pode estar em um dos seguintes estados:
-
CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED
-
DELETE PENDING
Para obter o status do grupo de conjuntos de dados, chame DescribeDatasetGroup. Se o status for exibido como CREATE FAILED, a resposta incluirá uma chave failureReason que descreve por que a criação falhou.
nota
Você deve esperar até que o status do grupo de conjuntos de dados esteja ACTIVE antes de adicionar um conjunto de dados ao grupo.
É possível especificar uma chave do AWS Key Management Service (KMS) para criptografar os conjuntos de dados no grupo. Se você especificar uma chave KMS, também deverá incluir um perfil do IAM AWS Identity and Access Management que tenha permissão para acessar a chave.
APIs que exigem um ARN de grupo de conjuntos de dados na solicitação
APIs relacionadas
Sintaxe da Solicitação
{
"domain": "string",
"kmsKeyArn": "string",
"name": "string",
"roleArn": "string",
"tags": [
{
"tagKey": "string",
"tagValue": "string"
}
]
}Parâmetros da solicitação
A solicitação aceita os dados a seguir no formato JSON.
- domain
-
O domínio do grupo de conjuntos de dados. Especifique um domínio para criar um grupo de conjunto de dados de domínio. O domínio que você especifica determina os esquemas padrão para conjuntos de dados e os casos de uso disponíveis para os recomendadores. Se você não especificar um domínio, crie um grupo de conjuntos de dados personalizados com versões da solução que você implanta com uma campanha.
Tipo: string
Valores Válidos:
ECOMMERCE | VIDEO_ON_DEMANDObrigatório: Não
- kmsKeyArn
-
O nome do recurso da Amazon (ARN) da chave do AWS Key Management Service (KMS) a ser utilizada para criptografar os conjuntos de dados.
Tipo: string
Restrições de tamanho: tamanho máximo de 2048.
Padrão:
arn:aws.*:kms:.*:[0-9]{12}:key/.*Obrigatório: Não
- name
-
O nome do grupo de conjuntos de dados.
Tipo: string
Restrições de tamanho: o tamanho mínimo é 1. O tamanho máximo é 63.
Padrão:
^[a-zA-Z0-9][a-zA-Z0-9\-_]*Exigido: Sim
- roleArn
-
O ARN do perfil do IAM do AWS Identity and Access Management que tem permissões para acessar a chave AWS Key Management Service (KMS). O fornecimento de um perfil do IAM só é válido quando também se especifica uma chave KMS.
Tipo: string
Restrições de tamanho: o tamanho máximo é 256.
Padrão:
arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+Obrigatório: Não
-
Uma lista de tags a serem aplicadas ao grupo de conjuntos de dados.
Tipo: matriz de objetos Tag
Membros da Matriz: número mínimo de 0 itens. Número máximo de 200 itens.
Obrigatório: Não
Sintaxe da Resposta
{
"datasetGroupArn": "string",
"domain": "string"
}Elementos de Resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
- datasetGroupArn
-
O nome do recurso da Amazon (ARN) do novo grupo de conjuntos de dados.
Tipo: string
Restrições de tamanho: o tamanho máximo é 256.
Padrão:
arn:([a-z\d-]+):personalize:.*:.*:.+ - domain
-
O domínio do novo grupo de conjuntos de dados do domínio.
Tipo: string
Valores Válidos:
ECOMMERCE | VIDEO_ON_DEMAND
Erros
- InvalidInputException
-
Forneça um valor válido para o campo ou parâmetro.
Código de Status HTTP: 400
- LimitExceededException
-
O limite de número de solicitações por segundo foi excedido.
Código de Status HTTP: 400
- ResourceAlreadyExistsException
-
O recurso especificado já existe.
Código de Status HTTP: 400
- TooManyTagsException
-
Você excedeu o número máximo de tags que pode aplicar a esse recurso.
Código de Status HTTP: 400
Consulte Também
Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte:
