查看 Unified Access Policies

借助 Unified Access Policies (UAP),您可以向主账号授予或拒绝其对Google Cloud 资源的访问权限。本文档介绍了如何查看 UAP 和绑定。

准备工作

  1. 设置身份验证。

    选择标签页以了解您打算如何使用本页面上的示例:

    控制台

    当您使用 Google Cloud 控制台访问 Google Cloud 服务和 API 时,无需设置身份验证。

    gcloud

    在 Google Cloud 控制台中,激活 Cloud Shell。

    激活 Cloud Shell

    Cloud Shell 会话随即会在 Google Cloud 控制台的底部启动,并显示命令行提示符。Cloud Shell 是一个已安装 Google Cloud CLI 且已为当前项目设置值的 Shell 环境。该会话可能需要几秒钟时间来完成初始化。

    REST

    如需在本地开发环境中使用本页面上的 REST API 示例,请使用您提供给 gcloud CLI 的凭证。

      安装 Google Cloud CLI。

      如果您使用的是外部身份提供方 (IdP),则必须先使用联合身份登录 gcloud CLI。

    如需了解详情,请参阅 Google Cloud 身份验证文档中的使用 REST 时进行身份验证。

  2. 验证是否已为您的 Google Cloud 项目启用结算功能。

  3. 可选:阅读 UAP 概览。

查看 Unified Access Policies 所需的角色

如需获得查看 UAP 所需的权限,请让管理员向您授予拥有您要查看的 UAP 的项目、文件夹或组织的 Access Policy Viewer (roles/iam.accessPolicyViewer) IAM 角色。如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。

此预定义角色包含查看 UAP 所需的权限。如需查看所需的确切权限,请展开所需权限部分:

所需权限

如需查看 UAP,您需要具备以下权限:

  • iam.accesspolicies.get
  • iam.accessPolicies.list

您也可以使用自定义角色或其他预定义角色来获取这些权限。

查看 Unified Access Policy 绑定所需的角色

如需获得查看绑定所需的权限,请让您的管理员为您授予绑定的父级资源的以下 IAM 角色:

如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。

这些预定义角色包含查看绑定所需的权限。如需查看所需的确切权限,请展开所需权限部分:

所需权限

查看绑定需要以下权限:

  • 查看单个绑定: iam.policybindings.get
  • 列出父级为项目、文件夹或组织的绑定: iam.policybindings.list

您也可以使用自定义角色或其他预定义角色来获取这些权限。

查看 Unified Access Policy 的所有绑定所需的角色

如需获得查看 UAP 的所有绑定所需的权限,请让您的管理员为您授予拥有 UAP 的资源的 Access Policy Viewer (roles/iam.accessPolicyViewer) IAM 角色。 如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。

此预定义角色包含查看 UAP 的所有绑定所需的 iam.accesspolicies.searchPolicyBindings 权限。

您也可以使用自定义角色或其他预定义角色来获取此权限。

用于查看资源的所有绑定的角色

如需获得查看包含特定目标资源的所有绑定所需的权限,请让管理员为您授予一个角色,以便您列出该资源的绑定。此角色必须包含 SERVICE.RESOURCE.searchPolicyBindings 权限,其中 RESOURCE 是目标资源类型,SERVICE 是拥有该资源的服务。

如需查找包含所需权限的角色,请在角色和权限参考文档中搜索该权限,点击该权限名称,然后查看包含该权限的角色。

您需要对目标资源或其某个祖先资源拥有此角色。

如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。

列出项目、文件夹或组织中的 Unified Access Policies

您可以使用 Google Cloud 控制台、gcloud CLI 或 IAM REST API 列出特定项目、文件夹或组织的所有 UAP。

控制台

  1. 在 Google Cloud 控制台中,前往 Unified Access Policies 页面。

    前往“Unified Access Policies”
  2. 选择拥有您要查看的 UAP 的项目、文件夹或组织。

Google Cloud 控制台会显示由您选择的资源作为父级或绑定到该资源的 UAP。

gcloud

gcloud iam access-policies list 命令可列出作为某个特定资源子级的所有 UAP。

在使用下面的命令数据之前,请先进行以下替换:

  • UAP_PARENT_RESOURCE_TYPE:拥有您要列出的 UAP 的 Resource Manager 资源(项目、文件夹或组织)的类型。使用值 project、folder 或 organization。
  • UAP_PARENT_RESOURCE_ID:拥有您要列出的 UAP 的项目、文件夹或组织的 ID。项目 ID 是字母数字字符串,例如 my-project。 文件夹和组织 ID 是数字,例如 123456789012。
  • FORMAT:响应的格式。请使用 json 或 yaml。

