使用擴充功能政策管理 VM 擴充功能

VM 擴充功能管理工具會使用擴充功能政策,大規模管理 VM 擴充功能。詳情請參閱「關於 VM 擴充功能管理工具」。本文說明如何在專案層級,或資料夾和組織層級 (預先發布版),更新及刪除全域和可用區 VM 擴充功能政策。如要查看 VM 執行個體的擴充功能政策、VM 擴充功能和版本,以及執行階段擴充功能狀態,請參閱「查看 VM 擴充功能詳細資料和狀態」。如要診斷安裝或執行階段問題,請參閱「排解 VM 擴充功能問題」。

政策管理限制

如要更新及刪除資料夾範圍和組織範圍的 VM 擴充功能政策,只能使用 Google Cloud CLI 或 Compute Engine REST API。您無法在Google Cloud 控制台管理資料夾或組織範圍的政策。

更新 VM 擴充功能政策來修改擴充功能

更新政策時,VM 擴充功能管理工具會將變更推送至所有適用的 VM,通常一分鐘內就會完成。如果修改納入標籤,系統可能會根據是否符合更新後的標籤,在新的 VM 上安裝擴充功能,或從現有 VM 解除安裝擴充功能。

修改組織中所有可用區的 VM 擴充功能

必要 IAM 權限

如要取得更新組織層級擴充功能政策所需的權限,請要求管理員授予您組織的組織層級 Compute VM 擴充功能政策管理員 (roles/compute.orgVmExtensionPolicyAdmin) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備 compute.orgVmExtensionPolicies.update 權限,可更新組織層級的擴充功能政策。

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

如要更新組織範圍的全域擴充欄位政策,請選取下列任一選項:

gcloud

使用 gcloud preview compute global-vm-extension-policies update 指令搭配 --organization 旗標,修改現有的組織範圍全域 VM 擴充功能政策。使用 gcloud 更新政策時,要求會完全取代現有政策。您省略的任何選用欄位都會還原為預設值,而不會保留修改後政策的現有值。

如要更新組織範圍的全域 VM 擴充功能政策,請執行下列指令:

gcloud preview compute global-vm-extension-policies update POLICY_NAME \
  --organization=organizations/ORGANIZATION_ID \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-conflict-behavior=ROLLOUT_CONFLICT_BEHAVIOR \
  --rollout-retry-uuid=RETRY_UUID

更改下列內容:

  • POLICY_NAME:要更新的 VM 擴充功能政策名稱。
  • ORGANIZATION_ID:您的 Google Cloud 組織 ID。
  • DESCRIPTION:政策說明 (選用)。
  • EXTENSION_NAME_1,EXTENSION_NAME_2:以半形逗號分隔的清單,列出要新增至政策的擴充功能。您必須指定至少一個擴充功能。您可以指定下列任一支援的副檔名:
    • ops-agent
    • google-cloud-sap-extension
    • google-cloud-workload-extension
  • EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2:以半形逗號分隔的鍵/值組合清單,其中鍵是擴充功能名稱,值是擴充功能版本。如未指定擴充功能版本,VM 擴充功能管理工具會使用最新可用版本,並在有新版本時自動升級。
  • EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2:以半形逗號分隔的鍵/值組合清單,其中鍵是擴充功能名稱,值則是該擴充功能的設定檔路徑。這個檔案位於您執行 gcloud 指令的 VM,而非安裝擴充功能的 VM。

    或者,如要以內嵌字串的形式提供設定,請使用 --config 旗標,而非 --config-from-file,例如 EXTENSION_NAME_1="CONFIG_1"。您可以使用 --config-from-file 或 --config,但不能在同一個指令中同時使用兩者。

  • KEY_1=VALUE_1:以半形逗號分隔的鍵/值組合清單,用於定義選取器的納入標籤。VM 必須具備選取器中的所有指定標籤,才能成為目標。如果多次指定 --inclusion-labels,政策會指定與所提供選取器「任一」相符的 VM (邏輯 OR)。如果省略這個旗標,政策會指定組織下所有子項專案和可用區中的所有 VM。
  • PRIORITY:0 到 65535 之間的整數,用於定義政策的優先順序。數字越小,優先順序越高。預設值為 1000。如果多項政策的優先順序相同,VM 擴充功能管理工具會將最近更新的政策套用至 VM。
  • ROLLOUT_PLAN:指定 slow_rollout 或 fast_rollout。 如要使用自訂推出計畫,請指定 --rollout-custom-plan 旗標,而非使用下列格式的 --rollout-predefined-plan:
    --rollout-custom-plan=organizations/ORGANIZATION_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME

    更改下列內容:

    • ORGANIZATION_ID:定義推出計畫的組織。
    • ROLLOUT_PLAN_NAME:您定義的自訂推出計畫名稱。

    如未指定推出計畫旗標,VM 擴充功能管理工具會使用 slow_rollout。

  • ROLLOUT_CONFLICT_BEHAVIOR:指定 VM 擴充功能管理工具偵測到可用區政策與全域政策衝突時的行為。您可以指定下列其中一種衝突行為:
    • "" (空字串):全域政策不會覆寫名稱相同的衝突可用區政策。這是預設的衝突行為。
    • overwrite:全域政策會覆寫任何同名的可用區政策,然後全域政策會管理可用區中的政策推出作業。

    詳情請參閱 --rollout-conflict-behavior 旗標。

  • RETRY_UUID:UUID,用於識別政策更新推出作業的重試。這個 UUID 可讓您在不變更的情況下重試更新。如果設定這個旗標,且政策遭到修改,就會發生錯誤。詳情請參閱「重試推出作業」。

範例:更新組織範圍的全域政策

下列指令會更新組織 123456789 中的政策 prod-frontend-policy,新增 google-cloud-workload-extension 擴充功能並取消固定 ops-agent,以便使用快速推出計畫追蹤最新版本:

gcloud preview compute global-vm-extension-policies update prod-frontend-policy \
  --organization=organizations/123456789 \
  --description="Updated policy: ops-agent + workload extension, unpinned" \
  --extensions=ops-agent,google-cloud-workload-extension \
  --config=ops-agent="updated-monitoring-config" \
  --inclusion-labels="env=prod,workload=frontend" \
  --priority=100 \
  --rollout-predefined-plan=fast_rollout

REST

如要更新組織範圍的全域擴充功能政策,請向 organizationGlobalVmExtensionPolicies.update 方法發出 PATCH 要求。使用 REST 更新政策時,只需提供要更新的欄位。任何省略的欄位都會保留現有值。

PATCH https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/global/vmExtensionPolicies/POLICY_NAME

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY,
"rolloutOperation": {
  "rolloutInput": {
    "conflictBehavior": "ROLLOUT_CONFLICT_BEHAVIOR",
    "retryUuid": "RETRY_UUID",
    "name": "organizations/ORGANIZATION_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME"
  }
}
}

