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á.
CreateGroup
Usar aCreateGroup
operação para criar um grupo na Amazon QuickSight. Você pode criar até 10.000 grupos em um namespace. Se quiser criar mais de 10.000 grupos em um namespace, entre em contato com o AWS Support.
O recurso de permissões éarn:aws:quicksight:<your-region>:<relevant-aws-account-id>:group/default/<group-name>
.
A resposta é um objeto de grupo.
Sintaxe da solicitação
POST /accounts/AwsAccountId
/namespaces/Namespace
/groups HTTP/1.1
Content-type: application/json
{
"Description": "string
",
"GroupName": "string
"
}
Parâmetros da solicitação de URI
A solicitação usa os parâmetros de URI a seguir.
- AwsAccountId
-
O ID doAWSconta em que o grupo está. Atualmente, você usa o ID para oAWSconta da que contém sua Amazon QuickSight conta.
Restrições de comprimento: Comprimento fixo de 12.
Padrão:
^[0-9]{12}$
Obrigatório: Sim
- Namespace
-
O namespace do qual você deseja que o grupo faça parte.
Restrições de comprimento: Tamanho máximo de 64.
Padrão:
^[a-zA-Z0-9._-]*$
Obrigatório: Sim
Corpo da solicitação
A solicitação aceita os dados a seguir no formato JSON.
- GroupName
-
Um nome para o grupo que você deseja criar.
Type: String
Restrições de comprimento: Tamanho mínimo de 1.
Padrão:
[\u0020-\u00FF]+
Obrigatório: Sim
- Description
-
Uma descrição do para o grupo que você deseja criar.
Type: String
Restrições de comprimento: Tamanho mínimo de 1. Tamanho máximo de 512.
Obrigatório: Não
Sintaxe da resposta
HTTP/1.1 Status
Content-type: application/json
{
"Group": {
"Arn": "string",
"Description": "string",
"GroupName": "string",
"PrincipalId": "string"
},
"RequestId": "string"
}
Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará a resposta HTTP a seguir.
- Status
-
O status HTTP da solicitação.
Os seguintes dados são retornados no formato JSON pelo serviço.
Erros
Para obter informações sobre os erros que são comuns a todas as ações, consulteErros comuns.
- AccessDeniedException
-
Você não tem acesso a esse item. Não foi possível validar as credenciais fornecidas. Talvez você não tenha permissão para executar a solicitação. Verifique se sua conta está autorizada a usar a Amazon QuickSight , se as suas políticas têm as permissões corretas e se você está usando as chaves de acesso corretas.
Código de status HTTP: 401
- InternalFailureException
-
Ocorreu um erro interno.
Código de status HTTP: 500
- InvalidParameterValueException
-
Um ou mais parâmetros têm um valor que não é válido.
Código de status HTTP: 400
- LimitExceededException
-
Um limite foi excedido.
Código de status HTTP: 409
- PreconditionNotMetException
-
Uma ou mais pré-condições não foram atendidas.
Código de status HTTP: 400
- ResourceExistsException
-
O recurso especificado já existe.
Código de status HTTP: 409
- ResourceNotFoundException
-
Não foi possível encontrar um ou mais recursos.
Código de status HTTP: 404
- ResourceUnavailableException
-
Este recurso está indisponível no momento.
Código de status HTTP: 503
- ThrottlingException
-
O acesso é limitado.
Código de status HTTP: 429
Consulte também
Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos de linguagem, consulte o seguinte: