Ver Políticas de Acesso Unificadas

As políticas de acesso unificadas (UAPs) permitem conceder e negar aos principais o acesso aos recursos doGoogle Cloud . Neste documento, explicamos como visualizar UAPs e vinculações.

Antes de começar

  1. Configure a autenticação.

    Selecione a guia para como planeja usar as amostras nesta página:

    Console

    Quando você usa o console do Google Cloud para acessar os serviços e as APIs do Google Cloud , não é necessário configurar a autenticação.

    gcloud

    No console do Google Cloud , ative o Cloud Shell.

    Ativar o Cloud Shell

    Na parte inferior do console do Google Cloud , uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente shell com a CLI do Google Cloud já instalada e com valores já definidos para o projeto atual. A inicialização da sessão pode levar alguns segundos.

    REST

    Para usar as amostras da API REST desta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para a CLI gcloud.

      Instale a CLI do Google Cloud.

      Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

    Saiba mais em Autenticar para usar REST na documentação de autenticação do Google Cloud .

  2. Verifique se o faturamento está ativado para o projeto do Google Cloud .

  3. Opcional: leia a visão geral dos UAPs.

Papéis necessários para visualizar as Políticas de Acesso Unificadas

Para receber as permissões necessárias para visualizar UAPs, peça ao administrador para conceder a você o papel do IAM de Leitor de políticas de acesso (roles/iam.accessPolicyViewer) no projeto, na pasta ou na organização que possui a UAP que você quer visualizar. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém as permissões necessárias para visualizar UAPs. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para visualizar UAPs:

  • iam.accesspolicies.get
  • iam.accessPolicies.list

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Papéis necessários para visualizar as vinculações da Política de Acesso Unificada

Para receber as permissões necessárias para visualizar vinculações, peça ao administrador para conceder a você os seguintes papéis do IAM no recurso pai das vinculações:

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esses papéis predefinidos contêm as permissões necessárias para visualizar vinculações. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para visualizar as vinculações:

  • Ver uma única vinculação: iam.policybindings.get
  • Liste as vinculações que têm como pai um projeto, uma pasta ou uma organização: iam.policybindings.list

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Papéis necessários para visualizar todas as vinculações de uma Política de Acesso Unificada

Para receber a permissão necessária para visualizar todas as vinculações de uma UAP, peça ao administrador para conceder a você o papel do IAM de Leitor de políticas de acesso (roles/iam.accessPolicyViewer) no recurso que possui a UAP. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém a permissão iam.accesspolicies.searchPolicyBindings, que é necessária para visualizar todas as vinculações de um UAP.

Também é possível receber essa permissão com papéis personalizados ou outros papéis predefinidos.

Papéis para visualizar todas as vinculações de um recurso

Para receber as permissões necessárias para visualizar todas as vinculações que incluem um recurso de destino específico, peça ao administrador para conceder a você um papel que permita listar vinculações para esse recurso. Esse papel precisa incluir a permissão SERVICE.RESOURCE.searchPolicyBindings, em que RESOURCE é o tipo de recurso de destino e SERVICE é o serviço que possui o recurso.

Para encontrar um papel que inclua a permissão necessária, pesquise a permissão na referência de papéis e permissões, clique no nome da permissão e analise os papéis que a incluem.

Você precisa desse papel no recurso de destino ou em um dos ancestrais dele.

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Listar políticas de acesso unificadas em um projeto, uma pasta ou uma organização

É possível listar todas as UAPs que têm como pai um projeto, uma pasta ou uma organização específicos usando o Google Cloud console, a CLI gcloud ou a API REST do IAM.

Console

  1. No console do Google Cloud , acesse a página Políticas de acesso unificadas.

    Acesse as políticas de acesso unificadas
  2. Selecione o projeto, a pasta ou a organização que possui as UAPs que você quer visualizar.

O console do Google Cloud exibe as UAPs que têm como pai ou estão vinculadas ao recurso selecionado.

gcloud

O comando gcloud iam access-policies list lista todas as UAPs que são filhas de um determinado recurso.

