Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda/ Identity and Access Management/ Referência de API/ API/ Gerenciamento de usuários do IAM/ Listagem de usuários do IAM

Atualizado em 2023-02-16 GMT+08:00

Ver PDF

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

**Tabela 1** Parâmetros de consulta
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: o valor do operator pode ser lt, lte, gt, gte, eq ou neq. lt: o tempo de expiração é anterior ao timestamp. lte: o tempo de expiração é anterior ou igual ao timestamp. gt: o tempo de expiração é posterior ao timestamp. gte: o tempo de expiração é igual ou posterior ao timestamp. eq: o tempo de expiração é igual ao timestamp. neq: o tempo de expiração não é igual ao timestamp.

Parâmetros de solicitação

**Tabela 2** Parâmetros no cabeçalho da 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

**Tabela 3** Parâmetros no corpo da resposta
Parâmetro	Tipo	Descrição
links	Object	Informações sobre o link do recurso.
users	Array of objects	Informações do usuário do IAM.

**Tabela 4** links
Parâmetro	Tipo	Descrição
self	String	Link de recursos.
previous	String	Link do recurso anterior.
next	String	Próximo link de recurso.

**Tabela 5** users
Parâmetro	Tipo	Descrição
name	String	Nome de usuário do IAM.
links	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.

**Tabela 6** users.links
Parâmetro	Tipo	Descrição
self	String	Link de recursos.
previous	String	Link do recurso anterior.
next	String	Próximo link de recurso.

Exemplo de solicitação

GET https://iam.myhuaweicloud.com/v3/users

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.