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 grupos de usuários/Listagem de grupos de usuários
Atualizado em 2024-08-31 GMT+08:00
Ver PDF
Compartilhar

Listagem de grupos de usuários

Função

Esta API é fornecida para que o administrador liste todos os grupos de usuários.

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/groups

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.

name

Não

String

Nome do grupo de usuários, que contém de 1 a 128 caracteres. Para obter detalhes sobre como obter o nome do grupo, consulte Obtenção de informações sobre 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

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

groups

Array of objects

Informações do grupo de usuários.

links

Object

Informações do link do recurso.

Tabela 4 groups

Parâmetro

Tipo

Descrição

description

String

Descrição do grupo de usuários.

id

String

ID do grupo de usuários.

domain_id

String

ID da conta à qual o grupo de usuários pertence.

name

String

Nome do grupo de usuários.

links

Object

Link de recurso do grupo de usuários.

create_time

Long

Hora em que o grupo de usuários foi criado.

Tabela 5 groups.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 6 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 consultar uma lista de grupos de usuários

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

Exemplo de resposta

Código de status: 200

A solicitação foi bem-sucedida.

{
    "groups": [
        {
            "domain_id": "d78cbac186b744899480f25bd02...",
            "create_time": 1536293929624,
            "name": "IAMGroupA",
            "description": "IAMDescription",
            "links": {
                "next": null,
                "previous": null,
                "self": "https://iam.myhuaweicloud.com/v3/groups/5b050baea9db472c88cbae67..."
            },
            "id": "5b050baea9db472c88cbae6..."
        },
        {
            "domain_id": "d78cbac186b744899480f25...",
            "create_time": 1578107542861,
            "name": "IAMGroupB",
            "description": "IAMDescription",
            "links": {
                "next": null,
                "previous": null,
                "self": "https://iam.myhuaweicloud.com/v3/groups/07609e7eb200250a3f7dc003cb7a4e2d"
            },
            "id": "07609e7eb200250a3f7dc003cb..."
        }
    ],
    "links": {
        "next": null,
        "previous": null,
        "self": "https://iam.myhuaweicloud.com/v3/groups"
    }
}

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.

Códigos de erro

Nenhum