替換、移除或刪除配置政策

本文將說明如何替換、移除或刪除刊登位置政策。

在下列情況中，取代、移除或刪除刊登位置政策很有幫助：

  • 取代虛擬機器 (VM) 執行個體中的配置政策，將 VM 移至相對於其他 VM 的不同位置。

  • 如果您不再需要 VM 相對於其他 VM 的位置，可以從 VM 移除放置政策。

  • 不再需要配置政策時，可以將其刪除。

事前準備

  • 請參閱刊登位置政策的 限制。
  • 如果尚未設定驗證，請先完成設定。 驗證可確認您的身分，以便存取 Google Cloud 服務和 API。如要從本機開發環境執行程式碼或範例，請選取下列其中一個選項，向 Compute Engine 進行驗證：

    選取這個頁面上的分頁，瞭解如何使用範例：

    gcloud

    1. 安裝 Google Cloud CLI。 完成後，執行下列指令來初始化 Google Cloud CLI：

      gcloud init

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

  • 設定預設地區和區域。

    • REST

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

      安裝 Google Cloud CLI。

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

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

必要的角色

如要取得取代、移除或刪除放置政策所需的權限，請要求系統管理員授予您專案的 Compute 執行個體管理員 (v1) (roles/compute.instanceAdmin.v1) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備取代、移除或刪除刊登位置政策所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

如要取代、移除或刪除刊登位置政策，您必須具備下列權限：

  • 如要替換或移除 VM 的放置位置政策，請在專案上執行 compute.instances.update：
  • 如要刪除配置政策： 在專案中點選 compute.resourcePolicies.delete

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

替換 VM 中的配置政策

在 VM 中以密集配置政策取代分散配置政策前，請確認 VM 使用支援的機型和主機維護政策。如要在更換 VM 的放置政策前更新 VM，請執行下列一或多項操作：

在 VM 中取代放置位置政策後，您必須重新啟動 VM，新套用的放置位置政策才會生效。

如要取代 VM 中的放置位置政策，請選取下列任一選項：

gcloud

  1. 建立空白 YAML 檔案。

  2. 如要將 VM 的屬性匯出至您剛建立的 YAML 檔案，請使用 gcloud compute instances export 指令。

    gcloud compute instances export VM_NAME \
    --destination=FILE_PATH \
    --zone=ZONE

    更改下列內容：

    • VM_NAME：現有 VM 的名稱，用於指定配置政策。

    • FILE_PATH：您在上一個步驟中建立的 YAML 檔案路徑。

    • ZONE：VM 所在的可用區。

  3. 在 YAML 設定檔中，編輯 resourcePolicies 欄位的值，指定其他放置政策。

    resourcePolicies:
- https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME

    更改下列內容：

    • PROJECT_ID：放置政策所在的專案 ID。您只能指定與 VM 位於相同專案的配置方式政策。

    • REGION：放置政策所在的區域。

    • POLICY_NAME：放置政策的名稱。

  4. 如要更新及重新啟動 VM，請使用 gcloud compute instances update-from-file 指令，並將 --most-disruptive-allowed-action 旗標設為 RESTART。

    gcloud compute instances update-from-file VM_NAME \
    --most-disruptive-allowed-action=RESTART \
    --source=YAML_FILE \
    --zone=ZONE

    更改下列內容：

    • VM_NAME：VM 的名稱。

    • YAML_FILE：YAML 檔案的路徑，內含您在上一步修改的設定資料。

    • ZONE：VM 所在的可用區。