执行以下命令:

Linux、macOS 或 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

响应包含作为请求中的资源子级的 UAP。

{
  "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

accessPolicies.list 方法可列出作为某个特定资源的子级的所有 UAP。

在使用任何请求数据之前,请先进行以下替换:

  • UAP_PARENT_RESOURCE_TYPE:拥有您要列出的 UAP 的 Resource Manager 资源(项目、文件夹或组织)的类型。使用值 projects、folders 或 organizations。
  • UAP_PARENT_RESOURCE_ID:拥有您要列出的 UAP 的项目、文件夹或组织的 ID。项目 ID 是字母数字字符串,例如 my-project。 文件夹和组织 ID 是数字,例如 123456789012。

HTTP 方法和网址:

GET https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies

如需发送您的请求,请展开以下选项之一:

响应包含作为请求中的资源子级的 UAP。

{
  "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"
          }
        ]
      }
    }
  ]
}

获取单个统一访问权限政策

您可以使用Google Cloud 控制台、gcloud CLI 或 IAM REST API 获取单个 UAP 的详细信息。

控制台

  1. 在 Google Cloud 控制台中,前往 Unified Access Policies 页面。

    前往“Unified Access Policies”
  2. 选择拥有您要查看其详细信息的 UAP 的项目、文件夹或组织。
  3. 点击要查看其详细信息的 UAP 的政策 ID。

Google Cloud 控制台会显示 UAP 的详细信息,包括 ID、创建时间、上次更新时间和规则列表。

gcloud

gcloud iam access-policies describe 命令可获取单个 UAP。

在使用下面的命令数据之前,请先进行以下替换:

  • UAP_ID:您要获取的 UAP 的 ID,例如 example-policy。
  • UAP_PARENT_RESOURCE_TYPE:拥有您要获取的 UAP 的 Resource Manager 资源(项目、文件夹或组织)的类型。使用值 project、folder 或 organization。
  • UAP_PARENT_RESOURCE_ID:拥有您要获取的 UAP 的项目、文件夹或组织的 ID。项目 ID 是字母数字字符串,例如 my-project。 文件夹和组织 ID 是数字,例如 123456789012。
  • FORMAT:响应的格式。请使用 json 或 yaml。

执行以下命令:

Linux、macOS 或 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

响应包含请求中指定的 UAP。

{
  "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

accessPolicies.get 方法可获取单个 UAP。

在使用任何请求数据之前,请先进行以下替换:

  • UAP_PARENT_RESOURCE_TYPE:拥有您要获取的 UAP 的 Resource Manager 资源(项目、文件夹或组织)的类型。使用值 projects、folders 或 organizations。
  • UAP_PARENT_RESOURCE_ID:拥有您要获取的 UAP 的项目、文件夹或组织的 ID。项目 ID 是字母数字字符串,例如 my-project。 文件夹和组织 ID 是数字,例如 123456789012。
  • UAP_ID:您要获取的 UAP 的 ID,例如 example-policy。

HTTP 方法和网址:

GET https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies/UAP_ID

如需发送您的请求,请展开以下选项之一:

响应包含请求中指定的 UAP。

{
  "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"
      }
    ]
  }
}

列出 Unified Access Policies 的绑定

您可以通过以下几种方式列出 UAP 的绑定:

列出 Unified Access Policy 的绑定

如需查看包含某个特定 UAP 的所有绑定,请搜索该 UAP 的绑定。

您可以使用Google Cloud 控制台、gcloud CLI 或 IAM REST API 查看 UAP 的所有绑定。

控制台

  1. 在 Google Cloud 控制台中,前往 Unified Access Policies 页面。

    前往“Unified Access Policies”
  2. 选择拥有您要查看其绑定的 UAP 的项目、文件夹或组织。
  3. 点击要查看其绑定的 UAP 的政策 ID。
  4. 选择绑定标签页。

Google Cloud 控制台会显示 UAP 的绑定列表,以及每个绑定的显示名称和目标资源。

gcloud

gcloud iam access-policies search-policy-bindings 命令可列出指定 UAP 的所有绑定。

在使用下面的命令数据之前,请先进行以下替换:

  • UAP_ID:您要列出绑定的 UAP 的 ID,例如 example-policy。
  • UAP_PARENT_RESOURCE_TYPE:拥有您要列出其绑定的 UAP 的 Resource Manager 资源(项目、文件夹或组织)的类型。使用值 project、folder 或 organization。
  • UAP_PARENT_RESOURCE_ID:拥有您要列出其绑定的 UAP 的项目、文件夹或组织的 ID。项目 ID 是字母数字字符串,例如 my-project。文件夹和组织 ID 是数字,例如 123456789012。
  • FORMAT:响应的格式。请使用 json 或 yaml。

