Las políticas de acceso unificado (UAP) te permiten otorgar y denegar el acceso de las principales a los recursos deGoogle Cloud . Si ya no quieres que una UAP se aplique a un recurso, puedes borrar la vinculación de la política que vincula la política al recurso. Si deseas quitar una política de todos los recursos a los que está vinculada, puedes borrarla.
Antes de comenzar
Configura la autenticación.
Selecciona la pestaña según cómo planeas usar las muestras de esta página:
Console
Cuando usas la consola de Google Cloud para acceder a los servicios y las APIs de Google Cloud , no necesitas configurar la autenticación.
gcloud
En la consola de Google Cloud , activa Cloud Shell.
En la parte inferior de la consola de Google Cloud , se inicia una sesión de Cloud Shell en la que se muestra una ventana de línea de comandos. Cloud Shell es un entorno de shell con Google Cloud CLI ya instalada y con valores ya establecidos para el proyecto actual. La sesión puede tardar unos segundos en inicializarse.
REST
Para usar las muestras de la API de REST incluidas en esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la gcloud CLI.
Instala Google Cloud CLI.
Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.
Para obtener más información, consulta Autentícate para usar REST en la documentación de autenticación de Google Cloud .
-
Verifica que la facturación esté habilitada para tu proyecto de Google Cloud .
Opcional: Lee la descripción general de los UAP.
Roles necesarios para borrar vinculaciones de políticas de acceso unificado
Para obtener los permisos que necesitas para borrar una vinculación de una UAP, pídele a tu administrador que te otorgue los siguientes roles de IAM:
- Usuario de la política de acceso (
roles/iam.accessPolicyUser) en el recurso propietario de la UAP. Este rol incluye el permisoiam.accesspolicies.unbind, que se requiere para borrar vinculaciones. Un rol que incluya el permiso
SERVICE.RESOURCE.deletePolicyBinding, en el queRESOURCEes el tipo de recurso al que está vinculada la UAP ySERVICEes el servicio que posee el recurso.Para encontrar un rol que incluya el permiso requerido, busca el permiso en la referencia de roles y permisos, haz clic en el nombre del permiso y, luego, revisa los roles que lo incluyen.
Necesitas este rol en el recurso o en uno de sus principales.
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
Roles necesarios para borrar políticas de acceso unificado
Para obtener los permisos que
necesitas para borrar las UAP,
pídele a tu administrador que te otorgue el
rol de IAM de administrador de políticas de acceso (roles/iam.accessPolicyAdmin) en el proyecto, la carpeta o la organización que posee la
UAP que deseas borrar.
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
Este rol predefinido contiene los permisos necesarios para borrar UAP. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para borrar los UAP:
-
iam.accesspolicies.delete -
Borra los UAP en la consola de Google Cloud :
-
iam.accesspolicies.get -
iam.accessPolicies.list
-
También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.
Quita una política de acceso unificado de un recurso
Para quitar una UAP de un recurso, borra la vinculación que une la UAP al recurso. Después de borrar la vinculación, la UAP ya no se aplica al recurso ni a sus descendientes. Sin embargo, no se borra la UAP y no se ve afectada ninguna de sus otras vinculaciones.
Puedes borrar vinculaciones para proyectos, carpetas y organizaciones con la consola deGoogle Cloud , gcloud CLI o la API de REST de IAM. Para borrar vinculaciones de otros recursos, debes usar la gcloud CLI o la API de REST de IAM.
Console
-
En la consola de Google Cloud , ve a la página Políticas de acceso unificado.
Ir a Políticas de acceso unificado - Selecciona el proyecto, la carpeta o la organización que posee la UAP que deseas quitar.
- Haz clic en el ID de la política de UAP que quieres quitar.
- Selecciona la pestaña Vinculaciones.
- En la tabla Vinculaciones, busca la fila que contiene la vinculación que deseas quitar.
- En esa fila, haz clic en el menú Acciones y, luego, en Borrar vinculación.
- En el cuadro de diálogo Borrar vinculación, haz clic en Borrar.
gcloud
El comando
gcloud iam policy-bindings delete
borra una vinculación.
Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:
-
BINDING_ID: Es el ID de la vinculación que deseas borrar, por ejemplo,example-binding. -
BINDING_PARENT_RESOURCE_TYPE: Es el tipo de recurso de Resource Manager (proyecto, carpeta u organización) del que es un elemento secundario la vinculación. Usa el valorproject,folderoorganization.El recurso superior de la vinculación depende del recurso objetivo de la vinculación. Para obtener más información, consulta Recursos compatibles.
-
BINDING_PARENT_RESOURCE_ID: El ID del proyecto, la carpeta o la organización de la que es elemento secundario la vinculación de políticas. Los ID de proyecto son strings alfanuméricas, comomy-project. Los IDs de carpeta y organización son numéricos, como123456789012.
Ejecuta el siguiente comando:
Linux, macOS o 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
La respuesta contiene una operación de larga duración que representa tu solicitud. Para aprender a obtener el estado de una operación de larga duración, consulta Verifica el estado de una operación de larga duración en esta 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
El método policyBindings.delete borra una vinculación.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
-
BINDING_PARENT_RESOURCE_TYPE: Es el tipo de recurso de Resource Manager (proyecto, carpeta u organización) del que es un elemento secundario la vinculación. Usa el valorprojects,foldersoorganizations.El recurso superior de la vinculación depende del recurso objetivo de la vinculación. Para obtener más información, consulta Recursos compatibles.
-
BINDING_PARENT_RESOURCE_ID: El ID del proyecto, la carpeta o la organización de la que es elemento secundario la vinculación de políticas. Los ID de proyecto son strings alfanuméricas, comomy-project. Los IDs de carpeta y organización son numéricos, como123456789012. -
BINDING_ID: Es el ID de la vinculación que deseas borrar, por ejemplo,example-binding.
Método HTTP y URL:
DELETE https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings/BINDING_ID
Para enviar tu solicitud, expande una de estas opciones:
La respuesta contiene una operación de larga duración que representa tu solicitud. Para aprender a obtener el estado de una operación de larga duración, consulta Verifica el estado de una operación de larga duración en esta 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
}
Borra una Política de acceso unificado
Antes de borrar una UAP, identifica y borra todas las vinculaciones existentes que hagan referencia a la UAP. Los intentos de borrar una UAP sin borrar las vinculaciones existentes generan un error.
Si quieres borrar una UAP sin borrar las vinculaciones existentes, puedes borrarla de forma forzosa. Si borras de forma forzosa una UAP, se quitará de todos los recursos a los que está vinculada. Las vinculaciones que hagan referencia a la UAP se borrarán con el tiempo. Sin embargo, hasta que se borren, las vinculaciones seguirán contando para el límite de la cantidad de vinculaciones que pueden hacer referencia a un solo recurso.
Puedes borrar las UAP con la consola de Google Cloud , gcloud CLI o la API de REST de IAM.
Console
-
En la consola de Google Cloud , ve a la página Políticas de acceso unificado.
Ir a Políticas de acceso unificado - Selecciona el proyecto, la carpeta o la organización que posee la UAP que deseas borrar.
- Haz clic en el ID de política de la UAP que deseas borrar.
- Haz clic en Borrar política.
- Si la UAP tiene vinculaciones existentes, selecciona Borrar esta política y todas sus vinculaciones. Si intentas borrar una UAP con vinculaciones existentes sin seleccionar esta opción, la solicitud fallará.
- En el cuadro de diálogo Borrar política, haz clic en Borrar.
gcloud
El comando
gcloud iam access-policies delete
borra una UAP y todas las vinculaciones asociadas.
Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:
-
UAP_ID: Es el ID de la UAP que deseas borrar, por ejemplo,example-policy. -
UAP_PARENT_RESOURCE_TYPE: Es el tipo de recurso de Resource Manager (proyecto, carpeta u organización) que posee la UAP que deseas borrar. Usa el valorproject,folderoorganization. -
UAP_PARENT_RESOURCE_ID: Es el ID del proyecto, la carpeta o la organización propietaria de la UAP que deseas borrar. Los ID de proyecto son strings alfanuméricas, comomy-project. Los IDs de carpeta y organización son numéricos, como123456789012. -
FORCE_FLAG: Opcional Para forzar que el comando borre una política, incluso si se hace referencia a ella en vinculaciones existentes, usa la marca--force. Si no se establece esta marca y se hace referencia a la política en vinculaciones existentes, el comando falla.
Ejecuta el siguiente comando:
Linux, macOS o 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
La respuesta contiene una operación de larga duración que representa tu solicitud. Para aprender a obtener el estado de una operación de larga duración, consulta Verifica el estado de una operación de larga duración en esta 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
El método
accessPolicies.delete
borra una UAP y todas las vinculaciones asociadas.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
-
UAP_PARENT_RESOURCE_TYPE: Es el tipo de recurso de Resource Manager (proyecto, carpeta u organización) que posee la UAP que deseas borrar. Usa el valorprojects,foldersoorganizations. -
UAP_PARENT_RESOURCE_ID: Es el ID del proyecto, la carpeta o la organización propietaria de la UAP que deseas borrar. Los ID de proyecto son strings alfanuméricas, comomy-project. Los IDs de carpeta y organización son numéricos, como123456789012. -
UAP_ID: Es el ID de la UAP que deseas borrar, por ejemplo,example-policy. -
FORCE_DELETE: Opcional Para forzar la solicitud de borrar la política, incluso si se hace referencia a ella en vinculaciones existentes, agrega el parámetro de consultaforce=true. Si no se establece este parámetro de consulta y se hace referencia a la política en vinculaciones existentes, la solicitud falla.
Método HTTP y URL:
DELETE https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies/UAP_ID?FORCE_DELETE
Para enviar tu solicitud, expande una de estas opciones:
La respuesta contiene una operación de larga duración que representa tu solicitud. Para aprender a obtener el estado de una operación de larga duración, consulta Verifica el estado de una operación de larga duración en esta 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
}
Revisa el estado de una operación de larga duración
Cuando usas la API de REST o las bibliotecas cliente, cualquier método que cambie una política o vinculación devuelve una operación de larga duración (LRO). La operación de larga duración realiza un seguimiento del estado de la solicitud y también indica si se completó el cambio en la política o la vinculación.
REST
El
método
operations.get
muestra el estado de una operación de larga duración.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
-
OPERATION_NAME: Es el nombre completo de la operación. Recibirás este nombre en la respuesta a tu solicitud original.El nombre de la operación tiene el siguiente formato:
RESOURCE_TYPE/RESOURCE_ID/locations/global/operations/OPERATION_ID
Método HTTP y URL:
GET https://iam.googleapis.com/v3/OPERATION_NAME
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{
"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
}
}
Si el campo done de la operación no está presente, sigue supervisando
su estado obteniendo la operación de forma repetida. Usa la retirada exponencial truncada para
introducir un retraso entre cada solicitud. Cuando el campo done se establece como true, la operación está completa, y puedes dejar de obtener la operación.