Ver Políticas de acceso unificado

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

  1. 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.

    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 .

  2. Verifica que la facturación esté habilitada para tu proyecto de Google Cloud .

  3. 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:

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

  1. En la consola de Google Cloud , ve a la página Políticas de acceso unificado.

    Ir a Políticas de acceso unificado
  2. 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 valor project, folder o organization.
  • 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, como my-project. Los IDs de carpeta y organización son numéricos, como 123456789012.
  • FORMAT: Es el formato de la respuesta. Usa json o yaml.

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 valor projects, folders o organizations.
  • 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, como my-project. Los IDs de carpeta y organización son numéricos, como 123456789012.

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

  1. En la consola de Google Cloud , ve a la página Políticas de acceso unificado.

    Ir a Políticas de acceso unificado
  2. Selecciona el proyecto, la carpeta o la organización que posee la UAP cuyos detalles deseas ver.
  3. 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 valor project, folder o organization
  • 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, como my-project. Los IDs de carpeta y organización son numéricos, como 123456789012.
  • FORMAT: Es el formato de la respuesta. Usa json o yaml.

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 valor projects, folders o organizations
  • 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, como my-project. Los IDs de carpeta y organización son numéricos, como 123456789012.
  • 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 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

  1. En la consola de Google Cloud , ve a la página Políticas de acceso unificado.

    Ir a Políticas de acceso unificado
  2. Selecciona el proyecto, la carpeta o la organización que posee la UAP cuyas vinculaciones deseas ver.
  3. Haz clic en el ID de la UAP cuyas vinculaciones deseas ver.
  4. 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 valor project, folder o organization.
  • 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, como my-project. Los IDs de carpeta y organización son numéricos, como 123456789012.
  • FORMAT: Es el formato de la respuesta. Usa json o yaml.

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 valor projects, folders o organizations.
  • 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, como my-project. Los IDs de carpeta y organización son numéricos, como 123456789012.
  • 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

  1. En la consola de Google Cloud , ve a la página Políticas de acceso unificado.

    Ir a Políticas de acceso unificado
  2. Selecciona el proyecto, la carpeta o la organización cuyas vinculaciones deseas ver.
  3. 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 valor project, folder o organization.

    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, como my-project. Los IDs de carpeta y organización son numéricos, como 123456789012.
  • 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. Usa json o yaml.

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 valor projects, folders o organizations.

    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, como my-project. Los IDs de carpeta y organización son numéricos, como 123456789012.
  • 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 valor project, folder o organization.

    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, como my-project. Los IDs de carpeta y organización son numéricos, como 123456789012.
  • FORMAT: Es el formato de la respuesta. Usa json o yaml.

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 valor projects, folders o organizations.

    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, como my-project. Los IDs de carpeta y organización son numéricos, como 123456789012.

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

  1. En la consola de Google Cloud , ve a la página Políticas de acceso unificado.

    Ir a Políticas de acceso unificado
  2. Selecciona el proyecto, la carpeta o la organización que posee la UAP cuyas vinculaciones deseas ver.
  3. Haz clic en el ID de la UAP cuyas vinculaciones deseas ver.
  4. Selecciona la pestaña Vinculaciones.
  5. 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 valor project, folder o organization.

    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, como my-project. Los IDs de carpeta y organización son numéricos, como 123456789012.
  • FORMAT: Es el formato de la respuesta. Usa json o yaml.

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 valor projects, folders o organizations.

    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, como my-project. Los IDs de carpeta y organización son numéricos, como 123456789012.
  • 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"
}

¿Qué sigue?