Criação de um grupo de usuários
Função
Esta API é fornecida para que o administrador crie um grupo de usuários.
A API pode ser chamada usando o ponto de extremidade global e pontos de extremidade específicos da região. Para pontos de extremidade do IAM, consulte Regiões e pontos de extremidade.
URI
POST /v3/groups
Parâmetros de solicitação
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
---|---|---|---|
Content-Type |
Sim |
String |
Preencha application/json;charset=utf8 neste campo. |
X-Auth-Token |
Sim |
String |
Consulte Ações. |
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
---|---|---|---|
Sim |
Object |
Informações do grupo de usuários. |
Parâmetro |
Obrigatoriedade |
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 conseguir o ID de domínio, consulte Obtenção de informações de conta, usuário do IAM, grupo, projeto, região e agência. |
name |
Sim |
String |
Nome do grupo de usuários, que deve conter menos ou igual a 64 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
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 êxito.
{ "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 êxito. |
400 |
Parâmetros inválidos. |
401 |
Autenticação falhou. |
403 |
Acesso negado. |
409 |
Ocorre um conflito de recursos. |
Códigos de erro
Nenhum