更改下列內容:

  • ORGANIZATION_ID:您的 Google Cloud 組織 ID。
  • POLICY_NAME:要更新的 VM 擴充功能政策名稱。
  • DESCRIPTION:VM 擴充功能政策的說明。
  • EXTENSION_NAME:要更新的擴充功能名稱,在 extensionPolicies 對應中做為索引鍵。如要更新多個擴充功能,請在 extensionPolicies 對應中加入多個項目。
  • EXTENSION_NAME_VERSION:VM 擴充功能的版本。
  • EXTENSION_NAME_CONFIG:VM 擴充功能的設定,以內嵌字串表示。
  • KEY_1:VALUE_1、KEY_2:VALUE_2: 定義選取器納入標籤的鍵/值組合。VM 必須具備選取器中的所有指定標籤,才能成為目標。如要指定多個選取器,請在 instanceSelectors 陣列中加入多個物件,每個物件都包含 labelSelector 欄位。在這種情況下,VM 擴充功能管理工具會指定符合任一所提供選取器的 VM (邏輯 OR)。如果省略 instanceSelectors,政策會指定組織下所有子系專案和可用區中的所有 VM。
  • PRIORITY:0 到 65535 之間的整數,用於定義政策的優先順序。數字越小,優先順序越高。預設值為 1000。如果多項政策的優先順序相同,VM 擴充功能管理工具會將最近更新的政策套用至 VM。
  • ROLLOUT_CONFLICT_BEHAVIOR:指定 VM 擴充功能管理工具偵測到可用區政策與全域政策衝突時的行為。您可以指定下列其中一種衝突行為:
    • "" (空字串):全域政策不會覆寫名稱相同的衝突可用區政策。這是預設的衝突行為。
    • overwrite:全域政策會覆寫任何同名的可用區政策,然後全域政策會管理可用區中的政策推出作業。

    詳情請參閱 --rollout-conflict-behavior 旗標。

  • ROLLOUT_PLAN_NAME:您定義的自訂推出計畫名稱。 如要使用預先定義的推出計畫,請將 name 欄位替換為 predefinedRolloutPlan,並指定下列其中一個值:
    • SLOW_ROLLOUT:在五天內推出政策。如未指定計畫,系統會預設採用這個預先定義的推出計畫。
    • FAST_ROLLOUT:立即將政策推行至所有可用區。
  • RETRY_UUID:UUID,用於識別政策更新推出作業的重試。

修改資料夾中所有可用區的 VM 擴充功能

必要 IAM 權限

如要取得更新資料夾範圍擴充功能政策所需的權限,請要求管理員授予您資料夾的資料夾層級 Compute VM 擴充功能政策管理員 (roles/compute.folderVmExtensionPolicyAdmin) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備 compute.folderVmExtensionPolicies.update 權限,可更新資料夾範圍的擴充功能政策。

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

如要更新資料夾範圍的全域擴充功能政策,請選取下列其中一個選項:

gcloud

使用 gcloud preview compute global-vm-extension-policies update 指令搭配 --folder 旗標,修改現有的資料夾範圍全域 VM 擴充功能政策。使用 gcloud 更新政策時,要求會完全取代現有政策。您省略的任何選用欄位都會還原為預設值,而不會保留修改後政策的現有值。

如要更新資料夾範圍的全域 VM 擴充功能政策,請執行下列指令:

gcloud preview compute global-vm-extension-policies update POLICY_NAME \
  --folder=folders/FOLDER_ID \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-conflict-behavior=ROLLOUT_CONFLICT_BEHAVIOR \
  --rollout-retry-uuid=RETRY_UUID

更改下列內容:

  • POLICY_NAME:要更新的 VM 擴充功能政策名稱。
  • FOLDER_ID:您的 Google Cloud 資料夾 ID。
  • DESCRIPTION:政策說明 (選用)。
  • EXTENSION_NAME_1,EXTENSION_NAME_2:以半形逗號分隔的清單,列出要新增至政策的擴充功能。您必須指定至少一個擴充功能。您可以指定下列任一支援的副檔名:
    • ops-agent
    • google-cloud-sap-extension
    • google-cloud-workload-extension
  • EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2:以半形逗號分隔的鍵/值組合清單,其中鍵是擴充功能名稱,值是擴充功能版本。如未指定擴充功能版本,VM 擴充功能管理工具會使用最新可用版本,並在有新版本時自動升級。
  • EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2:以半形逗號分隔的鍵/值組合清單,其中鍵是擴充功能名稱,值則是該擴充功能的設定檔路徑。這個檔案位於您執行 gcloud 指令的 VM,而非安裝擴充功能的 VM。

    或者,如要以內嵌字串的形式提供設定,請使用 --config 旗標,而非 --config-from-file,例如 EXTENSION_NAME_1="CONFIG_1"。您可以使用 --config-from-file 或 --config,但不能在同一個指令中同時使用兩者。

  • KEY_1=VALUE_1:以半形逗號分隔的鍵/值組合清單,用於定義選取器的納入標籤。VM 必須具備選取器中的所有指定標籤,才能成為目標。如果多次指定 --inclusion-labels,政策會指定與所提供選取器「任一」相符的 VM (邏輯 OR)。如果省略這個旗標,政策會指定資料夾中所有子系專案和可用區的所有 VM。
  • PRIORITY:0 到 65535 之間的整數,用於定義政策的優先順序。數字越小,優先順序越高。預設值為 1000。如果多項政策的優先順序相同,VM 擴充功能管理工具會將最近更新的政策套用至 VM。
  • ROLLOUT_PLAN:指定 slow_rollout 或 fast_rollout。 如要使用自訂推出計畫,請指定 --rollout-custom-plan 旗標,而非使用下列格式的 --rollout-predefined-plan:
    --rollout-custom-plan=folders/FOLDER_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME

    更改下列內容:

    • FOLDER_ID:定義推出計畫的資料夾。
    • ROLLOUT_PLAN_NAME:您定義的自訂推出計畫名稱。

    如未指定推出計畫旗標,VM 擴充功能管理工具會使用 slow_rollout。

  • ROLLOUT_CONFLICT_BEHAVIOR:指定 VM 擴充功能管理工具偵測到可用區政策與全域政策衝突時的行為。您可以指定下列其中一種衝突行為:
    • "" (空字串):全域政策不會覆寫名稱相同的衝突可用區政策。這是預設的衝突行為。
    • overwrite:全域政策會覆寫任何同名的可用區政策,然後全域政策會管理可用區中的政策推出作業。

    詳情請參閱 --rollout-conflict-behavior 旗標。

  • RETRY_UUID:UUID,用於識別政策更新推出作業的重試。這個 UUID 可讓您在不變更的情況下重試更新。如果設定這個旗標,且政策遭到修改,就會發生錯誤。詳情請參閱「重試推出作業」。

