移除統一存取政策

您可以透過統一存取政策 (UAP),授予及拒絕主體對Google Cloud 資源的存取權。如果不想再將 UAP 套用至資源,可以刪除將政策繫結至資源的政策繫結。如要從所有繫結資源中移除政策,可以刪除政策。

事前準備

  1. 設定驗證方法。

    請根據您打算如何使用本頁範例,選取對應的分頁標籤:

    控制台

    使用 Google Cloud 控制台存取 Google Cloud 服務和 API 時,不需要設定驗證機制。

    gcloud

    在 Google Cloud 控制台啟用 Cloud Shell。

    啟用 Cloud Shell

    Google Cloud 控制台底部會開啟 Cloud Shell 工作階段,並顯示指令列提示。Cloud Shell 是已安裝 Google Cloud CLI 的殼層環境,並已設定適用於您目前專案的值。工作階段可能要幾秒鐘的時間才能初始化。

    REST

    如要在本機開發環境中使用本頁的 REST API 範例,請使用您提供給 gcloud CLI 的憑證。

      安裝 Google Cloud CLI。

      若您採用的是外部識別資訊提供者 (IdP),請先使用聯合身分登入 gcloud CLI。

    詳情請參閱 Google Cloud 驗證說明文件中的「使用 REST 進行驗證」一節。

  2. 確認 Google Cloud 專案已啟用計費功能。

  3. 選用:閱讀 UAP 總覽。

刪除統一存取政策繫結所需的角色

如要取得刪除 UAP 繫結所需的權限,請要求管理員授予您下列 IAM 角色:

  • 擁有 UAP 的資源存取權政策使用者 (roles/iam.accessPolicyUser)。這個角色包含 iam.accesspolicies.unbind 權限,這是刪除繫結的必要權限。
  • 包含 SERVICE.RESOURCE.deletePolicyBinding 權限的角色,其中 RESOURCE 是 UAP 繫結的資源類型,SERVICE 則是擁有資源的服務。

    如要找出具備必要權限的角色,請在角色和權限參考資料中搜尋該權限,然後按一下權限名稱,查看具備該權限的角色。

    您必須在資源或其上層資源中具備這個角色。

如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

刪除統一存取政策所需的角色

如要取得刪除 UAP 所需的權限,請要求管理員在擁有要刪除 UAP 的專案、資料夾或組織中,授予您存取權政策管理員 (roles/iam.accessPolicyAdmin) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備刪除 UAP 所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:

所需權限

必須具備下列權限,才能刪除 UAP:

  • iam.accesspolicies.delete
  • 在 Google Cloud 控制台中刪除 UAP:
    • iam.accesspolicies.get
    • iam.accessPolicies.list

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

從資源移除統一存取政策

如要從資源中移除 UAP,請刪除將 UAP 繫結至資源的繫結。刪除繫結後,UAP 就不會再套用至該資源或其子系。不過,UAP 不會遭到刪除,其他繫結也不會受到影響。

您可以使用Google Cloud 控制台、gcloud CLI 或 IAM REST API,刪除專案、資料夾和組織的繫結。如要刪除其他資源的繫結,請使用 gcloud CLI 或 IAM REST API。

控制台

  1. 在 Google Cloud 控制台中,前往「統一存取政策」 頁面。

    前往「Unified Access Policies」(統一存取政策) 頁面
  2. 選取要移除的 UAP 所屬的專案、資料夾或組織。
  3. 按一下要移除的 UAP 政策 ID。
  4. 選取「繫結」分頁標籤。
  5. 在「Bindings」(繫結) 表格中,找出要移除的繫結所在的資料列。
  6. 在該列中,按一下 「Actions」(動作) 選單,然後按一下「Delete binding」(刪除繫結)。
  7. 在「Delete binding」(刪除繫結) 對話方塊中,按一下「Delete」(刪除)。

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
}

刪除統一存取政策

刪除 UAP 前,請先找出並刪除所有參照 UAP 的現有繫結。如果嘗試刪除 UAP,但未刪除現有繫結,就會發生錯誤。

如要刪除 UAP,但不刪除現有繫結,可以強制刪除 UAP。強制刪除 UAP 會將其從所有繫結的資源中移除。參照 UAP 的繫結最終都會刪除。不過,在刪除之前,這些繫結仍會計入可參照單一資源的繫結數量上限。

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

控制台

  1. 在 Google Cloud 控制台中,前往「統一存取政策」 頁面。

    前往「Unified Access Policies」(統一存取政策) 頁面
  2. 選取要刪除的 UAP 所屬的專案、資料夾或組織。
  3. 按一下要刪除的 UAP 政策 ID。
  4. 按一下「 刪除政策」。
  5. 如果 UAP 有現有繫結,請選取「Delete this policy and all of its bindings」(刪除這項政策及其所有繫結)。如果嘗試刪除具有現有繫結的 UAP,但未選取這個選項,要求就會失敗。
  6. 在「Delete policy」(刪除政策) 對話方塊中,按一下「Delete」(刪除)。

gcloud

gcloud iam access-policies delete 指令會刪除 UAP 和所有相關繫結。

使用下列任何指令資料前,請先替換以下項目:

  • UAP_ID:要刪除的 UAP ID,例如 example-policy。
  • UAP_PARENT_RESOURCE_TYPE:Resource Manager 資源 (專案、資料夾或組織) 的類型,該資源擁有您要刪除的 UAP。請使用 project、folder 或 organization 值。
  • UAP_PARENT_RESOURCE_ID:專案、資料夾或組織的 ID,該專案、資料夾或組織擁有您要刪除的 UAP。專案 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:Resource Manager 資源 (專案、資料夾或組織) 的類型,該資源擁有您要刪除的 UAP。請使用 projects、folders 或 organizations 值。
  • UAP_PARENT_RESOURCE_ID:專案、資料夾或組織的 ID,該專案、資料夾或組織擁有您要刪除的 UAP。專案 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 時,代表作業已完成,您可以停止取得作業。

後續步驟