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 da região específica. 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 |
Obrigatório |
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 sobre conta, usuário do IAM, grupo, projeto, região e agência. |
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 |
Se o administrador estiver solicitando a consulta dos 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 do link de recursos do usuário de IAM. |
|
domain_id |
String |
ID da conta à qual o usuário do IAM pertence. |
enabled |
Boolean |
Status de ativação do usuário do IAM. true (valor padrão) indica que o usuário está ativado. false indica que o usuário está desativado. |
id |
String |
ID do usuário do IAM. |
password_expires_at |
String |
Tempo de expiração da senha do usuário do IAM. Se esse parâmetro for definido como null, a senha nunca expirará.
NOTA:
O valor é uma hora UTC no formato AAAA-MM-DDTHH:mm:ss.ssssssZ, por exemplo, 2023-06-28T08:56:33.710000Z. Para obter detalhes sobre os formatos de data e carimbo de data/hora, consulte ISO-8601. |
description |
String |
Descrição do usuário. |
pwd_status |
Boolean |
Status da senha. true significa que a senha precisa ser alterada e 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
Solicitação para consultar detalhes do usuário do IAM, excluindo o número de celular e o endereço de e-mail do usuário do IAM
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 |
Falha na autenticação. |
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