REST

如要更新資料夾範圍的全域擴充功能政策,請向 folderGlobalVmExtensionPolicies.update 方法發出 PATCH 要求。使用 REST 更新政策時,只需提供要更新的欄位。任何省略的欄位都會保留現有值。

PATCH https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/global/vmExtensionPolicies/POLICY_NAME

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY,
"rolloutOperation": {
  "rolloutInput": {
    "conflictBehavior": "ROLLOUT_CONFLICT_BEHAVIOR",
    "retryUuid": "RETRY_UUID",
    "name": "folders/FOLDER_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME"
  }
}
}

更改下列內容:

  • FOLDER_ID:您的 Google Cloud 資料夾 ID。
  • POLICY_NAME:要更新的 VM 擴充功能政策名稱。
  • DESCRIPTION:VM 擴充功能政策的說明。
  • EXTENSION_NAME:要更新的擴充功能名稱,在 extensionPolicies 對應中做為索引鍵。如要更新多個擴充功能,請在 extensionPolicies 對應中加入多個項目。
  • EXTENSION_NAME_VERSION:VM 擴充功能的版本。
  • EXTENSION_NAME_CONFIG:VM 擴充功能的設定,以內嵌字串表示。
  • KEY_1:VALUE_1、KEY_2:VALUE_2: 定義選取器納入標籤的鍵/值組合。VM 必須具備選取器中的所有指定標籤,才能成為目標。如要指定多個選取器,請在 instanceSelectors 陣列中加入多個物件,每個物件都包含 labelSelector 欄位。在這種情況下,VM 擴充功能管理工具會指定符合任一所提供選取器的 VM (邏輯 OR)。如果省略 instanceSelectors,政策會指定資料夾中所有子系專案和可用區的所有 VM。
  • PRIORITY:0 到 65535 之間的整數,用於定義政策的優先順序。數字越小,優先順序越高。預設值為 1000。如果多項政策的優先順序相同,VM 擴充功能管理工具會將最近更新的政策套用至 VM。
  • ROLLOUT_CONFLICT_BEHAVIOR:指定 VM 擴充功能管理工具偵測到可用區政策與全域政策衝突時的行為。您可以指定下列其中一種衝突行為:
    • "" (空字串):全域政策不會覆寫名稱相同的衝突可用區政策。這是預設的衝突行為。
    • overwrite:全域政策會覆寫任何同名的可用區政策,然後全域政策會管理可用區中的政策推出作業。

    詳情請參閱 --rollout-conflict-behavior 旗標。

  • ROLLOUT_PLAN_NAME:您定義的自訂推出計畫名稱。 如要使用預先定義的推出計畫,請將 name 欄位替換為 predefinedRolloutPlan,並指定下列其中一個值:
    • SLOW_ROLLOUT:在五天內推出政策。如未指定計畫,系統會預設採用這個預先定義的推出計畫。
    • FAST_ROLLOUT:立即將政策推行至所有可用區。
  • RETRY_UUID:UUID,用於識別政策更新推出作業的重試。

修改專案中所有可用區的 VM 擴充功能

必要 IAM 權限

如要取得更新專案範圍擴充功能政策所需的權限,請要求管理員授予您專案的Compute VM 擴充功能政策管理員 (roles/compute.vmExtensionPolicyAdmin) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備 compute.vmExtensionPolicies.update 權限,可更新專案範圍的擴充功能政策。

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

如要更新專案範圍的全域擴充功能政策,請選取下列其中一個選項:

控制台

如要在 Google Cloud 控制台更新專案範圍的全域 VM 擴充功能政策,請完成下列步驟:

  1. 前往 Google Cloud 控制台的「VM extension policies」(VM 擴充功能政策) 頁面。

    前往「VM 擴充功能政策」頁面

  2. 按一下「Global policies」(全域政策),然後選取要編輯的政策。
  3. 按一下 [編輯]。
  4. 在「Priority」(優先順序) 欄位中指定優先順序編號,解決政策之間的衝突。數字越小,優先順序越高。預設值為 1000。
  5. 在「Manage extensions」(管理擴充功能) 部分,執行下列操作:
    • 如要新增更多擴充功能,請按一下「新增擴充功能」,然後選取擴充功能和版本。
    • 如要刪除這項政策管理的擴充功能,請按一下擴充功能名稱旁的「刪除」按鈕。
  6. 如要套用標籤,請在「Target VM instances」(目標 VM 執行個體) 區段中,為目標 VM 新增標籤。
  7. 按一下「儲存」。

gcloud

使用 gcloud compute global-vm-extension-policies update 指令,修改現有的專案範圍全域 VM 擴充功能政策。使用 gcloud 更新政策時,要求會完全取代現有政策。您省略的任何選用欄位都會還原為預設值,而不會保留修改後政策的現有值。

如要更新專案範圍的全域 VM 擴充功能政策,請執行下列指令:

gcloud compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-conflict-behavior=ROLLOUT_CONFLICT_BEHAVIOR \
  --rollout-retry-uuid=RETRY_UUID

更改下列內容:

  • POLICY_NAME:要更新的 VM 擴充功能政策名稱。
  • PROJECT_ID:您的 Google Cloud 專案 ID。
  • DESCRIPTION:政策說明 (選用)。
  • EXTENSION_NAME_1,EXTENSION_NAME_2:以半形逗號分隔的清單,列出要新增至政策的擴充功能。您必須指定至少一個擴充功能。您可以指定下列任一支援的副檔名:
    • ops-agent
    • google-cloud-sap-extension
    • google-cloud-workload-extension
  • EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2:以半形逗號分隔的鍵/值組合清單,其中鍵是擴充功能名稱,值是擴充功能版本。如未指定擴充功能版本,VM 擴充功能管理工具會使用最新可用版本,並在有新版本時自動升級。
  • EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2:以半形逗號分隔的鍵/值組合清單,其中鍵是擴充功能名稱,值則是該擴充功能的設定檔路徑。這個檔案位於您執行 gcloud 指令的 VM,而非安裝擴充功能的 VM。

    或者,如要以內嵌字串的形式提供設定,請使用 --config 旗標,而非 --config-from-file,例如 EXTENSION_NAME_1="CONFIG_1"。您可以使用 --config-from-file 或 --config,但不能在同一個指令中同時使用兩者。

  • KEY_1=VALUE_1:以半形逗號分隔的鍵/值組合清單,用於定義選取器的納入標籤。VM 必須具備選取器中的所有指定標籤,才能成為目標。如果多次指定 --inclusion-labels,政策會指定與所提供選取器「任一」相符的 VM (邏輯 OR)。如果省略這個旗標,政策會指定專案中所有可用區的所有 VM。
  • PRIORITY:0 到 65535 之間的整數,用於定義政策的優先順序。數字越小,優先順序越高。預設值為 1000。如果多項政策的優先順序相同,VM 擴充功能管理工具會將最近更新的政策套用至 VM。
  • ROLLOUT_PLAN:指定 slow_rollout 或 fast_rollout。 如要使用自訂推出計畫,請指定 --rollout-custom-plan 旗標,而非使用下列格式的 --rollout-predefined-plan:
    --rollout-custom-plan=projects/PROJECT_NUMBER/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME

    更改下列內容:

    • PROJECT_NUMBER:定義推出計畫的專案。
    • ROLLOUT_PLAN_NAME:您定義的自訂推出計畫名稱。

    如未指定推出計畫旗標,VM 擴充功能管理工具會使用 slow_rollout。

  • ROLLOUT_CONFLICT_BEHAVIOR:指定 VM 擴充功能管理工具偵測到可用區政策與全域政策衝突時的行為。您可以指定下列其中一種衝突行為:
    • "" (空字串):全域政策不會覆寫名稱相同的衝突可用區政策。這是預設的衝突行為。
    • overwrite:全域政策會覆寫任何同名的可用區政策,然後全域政策會管理可用區中的政策推出作業。

    詳情請參閱 --rollout-conflict-behavior 旗標。

  • RETRY_UUID:UUID,用於識別政策更新推出作業的重試。這個 UUID 可讓您在不變更的情況下重試更新。如果設定這個旗標,且政策遭到修改,就會發生錯誤。詳情請參閱「重試推出作業」。