Antes de usar os dados do comando abaixo, faça estas substituições:

  • UAP_PARENT_RESOURCE_TYPE: o tipo de recurso do Resource Manager (projeto, pasta ou organização) que é proprietário das UAPs que você quer listar. Use o valor project, folder ou organization.
  • UAP_PARENT_RESOURCE_ID: o ID do projeto, da pasta ou da organização que possui as UAPs que você quer listar. Os IDs do projeto são strings alfanuméricas, como my-project. Os IDs de pastas e organizações são numéricos, como 123456789012.
  • FORMAT: o formato da resposta. Use json ou yaml.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

gcloud iam access-policies list --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID \
    --location=global --format=FORMAT

Windows (PowerShell)

gcloud iam access-policies list --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID `
    --location=global --format=FORMAT

Windows (cmd.exe)

gcloud iam access-policies list --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ^
    --location=global --format=FORMAT

A resposta contém as UAPs que são filhas do recurso na solicitação.

{
  "accessPolicies": [
    {
      "createTime": "2026-08-31T21:43:39.822441Z",
      "details": {
        "rules": [
          {
            "conditions": {
              "iam.googleapis.com": {
                "expression": "resource.matchTag('environment', 'prod')"
              }
            },
            "description": "Grant non-delete compute permissions to compute admins in prod",
            "effect": "ALLOW",
            "excludedPrincipals": [
              "principal://goog/subject/access-restricted@example.com"
            ],
            "operation": {
              "excludedPermissions": [
                "*/*.delete"
              ],
              "permissions": [
                "role:roles/compute.admin"
              ]
            },
            "principals": [
              "principalSet://goog/group/compute-admins@example.com"
            ]
          }
        ]
      },
      "displayName": "Example policy 1",
      "etag": "W/\"YZtdQgtulCVzvTwlBTFjPQ==\"",
      "name": "projects/0123456789012/locations/global/accessPolicies/example-policy",
      "uid": "puid_0123456789012345678",
      "updateTime": "2026-08-31T21:43:39.822441Z"
    },
    {
      "createTime": "2026-05-29T23:25:01.606730Z",
      "details": {
        "rules": [
          {
            "description": "Deny group from publishing to message buses",
            "effect": "DENY",
            "operation": {
              "permissions": [
                "eventarc.googleapis.com/messageBuses.publish"
              ]
            },
            "principals": [
              "principalSet://goog/group/example-group@example.com"
            ]
          }
        ]
      },
      "displayName": "Example policy 2",
      "etag": "d6BJBTsk2+oDCygmr5ANxA==",
      "name": "organizations/123456789012/locations/global/accessPolicies/example-policy-2",
      "uid": "puid_13064942519001808897",
      "updateTime": "2026-05-29T23:25:01.606730Z"
    }
  ]
}

REST

O método accessPolicies.list lista todas as UAPs que são filhas de um determinado recurso.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • UAP_PARENT_RESOURCE_TYPE: o tipo de recurso do Resource Manager (projeto, pasta ou organização) que é proprietário das UAPs que você quer listar. Use o valor projects, folders ou organizations.
  • UAP_PARENT_RESOURCE_ID: o ID do projeto, da pasta ou da organização que possui as UAPs que você quer listar. Os IDs do projeto são strings alfanuméricas, como my-project. Os IDs de pastas e organizações são numéricos, como 123456789012.

Método HTTP e URL:

GET https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies

Para enviar a solicitação, expanda uma destas opções:

A resposta contém as UAPs que são filhas do recurso na solicitação.

{
  "accessPolicies": [
    {
      "name": "projects/0123456789012/locations/global/accessPolicies/example-policy",
      "uid": "puid_0123456789012345678",
      "etag": "W/\"YZtdQgtulCVzvTwlBTFjPQ==\"",
      "displayName": "Example policy",
      "createTime": "2026-08-31T21:43:39.822441Z",
      "updateTime": "2026-08-31T21:43:39.822441Z",
      "details": {
        "rules": [
          {
            "principals": [
              "principalSet://goog/group/compute-admins@example.com"
            ],
            "excludedPrincipals": [
              "principal://goog/subject/access-restricted@example.com"
            ],
            "operation": {
              "permissions": [
                "role:roles/compute.admin"
              ],
              "excludedPermissions": [
                "*/*.delete"
              ]
            },
            "conditions": {
              "iam.googleapis.com": {
                "expression": "resource.matchTag('environment', 'prod')"
              }
            },
            "description": "Grant non-delete compute permissions to compute admins in prod",
            "effect": "ALLOW"
          }
        ]
      }
    },
    {
      "name": "organizations/123456789012/locations/global/accessPolicies/example-policy-2",
      "uid": "puid_13064942519001808897",
      "etag": "d6BJBTsk2+oDCygmr5ANxA==",
      "displayName": "Example policy 2",
      "createTime": "2026-05-29T23:25:01.606730Z",
      "updateTime": "2026-05-29T23:25:01.606730Z",
      "details": {
        "rules": [
          {
            "description": "Deny group from publishing to message buses",
            "principals": [
              "principalSet://goog/group/example-group@example.com"
            ],
            "operation": {
              "permissions": [
                "eventarc.googleapis.com/messageBuses.publish"
              ]
            },
            "effect": "DENY"
          }
        ]
      }
    }
  ]
}

Receber uma única Política de Acesso Unificada

É possível conferir os detalhes de uma única UAP usando o console doGoogle Cloud , a CLI gcloud ou a API REST do IAM.

Console

  1. No console do Google Cloud , acesse a página Políticas de acesso unificadas.

    Acesse as políticas de acesso unificadas
  2. Selecione o projeto, a pasta ou a organização que possui a UAP com os detalhes que você quer ver.
  3. Clique no ID da política da UAP com os detalhes que você quer ver.

O console do Google Cloud mostra os detalhes da UAP, incluindo o ID, o horário de criação, o horário da última atualização e a lista de regras.

gcloud

O comando gcloud iam access-policies describe recebe um único UAP.

Antes de usar os dados do comando abaixo, faça estas substituições:

  • UAP_ID: o ID da UAP que você quer receber, por exemplo, example-policy.
  • UAP_PARENT_RESOURCE_TYPE: o tipo de recurso do Resource Manager (projeto, pasta ou organização) que é proprietário da UAP que você quer receber. Use o valor project, folder ou organization
  • UAP_PARENT_RESOURCE_ID: o ID do projeto, da pasta ou da organização que é proprietária da UAP que você quer receber. Os IDs do projeto são strings alfanuméricas, como my-project. Os IDs de pastas e organizações são numéricos, como 123456789012.
  • FORMAT: o formato da resposta. Use json ou yaml.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

gcloud iam access-policies describe UAP_ID \
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID \
    --location=global --format=FORMAT

Windows (PowerShell)

gcloud iam access-policies describe UAP_ID `
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID `
    --location=global --format=FORMAT

Windows (cmd.exe)

gcloud iam access-policies describe UAP_ID ^
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ^
    --location=global --format=FORMAT

A resposta contém o UAP especificado na solicitação.

{
  "createTime": "2026-08-31T21:43:39.822441Z",
  "details": {
    "rules": [
      {
        "conditions": {
          "iam.googleapis.com": {
            "expression": "resource.matchTag('environment', 'prod')"
          }
        },
        "description": "Grant non-delete compute permissions to compute admins in prod",
        "effect": "ALLOW",
        "excludedPrincipals": [
          "principal://goog/subject/access-restricted@example.com"
        ],
        "operation": {
          "excludedPermissions": [
            "*/*.delete"
          ],
          "permissions": [
            "role:roles/compute.admin"
          ]
        },
        "principals": [
          "principalSet://goog/group/compute-admins@example.com"
        ]
      }
    ]
  },
  "displayName": "Example policy",
  "etag": "W/\"YZtdQgtulCVzvTwlBTFjPQ==\"",
  "name": "projects/0123456789012/locations/global/accessPolicies/example-policy",
  "uid": "puid_0123456789012345678",
  "updateTime": "2026-08-31T21:43:39.822441Z"
}

REST

O método accessPolicies.get recebe uma única UAP.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • UAP_PARENT_RESOURCE_TYPE: o tipo de recurso do Resource Manager (projeto, pasta ou organização) que é proprietário da UAP que você quer receber. Use o valor projects, folders ou organizations
  • UAP_PARENT_RESOURCE_ID: o ID do projeto, da pasta ou da organização que é proprietária da UAP que você quer receber. Os IDs do projeto são strings alfanuméricas, como my-project. Os IDs de pastas e organizações são numéricos, como 123456789012.
  • UAP_ID: o ID da UAP que você quer receber, por exemplo, example-policy.

Método HTTP e URL:

GET https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies/UAP_ID

Para enviar a solicitação, expanda uma destas opções:

A resposta contém o UAP especificado na solicitação.

{
  "name": "projects/0123456789012/locations/global/accessPolicies/example-policy",
  "uid": "puid_0123456789012345678",
  "etag": "W/\"YZtdQgtulCVzvTwlBTFjPQ==\"",
  "displayName": "Example policy",
  "createTime": "2026-08-31T21:43:39.822441Z",
  "updateTime": "2026-08-31T21:43:39.822441Z",
  "details": {
    "rules": [
      {
        "principals": [
          "principalSet://goog/group/compute-admins@example.com"
        ],
        "excludedPrincipals": [
          "principal://goog/subject/access-restricted@example.com"
        ],
        "operation": {
          "permissions": [
            "role:roles/compute.admin"
          ],
          "excludedPermissions": [
            "*/*.delete"
          ]
        },
        "conditions": {
          "iam.googleapis.com": {
            "expression": "resource.matchTag('environment', 'prod')"
          }
        },
        "description": "Grant non-delete compute permissions to compute admins in prod",
        "effect": "ALLOW"
      }
    ]
  }
}

Listar vinculações para Políticas de Acesso Unificadas

É possível listar vinculações para UAPs de várias maneiras:

Listar vinculações de uma Política de Acesso Unificada

Para ver todas as vinculações que incluem um determinado UAP, pesquise as vinculações do UAP.

É possível ver todas as vinculações de uma UAP usando o console doGoogle Cloud , a CLI gcloud ou a API REST do IAM.

Console

  1. No console do Google Cloud , acesse a página Políticas de acesso unificadas.

    Acesse as políticas de acesso unificadas
  2. Selecione o projeto, a pasta ou a organização que possui o UAP com as vinculações que você quer visualizar.
  3. Clique no ID da política da UAP com as vinculações que você quer visualizar.
  4. Selecione a guia Vinculações.

O console do Google Cloud exibe uma lista das vinculações da UAP, com o nome de exibição e o recurso de destino de cada uma.

gcloud

O comando gcloud iam access-policies search-policy-bindings lista todas as vinculações do UAP especificado.

Antes de usar os dados do comando abaixo, faça estas substituições:

  • UAP_ID: o ID da UAP que você quer listar as vinculações, por exemplo, example-policy.
  • UAP_PARENT_RESOURCE_TYPE: o tipo de recurso do Resource Manager (projeto, pasta ou organização) que possui o UAP para o qual você quer listar as vinculações. Use o valor project, folder ou organization.
  • UAP_PARENT_RESOURCE_ID: o ID do projeto, da pasta ou da organização que é proprietária da UAP para listar as vinculações. Os IDs do projeto são strings alfanuméricas, como my-project. Os IDs de pastas e IDs da organização são numéricos, como 123456789012.
  • FORMAT: o formato da resposta. Use json ou yaml.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

gcloud iam access-policies search-policy-bindings UAP_ID \
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID \
    --location=global --format=FORMAT

Windows (PowerShell)

gcloud iam access-policies search-policy-bindings UAP_ID `
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID `
    --location=global --format=FORMAT

Windows (cmd.exe)

gcloud iam access-policies search-policy-bindings UAP_ID ^
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ^
    --location=global --format=FORMAT

A resposta contém as vinculações da UAP especificada.

{
  "policyBindings": [
    {
      "createTime": "2026-05-06T18:08:24.729843Z",
      "displayName": "Example binding 1",
      "etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding1",
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-policy",
      "policyKind": "ACCESS",
      "policyUid": "puid_9519202237377675265",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
      },
      "uid": "buid_9904260005517852673", 
      "updateTime": "2026-05-06T18:08:24.729843Z"
    },
    {
      "createTime": "2026-05-07T07:05:06.203861Z",
      "displayName": "Example binding 2",
      "etag": "W/\"cRMdDXbT82aLuZlvoL9Gqg==\"",
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding2",
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-policy",
      "policyKind": "ACCESS",
      "policyUid": "puid_9519202237377675265",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/projects/example-project"
      },
      "uid": "buid_4331055466646863873", 
      "updateTime": "2026-05-07T07:05:06.203861Z"
    }
  ]
}

REST

O método accessPolicies.searchPolicyBindings lista todas as vinculações do UAP especificado.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • UAP_PARENT_RESOURCE_TYPE: o tipo de recurso do Resource Manager (projeto, pasta ou organização) que possui o UAP para o qual você quer listar as vinculações. Use o valor projects, folders ou organizations.
  • UAP_PARENT_RESOURCE_ID: o ID do projeto, da pasta ou da organização que é proprietária da UAP para listar as vinculações. Os IDs do projeto são strings alfanuméricas, como my-project. Os IDs de pastas e IDs da organização são numéricos, como 123456789012.
  • UAP_ID: o ID da UAP que você quer listar as vinculações, por exemplo, example-policy.

Método HTTP e URL:

GET https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies/UAP_ID:searchPolicyBindings

Para enviar a solicitação, expanda uma destas opções:

A resposta contém as vinculações da UAP especificada.

{
  "policyBindings": [
    {
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding1",
      "uid": "buid_9904260005517852673", 
      "etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
      "displayName": "Example binding 1",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
      },
      "policyKind": "ACCESS",
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-policy",
      "policyUid": "puid_9519202237377675265",
      "createTime": "2026-05-06T18:08:24.729843Z",
      "updateTime": "2026-05-06T18:08:24.729843Z"
    },
    {
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding2",
      "uid": "buid_4331055466646863873", 
      "etag": "W/\"cRMdDXbT82aLuZlvoL9Gqg==\"",
      "displayName": "Example binding 2",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/projects/example-project"
      },
      "policyKind": "ACCESS",
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-policy",
      "policyUid": "puid_9519202237377675265",
      "createTime": "2026-05-07T07:05:06.203861Z",
      "updateTime": "2026-05-07T07:05:06.203861Z"
    }
  ]
}

Listar todas as vinculações de um recurso

Para ver todas as vinculações que incluem um recurso de destino específico, pesquise as vinculações desse recurso.

Cada vinculação contém o ID do UAP vinculado ao recurso. Para conferir os detalhes de uma política, use o ID dela para acessar os detalhes.

É possível ver todas as vinculações de um recurso usando o Google Cloud console, a CLI gcloud ou a API REST do IAM.

Console

  1. No console do Google Cloud , acesse a página Políticas de acesso unificadas.

    Acesse as políticas de acesso unificadas
  2. Selecione o projeto, a pasta ou a organização com as vinculações que você quer visualizar.
  3. No campo Filtro, insira o filtro Aplicação: Aplicado.

A tabela mostra todas as UAPs vinculadas ao recurso.

gcloud

O comando gcloud iam policy-bindings search-target-policy-bindings recebe todas as vinculações de UAP que incluem o recurso.

Antes de usar os dados do comando abaixo, faça estas substituições:

  • BINDING_PARENT_RESOURCE_TYPE: o tipo de recurso do Resource Manager (projeto, pasta ou organização) que gera vinculações para o recurso de destino. Use o valor project, folder ou organization.

    Para saber quais recursos são pai de quais vinculações, consulte Recursos compatíveis.

  • BINDING_PARENT_RESOURCE_ID: o ID do projeto, da pasta ou da organização que gera as vinculações para o recurso de destino. Os IDs do projeto são strings alfanuméricas, como my-project. Os IDs de pastas e organizações são numéricos, como 123456789012.
  • TARGET_RESOURCE: o recurso com as vinculações que você quer listar. Para ver uma lista de recursos válidos, consulte Recursos compatíveis.
  • FORMAT: o formato da resposta. Use json ou yaml.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

gcloud iam policy-bindings search-target-policy-bindings \
    --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID \
    --target=TARGET_RESOURCE \
    --format=FORMAT

Windows (PowerShell)

gcloud iam policy-bindings search-target-policy-bindings `
    --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID `
    --target=TARGET_RESOURCE `
    --format=FORMAT

