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 2024-08-31 GMT+08:00
Ver PDF
Compartilhar

Listagem de usuários do IAM

Função

Essa 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 da região específica. 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

Obrigatório

Tipo

Descrição

domain_id

Não

String

ID da conta. Para obter detalhes sobre como obter o ID da conta, consulte Obtenção de informações sobre conta, usuário do IAM, grupo, projeto, região e agência.

enabled

Não

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.

name

Não

String

Nome de usuário do IAM.

password_expires_at

Não

String

Tempo de expiração da senha. O valor null indica que a senha nunca expirará.

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

Obrigatório

Tipo

Descrição

Content-Type

Sim

String

Preencha application/json;charset=utf8 nesse campo.

X-Auth-Token

Sim

String

Token de acesso emitido para um usuário para suportar sua identidade e permissões.

Para obter detalhes sobre as permissões exigidas pelo token, consulte Ações.

Parâmetros de resposta

Tabela 3 Parâmetros no corpo da resposta

Parâmetro

Tipo

Descrição

links

Object

Informações do 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 de 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 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 do IAM.

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.

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 de recurso anterior.

next

String

Próximo link de recurso.

Exemplo de solicitação

Solicitação para listar usuários do IAM como administradores

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

Para restringir o intervalo de consulta, adicione um parâmetro de caminho. 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

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

A entidade de solicitação é muito grande.

503

Serviço indisponível.

Códigos de erro

Nenhum