REST

  1. 建立空白的 JSON 檔案。

  2. 如要查看現有 VM 的屬性，請對 instances.get 方法發出 GET 要求。

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME

    更改下列內容：

    • PROJECT_ID：VM 所在的專案 ID。

    • ZONE：VM 所在的可用區。

    • VM_NAME：現有 VM 的名稱，用於指定配置政策。

  3. 在您於上個步驟建立的空白 JSON 檔案中，執行下列操作：

    1. 輸入 GET 要求輸出內容中的 VM 屬性。

    2. 找出 resourcePolicies 欄位，然後編輯其值，指定其他刊登位置政策。

      "resourcePolicies": [
  "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
]

      更改下列內容：

      • PROJECT_ID：放置政策所在的專案 ID。您只能指定與 VM 位於相同專案的配置方式政策。

      • REGION：放置策略所在的區域。

      • POLICY_NAME：放置位置政策的名稱。

  4. 如要更新 VM 並重新啟動，請對 instances.update 方法發出 PUT 要求。請在要求中執行下列操作：

    • 在要求網址中，加入設為 RESTART 的 most_disruptive_allowed_action 查詢參數。

    • 要求主體請使用您在先前步驟中建立及更新的 JSON 檔案中的 VM 設定詳細資料。

    PUT https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME?most_disruptive_allowed_action=RESTART

{
  ...
  "resourcePolicies": [
    "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
  ],
  ...
}

如要進一步瞭解如何更新 VM 屬性，請參閱「更新 VM 屬性」。

從 VM 移除配置政策

如要從 VM 移除具有兩個以上可用性網域的分散配置政策，不必停止 VM 即可完成。如要移除密集配置政策或只有一個可用性網域的散佈配置政策，請先停止 VM，再移除附加的配置政策。

從 VM 移除配置政策不會影響其物理位置。 不過，如果 VM 正在即時遷移，Compute Engine 可能會將 VM 移至其他實體位置。

如要從 VM 移除配置政策，請選取下列任一選項：

gcloud

如要從 VM 移除放置位置政策，請使用 gcloud compute instances remove-resource-policies 指令。

gcloud compute instances remove-resource-policies VM_NAME \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

更改下列內容：

  • VM_NAME：現有 VM 的名稱，用於指定放置位置政策。

  • POLICY_NAME：套用至 VM 的放置政策名稱。如要驗證放置位置政策的名稱，請查看 VM 的詳細資料，並檢查 resourcePolicies 欄位的值。

  • ZONE：VM 所在的可用區。

REST

如要從 VM 移除配置政策，請對 instances.removeResourcePolicies 方法發出 POST 要求。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/removeResourcePolicies

{
  "resourcePolicies": [
    "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
  ]
}

更改下列內容：

  • PROJECT_ID：VM 所在的專案 ID。

  • ZONE：VM 所在的可用區。

  • VM_NAME：現有 VM 的名稱，用於指定放置位置政策。

  • REGION：放置政策所在的區域。

  • POLICY_NAME：套用至 VM 的放置政策名稱。如要驗證放置位置政策的名稱，請查看 VM 的詳細資料，並檢查 resourcePolicies 欄位的值。

刪除配置政策

只有在任何 Compute Engine 資源都未套用放置群組政策時，您才能刪除該政策。否則無法刪除配置政策。 如要刪除套用至一或多項 Compute Engine 資源的放置位置政策，請執行下列其中一項操作：

  • 如果政策只套用至 VM，且您想保留 VM，請執行下列操作：

    1. 如本文所述，從 VM 移除配置政策。

    2. 按照本節說明刪除配置政策。

  • 如果沒有，請按照下列步驟操作：

    1. 選用： 從要保留的 VM 中移除放置政策，如本文所述。

    2. 依下列順序刪除套用放置群組政策的所有其他 Compute Engine 資源：

      1. VM

      2. 預留項目

      3. 執行個體範本

    3. 按照本節說明刪除配置政策。

如要刪除配置政策，請選取下列任一選項：

gcloud

如要刪除配置政策，請使用 gcloud compute resource-policies delete 指令。

gcloud compute resource-policies delete POLICY_NAME \
    --region=REGION

更改下列內容：

  • POLICY_NAME：現有放置政策的名稱。

  • REGION：放置政策所在的區域。

REST

如要刪除刊登位置政策，請對 resourcePolicies.delete 方法發出 DELETE 要求。

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME

更改下列內容：

  • PROJECT_ID：刊登位置政策所在的專案 ID。

  • REGION：放置政策所在的區域。

  • POLICY_NAME：現有放置政策的名稱。

後續步驟