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\$1PROGRESS > ACTIVE -or- CREATE FAILED + DELETE PENDING Para obter o status do grupo de conjuntos de dados, ligue para [DescribeDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetGroup.html). 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. Você pode especificar uma chave 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 do grupo de conjuntos de dados na solicitação** + [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) ## 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](#API_CreateDatasetGroup_RequestSyntax) ** 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_DEMAND` Obrigatório: não ** [kmsKeyArn](#API_CreateDatasetGroup_RequestSyntax) ** O Amazon Resource Name (ARN) de uma chave AWS Key Management Service (KMS) usada 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](#API_CreateDatasetGroup_RequestSyntax) ** 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\-_]*` Obrigatório: Sim ** [roleArn](#API_CreateDatasetGroup_RequestSyntax) ** O ARN da função AWS Identity and Access Management (IAM) 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 ** [tags](#API_CreateDatasetGroup_RequestSyntax) ** Uma lista de [tags](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) a serem aplicadas ao grupo de conjuntos de dados. Tipo: matriz de objetos [Tag](API_Tag.md) 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](#API_CreateDatasetGroup_ResponseSyntax) ** 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](#API_CreateDatasetGroup_ResponseSyntax) ** 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 uma das linguagens específicas AWS SDKs, consulte o seguinte: + [AWS Interface de linha de comando 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)