Listagem de grupos de usuários
Função
Essa API é fornecida para que o administrador liste todos os grupos 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
GET /v3/groups
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
---|---|---|---|
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 |
Não |
String |
Nome do grupo de usuários, que pode conter no máximo 64 caracteres. Para obter detalhes sobre como obter um nome de grupo de usuários, consulte Obtenção de informações de conta, usuário do IAM, grupo, projeto, região e agência. |
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âmetros de resposta
Parâmetro |
Tipo |
Descrição |
---|---|---|
Array of objects |
Informações do grupo de usuários. |
|
Object |
Informações sobre o link do recurso. |
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
GET https://iam.myhuaweicloud.com/v3/groups
Exemplo de resposta
Código de status: 200
A solicitação foi bem-sucedida.
{ "groups": [ { "domain_id": "d78cbac186b744899480f25bd02...", "create_time": 1536293929624, "name": "IAMGroupA", "description": "IAMDescription", "links": { "next": null, "previous": null, "self": "https://iam.myhuaweicloud.com/v3/groups/5b050baea9db472c88cbae67..." }, "id": "5b050baea9db472c88cbae6..." }, { "domain_id": "d78cbac186b744899480f25...", "create_time": 1578107542861, "name": "IAMGroupB", "description": "IAMDescription", "links": { "next": null, "previous": null, "self": "https://iam.myhuaweicloud.com/v3/groups/07609e7eb200250a3f7dc003cb7a4e2d" }, "id": "07609e7eb200250a3f7dc003cb..." } ], "links": { "next": null, "previous": null, "self": "https://iam.myhuaweicloud.com/v3/groups" } }
Códigos de status
Código de status |
Descrição |
---|---|
200 |
A solicitação foi bem-sucedida. |
400 |
Parâmetros inválidos. |
401 |
Autenticação falhou. |
403 |
Acesso negado. |
Códigos de erro
Nenhum