执行以下命令:

Linux、macOS 或 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

响应包含指定 UAP 的绑定。

{
  "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

accessPolicies.searchPolicyBindings 方法可列出指定 UAP 的所有绑定。

在使用任何请求数据之前,请先进行以下替换:

  • UAP_PARENT_RESOURCE_TYPE:拥有您要列出其绑定的 UAP 的 Resource Manager 资源(项目、文件夹或组织)的类型。使用值 projects、folders 或 organizations。
  • UAP_PARENT_RESOURCE_ID:拥有您要列出其绑定的 UAP 的项目、文件夹或组织的 ID。项目 ID 是字母数字字符串,例如 my-project。文件夹和组织 ID 是数字,例如 123456789012。
  • UAP_ID:您要列出绑定的 UAP 的 ID,例如 example-policy。

HTTP 方法和网址:

GET https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies/UAP_ID:searchPolicyBindings

如需发送您的请求,请展开以下选项之一:

响应包含指定 UAP 的绑定。

{
  "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"
    }
  ]
}

列出资源的所有绑定

如需查看包含特定目标资源的所有绑定,请搜索该资源的绑定。

每个绑定都包含绑定到资源的 UAP 的 ID。如需查看政策的详细信息,请使用政策 ID 获取政策详细信息。

您可以使用Google Cloud 控制台、gcloud CLI 或 IAM REST API 查看资源的所有绑定。

控制台

  1. 在 Google Cloud 控制台中,前往 Unified Access Policies 页面。

    前往“Unified Access Policies”
  2. 选择您要查看其绑定的项目、文件夹或组织。
  3. 在过滤条件字段中,输入过滤条件强制执行:已强制执行。

该表会显示绑定到该资源的所有 UAP。

gcloud

gcloud iam policy-bindings search-target-policy-bindings 命令可获取包含该资源的所有 UAP 绑定。

在使用下面的命令数据之前,请先进行以下替换:

  • BINDING_PARENT_RESOURCE_TYPE:为目标资源提供绑定关系的 Resource Manager 资源(项目、文件夹或组织)的类型。使用值 project、folder 或 organization。

    如需了解哪些资源是哪些绑定的父级,请参阅支持的资源。

  • BINDING_PARENT_RESOURCE_ID:目标资源的父级绑定所在的项目、文件夹或组织的 ID。项目 ID 是字母数字字符串,例如 my-project。文件夹和组织 ID 是数字,例如 123456789012。
  • TARGET_RESOURCE:您要列出其绑定的资源。如需查看有效资源列表,请参阅支持的资源。
  • FORMAT:响应的格式。请使用 json 或 yaml。

执行以下命令:

Linux、macOS 或 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

响应包含包含目标资源的所有 UAP 绑定。

{
  "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

SearchTargetPolicyBindings.search 方法可获取包含该资源的所有 UAP 绑定。

在使用任何请求数据之前,请先进行以下替换:

  • BINDING_PARENT_RESOURCE_TYPE:为目标资源提供绑定关系的 Resource Manager 资源(项目、文件夹或组织)的类型。使用值 projects、folders 或 organizations。

    如需了解哪些资源是哪些绑定的父级,请参阅支持的资源。

  • BINDING_PARENT_RESOURCE_ID:目标资源的父级绑定所在的项目、文件夹或组织的 ID。项目 ID 是字母数字字符串,例如 my-project。文件夹和组织 ID 是数字,例如 123456789012。
  • TARGET_RESOURCE:您要列出其绑定的资源。如需查看有效资源列表,请参阅支持的资源。

HTTP 方法和网址:

GET https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings:searchTargetPolicyBindings?target=TARGET_RESOURCE

如需发送您的请求,请展开以下选项之一:

响应包含包含目标资源的所有 UAP 绑定。

{
  "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"
    }
  ]
}

列出项目、文件夹或组织中的所有绑定

如果您使用 gcloud CLI 或 IAM REST API 查看绑定,则还可以列出特定项目、文件夹或组织的所有子绑定。

列出项目、文件夹或组织的绑定类似于搜索该资源的绑定。但是,与搜索绑定不同,列出资源的绑定还包括作为该资源的直接子级的所有绑定。

例如,假设您有一个将政策附加到 Network Services API Agent Gateway 的绑定。此绑定的父级资源是 Agent Gateway 的父级项目。换句话说,绑定是项目的直接子级。因此,如果您列出该项目的绑定,则响应中会包含 Agent Gateway 的绑定。但是,如果您列出项目父级组织的绑定,则响应中不包含该绑定。这是因为,虽然绑定是组织的后代,但它不是组织的直接子级。