REST

如要更新專案範圍的全域擴充功能政策,請向 globalVmExtensionPolicies.update 方法發出 PATCH 要求。使用 REST 更新政策時,只需提供要更新的欄位。任何省略的欄位都會保留現有值。

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/vmExtensionPolicies/POLICY_NAME

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY,
"rolloutOperation": {
  "rolloutInput": {
    "conflictBehavior": "ROLLOUT_CONFLICT_BEHAVIOR",
    "retryUuid": "RETRY_UUID",
    "name": "projects/PROJECT_NUMBER/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME"
  }
}
}

更改下列內容:

  • PROJECT_ID:您的 Google Cloud 專案 ID。
  • POLICY_NAME:要更新的 VM 擴充功能政策名稱。
  • DESCRIPTION:VM 擴充功能政策的說明。
  • EXTENSION_NAME:要更新的擴充功能名稱,在 extensionPolicies 對應中做為索引鍵。如要更新多個擴充功能,請在 extensionPolicies 對應中加入多個項目。
  • EXTENSION_NAME_VERSION:VM 擴充功能的版本。
  • EXTENSION_NAME_CONFIG:VM 擴充功能的設定,以內嵌字串表示。
  • KEY_1:VALUE_1、KEY_2:VALUE_2: 定義選取器納入標籤的鍵/值組合。VM 必須具備選取器中的所有指定標籤,才能成為目標。如要指定多個選取器,請在 instanceSelectors 陣列中加入多個物件,每個物件都包含 labelSelector 欄位。在這種情況下,VM 擴充功能管理工具會指定符合任一所提供選取器的 VM (邏輯 OR)。如果省略 instanceSelectors,政策會指定專案中所有可用區的所有 VM。
  • PRIORITY:0 到 65535 之間的整數,用於定義政策的優先順序。數字越小,優先順序越高。預設值為 1000。如果多項政策的優先順序相同,VM 擴充功能管理工具會將最近更新的政策套用至 VM。
  • ROLLOUT_CONFLICT_BEHAVIOR:指定 VM 擴充功能管理工具偵測到可用區政策與全域政策衝突時的行為。您可以指定下列其中一種衝突行為:
    • "" (空字串):全域政策不會覆寫名稱相同的衝突可用區政策。這是預設的衝突行為。
    • overwrite:全域政策會覆寫任何同名的可用區政策,然後全域政策會管理可用區中的政策推出作業。

    詳情請參閱 --rollout-conflict-behavior 旗標。

  • PROJECT_NUMBER:定義自訂推出計畫的專案。
  • ROLLOUT_PLAN_NAME:您定義的自訂推出計畫名稱。 如要使用預先定義的推出計畫,請將 name 欄位替換為 predefinedRolloutPlan,並指定下列其中一個值:
    • SLOW_ROLLOUT:在五天內推出政策。如未指定計畫,系統會預設採用這個預先定義的推出計畫。
    • FAST_ROLLOUT:立即將政策推行至所有可用區。
  • RETRY_UUID:UUID,用於識別政策更新推出作業的重試。

修改組織內某個可用區的 VM 擴充功能

必要 IAM 權限

如要取得更新組織層級擴充功能政策所需的權限,請要求管理員授予您組織的組織層級 Compute VM 擴充功能政策管理員 (roles/compute.orgVmExtensionPolicyAdmin) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備 compute.orgVmExtensionPolicies.update 權限,可更新組織層級的擴充功能政策。

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

如要更新組織範圍的可用區擴充政策,請選取下列其中一個選項:

gcloud

使用 gcloud preview compute zone-vm-extension-policies update 指令搭配 --organization 旗標,修改現有的組織範圍可用區 VM 擴充功能政策。使用 gcloud 更新政策時,要求會完全取代政策。您省略的任何選用欄位都會還原為預設值,而非保留修改後政策的現有值。

如要更新組織範圍的可用區 VM 擴充功能政策,請執行下列指令:

gcloud preview compute zone-vm-extension-policies update POLICY_NAME \
  --organization=organizations/ORGANIZATION_ID \
  --zone=ZONE \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY

更改下列內容:

  • POLICY_NAME:要更新的 VM 擴充功能政策名稱。
  • ORGANIZATION_ID:您的 Google Cloud 組織 ID。
  • ZONE:政策適用的 Google Cloud 區域。
  • DESCRIPTION:政策說明 (選用)。
  • EXTENSION_NAME_1,EXTENSION_NAME_2:以半形逗號分隔的清單,列出要新增至政策的擴充功能。您必須指定至少一個擴充功能。您可以指定下列任一支援的副檔名:
    • ops-agent
    • google-cloud-sap-extension
    • google-cloud-workload-extension
  • EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2:以半形逗號分隔的鍵/值組合清單,其中鍵是擴充功能名稱,值是擴充功能版本。如未指定擴充功能版本,VM 擴充功能管理工具會使用最新可用版本,並在有新版本時自動升級。
  • EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2:以半形逗號分隔的鍵/值組合清單,其中鍵是擴充功能名稱,值則是該擴充功能的設定檔路徑。這個檔案位於您執行 gcloud 指令的 VM,而非安裝擴充功能的 VM。

    或者,如要以內嵌字串的形式提供設定,請使用 --config 旗標,而非 --config-from-file,例如 EXTENSION_NAME_1="CONFIG_1"。您可以使用 --config-from-file 或 --config,但不能在同一個指令中同時使用兩者。

  • KEY_1=VALUE_1:以半形逗號分隔的鍵/值組合清單,用於定義選取器的納入標籤。VM 必須具備選取器中的所有指定標籤,才能成為目標。如果多次指定 --inclusion-labels,政策會指定與所提供選取器「任一」相符的 VM (邏輯 OR)。如果省略這個旗標,政策會指定組織下所有子項專案中,指定可用區內的所有 VM。
  • PRIORITY:0 到 65535 之間的整數,用於定義政策的優先順序。數字越小,優先順序越高。預設值為 1000。如果多項政策的優先順序相同,VM 擴充功能管理工具會將最近更新的政策套用至 VM。

