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/ APIs desatualizadas/ Consulta das permissões de um grupo de usuários vinculado a um projeto empresarial
Atualizado em 2024-08-31 GMT+08:00

Consulta das permissões de um grupo de usuários vinculado a um projeto empresarial

Função

Essa API é usada para consultar as permissões de um grupo de usuários vinculado ao projeto empresarial de um ID especificado.

Essa API pode ser invocada usando o nome de domínio global iam.myhuaweicloud.com.

Esta API será descontinuada em breve. Em vez disso, use a API descrita em Consulta das permissões de um grupo de usuários vinculado a um projeto empresarial.

URI

  • Formato de URI

    GET /v3.0/OS-PAP/enterprise-projects/{enterprise_project_id}/groups/{group_id}/roles

  • Descrição do parâmetro 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.

    group_id

    Sim

    String

    ID de um grupo de usuários vinculado ao projeto empresarial.

Solicitação

  • Descrição do parâmetro do cabeçalho da solicitação

    Parâmetro

    Obrigatório

    Tipo

    Descrição

    X-Auth-Token

    Sim

    String

    Token autenticado com permissões de Security Administrator.

    Content-Type

    Sim

    String

    Preencha application/json;charset=utf8 nesse campo.

  • Exemplo de solicitação
    curl -i -k -H "X-Auth-Token:$token" -H 'Content-Type:application/json;charset=utf8' -X GET https://iam.myhuaweicloud.com/v3.0/OS-PAP/enterprise-projects/535fb147-6148-4c71-a679-b79a2cb0e.../groups/10d8104f395d43468094753f28692.../roles

Resposta

  • Descrição do parâmetro do corpo de resposta

    Parâmetro

    Obrigatório

    Tipo

    Descrição

    roles

    Sim

    JSONArray

    Informações de permissão.

  • Descrição para o formato da função

    Parâmetro

    Obrigatório

    Tipo

    Descrição

    display_name

    Sim

    String

    Nome de uma permissão exibida no console.

    description

    Sim

    String

    Descrição da permissão.

    description_cn

    Sim

    String

    Descrição da permissão.

    domain_id

    Sim

    String

    • Se uma política personalizada tiver sido vinculada ao grupo de usuários, o valor deste parâmetro é o ID da conta do usuário que cria a política personalizada.
    • Se uma política padrão tiver sido vinculada ao grupo de usuários, o valor desse parâmetro será nulo.

    flag

    Não

    String

    Uma tag para indicar uma função interna refinada.

    catalog

    Sim

    String

    Diretório ao qual a permissão pertence.

    • Se uma política personalizada tiver sido vinculada ao grupo de usuários, o valor desse parâmetro será CUSTOMED.
    • Se uma política padrão tiver sido vinculada ao grupo de usuários, o valor desse parâmetro será o nome de serviço correspondente, por exemplo, ECS.

    policy

    Sim

    Dict

    Detalhes sobre a permissão. Para obter mais informações, consulte Descrição para o formato da política.

    id

    Sim

    String

    ID de permissão.

    type

    Sim

    String

    Posição de exibição da permissão.

    • AX: exibida no projeto Global.
    • XA: exibida em projetos diferentes do projeto Global.
      NOTA:

      O valor deste parâmetro só pode ser AX ou XA, e não pode ser AA ou XX.

    name

    Sim

    String

    Nome da permissão usada no sistema.

  • Descrição para o formato da política

    Parâmetro

    Obrigatório

    Tipo

    Descrição

    Version

    Sim

    String

    Versão da política.

    Statement

    Sim

    JSONArray

    Declaração para usar a política para conceder permissões. Uma política consiste em um máximo de oito declarações. Um campo Statement contém os elementos Effect e Action.

  • Descrição para o formato da declaração

    Parâmetro

    Obrigatório

    Tipo

    Descrição

    Effect

    Sim

    String

    O valor pode ser Allow ou Deny. Se as declarações Allow e Deny forem encontradas em uma política, a autenticação começará a partir das declarações Deny.

    Action

    Sim

    StringArray

    Conjunto de permissões, que especifica as permissões de operações em recursos. O número de conjuntos de permissões não pode exceder 100.

    Formato:

    O formato do valor é Service name:Resource type:Action, por exemplo, vpc:ports:create.

    Service name: indica o nome do produto, como ecs, evs ou vpc. Somente letras minúsculas são permitidas.

    Resource type e Action: os valores não diferenciam maiúsculas de minúsculas e o caractere curinga (*) é permitido. Um caractere curinga (*) pode representar todas ou parte das informações sobre tipos de recursos e ações para o serviço específico.

  • Exemplo de resposta bem-sucedida
    { 
       "roles": [ 
         { 
           "display_name": "Customed ECS Viewer", 
           "description": "The read-only permissions to all ECS resources, which can be used for statistics and survey.", 
           "domain_id": "9698542758bc422088c0c3eabf...", 
           "catalog": "CUSTOMED", 
           "policy": { 
             "Version": "1.1", 
             "Statement": [ 
               { 
                 "Action": [ 
                   "ecs:*:get*", 
                   "ecs:*:list*", 
                   "ecs:blockDevice:use", 
                   "ecs:serverGroups:manage", 
                   "ecs:serverVolumes:use", 
                   "evs:*:get*", 
                   "evs:*:list*", 
                   "vpc:*:get*", 
                   "vpc:*:list*", 
                   "ims:*:get*", 
                   "ims:*:list*" 
                 ], 
                 "Effect": "Allow" 
               } 
             ] 
           }, 
           "id": "24e7a89bffe443979760c4e9715c1...", 
           "type": "XA", 
           "name": "custom_9698542758bc422088c0c3eabfc30d1..." 
         } 
       ] 
     }
  • Descrição do parâmetro do corpo da resposta de erro

    Parâmetro

    Obrigatório

    Tipo

    Descrição

    error

    Sim

    Dict

    Erro de resposta

    message

    Sim

    String

    Detalhes do erro

    code

    Sim

    Int

    Código de status

    title

    Sim

    String

    Tipo de erro

  • Exemplo de resposta falhada
    {
      "error": {
        "message": "Authentication failed",
        "code": 401,
        "title": "Unauthorized"
      }
    }

Códigos de status

Código de status

Descrição

200

A solicitação foi bem-sucedida.

400

O servidor falhou ao processar a solicitação.

401

É necessário inserir um nome de usuário e uma senha para acessar a página solicitada.

403

Acesso negado.

500

Falha ao concluir a solicitação devido a um erro de serviço interno.