绑定的父级资源取决于绑定中的目标资源。如需了解详情,请参阅支持的资源。

每个绑定都包含绑定到资源的 UAP 的 ID。如需查看政策的详细信息,请使用政策 ID 获取政策详细信息。

您可以使用 gcloud CLI 或 IAM REST API 查看作为项目、文件夹或组织的子级的所有绑定。

gcloud

gcloud iam policy-bindings list 命令可列出作为某个特定资源子级的所有 UAP 绑定。

在使用下面的命令数据之前,请先进行以下替换:

  • BINDING_PARENT_RESOURCE_TYPE:绑定是其子级的 Resource Manager 资源(项目、文件夹或组织)的类型。使用值 project、folder 或 organization。

    绑定的父级资源取决于绑定中的目标资源。如需了解详情,请参阅支持的资源。

  • BINDING_PARENT_RESOURCE_ID:政策绑定是其子级的项目、文件夹或组织的 ID。项目 ID 是字母数字字符串,例如 my-project。文件夹和组织 ID 是数字,例如 123456789012。
  • FORMAT:响应的格式。请使用 json 或 yaml。

执行以下命令:

Linux、macOS 或 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

响应包含作为命令中的资源子级的 UAP 绑定。

{
  "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

policyBindings.list 方法可列出作为某个特定资源的子级的所有 UAP 绑定。

在使用任何请求数据之前,请先进行以下替换:

  • BINDING_PARENT_RESOURCE_TYPE:绑定是其子级的 Resource Manager 资源(项目、文件夹或组织)的类型。使用值 projects、folders 或 organizations。

    绑定的父级资源取决于绑定中的目标资源。如需了解详情,请参阅支持的资源。

  • BINDING_PARENT_RESOURCE_ID:政策绑定是其子级的项目、文件夹或组织的 ID。项目 ID 是字母数字字符串,例如 my-project。文件夹和组织 ID 是数字,例如 123456789012。

HTTP 方法和网址:

GET https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings?filter=policyKind:ACCESS

如需发送您的请求,请展开以下选项之一:

响应包含作为请求中的资源子级的 UAP 绑定。

{
  "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"
    }
  ]
}

获取统一访问权限政策的绑定

您可以使用 Google Cloud 控制台、gcloud CLI 或 IAM REST API 获取绑定的详细信息。

控制台

  1. 在 Google Cloud 控制台中,前往 Unified Access Policies 页面。

    前往“Unified Access Policies”
  2. 选择拥有您要查看其绑定的 UAP 的项目、文件夹或组织。
  3. 点击要查看其绑定的 UAP 的政策 ID。
  4. 选择绑定标签页。
  5. 使用绑定 ID 或绑定名称查找绑定。

该表会显示绑定详细信息,包括绑定 ID、绑定名称和绑定中的目标资源。

gcloud

gcloud iam policy-bindings describe 命令可获取绑定。

在使用下面的命令数据之前,请先进行以下替换:

  • BINDING_ID:您要获取的绑定的 ID,例如 example-binding。
  • BINDING_PARENT_RESOURCE_TYPE:绑定是其子级的 Resource Manager 资源(项目、文件夹或组织)的类型。使用值 project、folder 或 organization。

    绑定的父级资源取决于绑定中的目标资源。如需了解详情,请参阅支持的资源。

  • BINDING_PARENT_RESOURCE_ID:政策绑定是其子级的项目、文件夹或组织的 ID。项目 ID 是字母数字字符串,例如 my-project。文件夹和组织 ID 是数字,例如 123456789012。
  • FORMAT:响应的格式。请使用 json 或 yaml。

执行以下命令:

Linux、macOS 或 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

响应包含绑定。

{
  "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

policyBindings.get 方法可获取绑定。

在使用任何请求数据之前,请先进行以下替换:

  • BINDING_PARENT_RESOURCE_TYPE:绑定是其子级的 Resource Manager 资源(项目、文件夹或组织)的类型。使用值 projects、folders 或 organizations。

    绑定的父级资源取决于绑定中的目标资源。如需了解详情,请参阅支持的资源。

  • BINDING_PARENT_RESOURCE_ID:政策绑定是其子级的项目、文件夹或组织的 ID。项目 ID 是字母数字字符串,例如 my-project。文件夹和组织 ID 是数字,例如 123456789012。
  • BINDING_ID:您要获取的绑定的 ID,例如 example-binding。

HTTP 方法和网址:

GET https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings/BINDING_ID

如需发送您的请求,请展开以下选项之一:

响应包含绑定。

{
  "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"
}

后续步骤