REST

如要更新組織範圍的可用區擴充功能政策,請向 organizationZoneVmExtensionPolicies.update 方法發出 PATCH 要求。使用 REST 更新政策時,只需提供要更新的欄位。任何省略的欄位都會保留現有值。

PATCH https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/zones/ZONE/vmExtensionPolicies/POLICY_NAME

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY
}

更改下列內容:

  • ORGANIZATION_ID:您的 Google Cloud 組織 ID。
  • ZONE:VM 擴充功能政策所在的 Google Cloud 可用區。
  • POLICY_NAME:要更新的 VM 擴充功能政策名稱。
  • DESCRIPTION:VM 擴充功能政策的說明。
  • EXTENSION_NAME:要更新的擴充功能名稱,在 extensionPolicies 對應中做為索引鍵。如要更新多個擴充功能,請在 extensionPolicies 對應中加入多個項目。
  • EXTENSION_NAME_VERSION:VM 擴充功能的版本。
  • EXTENSION_NAME_CONFIG:VM 擴充功能的設定,以內嵌字串表示。
  • KEY_1:VALUE_1、KEY_2:VALUE_2: 定義選取器納入標籤的鍵/值組合。VM 必須具備選取器中的所有指定標籤,才能成為目標。如要指定多個選取器,請在 instanceSelectors 陣列中加入多個物件,每個物件都包含 labelSelector 欄位。在這種情況下,VM 擴充功能管理工具會指定符合任一所提供選取器的 VM (邏輯 OR)。如果省略 instanceSelectors,政策會指定組織下所有子項專案中,指定可用區內的所有 VM。
  • PRIORITY:0 到 65535 之間的整數,用於定義政策的優先順序。數字越小,優先順序越高。預設值為 1000。如果多項政策的優先順序相同,VM 擴充功能管理工具會將最近更新的政策套用至 VM。

修改資料夾中某個可用區的 VM 擴充功能

必要 IAM 權限

如要取得更新資料夾範圍擴充功能政策所需的權限,請要求管理員授予您資料夾的資料夾層級 Compute VM 擴充功能政策管理員 (roles/compute.folderVmExtensionPolicyAdmin) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備 compute.folderVmExtensionPolicies.update 權限,可更新資料夾範圍的擴充功能政策。

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

如要更新資料夾範圍可用區擴充政策,請選取下列其中一個選項:

gcloud

使用 gcloud preview compute zone-vm-extension-policies update 指令和 --folder 旗標,修改現有的資料夾範圍可用區 VM 擴充功能政策。使用 gcloud 更新政策時,要求會完全取代政策。您省略的任何選用欄位都會還原為預設值,而非保留修改後政策的現有值。

如要更新資料夾範圍的可用區 VM 擴充功能政策,請執行下列指令:

gcloud preview compute zone-vm-extension-policies update POLICY_NAME \
  --folder=folders/FOLDER_ID \
  --zone=ZONE \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY

更改下列內容:

  • POLICY_NAME:要更新的 VM 擴充功能政策名稱。
  • FOLDER_ID:您的 Google Cloud 資料夾 ID。
  • ZONE:政策適用的 Google Cloud 區域。
  • DESCRIPTION:政策說明 (選用)。
  • EXTENSION_NAME_1,EXTENSION_NAME_2:以半形逗號分隔的清單,列出要新增至政策的擴充功能。您必須指定至少一個擴充功能。您可以指定下列任一支援的副檔名:
    • ops-agent
    • google-cloud-sap-extension
    • google-cloud-workload-extension
  • EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2:以半形逗號分隔的鍵/值組合清單,其中鍵是擴充功能名稱,值是擴充功能版本。如未指定擴充功能版本,VM 擴充功能管理工具會使用最新可用版本,並在有新版本時自動升級。
  • EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2:以半形逗號分隔的鍵/值組合清單,其中鍵是擴充功能名稱,值則是該擴充功能的設定檔路徑。這個檔案位於您執行 gcloud 指令的 VM,而非安裝擴充功能的 VM。

    或者,如要以內嵌字串的形式提供設定,請使用 --config 旗標,而非 --config-from-file,例如 EXTENSION_NAME_1="CONFIG_1"。您可以使用 --config-from-file 或 --config,但不能在同一個指令中同時使用兩者。

  • KEY_1=VALUE_1:以半形逗號分隔的鍵/值組合清單,用於定義選取器的納入標籤。VM 必須具備選取器中的所有指定標籤,才能成為目標。如果多次指定 --inclusion-labels,政策會指定與所提供選取器「任一」相符的 VM (邏輯 OR)。如果省略這個旗標,政策會指定資料夾內所有子項專案中,指定可用區內的所有 VM。
  • PRIORITY:0 到 65535 之間的整數,用於定義政策的優先順序。數字越小,優先順序越高。預設值為 1000。如果多項政策的優先順序相同,VM 擴充功能管理工具會將最近更新的政策套用至 VM。

REST

如要更新資料夾範圍的可用區擴充功能政策,請向 folderZoneVmExtensionPolicies.update 方法發出 PATCH 要求。使用 REST 更新政策時,只需提供要更新的欄位。任何省略的欄位都會保留現有值。

PATCH https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/zones/ZONE/vmExtensionPolicies/POLICY_NAME

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY
}

更改下列內容:

  • FOLDER_ID:您的 Google Cloud 資料夾 ID。
  • ZONE:VM 擴充功能政策所在的 Google Cloud 可用區。
  • POLICY_NAME:要更新的 VM 擴充功能政策名稱。
  • DESCRIPTION:VM 擴充功能政策的說明。
  • EXTENSION_NAME:要更新的擴充功能名稱,在 extensionPolicies 對應中做為索引鍵。如要更新多個擴充功能,請在 extensionPolicies 對應中加入多個項目。
  • EXTENSION_NAME_VERSION:VM 擴充功能的版本。
  • EXTENSION_NAME_CONFIG:VM 擴充功能的設定,以內嵌字串表示。
  • KEY_1:VALUE_1、KEY_2:VALUE_2: 定義選取器納入標籤的鍵/值組合。VM 必須具備選取器中的所有指定標籤,才能成為目標。如要指定多個選取器,請在 instanceSelectors 陣列中加入多個物件,每個物件都包含 labelSelector 欄位。在這種情況下,VM 擴充功能管理工具會指定符合任一所提供選取器的 VM (邏輯 OR)。如果省略 instanceSelectors,政策會指定資料夾內所有子系專案中,指定可用區內的所有 VM。
  • PRIORITY:0 到 65535 之間的整數,用於定義政策的優先順序。數字越小,優先順序越高。預設值為 1000。如果多項政策的優先順序相同,VM 擴充功能管理工具會將最近更新的政策套用至 VM。