Windows (cmd.exe)

gcloud iam policy-bindings search-target-policy-bindings ^
    --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID ^
    --target=TARGET_RESOURCE ^
    --format=FORMAT

A resposta contém todas as vinculações de UAP que incluem o recurso de destino.

{
  "policyBindings": [
    {
      "createTime": "2026-05-06T18:08:24.729843Z",
      "displayName": "Example binding 1",
      "etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding1",
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-policy-1",
      "policyKind": "ACCESS",
      "policyUid": "puid_9519202237377675265",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
      },
      "uid": "buid_9904260005517852673", 
      "updateTime": "2026-05-06T18:11:16.798841Z"
    },
    {
      "createTime": "2026-05-06T18:08:24.729843Z",
      "displayName": "Example binding 2",
      "etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding2",
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-policy-2",
      "policyKind": "ACCESS",
      "policyUid": "puid_10358560617928851457",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
      },
      "uid": "buid_4331055466646863873", 
      "updateTime": "2026-05-06T18:11:16.798841Z"
    }
  ]
}

REST

O método SearchTargetPolicyBindings.search recebe todas as vinculações de UAP que incluem o recurso.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • BINDING_PARENT_RESOURCE_TYPE: o tipo de recurso do Resource Manager (projeto, pasta ou organização) que gera vinculações para o recurso de destino. Use o valor projects, folders ou organizations.

    Para saber quais recursos são pai de quais vinculações, consulte Recursos compatíveis.

  • BINDING_PARENT_RESOURCE_ID: o ID do projeto, da pasta ou da organização que gera as vinculações para o recurso de destino. Os IDs do projeto são strings alfanuméricas, como my-project. Os IDs de pastas e organizações são numéricos, como 123456789012.
  • TARGET_RESOURCE: o recurso com as vinculações que você quer listar. Para ver uma lista de recursos válidos, consulte Recursos compatíveis.

