您可以透過統一存取政策 (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 總覽。
刪除統一存取政策繫結所需的角色
如要取得刪除 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 -
在 Cloud de Confiance 控制台中刪除 UAP:
-
iam.accesspolicies.get -
iam.accessPolicies.list
-
從資源移除統一存取政策
如要從資源中移除 UAP,請刪除將 UAP 繫結至資源的繫結。刪除繫結後,UAP 就不會再套用至該資源或其子系。不過,UAP 不會遭到刪除,其他繫結也不會受到影響。
您可以使用Cloud de Confiance 控制台、gcloud CLI 或 IAM REST API,刪除專案、資料夾和組織的繫結。如要刪除其他資源的繫結,請使用 gcloud CLI 或 IAM REST API。
控制台
-
在 Cloud de Confiance 控制台中,前往「統一存取政策」 頁面。
前往「Unified Access Policies」(統一存取政策) 頁面 - 選取要移除的 UAP 所屬的專案、資料夾或組織。
- 按一下要移除的 UAP 政策 ID。
- 選取「繫結」分頁標籤。
- 在「Bindings」(繫結) 表格中,找出要移除的繫結所在的資料列。
- 在該列中,按一下 「Actions」(動作) 選單,然後按一下「Delete binding」(刪除繫結)。
- 在「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 的繫結最終都會刪除。不過,在刪除之前,這些繫結仍會計入可參照單一資源的繫結數量上限。
您可以使用 Cloud de Confiance 控制台、gcloud CLI 或 IAM REST API 刪除 UAP。
控制台
-
在 Cloud de Confiance 控制台中,前往「統一存取政策」 頁面。
前往「Unified Access Policies」(統一存取政策) 頁面 - 選取要刪除的 UAP 所屬的專案、資料夾或組織。
- 按一下要刪除的 UAP 政策 ID。
- 按一下「 刪除政策」。
- 如果 UAP 有現有繫結,請選取「Delete this policy and all of its bindings」(刪除這項政策及其所有繫結)。如果嘗試刪除具有現有繫結的 UAP,但未選取這個選項,要求就會失敗。
- 在「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 時,代表作業已完成,您可以停止取得作業。