As políticas de limite de acesso de principal (PAB) permitem limitar os recursos que um conjunto de principais pode acessar. Nesta página, explicamos como visualizar as políticas de limite de acesso de principal e as vinculações de políticas de limite de acesso de principal.
Antes de começar
Configure a autenticação.
Selecione a guia para como planeja usar as amostras nesta página:
gcloud
No console do Google Cloud , ative 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 .
Leia a visão geral das políticas de limite de acesso de principal.
Papéis necessários para visualizar políticas de limite de acesso de principal
Para receber as permissões necessárias para visualizar as políticas de limite de acesso de principal, peça ao administrador para conceder a você o papel do IAM de Leitor de limite de acesso de principal (roles/iam.principalAccessBoundaryViewer) na organização.
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 as políticas de limite de acesso de principal. 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 políticas de limite de acesso de principal:
-
Confira uma única política de limite de acesso de principal:
iam.principalaccessboundarypolicies.get -
Liste as políticas de limite de acesso de principal em uma organização:
iam.principalaccessboundarypolicies.list
Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.
Papéis necessários para visualizar vinculações de políticas
Para receber as permissões necessárias para visualizar as vinculações de política, peça ao administrador para conceder a você os seguintes papéis do IAM no recurso pai das vinculações de política:
-
Visualizar vinculações de política em um projeto:
Administrador do IAM do projeto (
roles/resourcemanager.projectIamAdmin) -
Ver vinculações de política em uma pasta:
Administrador do IAM da pasta (
roles/resourcemanager.folderIamAdmin) -
Ver vinculações de política em uma organização:
Administrador da organização (
roles/resourcemanager.organizationAdmin)
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 as vinculações de política. 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 de política:
-
Ver uma única vinculação de política:
iam.policybindings.get -
Liste as vinculações de política em 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 limite de acesso principal
Para receber a permissão necessária para visualizar todas as vinculações de uma política de limite de acesso de principal, peça ao administrador para conceder a você o papel do IAM de Leitor de limite de acesso de principal (roles/iam.principalAccessBoundaryViewer) na organização.
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.principalaccessboundarypolicies.searchIamPolicyBindings,
necessária para
visualizar todas as vinculações de uma política de limite de acesso de principal.
Também é possível receber essa permissão com papéis personalizados ou outros papéis predefinidos.
Papéis necessários para visualizar vinculações de políticas de um conjunto de principais
As permissões necessárias para visualizar todas as vinculações de política de um conjunto de principais dependem do conjunto de principais em que você quer visualizar as políticas.
Para receber as permissões necessárias para visualizar as vinculações de política, peça ao administrador para conceder a você os seguintes papéis do IAM:
-
Veja as vinculações de políticas para pools da federação de identidade de colaboradores:
Administrador de pool de colaboradores do IAM (
roles/iam.workforcePoolAdmin) no pool de federação de identidade de colaboradores de destino -
Ver as vinculações de políticas para pools de federação de identidade da carga de trabalho:
Administrador de pool de Identidade da carga de trabalho do IAM (
roles/iam.workloadIdentityPoolAdmin) no projeto que é proprietário do pool de federação de identidade da carga de trabalho de destino -
Ver vinculações de políticas para um domínio do Google Workspace:
Administrador do IAM do pool do Workspace (
roles/iam.workspacePoolAdmin) na organização -
Ver as vinculações de política do conjunto de principais de um projeto:
Administrador do IAM do projeto (
roles/resourcemanager.projectIamAdmin) no projeto -
Ver as vinculações de política do conjunto de principais de uma pasta:
Administrador do IAM da pasta (
roles/resourcemanager.folderIamAdmin) na pasta -
Visualizar as vinculações de política do conjunto de principais de uma organização:
Administrador da organização (
roles/resourcemanager.organizationAdmin) na organização
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 as vinculações de política. 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 de política:
-
Confira as vinculações de políticas para pools de federação de identidade de colaboradores:
iam.workforcePools.searchPolicyBindingsno pool de federação de identidade de colaboradores de destino -
Veja as vinculações de políticas para pools de federação de identidade da carga de trabalho:
iam.workloadIdentityPools.searchPolicyBindingsno projeto que é proprietário do pool de federação de identidade da carga de trabalho de destino -
Ver as vinculações de política de um domínio do Google Workspace:
iam.workspacePools.searchPolicyBindingsna organização -
Confira as vinculações de política do conjunto de principais de um projeto:
resourcemanager.projects.searchPolicyBindingsno projeto -
Confira as vinculações de política do conjunto de principal de uma pasta:
resourcemanager.folders.searchPolicyBindingsna pasta -
Ver as vinculações de política do conjunto de principais de uma organização:
resourcemanager.organizations.searchPolicyBindingsna organização
Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.
Listar políticas de limite de acesso de principal para uma organização
Para conferir todas as políticas de limite de acesso de principal criadas em uma organização, liste as políticas de limite de acesso de principal na organização.
É possível listar as políticas de limite de acesso de principal em uma organização usando o console doGoogle Cloud , a CLI gcloud ou a API REST do IAM.
Console
No console do Google Cloud , acesse a página Políticas de limite de acesso de principal.
Selecione a organização para visualizar as políticas de limite de acesso de principal.
O console do Google Cloud lista todas as políticas na organização que você selecionar.
gcloud
O comando
gcloud iam principal-access-boundary-policies list
lista todas as políticas de limite de acesso de principal em uma organização.
Antes de usar os dados do comando abaixo, faça estas substituições:
-
ORG_ID: o ID da organização do Google Cloud em que você quer listar as políticas de limite de acesso de principal. Os IDs da organização são numéricos, como123456789012. FORMAT: o formato da resposta. Usejsonouyaml.
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud iam principal-access-boundary-policies list --organization=ORG_ID \ --location=global --format=FORMAT
Windows (PowerShell)
gcloud iam principal-access-boundary-policies list --organization=ORG_ID ` --location=global --format=FORMAT
Windows (cmd.exe)
gcloud iam principal-access-boundary-policies list --organization=ORG_ID ^ --location=global --format=FORMAT
A resposta contém as políticas de limite de acesso de principal na organização especificada.
{
"principalAccessBoundaryPolicies": [
{
"createTime": "2026-07-07T00:05:48.295209Z",
"details": {
"enforcementVersion": "4",
"rules": [
{
"description": "Make principals eligible to manage but not delete Compute resources in example.com",
"effect": "ALLOW",
"resources": [
"//cloudresourcemanager.googleapis.com/organizations/123456789012"
]
}
]
},
"displayName": "Example policy 1",
"etag": "W/\"Gh/PcTdJD/AWHUhPW45kdw==\"",
"name": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-policy-1",
"uid": "puid_13364150419245236225",
"updateTime": "2026-07-07T00:05:48.295209Z"
},
{
"createTime": "2026-05-29T23:25:01.606730Z",
"details": {
"enforcementVersion": "4",
"rules": [
{
"description": "Make principals eligible to access resources in example-project",
"effect": "ALLOW",
"resources": [
"//cloudresourcemanager.googleapis.com/projects/example-project"
]
}
]
},
"displayName": "Example policy 2",
"etag": "d6BJBTsk2+oDCygmr5ANxA==",
"name": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-policy-2",
"uid": "puid_13064942519001808897",
"updateTime": "2026-05-29T23:25:01.606730Z"
}
]
}
REST
O método
principalAccessBoundaryPolicies.list
lista todas as políticas de limite de acesso de principal em uma organização.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
-
ORG_ID: o ID da organização do Google Cloud em que você quer listar as políticas de limite de acesso de principal. Os IDs da organização são numéricos, como123456789012.
Método HTTP e URL:
GET https://iam.googleapis.com/v3/organizations/ORG_ID/locations/global/principalAccessBoundaryPolicies
Para enviar a solicitação, expanda uma destas opções:
A resposta contém as políticas de limite de acesso de principal na organização especificada.
{
"principalAccessBoundaryPolicies": [
{
"name": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-policy-1",
"uid": "puid_13364150419245236225",
"etag": "W/\"Gh/PcTdJD/AWHUhPW45kdw==\"",
"displayName": "Example policy 1",
"createTime": "2026-07-07T00:05:48.295209Z",
"updateTime": "2026-07-07T00:05:48.295209Z",
"details": {
"rules": [
{
"description": "Make principals eligible to access resources in example.com",
"resources": [
"//cloudresourcemanager.googleapis.com/organizations/123456789012"
],
"effect": "ALLOW"
}
],
"enforcementVersion": "4"
}
},
{
"name": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/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": "Make principals eligible to access resources in example-project",
"resources": [
"//cloudresourcemanager.googleapis.com/projects/example-project"
],
"effect": "ALLOW"
}
],
"enforcementVersion": "4"
}
}
]
}
Receber uma única política de limite de acesso de principal
Para conferir os detalhes de uma única política de limite de acesso de principal, use o ID da política para acessá-la.
É possível receber uma Política de limite de acesso de principal usando o console do Google Cloud , a CLI gcloud ou a API REST do IAM.
Console
No console do Google Cloud , acesse a página Políticas de limite de acesso de principal.
Selecione a organização para visualizar as políticas de limite de acesso de principal.
Clique no ID da política de limite de acesso de principal que você quer visualizar.
O console do Google Cloud mostra os detalhes da política de limite de acesso de principal que você selecionou.
gcloud
O comando
gcloud iam principal-access-boundary-policies describe
retorna uma única política de limite de acesso de principal.
Antes de usar os dados do comando abaixo, faça estas substituições:
-
PAB_POLICY_ID: o ID da política de limite de acesso de principal que você quer receber, por exemplo,example-policy. ORG_ID: o ID da organização proprietária da política de limite de acesso de principal. Os IDs da organização são numéricos, como123456789012.FORMAT: o formato da resposta. Usejsonouyaml.
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud iam principal-access-boundary-policies describe PAB_POLICY_ID \ --organization=ORG_ID --location=global \ --format=FORMAT
Windows (PowerShell)
gcloud iam principal-access-boundary-policies describe PAB_POLICY_ID ` --organization=ORG_ID --location=global ` --format=FORMAT
Windows (cmd.exe)
gcloud iam principal-access-boundary-policies describe PAB_POLICY_ID ^ --organization=ORG_ID --location=global ^ --format=FORMAT
A resposta contém a política de limite de acesso de principal especificada na solicitação.
{
"createTime": "2026-07-07T00:05:48.295209Z",
"details": {
"enforcementVersion": "4",
"rules": [
{
"description": "Make principals eligible to access resources in example.com",
"effect": "ALLOW",
"resources": [
"//cloudresourcemanager.googleapis.com/organizations/123456789012"
]
}
]
},
"displayName": "Example policy",
"etag": "W/\"Gh/PcTdJD/AWHUhPW45kdw==\"",
"name": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-policy",
"uid": "puid_13364150419245236225",
"updateTime": "2026-07-07T00:05:48.295209Z"
}
REST
O método
principalAccessBoundaryPolicies.get
recebe uma única política de limite de acesso de principal.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
ORG_ID: o ID da organização proprietária da política de limite de acesso de principal. Os IDs da organização são numéricos, como123456789012.-
PAB_POLICY_ID: o ID da política de limite de acesso de principal que você quer receber, por exemplo,example-policy.
Método HTTP e URL:
GET https://iam.googleapis.com/v3/organizations/ORG_ID/locations/global/principalAccessBoundaryPolicies/PAB_POLICY_ID
Para enviar a solicitação, expanda uma destas opções:
A resposta contém a política de limite de acesso de principal especificada na solicitação.
{
"name": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-policy",
"uid": "puid_13364150419245236225",
"etag": "W/\"Gh/PcTdJD/AWHUhPW45kdw==\"",
"displayName": "Example policy",
"createTime": "2026-07-07T00:05:48.295209Z",
"updateTime": "2026-07-07T00:05:48.295209Z",
"details": {
"rules": [
{
"description": "Make principals eligible to access resources in example.com",
"resources": [
"//cloudresourcemanager.googleapis.com/organizations/123456789012"
],
"effect": "ALLOW"
}
],
"enforcementVersion": "4"
}
}
Listar vinculações de políticas para políticas de limite de acesso de principal
Há várias maneiras de listar vinculações de políticas de limite de acesso de principal:
- Listar vinculações de uma política de limite de acesso de principal
- Listar vinculações de política para um conjunto de principais
- Listar vinculações de política para um projeto, uma pasta ou uma organização
Listar vinculações de política para uma política de limite de acesso de principal
Para ver todas as vinculações de política que incluem uma determinada política de limite de acesso de principal, pesquise as vinculações da política de limite de acesso de principal.
É possível ver todas as vinculações de uma Política de limite de acesso de principal usando o console doGoogle Cloud , a CLI gcloud ou a API REST do IAM.
Console
No console do Google Cloud , acesse a página Políticas de limite de acesso de principal.
Selecione a organização que tem a política de limite de acesso de principal com as vinculações que você quer visualizar.
Clique no ID da política de limite de acesso de principal com as vinculações que você quer visualizar.
Clique na guia Vinculações.
A guia Vinculações lista todas as vinculações de políticas de limite de acesso principal que incluem a política de limite de acesso principal.
gcloud
O comando
gcloud iam principal-access-boundary-policies search-policy-bindings
lista todas as vinculações da política de limite de acesso de principal especificada.
Antes de usar os dados do comando abaixo, faça estas substituições:
-
PAB_POLICY_ID: o ID da política de limite de acesso de principal em que você quer listar as vinculações de política, por exemplo,example-policy. ORG_ID: o ID da organização proprietária da política de limite de acesso de principal. Os IDs da organização são numéricos, como123456789012.FORMAT: o formato da resposta. Usejsonouyaml.
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud iam principal-access-boundary-policies search-policy-bindings PAB_POLICY_ID \ --organization=ORG_ID --location=global \ --format=FORMAT
Windows (PowerShell)
gcloud iam principal-access-boundary-policies search-policy-bindings PAB_POLICY_ID ` --organization=ORG_ID --location=global ` --format=FORMAT
Windows (cmd.exe)
gcloud iam principal-access-boundary-policies search-policy-bindings PAB_POLICY_ID ^ --organization=ORG_ID --location=global ^ --format=FORMAT
A resposta contém as vinculações da política de limite de acesso de principal especificada.
{
"policyBindings": [
{
"createTime": "2024-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/principalAccessBoundaryPolicies/example-pab-policy",
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policyUid": "puid_9519202237377675265",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"uid": "buid_9904260005517852673",
"updateTime": "2024-05-06T18:08:24.729843Z"
},
{
"createTime": "2024-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/principalAccessBoundaryPolicies/example-pab-policy",
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policyUid": "puid_9519202237377675265",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/projects/example-project"
},
"uid": "buid_4331055466646863873",
"updateTime": "2024-05-07T07:05:06.203861Z"
}
]
}
REST
O método principalAccessBoundaryPolicies.searchPolicyBindings lista todas as vinculações da política de limite de acesso de principal especificada.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
ORG_ID: o ID da organização proprietária da política de limite de acesso de principal. Os IDs da organização são numéricos, como123456789012.-
PAB_POLICY_ID: o ID da política de limite de acesso de principal em que você quer listar as vinculações de política, por exemplo,example-policy.
Método HTTP e URL:
GET https://iam.googleapis.com/v3/organizations/ORG_ID/locations/global/principalAccessBoundaryPolicies/PAB_POLICY_ID:searchPolicyBindings
Para enviar a solicitação, expanda uma destas opções:
A resposta contém as vinculações da política de limite de acesso de principal especificada.
{
"policyBindings": [
{
"name": "organizations/123456789012/locations/global/policyBindings/example-binding1",
"uid": "buid_9904260005517852673",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"displayName": "Example binding 1",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policy": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-pab-policy",
"policyUid": "puid_9519202237377675265",
"createTime": "2024-05-06T18:08:24.729843Z",
"updateTime": "2024-05-06T18:08:24.729843Z"
},
{
"name": "organizations/123456789012/locations/global/policyBindings/example-binding2",
"uid": "buid_4331055466646863873",
"etag": "W/\"cRMdDXbT82aLuZlvoL9Gqg==\"",
"displayName": "Example binding 2",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/projects/example-project"
},
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policy": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-pab-policy",
"policyUid": "puid_9519202237377675265",
"createTime": "2024-05-07T07:05:06.203861Z",
"updateTime": "2024-05-07T07:05:06.203861Z"
}
]
}
Listar vinculações de política para um conjunto de principais
Para ver todas as vinculações de política que incluem um determinado conjunto de principais, pesquise as vinculações do conjunto de principais.
Essas vinculações contêm os IDs das políticas de limite de acesso de principal que estão vinculadas ao conjunto de principais. Para conferir os detalhes dessas políticas, use o ID da política para receber a política de limite de acesso de principal.
É possível visualizar todas as vinculações de política de um conjunto de principal usando a CLI gcloud ou a API REST do IAM.
gcloud
O comando gcloud iam policy-bindings search-target-policy-bindings recebe todas as vinculações de política de limite de acesso de principal para um conjunto de principais.
Antes de usar os dados do comando abaixo, faça estas substituições:
-
RESOURCE_TYPE: o tipo de recurso do Resource Manager (projeto, pasta ou organização) do qual o conjunto de principais de destino é filho. Use o valorproject,folderouorganization.O tipo de recurso depende do tipo de conjunto de principais que você quer listar as vinculações de política. Para saber qual tipo de recurso usar, consulte Conjuntos de principais aceitos.
RESOURCE_ID: o ID do projeto, da pasta ou da organização de que o conjunto de principais de destino é filho. Os IDs do projeto são strings alfanuméricas, comomy-project. Os IDs de pastas e IDs da organização são numéricos, como123456789012.-
PRINCIPAL_SET: o conjunto de principais com as vinculações de política de limite de acesso de principal que você quer visualizar. Para ver uma lista de tipos de principais válidos, consulte Conjuntos de principais compatíveis. FORMAT: o formato da resposta. Usejsonouyaml.
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud iam policy-bindings search-target-policy-bindings \ --RESOURCE_TYPE=RESOURCE_ID \ --target=PRINCIPAL_SET \ --format=FORMAT
Windows (PowerShell)
gcloud iam policy-bindings search-target-policy-bindings ` --RESOURCE_TYPE=RESOURCE_ID ` --target=PRINCIPAL_SET ` --format=FORMAT
Windows (cmd.exe)
gcloud iam policy-bindings search-target-policy-bindings ^ --RESOURCE_TYPE=RESOURCE_ID ^ --target=PRINCIPAL_SET ^ --format=FORMAT
A resposta contém todas as vinculações de política que incluem o conjunto de principais de destino.
{
"policyBindings": [
{
"createTime": "2024-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/principalAccessBoundaryPolicies/example-pab-policy1",
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policyUid": "puid_9519202237377675265",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"uid": "buid_9904260005517852673",
"updateTime": "2024-05-06T18:11:16.798841Z"
},
{
"createTime": "2024-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/principalAccessBoundaryPolicies/example-pab-policy2",
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policyUid": "puid_10358560617928851457",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"uid": "buid_4331055466646863873",
"updateTime": "2024-05-06T18:11:16.798841Z"
}
]
}
REST
O método SearchTargetPolicyBindings.search recebe todas as vinculações de política de limite de acesso de principal para um conjunto de principais.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
-
RESOURCE_TYPE: o tipo de recurso do Resource Manager (projeto, pasta ou organização) do qual o conjunto de principais de destino é filho. Use o valorprojects,foldersouorganizations.O tipo de recurso depende do tipo de conjunto de principais que você quer listar as vinculações de política. Para saber qual tipo de recurso usar, consulte Conjuntos de principais aceitos.
RESOURCE_ID: o ID do projeto, da pasta ou da organização de que o conjunto de principais de destino é filho. Os IDs do projeto são strings alfanuméricas, comomy-project. Os IDs de pastas e IDs da organização são numéricos, como123456789012.-
PRINCIPAL_SET: o conjunto de principais com as vinculações de política de limite de acesso de principal que você quer visualizar. Para ver uma lista de tipos de principais válidos, consulte Conjuntos de principais compatíveis.
Método HTTP e URL:
GET https://iam.googleapis.com/v3/RESOURCE_TYPE/RESOURCE_ID/locations/global/policyBindings:searchTargetPolicyBindings?target=PRINCIPAL_SET
Para enviar a solicitação, expanda uma destas opções:
A resposta contém todas as vinculações de política que incluem o conjunto de principais de destino.
{
"policyBindings": [
{
"name": "organizations/123456789012/locations/global/policyBindings/example-binding1",
"uid": "buid_9904260005517852673",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"displayName": "Example binding 1",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"policy": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-pab-policy1",
"createTime": "2024-05-06T18:08:24.729843Z",
"updateTime": "2024-05-06T18:11:16.798841Z",
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policyUid": "puid_9519202237377675265"
},
{
"name": "organizations/123456789012/locations/global/policyBindings/example-binding2",
"uid": "buid_4331055466646863873",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"displayName": "Example binding 2",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"policy": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-pab-policy2",
"createTime": "2024-05-06T18:08:24.729843Z",
"updateTime": "2024-05-06T18:11:16.798841Z",
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policyUid": "puid_10358560617928851457"
}
]
}
Listar vinculações de política para um projeto, uma pasta ou uma organização
Para conferir todas as vinculações de política que são filhas de um projeto, uma pasta ou uma organização específica, liste as vinculações de política desse projeto, pasta ou organização.
O recurso pai de uma vinculação de política depende do principal definido na vinculação de política. Para saber mais, consulte Tipos de principal compatíveis.
É possível ver todas as vinculações de política 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 política que são filhas de um determinado recurso.
Antes de usar os dados do comando abaixo, faça estas substituições:
-
RESOURCE_TYPE: o tipo de recurso do Resource Manager (projeto, pasta ou organização) do qual a vinculação de políticas é filha. Use o valorproject,folderouorganization.O tipo de recurso depende do principal definido na vinculação de políticas. Para saber qual tipo de recurso usar, consulte Tipos de principais aceitos.
-
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, comomy-project. Os IDs de pastas e IDs da organização são numéricos, como123456789012. FORMAT: o formato da resposta. Usejsonouyaml.
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud iam policy-bindings list --RESOURCE_TYPE=RESOURCE_ID \ --location=global \ --filter=policyKind:PRINCIPAL_ACCESS_BOUNDARY \ --format=FORMAT
Windows (PowerShell)
gcloud iam policy-bindings list --RESOURCE_TYPE=RESOURCE_ID ` --location=global ` --filter=policyKind:PRINCIPAL_ACCESS_BOUNDARY ` --format=FORMAT
Windows (cmd.exe)
gcloud iam policy-bindings list --RESOURCE_TYPE=RESOURCE_ID ^ --location=global ^ --filter=policyKind:PRINCIPAL_ACCESS_BOUNDARY ^ --format=FORMAT
A resposta contém as vinculações de política que são filhas do recurso no comando.
{
"policyBindings": [
{
"createTime": "2024-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/principalAccessBoundaryPolicies/example-pab-policy-1",
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policyUid": "puid_9519202237377675265",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"uid": "buid_9904260005517852673",
"updateTime": "2024-05-06T18:08:24.729843Z"
},
{
"createTime": "2024-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/principalAccessBoundaryPolicies/example-pab-policy-2",
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policyUid": "puid_1566408245394800641",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"uid": "buid_4331055466646863873",
"updateTime": "2024-05-07T07:05:06.203861Z"
}
]
}
REST
O método policyBindings.list lista todas as vinculações de política que são filhas de um determinado recurso.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
-
RESOURCE_TYPE: o tipo de recurso do Resource Manager (projeto, pasta ou organização) do qual a vinculação de políticas é filha. Use o valorprojects,foldersouorganizations.O tipo de recurso depende do principal definido na vinculação de políticas. Para saber qual tipo de recurso usar, consulte Tipos de principais aceitos.
-
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, comomy-project. Os IDs de pastas e IDs da organização são numéricos, como123456789012.
Método HTTP e URL:
GET https://iam.googleapis.com/v3/RESOURCE_TYPE/RESOURCE_ID/locations/global/policyBindings?filter=policyKind:PRINCIPAL_ACCESS_BOUNDARY
Para enviar a solicitação, expanda uma destas opções:
A resposta contém as vinculações de política 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": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policy": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-pab-policy-1",
"policyUid": "puid_9519202237377675265",
"createTime": "2024-05-06T18:08:24.729843Z",
"updateTime": "2024-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": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policy": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-pab-policy-2",
"policyUid": "puid_1566408245394800641",
"createTime": "2024-05-07T07:05:06.203861Z",
"updateTime": "2024-05-07T07:05:06.203861Z"
}
]
}
Receber uma vinculação de política para uma política de limite de acesso de principal
Para conferir os detalhes de uma única vinculação de política, use o ID dela para acessá-la.
É possível receber uma vinculação de política usando a CLI gcloud ou a API REST do IAM.
gcloud
O comando
gcloud iam policy-bindings describe
recebe uma vinculação de política.
Antes de usar os dados do comando abaixo, faça estas substituições:
-
BINDING_ID: o ID da vinculação de política que você quer receber, por exemplo,example-binding. -
RESOURCE_TYPE: o tipo de recurso do Resource Manager (projeto, pasta ou organização) do qual a vinculação de políticas é filha. Use o valorproject,folderouorganization.O tipo de recurso depende do principal definido na vinculação de políticas. Para saber qual tipo de recurso usar, consulte Tipos de principais aceitos.
-
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, comomy-project. Os IDs de pastas e IDs da organização são numéricos, como123456789012. FORMAT: o formato da resposta. Usejsonouyaml.
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud iam policy-bindings describe BINDING_ID \ --RESOURCE_TYPE=RESOURCE_ID --location=global \ --format=FORMAT
Windows (PowerShell)
gcloud iam policy-bindings describe BINDING_ID ` --RESOURCE_TYPE=RESOURCE_ID --location=global ` --format=FORMAT
Windows (cmd.exe)
gcloud iam policy-bindings describe BINDING_ID ^ --RESOURCE_TYPE=RESOURCE_ID --location=global ^ --format=FORMAT
A resposta contém a vinculação de política.
{
"createTime": "2024-05-06T18:08:24.729843Z",
"displayName": "Example binding",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"name": "organizations/123456789012/locations/global/policyBindings/example-binding",
"policy": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-pab-policy",
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policyUid": "puid_9519202237377675265",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"uid": "buid_9904260005517852673",
"updateTime": "2024-05-06T18:08:24.729843Z"
}
REST
O método
policyBindings.get
recebe uma vinculação de política.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
-
RESOURCE_TYPE: o tipo de recurso do Resource Manager (projeto, pasta ou organização) do qual a vinculação de políticas é filha. Use o valorprojects,foldersouorganizations.O tipo de recurso depende do principal definido na vinculação de políticas. Para saber qual tipo de recurso usar, consulte Tipos de principais aceitos.
-
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, comomy-project. Os IDs de pastas e IDs da organização são numéricos, como123456789012. -
BINDING_ID: o ID da vinculação de política que você quer receber, por exemplo,example-binding.
Método HTTP e URL:
GET https://iam.googleapis.com/v3/RESOURCE_TYPE/RESOURCE_ID/locations/global/policyBindings/BINDING_ID
Para enviar a solicitação, expanda uma destas opções:
A resposta contém a vinculação de política.
{
"name": "organizations/123456789012/locations/global/policyBindings/example-binding",
"uid": "buid_9904260005517852673",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"displayName": "Example binding",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policy": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-pab-policy",
"policyUid": "puid_9519202237377675265",
"createTime": "2024-05-06T18:08:24.729843Z",
"updateTime": "2024-05-06T18:08:24.729843Z"
}
A seguir
- Criar e aplicar políticas de limite de acesso de principal
- Editar políticas de limite de acesso de principal
- Remover políticas de limite de acesso de principal