套用工作負載更新

本頁面說明如何啟用、查看及套用 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.resourceLocations
    • gcp.restrictCmekCryptoKeyProjects
  • 資料邊界推出階段:只有在特定資料邊界與首次部署時處於相同的推出階段時,這項功能才支援查看及套用更新。舉例來說,如果您在資料邊界處於預先發布階段時部署工作負載,而該資料邊界後來正式發布,則必須先使用正式發布版重新部署工作負載,才能套用更新。如未重新部署工作負載,嘗試套用更新時可能會發生錯誤或違反法規。

事前準備

  • 找出要啟用更新的 Assured Workloads 資料夾資源 ID。
  • 在目標 Assured Workloads 資料夾和工作負載上指派或驗證 IAM 權限。

必要的 IAM 權限

如要啟用、查看或套用工作負載更新,呼叫端必須透過預先定義的角色 (包含更廣泛的權限) 或自訂角色 (僅限最低必要權限) 取得 IAM 權限。請注意,自訂角色無法使用必要的 orgpolicy.policy.set 權限。

必須具備下列權限:

啟用工作負載更新

啟用工作負載更新後,系統會建立 Assured Workloads 服務代理。接著,這個服務代理會獲得目標 Assured Workloads 資料夾的Assured Workloads 服務代理 (roles/assuredworkloads.serviceAgent) 角色。這個角色可讓服務代理檢查資料夾是否有可用更新。

如要啟用工作負載更新,請完成下列步驟:

控制台

  1. 前往 Google Cloud 控制台的「Assured Workloads」頁面。

    前往「Assured Workloads」

  2. 在頁面頂端的「Introducing Compliance Updates」(法規遵循更新簡介) 窗格中,按一下「Enable compliance updates」(啟用法規遵循更新)。

  3. 系統提示「要啟用法規遵循更新嗎?」時,請按一下「啟用」。

組織中所有 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

查看工作負載更新

如要查看工作負載更新,請完成下列步驟:

控制台

  1. 前往 Google Cloud 控制台的「Assured Workloads」頁面。

    前往「Assured Workloads」

  2. 在「Name」(名稱) 欄中,按一下要查看更新的 Assured Workloads 資料夾名稱。或者,如果資料夾有可用的更新,請按一下「Updates」(更新) 欄中的連結。

  3. 在「可用的更新」下方,按一下「查看可用的更新」。

  4. 如有可用的組織政策更新,會顯示在「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"
}

套用工作負載更新

將工作負載更新套用至工作負載是長時間執行的作業。如果工作負載設定在作業開始後、完成前有所變更,可能會發生錯誤。

此外,系統會定期依據最新可用設定,重新評估工作負載更新。在這種情況下,套用更新後,可能立即會有其他更新。

如要套用工作負載更新,請完成下列步驟:

控制台

  1. 前往 Google Cloud 控制台的「Assured Workloads」頁面。

    前往「Assured Workloads」

  2. 在「Name」(名稱) 欄中,按一下要查看更新的 Assured Workloads 資料夾名稱。或者,如果資料夾有可用的更新,請按一下「Updates」(更新) 欄中的連結。

  3. 在「可用的更新」下方,按一下「查看可用的更新」。

  4. 如有可用的組織政策更新,會顯示在「Organization policy」(組織政策) 分頁中。查看受影響的組織政策限制,然後按一下「View update」(查看更新),預覽更新後的限制設定。

  5. 按一下「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
            }
          }
        }
      }
    }
  }
}