Método HTTP e URL:

GET https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings:searchTargetPolicyBindings?target=TARGET_RESOURCE

Para enviar a solicitação, expanda uma destas opções:

A resposta contém todas as vinculações de UAP que incluem o recurso de destino.

{
  "policyBindings": [
    {
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding1",
      "uid": "buid_9904260005517852673", 
      "etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
      "displayName": "Example binding 1",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
      },
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-policy-1",
      "createTime": "2026-05-06T18:08:24.729843Z",
      "updateTime": "2026-05-06T18:11:16.798841Z",
      "policyKind": "ACCESS",
      "policyUid": "puid_9519202237377675265"
    },
    {
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding2",
      "uid": "buid_4331055466646863873", 
      "etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
      "displayName": "Example binding 2",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
      },
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-policy-2",
      "createTime": "2026-05-06T18:08:24.729843Z",
      "updateTime": "2026-05-06T18:11:16.798841Z",
      "policyKind": "ACCESS",
      "policyUid": "puid_10358560617928851457"
    }
  ]
}

Listar todas as vinculações em um projeto, uma pasta ou uma organização

Se você estiver usando a CLI gcloud ou a API REST do IAM para visualizar as vinculações, também será possível listar todas as vinculações que são filhas de um projeto, uma pasta ou uma organização específica.

