借助 Unified Access Policies (UAP),您可以向主账号授予或拒绝其对Cloud de Confiance 资源的访问权限。本文档介绍了如何查看 UAP 和绑定。
准备工作
设置身份验证。
选择标签页以了解您打算如何使用本页面上的示例:
控制台
当您使用 Cloud de Confiance 控制台访问 Cloud de Confiance by S3NS 服务和 API 时,无需设置身份验证。
gcloud
安装 Google Cloud CLI,然后使用联合身份登录 gcloud CLI。 登录后,运行以下命令来初始化 Google Cloud CLI:
gcloud initREST
如需在本地开发环境中使用本页面上的 REST API 示例,请使用您提供给 gcloud CLI 的凭证。
安装 Google Cloud CLI,然后使用联合身份登录 gcloud CLI。
如需了解详情,请参阅 Cloud de Confiance 身份验证文档中的使用 REST 时进行身份验证。
可选:阅读 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 角色:
-
查看项目中的绑定:Project IAM Admin (
roles/resourcemanager.projectIamAdmin) -
查看文件夹中的绑定:Folder IAM Admin (
roles/resourcemanager.folderIamAdmin) -
查看组织中的绑定:Organization Administrator (
roles/resourcemanager.organizationAdmin)
如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
这些预定义角色包含查看绑定所需的权限。如需查看所需的确切权限,请展开所需权限部分:
所需权限
查看绑定需要以下权限:
-
查看单个绑定:
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
您可以使用 Cloud de Confiance 控制台、gcloud CLI 或 IAM REST API 列出特定项目、文件夹或组织的所有 UAP。
控制台
-
在 Cloud de Confiance 控制台中,前往 Unified Access Policies 页面。
前往“Unified Access Policies” - 选择拥有您要查看的 UAP 的项目、文件夹或组织。
Cloud de Confiance 控制台会显示由您选择的资源作为父级或绑定到该资源的 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"
}
]
}
}
]
}
获取单个统一访问权限政策
您可以使用Cloud de Confiance 控制台、gcloud CLI 或 IAM REST API 获取单个 UAP 的详细信息。
控制台
-
在 Cloud de Confiance 控制台中,前往 Unified Access Policies 页面。
前往“Unified Access Policies” - 选择拥有您要查看其详细信息的 UAP 的项目、文件夹或组织。
- 点击要查看其详细信息的 UAP 的政策 ID。
Cloud de Confiance 控制台会显示 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 的绑定:
- 列出 UAP 的绑定:查看包含特定 UAP 的所有绑定。
- 列出资源的绑定:查看包含特定目标资源的所有绑定。
- 列出项目、文件夹或组织中的所有绑定:查看由特定项目、文件夹或组织作为父级的所有绑定。
列出 Unified Access Policy 的绑定
如需查看包含某个特定 UAP 的所有绑定,请搜索该 UAP 的绑定。
您可以使用Cloud de Confiance 控制台、gcloud CLI 或 IAM REST API 查看 UAP 的所有绑定。
控制台
-
在 Cloud de Confiance 控制台中,前往 Unified Access Policies 页面。
前往“Unified Access Policies” - 选择拥有您要查看其绑定的 UAP 的项目、文件夹或组织。
- 点击要查看其绑定的 UAP 的政策 ID。
- 选择绑定标签页。
Cloud de Confiance 控制台会显示 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 获取政策详细信息。
您可以使用Cloud de Confiance 控制台、gcloud CLI 或 IAM REST API 查看资源的所有绑定。
控制台
-
在 Cloud de Confiance 控制台中,前往 Unified Access Policies 页面。
前往“Unified Access Policies” - 选择您要查看其绑定的项目、文件夹或组织。
- 在过滤条件字段中,输入过滤条件强制执行:已强制执行。
该表会显示绑定到该资源的所有 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"
}
]
}
获取统一访问权限政策的绑定
您可以使用 Cloud de Confiance 控制台、gcloud CLI 或 IAM REST API 获取绑定的详细信息。
控制台
-
在 Cloud de Confiance 控制台中,前往 Unified Access Policies 页面。
前往“Unified Access Policies” - 选择拥有您要查看其绑定的 UAP 的项目、文件夹或组织。
- 点击要查看其绑定的 UAP 的政策 ID。
- 选择绑定标签页。
- 使用绑定 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"
}