套用工作負載更新
本頁面說明如何啟用、查看及套用 Assured Workloads 資料夾的工作負載更新。Assured Workloads 會定期更新資料邊界,加入新設定和一般改善項目,例如更新組織政策限制值。這項功能可讓您評估目前的 Assured Workloads 資料夾設定,並與最新可用設定進行比較,然後選擇是否套用任何建議的更新。
根據預設,新的 Assured Workloads 資料夾會自動啟用這項功能。對於現有的 Assured Workloads 資料夾,強烈建議您按照步驟啟用工作負載更新。
這項功能不會產生任何額外費用,也不會影響 Assured Workloads 監控的行為;無論資料夾設定是否有更新,只要資料夾不符合目前設定,您仍會收到警示。
工作負載更新總覽
建立新的 Assured Workloads 資料夾時,您選取的資料邊界類型 (例如 FedRAMP 中等影響等級) 會決定套用至工作負載的各種設定。其中部分設定會以組織政策限制的形式對外顯示,其他設定則僅適用於 Google 的內部系統。Assured Workloads 使用內部設定版本管理系統,維護每種資料邊界類型的變更。
當新的內部設定版本推出時,Assured Workloads 會將工作負載的設定與新的內部版本進行比較。系統會分析任何差異,並將產生的強化功能做為更新提供,您可以將其套用至工作負載的設定。如果這類強化功能包含對新服務的支援,則該服務所需的任何組織政策限制,也可能套用至您的工作負載。
Google 已驗證可用的 Assured Workloads 更新,確保符合工作負載資料邊界的要求。不過,您仍有責任審查每項可用更新,確認符合貴組織的法規或法規遵循要求。詳情請參閱「Assured Workloads 的共同責任」。
支援的更新類型
這項功能支援在 Assured Workloads 資料夾中查看及套用下列類型的更新:
組織政策限制:任何適用於工作負載且由 Assured Workloads 強制執行的組織政策限制,都可以納入工作負載更新,但有下列例外狀況:
gcp.resourceLocationsgcp.restrictCmekCryptoKeyProjects
資料邊界推出階段:只有在特定資料邊界與首次部署時處於相同的推出階段時,這項功能才支援查看及套用更新。舉例來說,如果您在資料邊界處於預先發布階段時部署工作負載,而該資料邊界後來正式發布,則必須先使用正式發布版重新部署工作負載,才能套用更新。如未重新部署工作負載,嘗試套用更新時可能會發生錯誤或違反法規。
事前準備
- 找出要啟用更新的 Assured Workloads 資料夾資源 ID。
- 在目標 Assured Workloads 資料夾和工作負載上指派或驗證 IAM 權限。
必要的 IAM 權限
如要啟用、查看或套用工作負載更新,呼叫端必須透過預先定義的角色 (包含更廣泛的權限) 或自訂角色 (僅限最低必要權限) 取得 IAM 權限。請注意,自訂角色無法使用必要的 orgpolicy.policy.set 權限。
必須具備下列權限:
- 在目標工作負載上執行
assuredworkloads.workload.update,即可啟用更新。Assured Workloads 編輯者 (roles/assuredworkloads.editor) 和 Assured Workloads 管理員 (roles/assuredworkloads.admin) 預先定義的角色具備這項權限。 assuredworkloads.updates.list,查看目標工作負載可用的更新。這項權限包含在 Assured Workloads 讀取者 (roles/assuredworkloads.reader)、Assured Workloads 編輯者 (roles/assuredworkloads.editor) 和 Assured Workloads 管理員 (roles/assuredworkloads.admin) 預先定義的角色中。- 在目標工作負載上執行
assuredworkloads.updates.update,即可套用可用的更新。這項權限包含在 Assured Workloads 編輯者 (roles/assuredworkloads.editor) 和 Assured Workloads 管理員 (roles/assuredworkloads.admin) 預先定義的角色中。 assuredworkloads.operations.get,取得更新作業的狀態和結果。這項權限包含在 Assured Workloads 讀取者 (roles/assuredworkloads.reader)、Assured Workloads 編輯者 (roles/assuredworkloads.editor) 和 Assured Workloads 管理員 (roles/assuredworkloads.admin) 預先定義的角色中。orgpolicy.policy.get,套用可用的更新。組織政策檢視者 (roles/orgpolicy.policyViewer) 和組織政策管理員 (roles/orgpolicy.policyAdmin) 預先定義的角色具備這項權限。orgpolicy.policy.set,套用可用的更新。自訂角色不支援這項權限,但預先定義的組織政策管理員 (roles/orgpolicy.policyAdmin) 角色包含這項權限。resourcemanager.folders.getIamPolicy和resourcemanager.folders.setIamPolicy,才能啟用更新。資料夾 IAM 管理員 (roles/resourcemanager.folderIamAdmin) 角色和其他權限較高的預先定義角色,都具備這些權限。
啟用工作負載更新
啟用工作負載更新後,系統會建立 Assured Workloads 服務代理。接著,這個服務代理會獲得目標 Assured Workloads 資料夾的Assured Workloads 服務代理 (roles/assuredworkloads.serviceAgent) 角色。這個角色可讓服務代理檢查資料夾是否有可用更新。
如要啟用工作負載更新,請完成下列步驟:
控制台
前往 Google Cloud 控制台的「Assured Workloads」頁面。
在頁面頂端的「Introducing Compliance Updates」(法規遵循更新簡介) 窗格中,按一下「Enable compliance updates」(啟用法規遵循更新)。
系統提示「要啟用法規遵循更新嗎?」時,請按一下「啟用」。
組織中所有 Assured Workloads 資料夾的工作負載更新功能現已啟用。
REST
enableComplianceUpdates 方法可讓 Assured Workloads 通知您單一 Assured Workloads 資料夾的更新。
HTTP 方法、網址和查詢參數:
PUT https://[ENDPOINT_URI]/v1/organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/workloads/[WORKLOAD_ID]:enableComplianceUpdates
將下列預留位置值替換為您自己的值:
- ENDPOINT_URI:Assured Workloads 服務端點 URI。這個 URI 必須是與目的地工作負載位置相符的端點,例如
us-west1區域中的區域化工作負載為https://us-west1-assuredworkloads.googleapis.com,美國的多區域工作負載則為https://us-assuredworkloads.googleapis.com。 - ORGANIZATION_ID:Assured Workloads 資料夾的組織 ID,例如
919698201234。 - LOCATION_ID:Assured Workloads 資料夾的位置,例如
us-west1或us。這會對應到工作負載的data region值。 - WORKLOAD_ID:要啟用更新的 Assured Workloads 工作負載 ID,例如
00-701ea036-7152-4780-a867-9f5。
例如:
PUT https://us-west1-assuredworkloads.googleapis.com/v1/organizations/919698298765/locations/us-west1/workloads/00-701ea036-7152-4781-a867-9f5:enableComplianceUpdates查看工作負載更新
如要查看工作負載更新,請完成下列步驟:
控制台
前往 Google Cloud 控制台的「Assured Workloads」頁面。
在「Name」(名稱) 欄中,按一下要查看更新的 Assured Workloads 資料夾名稱。或者,如果資料夾有可用的更新,請按一下「Updates」(更新) 欄中的連結。
在「可用的更新」下方,按一下「查看可用的更新」。
如有可用的組織政策更新,會顯示在「Organization policy」(組織政策) 分頁中。查看受影響的組織政策限制,然後按一下「View update」(查看更新),預覽更新後會套用的限制設定。
REST
organizations.locations.workloads.updates.list 方法會列出 Assured Workloads 工作負載可用的更新。
HTTP 方法、網址和查詢參數:
GET https://[ENDPOINT_URI]/v1/organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/workloads/[WORKLOAD_ID]/updates?page_size=[PAGE_SIZE]&page_token=[PAGE_TOKEN]
將下列預留位置值替換為您自己的值:
- ENDPOINT_URI:Assured Workloads 服務端點 URI。這個 URI 必須是與目的地工作負載位置相符的端點,例如
us-central1區域中的區域化工作負載為https://us-central1-assuredworkloads.googleapis.com,美國的多區域工作負載則為https://us-assuredworkloads.googleapis.com。 - ORGANIZATION_ID:Assured Workloads 資料夾的組織 ID,例如
919698201234。 - LOCATION_ID:Assured Workloads 資料夾的位置,例如
us-central1或us。這會對應到工作負載的data region值。 - WORKLOAD_ID:Assured Workloads 工作負載的 ID,用於列出可用的更新,例如
00-701ea036-7152-4780-a867-9f5。 - PAGE_SIZE (選用):限制回應中傳回的更新數量。如未指定,預設值會設為
20。最大值為100。 - PAGE_TOKEN (選用):如果有一或多個頁面可用,JSON 回應中會傳回下一頁的權杖,例如
nextPageToken": "chEKD4IBDAid1e-3BhCo68f6AQ。如未指定,系統不會傳回後續頁面。
例如:
GET https://us-central1-assuredworkloads.googleapis.com/v1/organizations/919698298765/locations/us-west1/workloads/00-701ea036-7152-4781-a867-9f5/updates如果成功,您會收到類似下列範例的 JSON 回應:
{ "workloadUpdates": [ { "name": "organizations/919698298765/locations/us-central1/workloads/00-701ea036-7152-4781-a867-9f5/updates/5320de45-6c98-41af-b4a0-2ef930b124c3", "state": "AVAILABLE", "createTime": "2024-10-01T16:33:10.154368Z", "updateTime": "2024-10-01T16:33:10.154368Z", "details": { "orgPolicyUpdate": { "appliedPolicy": { "resource": "folders/376585579673", "constraint": "constraints/gcp.resourceLocations", "rule": { "values": { "allowedValues": [ "us-central1", ] } } }, "suggestedPolicy": { "resource": "folders/376585579673", "constraint": "constraints/gcp.resourceLocations", "rule": { "values": { "allowedValues": [ "us-central1", "us-central2", "us-west1", ] } } } } } } ], "nextPageToken": "chEKD4IBDAid1e-3BhCo68f6AQ" }
套用工作負載更新
將工作負載更新套用至工作負載是長時間執行的作業。如果工作負載設定在作業開始後、完成前有所變更,可能會發生錯誤。
此外,系統會定期依據最新可用設定,重新評估工作負載更新。在這種情況下,套用更新後,可能立即會有其他更新。
如要套用工作負載更新,請完成下列步驟:
控制台
前往 Google Cloud 控制台的「Assured Workloads」頁面。
在「Name」(名稱) 欄中,按一下要查看更新的 Assured Workloads 資料夾名稱。或者,如果資料夾有可用的更新,請按一下「Updates」(更新) 欄中的連結。
在「可用的更新」下方,按一下「查看可用的更新」。
如有可用的組織政策更新,會顯示在「Organization policy」(組織政策) 分頁中。查看受影響的組織政策限制,然後按一下「View update」(查看更新),預覽更新後的限制設定。
按一下「Update organization policy」(更新組織政策),套用更新。
長時間執行的更新作業會啟動,並套用資料夾的新組織政策設定。
REST
organizations.locations.workloads.updates.apply 方法會為 Assured Workloads 工作負載套用指定更新。
HTTP 方法、網址和查詢參數:
POST https://[ENDPOINT_URI]/v1/organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/workloads/[WORKLOAD_ID]/updates/[UPDATE_ID]:apply
將下列預留位置值替換為您自己的值:
- ENDPOINT_URI:Assured Workloads 服務端點 URI。這個 URI 必須是與目的地工作負載位置相符的端點,例如
us-central1區域中的區域化工作負載為https://us-central1-assuredworkloads.googleapis.com,美國的多區域工作負載則為https://us-assuredworkloads.googleapis.com。 - ORGANIZATION_ID:Assured Workloads 資料夾的組織 ID,例如
919698201234。 - LOCATION_ID:Assured Workloads 資料夾的位置,例如
us-central1或us。這會對應到工作負載的data region值。 - WORKLOAD_ID:Assured Workloads 工作負載的 ID,用於列出可用的更新,例如
00-701ea036-7152-4780-a867-9f5。 - UPDATE_ID:要套用的更新 ID,從
organizations.locations.workloads.updates.list方法傳回的可用更新清單中選取,例如edb84871-833b-45ec-9c00-c9b5c19d2d87。
要求主體:
{ "name":"organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/workloads/[WORKLOAD_ID]/updates/[UPDATE_ID]", "action": "APPLY" }
例如:
POST https://us-central1-assuredworkloads.googleapis.com/v1/organizations/919698298765/locations/us-central1/workloads/00-701ea036-7152-4781-a867-9f5/updates/edb84871-833b-45ec-9c00-c9b5c19d2d87:apply{ "name": "organizations/919698298765/locations/us-central1/workloads/00-701ea036-7152-4781-a867-9f5/updates/edb84871-833b-45ec-9c00-c9b5c19d2d87", "action": "APPLY" }
如果成功,您會收到類似下列範例的 JSON 回應:
{ "name": "organizations/919698298765/locations/us-central1/operations/647b1c77-b9a5-45d2-965e-70a1e867fe5b", "metadata": { "@type": "type.googleapis.com/google.cloud.assuredworkloads.v1.ApplyWorkloadUpdateOperationMetadata", "update_name": "organizations/919698298765/locations/us-central1/workloads/00-701ea036-7152-4781-a867-9f5/updates/edb84871-833b-45ec-9c00-c9b5c19d2d87", "create_time": "2024-10-01T14:34:30.290896Z", "action": "APPLY" } }
如要取得長時間執行的更新作業狀態,請使用 JSON 回應中 name 值的作業 ID。以上述範例來說,作業 ID 為 647b1c77-b9a5-45d2-965e-70a1e867fe5b。接著,請提出下列要求,並將預留位置值替換成您自己的值:
GET https://[ENDPOINT_URI]/v1/organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/operations/[OPERATION_ID]
例如:
GET https://us-central1-assuredworkloads.googleapis.com/v1/organizations/919698298765/locations/us-central1/operations/647b1c77-b9a5-45d2-965e-70a1e867fe5b如果成功,您會收到類似下列範例的 JSON 回應:
{ "name": "organizations/919698298765/locations/us-central1/operations/647b1c77-b9a5-45d2-965e-70a1e867fe5b", "metadata": { "@type": "type.googleapis.com/google.cloud.assuredworkloads.v1.ApplyWorkloadUpdateOperationMetadata", "updateName": "organizations/919698298765/locations/us-central1/workloads/00-701ea036-7152-4781-a867-9f5/updates/edb84871-833b-45ec-9c00-c9b5c19d2d87", "createTime": "2024-10-01T13:33:09Z" "action": "APPLY" }, "done": true "response": { "@type": "type.googleapis.com/google.cloud.assuredworkloads.v1.ApplyWorkloadUpdateResponse", "appliedUpdate": { "name": "organizations/531459884741/locations/us-central1/workloads/00-0b328e90-da70-431e-befc-a4a/updates/db556beb-ce66-4260-bd3b-28115f1ec300", "state": "APPLIED", "createTime": "2024-10-01T14:31:24.310323Z", "updateTime": "2024-10-01T14:34:30.855792Z", "details": { "orgPolicyUpdate": { "appliedPolicy": { "resource": "folders/196232301850", "constraint": "constraints/compute.disableInstanceDataAccessApis", "rule": { "enforce": true } }, "suggestedPolicy": { "resource": "folders/196232301850", "constraint": "constraints/compute.disableInstanceDataAccessApis", "rule": { "enforce": false } } } } } } }