Remover Políticas de Acesso Unificadas

As políticas de acesso unificadas (UAPs) permitem conceder e negar aos principais o acesso aos recursos doGoogle Cloud . Se você não quiser mais que uma UAP seja aplicada a um recurso, exclua a vinculação de política que vincula a política ao recurso. Se você quiser remover uma política de todos os recursos a que ela está vinculada, exclua essa política.

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 excluir vinculações de políticas de acesso unificadas

Para receber as permissões necessárias para excluir uma vinculação de uma UAP, peça ao administrador para conceder a você os seguintes papéis do IAM:

  • Usuário da política de acesso (roles/iam.accessPolicyUser) no recurso que possui a UAP. Esse papel inclui a permissão iam.accesspolicies.unbind, que é necessária para excluir vinculações.
  • Um papel que inclui a permissão SERVICE.RESOURCE.deletePolicyBinding, em que RESOURCE é o tipo de recurso ao qual o UAP está vinculado 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 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.

Papéis necessários para excluir políticas de acesso unificadas

Para receber as permissões necessárias para excluir UAPs, peça ao administrador para conceder a você o papel do IAM de Administrador de políticas de acesso (roles/iam.accessPolicyAdmin) no projeto, na pasta ou na organização que possui a UAP que você quer excluir. 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 excluir 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 excluir UAPs:

  • iam.accesspolicies.delete
  • Exclua UAPs no console do Google Cloud :
    • iam.accesspolicies.get
    • iam.accessPolicies.list

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

Remover uma Política de Acesso Unificada de um recurso

Para remover uma UAP de um recurso, exclua a vinculação que associa a UAP ao recurso. Depois de excluir a vinculação, a UAP não se aplica mais ao recurso ou aos descendentes dele. No entanto, o UAP não é excluído, e nenhuma das outras vinculações dele é afetada.

É possível excluir vinculações de projetos, pastas e organizações usando o console doGoogle Cloud , a CLI gcloud ou a API REST do IAM. Para excluir vinculações de outros recursos, use 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 que você quer remover.
  3. Clique no ID da política UAP que você quer remover.
  4. Selecione a guia Vinculações.
  5. Na tabela Vinculações, encontre a linha que contém a vinculação que você quer remover.
  6. Nessa linha, clique no menu Ações e, em seguida, em Excluir vinculação.
  7. Na caixa de diálogo Excluir vinculação, clique em Excluir.

gcloud

O comando gcloud iam policy-bindings delete exclui 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 excluir, 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.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

gcloud iam policy-bindings delete BINDING_ID \
    --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global

Windows (PowerShell)