修改專案中某個可用區的 VM 擴充功能

必要 IAM 權限

如要取得更新專案範圍擴充功能政策所需的權限,請要求管理員授予您專案的Compute VM 擴充功能政策管理員 (roles/compute.vmExtensionPolicyAdmin) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備 compute.vmExtensionPolicies.update 權限,可更新專案範圍的擴充功能政策。

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

如要更新專案範圍可用區擴充政策,請選取下列其中一個選項:

控制台

如要在 Google Cloud 控制台更新專案範圍可用區 VM 擴充功能政策,請完成下列步驟:

  1. 前往 Google Cloud 控制台的「VM extension policies」(VM 擴充功能政策) 頁面。

    前往「VM 擴充功能政策」頁面

  2. 選取要更新的政策。
  3. 按一下 [編輯]。
  4. 修改「Description」(說明)、「Priority」(優先順序)、「Extensions」(擴充功能) 或「Target VM instances」(目標 VM 執行個體)。
  5. 按一下「儲存」。

gcloud

使用 gcloud compute zone-vm-extension-policies update 指令,修改現有的專案範圍區域 VM 擴充功能政策。使用 gcloud 更新政策時,要求會完全取代政策。您省略的任何選用欄位都會還原為預設值,而非保留修改後政策的現有值。

如要更新專案範圍內可用區 VM 擴充功能政策,請執行下列指令:

gcloud compute zone-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY

更改下列內容:

  • POLICY_NAME:要更新的 VM 擴充功能政策名稱。
  • PROJECT_ID:您的 Google Cloud 專案 ID。
  • ZONE:政策適用的 Google Cloud 區域。
  • DESCRIPTION:政策說明 (選用)。
  • EXTENSION_NAME_1,EXTENSION_NAME_2:以半形逗號分隔的清單,列出要新增至政策的擴充功能。您必須指定至少一個擴充功能。您可以指定下列任一支援的副檔名:
    • ops-agent
    • google-cloud-sap-extension
    • google-cloud-workload-extension
  • EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2:以半形逗號分隔的鍵/值組合清單,其中鍵是擴充功能名稱,值是擴充功能版本。如未指定擴充功能版本,VM 擴充功能管理工具會使用最新可用版本,並在有新版本時自動升級。
  • EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2:以半形逗號分隔的鍵/值組合清單,其中鍵是擴充功能名稱,值則是該擴充功能的設定檔路徑。這個檔案位於您執行 gcloud 指令的 VM,而非安裝擴充功能的 VM。

    或者,如要以內嵌字串的形式提供設定,請使用 --config 旗標,而非 --config-from-file,例如 EXTENSION_NAME_1="CONFIG_1"。您可以使用 --config-from-file 或 --config,但不能在同一個指令中同時使用兩者。

  • KEY_1=VALUE_1:以半形逗號分隔的鍵/值組合清單,用於定義選取器的納入標籤。VM 必須具備選取器中的所有指定標籤,才能成為目標。如果多次指定 --inclusion-labels,政策會指定與所提供選取器「任一」相符的 VM (邏輯 OR)。如果省略這個旗標,政策會指定專案中指定可用區內的所有 VM。
  • PRIORITY:0 到 65535 之間的整數,用於定義政策的優先順序。數字越小,優先順序越高。預設值為 1000。如果多項政策的優先順序相同,VM 擴充功能管理工具會將最近更新的政策套用至 VM。

REST

如要更新專案範圍的可用區擴充功能政策,請向 zoneVmExtensionPolicies.update 方法發出 PATCH 要求。使用 REST 更新政策時,只需提供要更新的欄位。任何省略的欄位都會保留現有值。

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/vmExtensionPolicies/POLICY_NAME

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY
}

更改下列內容:

  • PROJECT_ID:您的 Google Cloud 專案 ID。
  • ZONE:VM 擴充功能政策所在的 Google Cloud 可用區。
  • POLICY_NAME:要更新的 VM 擴充功能政策名稱。
  • DESCRIPTION:VM 擴充功能政策的說明。
  • EXTENSION_NAME:要更新的擴充功能名稱,在 extensionPolicies 對應中做為索引鍵。如要更新多個擴充功能,請在 extensionPolicies 對應中加入多個項目。
  • EXTENSION_NAME_VERSION:VM 擴充功能的版本。
  • EXTENSION_NAME_CONFIG:VM 擴充功能的設定,以內嵌字串表示。
  • KEY_1:VALUE_1、KEY_2:VALUE_2: 定義選取器納入標籤的鍵/值組合。VM 必須具備選取器中的所有指定標籤,才能成為目標。如要指定多個選取器,請在 instanceSelectors 陣列中加入多個物件,每個物件都包含 labelSelector 欄位。在這種情況下,VM 擴充功能管理工具會指定符合任一所提供選取器的 VM (邏輯 OR)。如果省略 instanceSelectors,政策會指定專案中指定可用區內的所有 VM。
  • PRIORITY:0 到 65535 之間的整數,用於定義政策的優先順序。數字越小,優先順序越高。預設值為 1000。如果多項政策的優先順序相同,VM 擴充功能管理工具會將最近更新的政策套用至 VM。

刪除 VM 擴充功能政策,藉此解除安裝擴充功能

刪除政策後,VM 擴充功能管理工具會從該政策管理的 VM 解除安裝擴充功能。不過,如果另一個有效、優先順序較低的政策適用於 VM,且宣告相同的擴充功能,則該擴充功能仍會根據優先順序較低的政策,安裝在該 VM 上。

政策刪除後,VM 擴充功能管理工具會在一分鐘內,從所有可存取的 VM 移除擴充功能。如果因客體代理程式遭移除或 VM 遭刪除,導致無法存取 VM,VM 擴充功能管理工具會略過刪除擴充功能。如果這類 VM 再次可用,VM 擴充功能管理工具就會移除擴充功能。

解除安裝組織內所有可用區的 VM 擴充功能

必要 IAM 權限

如要取得刪除組織範圍擴充功能政策所需的權限,請要求管理員授予您組織的組織層級 Compute VM 擴充功能政策管理員 (roles/compute.orgVmExtensionPolicyAdmin) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備 compute.orgVmExtensionPolicies.delete 權限,可刪除組織範圍的擴充功能政策。

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

