Criação de um grupo de usuários
Função
Esta API é fornecida para o administrador criar um grupo de usuários.
A API pode ser chamada usando o ponto de extremidade global e pontos de extremidade da região específica. Para pontos de extremidade do IAM, consulte Regiões e pontos de extremidade.
URI
POST /v3/groups
Parâmetros de solicitação
Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Content-Type | Sim | String | Preencha application/json;charset=utf8 nesse campo. |
X-Auth-Token | Sim | String | Token de acesso emitido para um usuário para suportar sua identidade e permissões. Para obter detalhes sobre as permissões exigidas pelo token, consulte Ações. |
Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Sim | Object | Informações do grupo de usuários. |
Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
description | Não | String | Descrição do grupo de usuários, que deve conter menos ou igual a 255 caracteres. |
domain_id | Não | String | ID da conta. Para obter detalhes sobre como obter o ID da conta, consulte Obtenção de informações sobre conta, usuário do IAM, grupo, projeto, região e agência. |
name | Sim | String | Nome do grupo de usuários, que contém de 1 a 128 caracteres. |
Parâmetros de resposta
Parâmetro | Tipo | Descrição |
|---|---|---|
Object | Informações do grupo de usuários. |
Parâmetro | Tipo | Descrição |
|---|---|---|
description | String | Descrição do grupo de usuários. |
id | String | ID do grupo de usuários. |
domain_id | String | ID da conta à qual o grupo de usuários pertence. |
name | String | Nome do grupo de usuários. |
Object | Link de recurso do grupo de usuários. | |
create_time | Long | Hora em que o grupo de usuários foi criado. |
Exemplo de solicitação
Solicitação para que um administrador crie um grupo de usuários chamado IAMGroup
POST https://iam.myhuaweicloud.com/v3/groups
{
"group": {
"description": "IAMDescription",
"domain_id": "d78cbac186b744899480f25bd0...",
"name": "IAMGroup"
}
} Exemplo de resposta
Código de status: 201
O grupo de usuários foi criado com sucesso.
{
"group": {
"description": "IAMDescription",
"links": {
"self": "https://iam.myhuaweicloud.com/v3/groups/077a4c7bcd8010d53fb7c003e9d966c2"
},
"id": "077a4c7bcd8010d53fb7c003e9d966c2",
"create_time": 1578969208707,
"domain_id": "d78cbac186b744899480f25bd0...",
"name": "IAMGroup"
}
} Códigos de status
Código de status | Descrição |
|---|---|
201 | O grupo de usuários foi criado com sucesso. |
400 | Parâmetros inválidos. |
401 | Falha na autenticação. |
403 | Acesso negado. |
409 | Ocorre um conflito de recursos. |
Códigos de erro
Nenhum
