借助 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 绑定所需的权限,请让管理员向您授予以下 IAM 角色:
- 针对拥有 UAP 的资源的 Access Policy User (
roles/iam.accessPolicyUser)。此角色包含删除绑定所需的iam.accesspolicies.unbind权限。 包含
SERVICE.RESOURCE.deletePolicyBinding权限的角色,其中RESOURCE是 UAP 绑定到的资源类型,SERVICE是拥有该资源的服务。如需查找包含所需权限的角色,请在角色和权限参考文档中搜索该权限,点击该权限名称,然后查看包含该权限的角色。
您需要对该资源或其某个祖先资源拥有此角色。
如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
删除 Unified Access Policies 所需的角色
如需获得删除 UAP 所需的权限,请让管理员为您授予拥有要删除的 UAP 的项目、文件夹或组织的 Access Policy Admin (roles/iam.accessPolicyAdmin) IAM 角色。
如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
此预定义角色包含删除 UAP 所需的权限。如需查看所需的确切权限,请展开所需权限部分:
所需权限
您需要具备以下权限才能删除 UAP:
-
iam.accesspolicies.delete -
在 Cloud de Confiance 控制台中删除 UAP:
-
iam.accesspolicies.get -
iam.accessPolicies.list
-
从资源中移除 Unified Access Policies
如需从资源中移除 UAP,请删除将 UAP 绑定到资源的绑定。删除绑定后,UAP 将不再应用于该资源或该资源的后代。但是,UAP 不会被删除,其任何其他绑定也不会受到影响。
您可以使用Cloud de Confiance 控制台、gcloud CLI 或 IAM REST API 删除项目、文件夹和组织的绑定。如需删除其他资源的绑定,您必须使用 gcloud CLI 或 IAM REST API。
控制台
-
在 Cloud de Confiance 控制台中,前往 Unified Access Policies 页面。
前往“Unified Access Policies” - 选择拥有要移除的 UAP 的项目、文件夹或组织。
- 点击要移除的 UAP 的政策 ID。
- 选择绑定标签页。
- 在绑定表中,找到包含要移除的绑定的行。
- 在该行中,点击 操作菜单,然后点击删除绑定。
- 在删除绑定对话框中,点击删除。
gcloud
gcloud iam policy-bindings delete 命令可删除绑定。
在使用下面的命令数据之前,请先进行以下替换:
-
BINDING_ID:您要删除的绑定的 ID,例如example-binding。 -
BINDING_PARENT_RESOURCE_TYPE:绑定是其子级的 Resource Manager 资源(项目、文件夹或组织)的类型。使用值project、folder或organization。绑定的父级资源取决于绑定中的目标资源。如需了解详情,请参阅支持的资源。
-
BINDING_PARENT_RESOURCE_ID:政策绑定是其子级的项目、文件夹或组织的 ID。项目 ID 是字母数字字符串,例如my-project。文件夹和组织 ID 是数字,例如123456789012。
执行以下命令:
Linux、macOS 或 Cloud Shell
gcloud iam policy-bindings delete BINDING_ID \ --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global
Windows (PowerShell)
gcloud iam policy-bindings delete BINDING_ID ` --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global
Windows (cmd.exe)
gcloud iam policy-bindings delete BINDING_ID ^ --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global
响应包含表示请求的长时间运行的操作。如需了解如何获取长时间运行的操作的状态,请参阅本页面上的检查长时间运行的操作的状态。
Delete request issued for: [example-binding] Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374724030-6181fcd1520c5-d21b0a12-b704e1ce] to complete...done. Deleted policyBinding [example-binding].
REST
policyBindings.delete 方法可删除绑定。
在使用任何请求数据之前,请先进行以下替换:
-
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 方法和网址:
DELETE https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings/BINDING_ID
如需发送您的请求,请展开以下选项之一:
响应包含表示请求的长时间运行的操作。如需了解如何获取长时间运行的操作的状态,请参阅本页面上的检查长时间运行的操作的状态。
{
"name": "organizations/123456789012/locations/global/operations/operation-1715373190994-6181f71b4daad-6d8168c1-13cc6600",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2026-05-10T20:33:11.165728913Z",
"target": "organizations/123456789012/locations/global/policyBindings/example-binding",
"verb": "delete",
"requestedCancellation": false,
"apiVersion": "v3"
},
"done": false
}
删除 Unified Access Policies
在删除 UAP 之前,请识别并删除引用该 UAP 的所有现有绑定。尝试删除 UAP 而不删除现有绑定会导致错误。
如果您想删除 UAP 而不删除现有绑定,则可以强制删除 UAP。强制删除 UAP 会将其从其绑定的所有资源中移除。引用 UAP 的任何绑定最终都会被删除。不过,在删除之前,这些绑定仍会计入可引用单个资源的绑定数量上限。
您可以使用 Cloud de Confiance 控制台、gcloud CLI 或 IAM REST API 删除 UAP。
控制台
-
在 Cloud de Confiance 控制台中,前往 Unified Access Policies 页面。
前往“Unified Access Policies” - 选择拥有您要删除的 UAP 的项目、文件夹或组织。
- 点击要删除的 UAP 的政策 ID。
- 点击 删除政策。
- 如果 UAP 具有现有绑定,请选择删除此政策及其所有绑定。如果您尝试删除具有现有绑定的 UAP,但未选择此选项,则请求会失败。
- 在删除政策对话框中,点击删除。
gcloud
gcloud iam access-policies delete 命令可删除 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。 -
FORCE_FLAG:可选。如需强制该命令删除政策(即使现有绑定中引用了该政策),请使用--force标志。如果未设置此标志,并且现有绑定中引用了该政策,则该命令会失败。
执行以下命令:
Linux、macOS 或 Cloud Shell
gcloud iam access-policies delete UAP_ID \ --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID --location=global \ FORCE_FLAG
Windows (PowerShell)
gcloud iam access-policies delete UAP_ID ` --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID --location=global ` FORCE_FLAG
Windows (cmd.exe)
gcloud iam access-policies delete UAP_ID ^ --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID --location=global ^ FORCE_FLAG
响应包含表示请求的长时间运行的操作。如需了解如何获取长时间运行的操作的状态,请参阅本页面上的检查长时间运行的操作的状态。
Delete request issued for: [example-policy] Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374811191-6181fd2471ab4-f0947406-85778c43] to complete...done. Deleted accessPolicy [example-policy].
REST
accessPolicies.delete 方法可删除 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。 -
FORCE_DELETE:可选。如需强制请求删除政策(即使现有绑定中引用了该政策),请添加查询参数force=true。如果未设置此查询参数,并且现有绑定中引用了该政策,则请求会失败。
HTTP 方法和网址:
DELETE https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies/UAP_ID?FORCE_DELETE
如需发送您的请求,请展开以下选项之一:
响应包含表示请求的长时间运行的操作。如需了解如何获取长时间运行的操作的状态,请参阅本页面上的检查长时间运行的操作的状态。
{
"name": "organizations/123456789012/locations/global/operations/operation-1715373190994-6181f71b4daad-6d8168c1-13cc6600",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2026-05-10T20:33:11.165728913Z",
"target": "organizations/123456789012/locations/global/accessPolicies/example-policy",
"verb": "delete",
"requestedCancellation": false,
"apiVersion": "v3"
},
"done": false
}
检查长时间运行的操作的状态
使用 REST API 或客户端库时,任何更改政策或绑定的方法都会返回长时间运行的操作 (LRO)。长时间运行的操作会跟踪请求的状态,并指示政策或绑定更改是否已完成。
REST
operations.get 方法可返回长时间运行的操作的状态。
在使用任何请求数据之前,请先进行以下替换:
-
OPERATION_NAME:操作的完整名称。您将在原始请求的响应中收到此名称。操作名称格式如下:
RESOURCE_TYPE/RESOURCE_ID/locations/global/operations/OPERATION_ID
HTTP 方法和网址:
GET https://iam.googleapis.com/v3/OPERATION_NAME
如需发送您的请求,请展开以下选项之一:
您应该收到类似以下内容的 JSON 响应:
{
"name": "organizations/314340013352/locations/global/operations/operation-1732752311821-627edd607a3df-9a62cdea-2a7d9f07",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2024-11-28T00:05:12.006289686Z",
"endTime": "2024-11-28T00:05:12.192141801Z",
"target": "organizations/314340013352/locations/global/POLICY_TYPE/POLICY_ID",
"verb": "create",
"requestedCancellation": false,
"apiVersion": "v3"
},
"done": true,
"response": {
POLICY
}
}
如果操作的 done 字段不存在,请重复获取操作,以持续监控其状态。使用截断指数退避算法在每个请求之间引入延迟。当 done 字段设置为 true 时,操作完成,您可以停止获取操作。