如要刪除組織範圍的全域擴充功能政策,請選取下列任一選項:

gcloud

使用 gcloud preview compute global-vm-extension-policies delete 指令並搭配 --organization 旗標,刪除現有的組織範圍全域 VM 擴充功能政策:

gcloud preview compute global-vm-extension-policies delete POLICY_NAME \
  --organization=organizations/ORGANIZATION_ID \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-retry-uuid=RETRY_UUID

更改下列內容:

  • POLICY_NAME:要刪除的 VM 擴充功能政策名稱。
  • ORGANIZATION_ID: Google Cloud 組織的 ID。
  • ROLLOUT_PLAN:指定 slow_rollout 或 fast_rollout。 如要使用自訂推出計畫,請指定 --rollout-custom-plan 旗標,而非使用下列格式的 --rollout-predefined-plan:
    --rollout-custom-plan=organizations/ORGANIZATION_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME

    更改下列內容:

    • ORGANIZATION_ID:定義推出計畫的組織。
    • ROLLOUT_PLAN_NAME:您定義的自訂推出計畫名稱。

    如未指定推出計畫旗標,VM 擴充功能管理工具會使用 slow_rollout。

  • RETRY_UUID:重試刪除擴充功能政策的 UUID。只有在重試刪除處於 DELETING 狀態的現有政策時,才需要設定這個欄位。如果政策並非處於 DELETING 狀態,設定這個欄位會導致錯誤。詳情請參閱「重試推出作業」。

REST

如要刪除組織範圍的全域擴充功能政策,請向 organizationGlobalVmExtensionPolicies.delete 方法發出 POST 要求。

POST https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/global/vmExtensionPolicies/POLICY_NAME/delete

{
"retryUuid": "RETRY_UUID",
"predefinedRolloutPlan": "ROLLOUT_PLAN"
}

更改下列內容:

  • POLICY_NAME:要刪除的 VM 擴充功能政策名稱。
  • ORGANIZATION_ID:您的 Google Cloud 組織 ID。
  • ROLLOUT_PLAN:指定 SLOW_ROLLOUT 或 FAST_ROLLOUT。如要使用自訂推出計畫,請將 predefinedRolloutPlan 替換為 "name": "organizations/ORGANIZATION_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME"。
  • RETRY_UUID:重試刪除擴充功能政策的 UUID。只有在重試刪除處於 DELETING 狀態的現有政策時,才需要設定這個欄位。如果政策並非處於 DELETING 狀態,設定這個欄位會導致錯誤。詳情請參閱「重試推出作業」。

解除安裝資料夾中所有可用區的 VM 擴充功能

必要 IAM 權限

如要取得刪除資料夾範圍擴充功能政策所需的權限,請要求管理員授予您資料夾的資料夾層級 Compute VM 擴充功能政策管理員 (roles/compute.folderVmExtensionPolicyAdmin) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備 compute.folderVmExtensionPolicies.delete 權限,可刪除資料夾範圍的擴充功能政策。

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

如要刪除資料夾範圍的全域擴充功能政策,請選取下列任一選項:

gcloud

使用 gcloud preview compute global-vm-extension-policies delete 指令並搭配 --folder 旗標,刪除現有的資料夾範圍全域 VM 擴充功能政策:

gcloud preview compute global-vm-extension-policies delete POLICY_NAME \
  --folder=folders/FOLDER_ID \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-retry-uuid=RETRY_UUID

更改下列內容:

  • POLICY_NAME:要刪除的 VM 擴充功能政策名稱。
  • FOLDER_ID: Google Cloud 資料夾的 ID。
  • ROLLOUT_PLAN:指定 slow_rollout 或 fast_rollout。 如要使用自訂推出計畫,請指定 --rollout-custom-plan 旗標,而非使用下列格式的 --rollout-predefined-plan:
    --rollout-custom-plan=folders/FOLDER_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME

    更改下列內容:

    • FOLDER_ID:定義推出計畫的資料夾。
    • ROLLOUT_PLAN_NAME:您定義的自訂推出計畫名稱。

    如未指定推出計畫旗標,VM 擴充功能管理工具會使用 slow_rollout。

  • RETRY_UUID:重試刪除擴充功能政策的 UUID。只有在重試刪除處於 DELETING 狀態的現有政策時,才需要設定這個欄位。如果政策並非處於 DELETING 狀態,設定這個欄位會導致錯誤。詳情請參閱「重試推出作業」。

REST

如要刪除資料夾範圍的全域擴充功能政策,請向 folderGlobalVmExtensionPolicies.delete 方法發出 POST 要求。

POST https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/global/vmExtensionPolicies/POLICY_NAME/delete

{
"retryUuid": "RETRY_UUID",
"predefinedRolloutPlan": "ROLLOUT_PLAN"
}

更改下列內容:

  • POLICY_NAME:要刪除的 VM 擴充功能政策名稱。
  • FOLDER_ID:您的 Google Cloud 資料夾 ID。
  • ROLLOUT_PLAN:指定 SLOW_ROLLOUT 或 FAST_ROLLOUT。如要使用自訂推出計畫,請將 predefinedRolloutPlan 替換為 "name": "folders/FOLDER_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME"。
  • RETRY_UUID:重試刪除擴充功能政策的 UUID。只有在重試刪除處於 DELETING 狀態的現有政策時,才需要設定這個欄位。如果政策並非處於 DELETING 狀態,設定這個欄位會導致錯誤。詳情請參閱「重試推出作業」。

解除安裝專案中所有可用區的 VM 擴充功能

必要 IAM 權限

如要取得刪除專案範圍擴充功能政策所需的權限,請要求管理員授予您專案的 Compute VM 擴充功能政策管理員 (roles/compute.vmExtensionPolicyAdmin) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備 compute.vmExtensionPolicies.delete 權限,可刪除專案範圍的擴充功能政策。

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

如要刪除專案範圍的全域擴充功能政策,請選取下列任一選項:

控制台

如要在 Google Cloud 控制台刪除專案範圍的全域 VM 擴充功能政策,請完成下列步驟:

  1. 前往 Google Cloud 控制台的「VM extension policies」(VM 擴充功能政策) 頁面。

    前往「VM 擴充功能政策」頁面

  2. 按一下「Global policies」(全域政策),然後選取要刪除的政策。
  3. 點選「刪除」。
  4. 在確認對話方塊中輸入政策名稱,然後按一下「Delete」(刪除)。

gcloud

使用 gcloud compute global-vm-extension-policies delete 指令,刪除現有的專案範圍全域 VM 擴充功能政策:

gcloud compute global-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-retry-uuid=RETRY_UUID