Listar as vinculações de um projeto, uma pasta ou uma organização é semelhante a pesquisar as vinculações desse recurso. No entanto, ao contrário da pesquisa de vinculações, a listagem de vinculações de um recurso também inclui todas as vinculações que são filhas imediatas desse recurso.

Por exemplo, imagine que você tenha uma vinculação que anexa uma política a um gateway de agente da API Network Services. O recurso pai dessa vinculação é o projeto pai do gateway de agente. Em outras palavras, a vinculação é um filho imediato do projeto. Como resultado, se você listar as vinculações desse projeto, a resposta vai incluir a vinculação do gateway de agente. No entanto, se você listar as vinculações da organização mãe do projeto, a resposta não vai incluir a vinculação. Isso ocorre porque, embora a vinculação seja descendente da organização, ela não é filha imediata da organização.

O recurso pai de uma vinculação depende do recurso de destino na vinculação. Para saber mais, consulte Recursos compatíveis.

Cada vinculação contém o ID do UAP vinculado ao recurso. Para conferir os detalhes de uma política, use o ID dela para acessar os detalhes.

É possível ver todas as vinculações que são filhas de um projeto, uma pasta ou uma organização usando a CLI gcloud ou a API REST do IAM.

gcloud

O comando gcloud iam policy-bindings list lista todas as vinculações de UAP que são filhas de um determinado recurso.

