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/ Consulta dos usuários do IAM em um grupo

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

Ver PDF

Consulta dos usuários do IAM em um grupo

Função

Essa API pode ser usada pelo administrador para consultar os usuários do IAM em um grupo de usuários.

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/groups/{group_id}/users

**Tabela 1** Parâmetros de URI
Parâmetro	Obrigatoriedade	Tipo	Descrição
group_id	Sim	String	ID do grupo de usuários. Para obter detalhes sobre como obter um ID de grupo de usuários, consulte Obtenção de informações de conta, usuário do IAM, grupo, projeto, região e agência.

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	Link de recurso do grupo de usuários.
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	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 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 pela última vez antes de sair do sistema.
pwd_strength	String	Força da senha. O valor pode ser high, mid ou low.
extra	object	Outras informações sobre o usuário do IAM.

**Tabela 6** users.extra
Parâmetro	Tipo	Descrição
description	string	Descrição do usuário do IAM.
last_project_id	string	ID do projeto que o usuário do IAM acessou pela última vez antes de sair do sistema.
pwd_status	boolean	Status da senha. true significa que a senha precisa ser alterada, false significa que a senha é normal.

**Tabela 7** 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/groups/{group_id}/users

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/groups/07609e7eb200250a3f7dc003cb7a4e2d/users"
    },
    "users": [
        {
            "pwd_status": true,
            "domain_id": "d78cbac186b744899480f25bd...",
            "last_project_id": "065a7c66da0010992ff7c0031e...",
             "name": "IAMUserA",
            "description": "--",
            "password_expires_at": null,
            "links": {
                "next": null,
                "previous": null,
                "self": "https://iam.myhuaweicloud.com/v3/users/07609fb9358010e21f7bc00375..."
            },
            "id": "07609fb9358010e21f7bc003751c7...",
            "enabled": true
        },
        {
            "pwd_status": true,
            "domain_id": "d78cbac186b744899480f25bd022...",
            "last_project_id": "065a7c66da0010992ff7c0031e5a...",
            "name": "IAMUserB",
            "description": "",
            "password_expires_at": null,
            "links": {
                "next": null,
                "previous": null,
                "self": "https://iam.myhuaweicloud.com/v3/users/076837351e80251c1f0fc003af..."
            },
            "id": "076837351e80251c1f0fc003afe43...",
            "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	Parâmetros inválidos.
403	Acesso negado.
404	O recurso solicitado não pode ser encontrado.