更改下列內容:

  • POLICY_NAME:要刪除的 VM 擴充功能政策名稱。
  • PROJECT_ID: Google Cloud 專案的 ID。
  • ROLLOUT_PLAN:指定 slow_rollout 或 fast_rollout。 如要使用自訂推出計畫,請指定 --rollout-custom-plan 旗標,而非使用下列格式的 --rollout-predefined-plan:
    --rollout-custom-plan=projects/PROJECT_NUMBER/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME

    更改下列內容:

    • PROJECT_NUMBER:定義推出計畫的專案。
    • ROLLOUT_PLAN_NAME:您定義的自訂推出計畫名稱。

    如未指定推出計畫旗標,VM 擴充功能管理工具會使用 slow_rollout。

  • RETRY_UUID:重試刪除擴充功能政策的 UUID。只有在重試刪除處於 DELETING 狀態的現有政策時,才需要設定這個欄位。如果政策並非處於 DELETING 狀態,設定這個欄位會導致錯誤。詳情請參閱「重試推出作業」。

REST

如要刪除專案範圍的全域擴充功能政策,請向 globalVmExtensionPolicies.delete 方法傳送 POST 要求。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/vmExtensionPolicies/POLICY_NAME/delete

{
"retryUuid": "RETRY_UUID",
"predefinedRolloutPlan": "ROLLOUT_PLAN"
}

更改下列內容:

  • POLICY_NAME:要刪除的 VM 擴充功能政策名稱。
  • PROJECT_ID:您的 Google Cloud 專案 ID。
  • ROLLOUT_PLAN:指定 SLOW_ROLLOUT 或 FAST_ROLLOUT。如要使用自訂推出計畫,請將 predefinedRolloutPlan 替換為 "name": "projects/PROJECT_NUMBER/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME"。
  • RETRY_UUID:重試刪除擴充功能政策的 UUID。只有在重試刪除處於 DELETING 狀態的現有政策時,才需要設定這個欄位。如果政策並非處於 DELETING 狀態,設定這個欄位會導致錯誤。詳情請參閱「重試推出作業」。

在組織內解除安裝可用區中的 VM 擴充功能

必要 IAM 權限

如要取得刪除組織層級擴充功能政策所需的權限,請要求管理員授予您組織的組織層級 Compute VM 擴充功能政策管理員 (roles/compute.orgVmExtensionPolicyAdmin) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備 compute.orgVmExtensionPolicies.delete 權限,可刪除組織範圍的擴充功能政策。

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

如要刪除組織範圍可用區擴充政策,請選取下列任一選項:

gcloud

使用 gcloud preview compute zone-vm-extension-policies delete 指令並搭配 --organization 旗標,刪除現有的組織範圍可用區 VM 擴充功能政策:

gcloud preview compute zone-vm-extension-policies delete POLICY_NAME \
  --organization=organizations/ORGANIZATION_ID \
  --zone=ZONE

更改下列內容:

  • POLICY_NAME:要刪除的 VM 擴充功能政策名稱。
  • ORGANIZATION_ID: Google Cloud 組織的 ID。
  • ZONE:政策所在的 Google Cloud 可用區。

REST

如要刪除組織層級可用區擴充功能政策,請向 organizationZoneVmExtensionPolicies.delete 方法發出 DELETE 要求。

DELETE https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/zones/ZONE/vmExtensionPolicies/POLICY_NAME

更改下列內容:

  • POLICY_NAME:要刪除的 VM 擴充功能政策名稱。
  • ORGANIZATION_ID:您的 Google Cloud 組織 ID。
  • ZONE:政策所在的 Google Cloud 可用區。

在資料夾中解除安裝可用區內的 VM 擴充功能

必要 IAM 權限

如要取得刪除資料夾範圍擴充功能政策所需的權限,請要求管理員授予您資料夾的資料夾層級 Compute VM 擴充功能政策管理員 (roles/compute.folderVmExtensionPolicyAdmin) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備 compute.folderVmExtensionPolicies.delete 權限,可刪除資料夾範圍的擴充功能政策。

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

如要刪除資料夾範圍可用區擴充政策,請選取下列其中一個選項:

gcloud

使用 gcloud preview compute zone-vm-extension-policies delete 指令並搭配 --folder 旗標,刪除現有的資料夾範圍可用區 VM 擴充功能政策:

gcloud preview compute zone-vm-extension-policies delete POLICY_NAME \
  --folder=folders/FOLDER_ID \
  --zone=ZONE

更改下列內容:

  • POLICY_NAME:要刪除的 VM 擴充功能政策名稱。
  • FOLDER_ID: Google Cloud 資料夾的 ID。
  • ZONE:政策所在的 Google Cloud 可用區。

REST

如要刪除資料夾範圍的可用區擴充政策,請向 folderZoneVmExtensionPolicies.delete 方法傳送 DELETE 要求。

DELETE https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/zones/ZONE/vmExtensionPolicies/POLICY_NAME

更改下列內容:

  • POLICY_NAME:要刪除的 VM 擴充功能政策名稱。
  • FOLDER_ID:您的 Google Cloud 資料夾 ID。
  • ZONE:政策所在的 Google Cloud 可用區。

解除安裝專案可用區中的 VM 擴充功能

必要 IAM 權限

如要取得刪除專案範圍擴充功能政策所需的權限,請要求管理員授予您專案的 Compute VM 擴充功能政策管理員 (roles/compute.vmExtensionPolicyAdmin) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備 compute.vmExtensionPolicies.delete 權限,可刪除專案範圍的擴充功能政策。

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

如要刪除專案範圍可用區擴充功能政策,請選取下列其中一個選項:

控制台

如要在 Google Cloud 控制台刪除專案範圍可用區 VM 擴充功能政策,請完成下列步驟:

  1. 前往 Google Cloud 控制台的「VM extension policies」(VM 擴充功能政策) 頁面。

    前往「VM 擴充功能政策」頁面

  2. 選取要刪除的政策。
  3. 點選「刪除」。
  4. 在確認對話方塊中點按「刪除」。

gcloud

使用 gcloud compute zone-vm-extension-policies delete 指令,刪除現有的專案範圍可用區 VM 擴充功能政策:

gcloud compute zone-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

更改下列內容:

  • POLICY_NAME:要刪除的 VM 擴充功能政策名稱。
  • PROJECT_ID: Google Cloud 專案的 ID。
  • ZONE:政策所在的 Google Cloud 可用區。

REST

如要刪除專案範圍可用區擴充功能政策,請向 zoneVmExtensionPolicies.delete 方法傳送 DELETE 要求。

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/vmExtensionPolicies/POLICY_NAME

更改下列內容:

  • POLICY_NAME:要刪除的 VM 擴充功能政策名稱。
  • PROJECT_ID:您的 Google Cloud 專案 ID。
  • ZONE:政策所在的 Google Cloud 可用區。

後續步驟