Las políticas de acceso unificado (UAP) te permiten otorgar y denegar el acceso de las principales a los recursos deGoogle Cloud . En este documento, se explica cómo ver las UAP y las vinculaciones.
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 ver las Políticas de acceso unificado
Para obtener los permisos que
necesitas para ver las UAP,
pídele a tu administrador que te otorgue el
rol de IAM de visualizador de políticas de acceso (roles/iam.accessPolicyViewer) en
el proyecto, la carpeta o la organización que posee la UAP
que quieres ver
.
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 ver los UAP. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para ver los UAP:
-
iam.accesspolicies.get -
iam.accessPolicies.list
También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.
Roles necesarios para ver las vinculaciones de la política de acceso unificado
Para obtener los permisos que necesitas para ver las vinculaciones, pídele a tu administrador que te otorgue los siguientes roles de IAM en el recurso superior de las vinculaciones:
-
Visualiza vinculaciones en un proyecto:
Administrador de IAM del proyecto (
roles/resourcemanager.projectIamAdmin) -
Ver vinculaciones en una carpeta:
Administrador de IAM de carpetas (
roles/resourcemanager.folderIamAdmin) -
Visualiza las vinculaciones en una organización:
Administrador de la organización (
roles/resourcemanager.organizationAdmin)
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
Estos roles predefinidos contienen los permisos necesarios para ver las vinculaciones. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para ver las vinculaciones:
-
Visualiza una sola vinculación:
iam.policybindings.get -
Enumera las vinculaciones superiores de un proyecto, una carpeta o una organización:
iam.policybindings.list
También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.
Roles necesarios para ver todas las vinculaciones de una política de acceso unificado
Para obtener el permiso que
necesitas para ver todas las vinculaciones de una UAP,
pídele a tu administrador que te otorgue el rol de IAM de
Visualizador de políticas de acceso (roles/iam.accessPolicyViewer) en el recurso que posee la UAP.
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
Este rol predefinido contiene el permiso
iam.accesspolicies.searchPolicyBindings,
que se requiere para
ver todas las vinculaciones de una UAP.
También puedes obtener este permiso con roles personalizados o con otros roles predefinidos.
Roles para ver todas las vinculaciones de un recurso
Para obtener los permisos que necesitas para ver todas las vinculaciones que incluyen un
recurso objetivo específico, pídele a tu administrador que te otorgue un rol que te permita
enumerar las vinculaciones de ese recurso. Este rol debe incluir el
permiso
SERVICE.RESOURCE.searchPolicyBindings, en el que
RESOURCE es el tipo de recurso objetivo y
SERVICE es el servicio propietario del 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 objetivo 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.
Enumera las políticas de acceso unificado en un proyecto, una carpeta o una organización
Puedes enumerar todas las UAP que pertenecen a un proyecto, una carpeta o una organización específicos 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 las UAP que deseas ver.
En la consola de Google Cloud , se muestran las UAP que dependen del recurso que seleccionaste o que están vinculadas a él.
gcloud
El comando
gcloud iam access-policies list
enumera todas las UAP que son secundarias de un recurso determinado.
Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:
-
UAP_PARENT_RESOURCE_TYPE: Es el tipo de recurso de Resource Manager (proyecto, carpeta u organización) que posee las UAP que deseas enumerar. Usa el valorproject,folderoorganization. -
UAP_PARENT_RESOURCE_ID: Es el ID del proyecto, la carpeta o la organización que posee los UAP que deseas enumerar. Los ID de proyecto son strings alfanuméricas, comomy-project. Los IDs de carpeta y organización son numéricos, como123456789012. FORMAT: Es el formato de la respuesta. Usajsonoyaml.
Ejecuta el siguiente comando:
Linux, macOS o 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
La respuesta contiene los UAP que son secundarios del recurso en la solicitud.
{
"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
El método accessPolicies.list enumera todas las UAP que son secundarias de un recurso determinado.
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 las UAP que deseas enumerar. Usa el valorprojects,foldersoorganizations. -
UAP_PARENT_RESOURCE_ID: Es el ID del proyecto, la carpeta o la organización que posee los UAP que deseas enumerar. Los ID de proyecto son strings alfanuméricas, comomy-project. Los IDs de carpeta y organización son numéricos, como123456789012.
Método HTTP y URL:
GET https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies
Para enviar tu solicitud, expande una de estas opciones:
La respuesta contiene los UAP que son secundarios del recurso en la solicitud.
{
"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"
}
]
}
}
]
}
Obtén una sola Política de acceso unificado
Puedes obtener los detalles de una sola UAP con la consola deGoogle 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 cuyos detalles deseas ver.
- Haz clic en el ID de la política de UAP cuyos detalles deseas ver.
En la consola de Google Cloud , se muestran los detalles de la UAP, incluidos el ID, la hora de creación, la hora de la última actualización y la lista de reglas.
gcloud
El comando
gcloud iam access-policies describe
obtiene un solo UAP.
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 obtener, 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 obtener. 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 obtener. Los ID de proyecto son strings alfanuméricas, comomy-project. Los IDs de carpeta y organización son numéricos, como123456789012. FORMAT: Es el formato de la respuesta. Usajsonoyaml.
Ejecuta el siguiente comando:
Linux, macOS o 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
La respuesta contiene el UAP especificado en la solicitud.
{
"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
El método
accessPolicies.get
obtiene una sola UAP.
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 obtener. Usa el valorprojects,foldersoorganizations -
UAP_PARENT_RESOURCE_ID: Es el ID del proyecto, la carpeta o la organización que posee la UAP que deseas obtener. 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 obtener, por ejemplo,example-policy.
Método HTTP y URL:
GET https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies/UAP_ID
Para enviar tu solicitud, expande una de estas opciones:
La respuesta contiene el UAP especificado en la solicitud.
{
"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"
}
]
}
}
Enumera las vinculaciones de las políticas de acceso unificado
Puedes enumerar las vinculaciones de los UAP de varias maneras:
- Enumera las vinculaciones de un UAP: Consulta todas las vinculaciones que incluyen un UAP específico.
- Enumera las vinculaciones de un recurso: Consulta todas las vinculaciones que incluyen un recurso objetivo específico.
- Enumera todas las vinculaciones de un proyecto, una carpeta o una organización: Consulta todas las vinculaciones que pertenecen a un proyecto, una carpeta o una organización específicos.
Enumera las vinculaciones de una política de acceso unificado
Para ver todas las vinculaciones que incluyen un UAP determinado, busca las vinculaciones del UAP.
Puedes ver todas las vinculaciones de una UAP con la consola deGoogle 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 cuyas vinculaciones deseas ver.
- Haz clic en el ID de la UAP cuyas vinculaciones deseas ver.
- Selecciona la pestaña Vinculaciones.
En la consola de Google Cloud , se muestra una lista de las vinculaciones de la UAP, junto con el nombre visible y el recurso objetivo de cada vinculación.
gcloud
El comando
gcloud iam access-policies search-policy-bindings
enumera todas las vinculaciones para el UAP especificado.
Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:
-
UAP_ID: Es el ID de la UAP para la que deseas enumerar las vinculaciones, 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 para la que deseas enumerar las vinculaciones. Usa el valorproject,folderoorganization. -
UAP_PARENT_RESOURCE_ID: Es el ID del proyecto, la carpeta o la organización propietaria de la UAP para la que deseas enumerar las vinculaciones. Los ID de proyecto son strings alfanuméricas, comomy-project. Los IDs de carpeta y organización son numéricos, como123456789012. FORMAT: Es el formato de la respuesta. Usajsonoyaml.
Ejecuta el siguiente comando:
Linux, macOS o 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
La respuesta contiene las vinculaciones para la 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
El método
accessPolicies.searchPolicyBindings
enumera todas las vinculaciones para el UAP especificado.
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 para la que deseas enumerar las vinculaciones. Usa el valorprojects,foldersoorganizations. -
UAP_PARENT_RESOURCE_ID: Es el ID del proyecto, la carpeta o la organización propietaria de la UAP para la que deseas enumerar las vinculaciones. 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 para la que deseas enumerar las vinculaciones, por ejemplo,example-policy.
Método HTTP y URL:
GET https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies/UAP_ID:searchPolicyBindings
Para enviar tu solicitud, expande una de estas opciones:
La respuesta contiene las vinculaciones para la 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"
}
]
}
Enumera todas las vinculaciones de un recurso
Para ver todas las vinculaciones que incluyen un recurso objetivo específico, busca las vinculaciones de ese recurso.
Cada vinculación contiene el ID del UAP que está vinculado al recurso. Para ver los detalles de una política, usa el ID de la política para obtener los detalles de la política.
Puedes ver todas las vinculaciones de un recurso con la consola deGoogle 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 cuyas vinculaciones deseas ver.
- En el campo Filtro, ingresa el filtro Aplicación de política: Aplicada.
En la tabla, se muestran todas las UAP vinculadas al recurso.
gcloud
El comando
gcloud iam policy-bindings search-target-policy-bindings
obtiene todas las vinculaciones de UAP que incluyen el recurso.
Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:
-
BINDING_PARENT_RESOURCE_TYPE: Es el tipo de recurso de Resource Manager (proyecto, carpeta u organización) que es el recurso superior de las vinculaciones para el recurso objetivo. Usa el valorproject,folderoorganization.Para saber qué recursos son superiores de qué vinculaciones, consulta Recursos compatibles.
-
BINDING_PARENT_RESOURCE_ID: Es el ID del proyecto, la carpeta o la organización que contiene las vinculaciones del recurso objetivo. Los ID de proyecto son strings alfanuméricas, comomy-project. Los IDs de carpeta y organización son numéricos, como123456789012. -
TARGET_RESOURCE: Es el recurso cuyas vinculaciones deseas enumerar. Para obtener una lista de recursos válidos, consulta Recursos compatibles. FORMAT: Es el formato de la respuesta. Usajsonoyaml.
Ejecuta el siguiente comando:
Linux, macOS o 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
La respuesta contiene todas las vinculaciones de UAP que incluyen el recurso objetivo.
{
"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
El método
SearchTargetPolicyBindings.search
obtiene todas las vinculaciones de UAP que incluyen el recurso.
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) que es el recurso superior de las vinculaciones para el recurso objetivo. Usa el valorprojects,foldersoorganizations.Para saber qué recursos son superiores de qué vinculaciones, consulta Recursos compatibles.
-
BINDING_PARENT_RESOURCE_ID: Es el ID del proyecto, la carpeta o la organización que contiene las vinculaciones del recurso objetivo. Los ID de proyecto son strings alfanuméricas, comomy-project. Los IDs de carpeta y organización son numéricos, como123456789012. -
TARGET_RESOURCE: Es el recurso cuyas vinculaciones deseas enumerar. Para obtener una lista de recursos válidos, consulta Recursos compatibles.
Método HTTP y URL:
GET https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings:searchTargetPolicyBindings?target=TARGET_RESOURCE
Para enviar tu solicitud, expande una de estas opciones:
La respuesta contiene todas las vinculaciones de UAP que incluyen el recurso objetivo.
{
"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"
}
]
}
Enumera todas las vinculaciones de un proyecto, una carpeta o una organización
Si usas gcloud CLI o la API de REST de IAM para ver las vinculaciones, también puedes enumerar todas las vinculaciones que son secundarias de un proyecto, una carpeta o una organización específicos.
Enumerar las vinculaciones de un proyecto, una carpeta o una organización es similar a buscar las vinculaciones de ese recurso. Sin embargo, a diferencia de la búsqueda de vinculaciones, la lista de vinculaciones de un recurso también incluye todas las vinculaciones que son elementos secundarios inmediatos de ese recurso.
Por ejemplo, imagina que tienes una vinculación que adjunta una política a un Agent Gateway de la API de Network Services. El recurso superior de esta vinculación es el proyecto superior del Agent Gateway. En otras palabras, la vinculación es un elemento secundario inmediato del proyecto. Por lo tanto, si enumeras las vinculaciones de ese proyecto, la respuesta incluirá la vinculación del Agent Gateway. Sin embargo, si enumeras las vinculaciones de la organización superior del proyecto, la respuesta no incluye la vinculación. Esto se debe a que, aunque la vinculación es un descendiente de la organización, no es un elemento secundario inmediato de la organización.
El recurso superior de una vinculación depende del recurso objetivo de la vinculación. Para obtener más información, consulta Recursos compatibles.
Cada vinculación contiene el ID de la UAP que está vinculada al recurso. Para ver los detalles de una política, usa el ID de la política para obtener los detalles de la política.
Puedes ver todas las vinculaciones que son secundarias de un proyecto, una carpeta o una organización con gcloud CLI o la API de REST de IAM.
gcloud
El comando
gcloud iam policy-bindings list
enumera todas las vinculaciones de UAP que son secundarias de un recurso determinado.
Antes de usar cualquiera de los datos de comando a continuación, haz 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 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. FORMAT: Es el formato de la respuesta. Usajsonoyaml.
Ejecuta el siguiente comando:
Linux, macOS o 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
La respuesta contiene las vinculaciones de UAP que son elementos secundarios del recurso en el 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
El método
policyBindings.list
enumera todas las vinculaciones de UAP que son secundarias de un recurso determinado.
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.
Método HTTP y URL:
GET https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings?filter=policyKind:ACCESS
Para enviar tu solicitud, expande una de estas opciones:
La respuesta contiene las vinculaciones de UAP que son elementos secundarios del recurso en la solicitud.
{
"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"
}
]
}
Obtén una vinculación para una política de acceso unificado
Puedes obtener los detalles de una vinculación 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 cuyas vinculaciones deseas ver.
- Haz clic en el ID de la UAP cuyas vinculaciones deseas ver.
- Selecciona la pestaña Vinculaciones.
- Busca la vinculación con el ID o el nombre de la vinculación.
En la tabla, se muestran los detalles de la vinculación, incluidos el ID, el nombre y el recurso objetivo de la vinculación.
gcloud
El comando
gcloud iam policy-bindings describe
obtiene 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 obtener, 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. FORMAT: Es el formato de la respuesta. Usajsonoyaml.
Ejecuta el siguiente comando:
Linux, macOS o 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
La respuesta contiene la vinculación.
{
"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
El método policyBindings.get obtiene 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 obtener, por ejemplo,example-binding.
Método HTTP y URL:
GET 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 la vinculación.
{
"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"
}