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 projetos corporativos/ Consulta de grupos de usuários vinculados a um projeto empresarial

Atualizado em 2024-08-31 GMT+08:00

Ver PDF

Consulta de grupos de usuários vinculados a um projeto empresarial

Função

Essa API é usada para consultar os grupos de usuários diretamente vinculados a um projeto empresarial especificado.

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.0/OS-PERMISSION/enterprise-projects/{enterprise_project_id}/groups

**Tabela 1** Parâmetros de URI
Parâmetro	Obrigatório	Tipo	Descrição
enterprise_project_id	Sim	String	ID do projeto empresarial para consultar as permissões de um grupo de usuários vinculado.

Parâmetros de solicitação

**Tabela 2** Parâmetros no cabeçalho da solicitação
Parâmetro	Obrigatório	Tipo	Descrição
X-Auth-Token	Sim	String	Token autenticado com permissão iam:permissions:listGroupsOnEnterpriseProject ou permissão de Security Administrator. O domain_id da conta à qual o enterprise_project_id pertence deve ser o mesmo que o domain_id no token.

Parâmetros de resposta

Código de status: 200

**Tabela 3** Parâmetros no corpo da resposta
Parâmetro	Tipo	Descrição
groups	Array of objects	Informações do grupo de usuários.

**Tabela 4** ListGroupsForEnterpriseProjectResDetail
Parâmetro	Tipo	Descrição
createTime	Integer	Hora em que o grupo de usuários foi criado.
description	String	Descrição do grupo de usuários.
domainId	String	ID da conta.
id	String	ID do grupo de usuários.
name	String	Nome do grupo de usuários.

Exemplo de solicitação

Solicitação para consultar grupos de usuários vinculados a um projeto empresarial

GET https://iam.myhuaweicloud.com/v3.0/OS-PERMISSION/enterprise-projects/{enterprise_project_id}/groups

Exemplo de resposta

Código de status: 200

A solicitação foi bem-sucedida.

{ 
  "groups" : [ { 
    "createTime" : 1552093271000, 
    "description" : null, 
    "domainId" : "dc7f62ae236c47b8836014c16d64d...", 
    "id" : "e6bde2403bda43e2813a1a6848963...", 
    "name" : "auth" 
  } ] 
}

Códigos de status

Código de status	Descrição
200	A solicitação foi bem-sucedida.
400	Erro de parâmetro.
401	Falha na autenticação.
403	Acesso negado.
404	O recurso solicitado não pode ser encontrado.
415	Tipo de conteúdo incorreto.
500	Ocorreu um erro no sistema.