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

Consulta de detalhes do grupo de usuários

Função

Essa API é fornecida para que o administrador consulte informações do grupo 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/{group_id}

Tabela 1 Parâmetros de URI

Parâmetro

Obrigatório

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

group

Object

Informações do grupo de usuários.
Tabela 4 group

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 group.links

Parâmetro

Tipo

Descrição

self

String

Link de recurso.

previous

String

Link de recurso anterior.

next

String

Próximo link de recurso.

Exemplo de solicitação

Solicitação para consultar detalhes do grupo de usuários

GET https://iam.myhuaweicloud.com/v3/groups/{group_id}

Exemplo de resposta

Código de status: 200

A solicitação foi bem-sucedida.

{
    "group": {
        "domain_id": "d78cbac186b744899480f25bd02...",
        "create_time": 1578107542861,
        "name": "IAMGroup",
        "description": "",
        "links": {
            "next": null,
            "previous": null,
            "self": "https://iam.myhuaweicloud.com/v3/groups/07609e7eb200250a3f7dc003cb7a..."
        },
        "id": "07609e7eb200250a3f7dc003cb7..."
    }
}

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.

Códigos de erro

Nenhum