Consulta dos grupos de usuários aos quais um usuário do IAM pertence
Função
Essa API pode ser usada pelo administrador para consultar os grupos de um usuário do IAM especificado ou usada por um usuário do IAM para consultar seus próprios grupos.
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/users/{user_id}/groups
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
---|---|---|---|
user_id |
Sim |
String |
ID do usuário do IAM. Para obter detalhes sobre como obter um ID de usuário, 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 |
Se o administrador estiver solicitando consultar os grupos aos quais um usuário do IAM pertence, consulte Ações. Se um usuário do IAM estiver solicitando a consulta de seus próprios grupos, o token do usuário (sem requisitos de permissão especiais) será necessário. |
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/users/{user_id}/groups
Exemplo de resposta
Código de status: 200
A solicitação foi bem-sucedida.
{ "groups": [ { "domain_id": "d78cbac186b744899480f25bd0...", "create_time": 1578107542861, "name": "IAMGroup", "description": "", "links": { "next": null, "previous": null, "self": "https://iam.myhuaweicloud.com/v3/groups/07609e7eb200250a3f7dc003cb..." }, "id": "07609e7eb200250a3f7dc003cb7..." } ], "links": { "next": null, "previous": null, "self": "https://iam.myhuaweicloud.com/v3/users/076837351e80251c1f0fc003afe43.../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. |
404 |
O recurso solicitado não pode ser encontrado. |
405 |
O método especificado na solicitação não é permitido para o recurso solicitado. |
413 |
Ocorre um conflito de recursos. |
500 |
Erro de servidor interno. |
503 |
Serviço indisponível. |
Códigos de erro
Nenhum