Antes de usar os dados do comando abaixo, faça estas substituições:

  • BINDING_PARENT_RESOURCE_TYPE: o tipo de recurso do Resource Manager (projeto, pasta ou organização) do qual a vinculação é filha. Use o valor project, folder ou organization.

    O recurso pai da vinculação depende do recurso de destino na vinculação. Consulte Recursos suportados para saber mais.

  • BINDING_PARENT_RESOURCE_ID: o ID do projeto, da pasta ou da organização de que a vinculação de políticas é filha. Os IDs do projeto são strings alfanuméricas, como my-project. Os IDs de pastas e organizações são numéricos, como 123456789012.
  • FORMAT: o formato da resposta. Use json ou yaml.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

gcloud iam policy-bindings list --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID \
    --location=global \
    --filter=policyKind:ACCESS \
    --format=FORMAT

Windows (PowerShell)

gcloud iam policy-bindings list --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID `
    --location=global `
    --filter=policyKind:ACCESS `
    --format=FORMAT

Windows (cmd.exe)

gcloud iam policy-bindings list --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID ^
    --location=global ^
    --filter=policyKind:ACCESS ^
    --format=FORMAT

A resposta contém as vinculações de UAP que são filhas do recurso no comando.

{
  "policyBindings": [
    {
      "createTime": "2026-05-06T18:08:24.729843Z",
      "displayName": "Example binding 1",
      "etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding-1",
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-1",
      "policyKind": "ACCESS",
      "policyUid": "puid_9519202237377675265",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
      },
      "uid": "buid_9904260005517852673", 
      "updateTime": "2026-05-06T18:08:24.729843Z"
    },
    {
      "createTime": "2026-05-07T07:05:06.203861Z",
      "displayName": "Example binding 2",
      "etag": "W/\"cRMdDXbT82aLuZlvoL9Gqg==\"",
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding-2",
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-2",
      "policyKind": "ACCESS",
      "policyUid": "puid_1566408245394800641",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
      },
      "uid": "buid_4331055466646863873", 
      "updateTime": "2026-05-07T07:05:06.203861Z"
    }
  ]
}

REST

O método policyBindings.list lista todas as vinculações de UAP que são filhas de um determinado recurso.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • BINDING_PARENT_RESOURCE_TYPE: o tipo de recurso do Resource Manager (projeto, pasta ou organização) do qual a vinculação é filha. Use o valor projects, folders ou organizations.

    O recurso pai da vinculação depende do recurso de destino na vinculação. Consulte Recursos suportados para saber mais.

  • BINDING_PARENT_RESOURCE_ID: o ID do projeto, da pasta ou da organização de que a vinculação de políticas é filha. Os IDs do projeto são strings alfanuméricas, como my-project. Os IDs de pastas e organizações são numéricos, como 123456789012.

Método HTTP e URL:

GET https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings?filter=policyKind:ACCESS

Para enviar a solicitação, expanda uma destas opções:

A resposta contém as vinculações de UAP que são filhas do recurso na solicitação.

{
  "policyBindings": [
    {
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding-1",
      "uid": "buid_9904260005517852673", 
      "etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
      "displayName": "Example binding 1",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
      },
      "policyKind": "ACCESS",
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-1",
      "policyUid": "puid_9519202237377675265",
      "createTime": "2026-05-06T18:08:24.729843Z",
      "updateTime": "2026-05-06T18:08:24.729843Z"
    },
    {
      "name": "organizations/123456789012/locations/global/policyBindings/example-binding-2",
      "uid": "buid_4331055466646863873", 
      "etag": "W/\"cRMdDXbT82aLuZlvoL9Gqg==\"",
      "displayName": "Example binding 2",
      "target": {
        "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
      },
      "policyKind": "ACCESS",
      "policy": "organizations/123456789012/locations/global/accessPolicies/example-uap-2",
      "policyUid": "puid_1566408245394800641",
      "createTime": "2026-05-07T07:05:06.203861Z",
      "updateTime": "2026-05-07T07:05:06.203861Z"
    }
  ]
}

Receber uma vinculação para uma Política de Acesso Unificada

É possível ver os detalhes de uma vinculação usando o console do Google Cloud , a CLI gcloud ou a API REST do IAM.

Console

  1. No console do Google Cloud , acesse a página Políticas de acesso unificadas.

    Acesse as políticas de acesso unificadas
  2. Selecione o projeto, a pasta ou a organização que possui o UAP com as vinculações que você quer visualizar.
  3. Clique no ID da política da UAP com as vinculações que você quer visualizar.
  4. Selecione a guia Vinculações.
  5. Encontre a vinculação usando o ID ou o nome dela.

A tabela mostra os detalhes da vinculação, incluindo o ID, o nome e o recurso de destino.

gcloud

O comando gcloud iam policy-bindings describe recebe uma vinculação.

Antes de usar os dados do comando abaixo, faça estas substituições:

  • BINDING_ID: o ID da vinculação que você quer receber, por exemplo, example-binding.
  • BINDING_PARENT_RESOURCE_TYPE: o tipo de recurso do Resource Manager (projeto, pasta ou organização) do qual a vinculação é filha. Use o valor project, folder ou organization.

    O recurso pai da vinculação depende do recurso de destino na vinculação. Consulte Recursos suportados para saber mais.

  • BINDING_PARENT_RESOURCE_ID: o ID do projeto, da pasta ou da organização de que a vinculação de políticas é filha. Os IDs do projeto são strings alfanuméricas, como my-project. Os IDs de pastas e organizações são numéricos, como 123456789012.
  • FORMAT: o formato da resposta. Use json ou yaml.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

gcloud iam policy-bindings describe BINDING_ID \
    --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID \
    --location=global --format=FORMAT

Windows (PowerShell)

gcloud iam policy-bindings describe BINDING_ID `
    --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID `
    --location=global --format=FORMAT

Windows (cmd.exe)

gcloud iam policy-bindings describe BINDING_ID ^
    --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID ^
    --location=global --format=FORMAT

A resposta contém a vinculação.

{
  "createTime": "2026-05-06T18:08:24.729843Z",
  "displayName": "Example binding",
  "etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
  "name": "organizations/123456789012/locations/global/policyBindings/example-binding",
  "policy": "organizations/123456789012/locations/global/accessPolicies/example-uap",
  "policyKind": "ACCESS",
  "policyUid": "puid_9519202237377675265",
  "target": {
    "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
  },
  "uid": "buid_9904260005517852673", 
  "updateTime": "2026-05-06T18:08:24.729843Z"
}

REST

O método policyBindings.get recebe uma vinculação.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • BINDING_PARENT_RESOURCE_TYPE: o tipo de recurso do Resource Manager (projeto, pasta ou organização) do qual a vinculação é filha. Use o valor projects, folders ou organizations.

    O recurso pai da vinculação depende do recurso de destino na vinculação. Consulte Recursos suportados para saber mais.

  • BINDING_PARENT_RESOURCE_ID: o ID do projeto, da pasta ou da organização de que a vinculação de políticas é filha. Os IDs do projeto são strings alfanuméricas, como my-project. Os IDs de pastas e organizações são numéricos, como 123456789012.
  • BINDING_ID: o ID da vinculação que você quer receber, por exemplo, example-binding.

Método HTTP e URL:

GET https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings/BINDING_ID

Para enviar a solicitação, expanda uma destas opções:

A resposta contém a vinculação.

{
  "name": "organizations/123456789012/locations/global/policyBindings/example-binding",
  "uid": "buid_9904260005517852673", 
  "etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
  "displayName": "Example binding",
  "target": {
    "resource": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
  },
  "policyKind": "ACCESS",
  "policy": "organizations/123456789012/locations/global/accessPolicies/example-uap",
  "policyUid": "puid_9519202237377675265",
  "createTime": "2026-05-06T18:08:24.729843Z",
  "updateTime": "2026-05-06T18:08:24.729843Z"
}

A seguir