gcloud iam policy-bindings delete BINDING_ID `
    --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global

Windows (cmd.exe)

gcloud iam policy-bindings delete BINDING_ID ^
    --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global

A resposta contém uma operação de longa duração que representa a solicitação. Para saber como ver o status de uma operação de longa duração, consulte Verificar o status de uma operação de longa duração nesta página.

Delete request issued for: [example-binding]
Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374724030-6181fcd1520c5-d21b0a12-b704e1ce] to complete...done.
Deleted policyBinding [example-binding].

REST

O método policyBindings.delete exclui 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 excluir, por exemplo, example-binding.

Método HTTP e URL:

DELETE 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 uma operação de longa duração que representa a solicitação. Para saber como ver o status de uma operação de longa duração, consulte Verificar o status de uma operação de longa duração nesta página.

{
  "name": "organizations/123456789012/locations/global/operations/operation-1715373190994-6181f71b4daad-6d8168c1-13cc6600",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
    "createTime": "2026-05-10T20:33:11.165728913Z",
    "target": "organizations/123456789012/locations/global/policyBindings/example-binding",
    "verb": "delete",
    "requestedCancellation": false,
    "apiVersion": "v3"
  },
  "done": false
}

Excluir uma política de acesso unificada

Antes de excluir um UAP, identifique e exclua todas as vinculações que fazem referência a ele. As tentativas de excluir uma UAP sem excluir as vinculações atuais resultam em um erro.

Se você quiser excluir uma UAP sem excluir as vinculações existentes, poderá excluí-la de maneira forçada. A exclusão forçada de uma UAP a remove de todos os recursos a que ela está vinculada. Todas as vinculações que fazem referência ao UAP serão excluídas. No entanto, até que sejam excluídas, as vinculações ainda contam para o limite do número de vinculações que podem se referir a um único recurso.

É possível excluir UAPs 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 a UAP que você quer excluir.
  3. Clique no ID da política UAP que você quer excluir.
  4. Clique em Excluir política.
  5. Se a UAP tiver vinculações, selecione Excluir esta política e todas as vinculações dela. Se você tentar excluir uma UAP com vinculações atuais sem selecionar essa opção, a solicitação vai falhar.
  6. Na caixa de diálogo Excluir política, clique em Excluir.

gcloud

O comando gcloud iam access-policies delete exclui uma UAP e todas as vinculações associadas.

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

  • UAP_ID: o ID do UAP que você quer excluir, 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 excluir. 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 excluir. 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.
  • FORCE_FLAG: opcional. Para forçar o comando a excluir uma política, mesmo que ela seja referenciada em vinculações, use a flag --force. Se essa flag não for definida e a política estiver presente nas vinculações atuais, o comando vai falhar.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

gcloud iam access-policies delete UAP_ID \
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID --location=global \
    FORCE_FLAG

Windows (PowerShell)

gcloud iam access-policies delete UAP_ID `
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID --location=global `
    FORCE_FLAG

Windows (cmd.exe)

gcloud iam access-policies delete UAP_ID ^
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID --location=global ^
    FORCE_FLAG

A resposta contém uma operação de longa duração que representa a solicitação. Para saber como ver o status de uma operação de longa duração, consulte Verificar o status de uma operação de longa duração nesta página.

Delete request issued for: [example-policy]
Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374811191-6181fd2471ab4-f0947406-85778c43] to complete...done.
Deleted accessPolicy [example-policy].

REST

O método accessPolicies.delete exclui uma UAP e todas as vinculações associadas.

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 excluir. 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 excluir. 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 do UAP que você quer excluir, por exemplo, example-policy.
  • FORCE_DELETE: opcional. Para forçar a solicitação de excluir a política, mesmo que ela esteja presente em vinculações, adicione o parâmetro de consulta force=true. Se esse parâmetro de consulta não for definido e a política estiver presente em vinculações atuais, a solicitação falhará.

Método HTTP e URL:

DELETE https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies/UAP_ID?FORCE_DELETE

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

A resposta contém uma operação de longa duração que representa a solicitação. Para saber como ver o status de uma operação de longa duração, consulte Verificar o status de uma operação de longa duração nesta página.

{
  "name": "organizations/123456789012/locations/global/operations/operation-1715373190994-6181f71b4daad-6d8168c1-13cc6600",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
    "createTime": "2026-05-10T20:33:11.165728913Z",
    "target": "organizations/123456789012/locations/global/accessPolicies/example-policy",
    "verb": "delete",
    "requestedCancellation": false,
    "apiVersion": "v3"
  },
  "done": false
}

Verificar o status de uma operação de longa duração

Quando você usa a API REST ou as bibliotecas de cliente, qualquer método que altere uma política ou vinculação retorna uma operação de longa duração (LRO, na sigla em inglês). A operação de longa duração rastreia o status da solicitação e indica se a alteração na política ou na vinculação foi concluída.

REST

O método operations.get retorna o status de uma operação de longa duração.

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

  • OPERATION_NAME: o nome completo da operação. Você recebe esse nome na resposta à sua solicitação original.

    O nome da operação tem o seguinte formato:

    RESOURCE_TYPE/RESOURCE_ID/locations/global/operations/OPERATION_ID
        

Método HTTP e URL:

GET https://iam.googleapis.com/v3/OPERATION_NAME

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

Você receberá uma resposta JSON semelhante a esta:

{
  "name": "organizations/314340013352/locations/global/operations/operation-1732752311821-627edd607a3df-9a62cdea-2a7d9f07",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
    "createTime": "2024-11-28T00:05:12.006289686Z",
    "endTime": "2024-11-28T00:05:12.192141801Z",
    "target": "organizations/314340013352/locations/global/POLICY_TYPE/POLICY_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v3"
  },
  "done": true,
  "response": {
    POLICY
  }
}

Se o campo done da operação não estiver presente, continue monitorando o status dela recebendo a operação repetidamente. Use a espera exponencial truncada para introduzir um atraso entre cada solicitação. Quando o campo done estiver definido como true, a operação será concluída e você poderá interromper a operação.

A seguir