Listagem de usuários do IAM
Função
Esta API é fornecida para que o administrador liste todos os usuários do IAM.
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
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. |
enabled |
Não |
Boolean |
Ativando o 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. |
name |
Não |
String |
Nome de usuário do IAM. |
password_expires_at |
Não |
String |
Data de expiração da senha. null indica que a senha tem validade ilimitada. Formato da senha: password_expires_at={operator}:{timestamp}. Formato de carimbo de data/hora: YYYY-MM-DDTHH:mm:ssZ. Exemplo: password_expires_at=lt:2016-12-08T22:02:00Z
NOTA:
|
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 |
---|---|---|
Object |
Informações sobre o link do recurso. |
|
Array of objects |
Informações do usuário do IAM. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
self |
String |
Link de recursos. |
previous |
String |
Link do recurso anterior. |
next |
String |
Próximo link de recurso. |
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 |
Ativando o 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 do IAM. |
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 por último antes de sair do sistema. |
pwd_strength |
String |
Força da senha. O valor pode ser high, mid ou low. |
Exemplo de solicitação
GET https://iam.myhuaweicloud.com/v3/users
![](https://support.huaweicloud.com/intl/pt-br/api-iam/public_sys-resources/note_3.0-pt-br.png)
Para restringir o intervalo de consulta, adicione um parâmetro path. Por exemplo:
GET https://iam.myhuaweicloud.com/v3/users?domain_id=d78cbac186b744899480f25bd02...&enabled=true
Exemplo de resposta
Código de status: 200
A solicitação foi bem-sucedida.
{ "links": { "next": null, "previous": null, "self": "https://iam.myhuaweicloud.com/v3/users" }, "users": [ { "domain_id": "d78cbac186b744899480f25bd02...", "name": "IAMUserA", "description": "IAMDescriptionA", "password_expires_at": null, "links": { "next": null, "previous": null, "self": "https://iam.myhuaweicloud.com/v3/users/07667db96a00265f1fc0c003a3..." }, "id": "07667db96a00265f1fc0c003a...", "enabled": true }, { "pwd_status": true, "domain_id": "d78cbac186b744899480f25bd02...", "last_project_id": "065a7c66da0010992ff7c0031e5a...", "name": "IAMUserB", "description": "IAMDescriptionB", "password_expires_at": null, "links": { "next": null, "previous": null, "self": "https://iam.myhuaweicloud.com/v3/users/07609fb9358010e21f7bc003751c7..." }, "id": "07609fb9358010e21f7bc003751c7...", "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 |
A entidade de solicitação é muito grande. |
503 |
Serviço indisponível. |
Códigos de erro
Nenhum