移除 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 绑定所需的权限,请让管理员向您授予以下 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
  • 在 Google Cloud 控制台中删除 UAP:
    • iam.accesspolicies.get
    • iam.accessPolicies.list

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

从资源中移除 Unified Access Policies

如需从资源中移除 UAP,请删除将 UAP 绑定到资源的绑定。删除绑定后,UAP 将不再应用于该资源或该资源的后代。但是,UAP 不会被删除,其任何其他绑定也不会受到影响。

您可以使用Google Cloud 控制台、gcloud CLI 或 IAM REST API 删除项目、文件夹和组织的绑定。如需删除其他资源的绑定,您必须使用 gcloud CLI 或 IAM REST API。

控制台

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

    前往“Unified Access Policies”
  2. 选择拥有要移除的 UAP 的项目、文件夹或组织。
  3. 点击要移除的 UAP 的政策 ID。
  4. 选择绑定标签页。
  5. 在绑定表中,找到包含要移除的绑定的行。
  6. 在该行中,点击 操作菜单,然后点击删除绑定。
  7. 在删除绑定对话框中,点击删除。

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 的任何绑定最终都会被删除。不过,在删除之前,这些绑定仍会计入可引用单个资源的绑定数量上限。

您可以使用 Google Cloud 控制台、gcloud CLI 或 IAM REST API 删除 UAP。

控制台

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

    前往“Unified Access Policies”
  2. 选择拥有您要删除的 UAP 的项目、文件夹或组织。
  3. 点击要删除的 UAP 的政策 ID。
  4. 点击 删除政策。
  5. 如果 UAP 具有现有绑定,请选择删除此政策及其所有绑定。如果您尝试删除具有现有绑定的 UAP,但未选择此选项,则请求会失败。
  6. 在删除政策对话框中,点击删除。

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 时,操作完成,您可以停止获取操作。

后续步骤