Consulta de detalhes do usuário do IAM
Função
Essa API pode ser usada pelo administrador para consultar os detalhes sobre um usuário do IAM especificado ou usada por um usuário do IAM para consultar seus próprios detalhes.
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.
Restrições
Essa API não pode ser usada para consultar o número de celular e o endereço de e-mail de um usuário do IAM. Para consultar essas informações, consulte Consulta de detalhes do usuário do IAM (recomendado).
URI
GET /v3/users/{user_id}
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 detalhes do usuário do IAM, consulte Ações. Se um usuário do IAM estiver solicitando a consulta de seus próprios detalhes, o token do usuário (sem requisitos de permissão especiais) será necessário. |
Parâmetros de resposta
Parâmetro |
Tipo |
Descrição |
---|---|---|
Object |
Informações do usuário do IAM. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
name |
String |
Nome de usuário do IAM. |
Object |
Informações de link de recurso do usuário do IAM. |
|
domain_id |
String |
ID da conta à qual o usuário do IAM pertence. |
enabled |
Boolean |
Habilitação do status do usuário do IAM. true (valor padrão) indica que o usuário está habilitado. false indica que o usuário está desativado. |
id |
String |
ID do usuário do IAM. |
password_expires_at |
String |
Horário UTC quando a senha expira. null indica que a senha tem validade ilimitada. |
description |
String |
Descrição do usuário. |
pwd_status |
Boolean |
Status da senha. true significa que a senha precisa ser alterada, false significa que a senha é normal. |
last_project_id |
String |
ID do projeto que o usuário do IAM acessou pela última vez antes de sair do sistema. |
Exemplo de solicitação
GET https://iam.myhuaweicloud.com/v3/users/{user_id}
Exemplo de resposta
Código de status: 200
A solicitação foi bem-sucedida.
{ "user": { "pwd_status": true, "domain_id": "d78cbac186b744899480f25bd02...", "last_project_id": "065a7c66da0010992ff7c0031e5a5...", "name": "IAMUser", "description": "--", "password_expires_at": null, "links": { "next": null, "previous": null, "self": "https://iam.myhuaweicloud.com/v3/users/07609fb9358010e21f7bc003751..." }, "id": "7116d09f88fa41908676fdd4b039...", "enabled": true } }
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