Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

查看 VM 擴充功能詳細資料和狀態

如要將 VM 擴充功能安裝至 Compute Engine 虛擬機器 (VM) 執行個體，請在組織、資料夾或專案層級建立全域或可用區擴充功能政策。單一政策可在單一 VM 安裝多項擴充功能，多項政策也可套用至同一個 VM。

本文說明如何使用 Google Cloud 資源階層中的唯讀get和list方法，執行下列工作：

查看資源階層中的擴充功能政策。列出全域或可用區 VM 擴充功能政策，查看整個組織、資料夾或專案的政策詳細資料和推出狀態。
查看 VM 擴充功能和版本。列出 VM 擴充功能管理工具支援的 VM 擴充功能，或查看擴充功能詳細資料 (包括版本號碼和支援等級)，涵蓋範圍包括貴組織、資料夾或專案中的所有可用區或特定可用區。
查看各 VM 上安裝的擴充功能狀態。如果政策在 VM 上安裝多個擴充功能，則列出執行個體上所有已安裝的 VM 擴充功能及其執行階段狀態；如果有多項政策適用於同一個 VM，則查看最終生效的設定和管理政策 (policyId)。
排解執行個體擴充功能問題。當 VM 執行個體上安裝了非預期的擴充功能，或擴充功能失敗時，您可以查看安裝進度、執行階段健康狀態和診斷訊息。

事前準備

查看 VM 擴充功能政策、擷取 VM 擴充功能詳細資料，或檢查 VM 執行個體的擴充功能狀態之前，請先完成下列必要條件：

請參閱「關於 VM 擴充功能管理工具」，瞭解擴充功能政策如何管理 VM 機群中的訪客代理程式外掛程式。
如果您尚未將擴充功能部署至執行個體，請先建立政策。詳情請參閱「建立擴充功能政策來安裝 VM 擴充功能」。
確認您具備必要的 Identity and Access Management 權限，可查看擴充功能政策、擷取擴充功能詳細資料，以及檢查執行個體擴充功能狀態。

政策和擴充功能查看限制

查看 VM 擴充功能政策、擴充功能詳細資料和執行個體狀態時，請考量下列操作限制：

如要查看資料夾範圍和組織範圍的 VM 擴充功能政策，只能使用 Google Cloud CLI 或 Compute Engine REST API。
您只能使用 Google Cloud CLI 或 Compute Engine REST API，擷取 VM 擴充功能詳細資料和執行個體擴充功能狀態。您無法在Google Cloud 控制台中查看 VM 擴充功能詳細資料或個別執行個體的擴充功能狀態。
執行個體擴充功能狀態 API (getVmExtensionState 和 listVmExtensionStates) 只會回報 VM 擴充功能管理工具政策安裝及管理的擴充功能執行階段狀態。這些 API 不會回報您在 VM 擴充功能管理工具以外，手動安裝的獨立代理程式狀態。

查看擴充功能政策

您可以在組織、資料夾或專案層級，列出 VM 擴充功能政策，或檢查特定政策的設定詳細資料。

查看組織中所有可用區的全域擴充功能政策

您可以列出組織中的所有全域 VM 擴充功能政策，或檢查特定組織範圍的全域政策，稽核整個機群的擴充功能推出情形。

必要 IAM 權限

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

這個預先定義的角色具備查看組織範圍擴充功能政策所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

必須具備下列權限，才能查看組織範圍的擴充功能政策：

列出擴充功能政策： compute.orgVmExtensionPolicies.list
查看擴充功能政策的詳細資料： compute.orgVmExtensionPolicies.get

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

如要查看組織中的全域擴充功能政策，請選取下列其中一個選項：

gcloud

如要查看組織中的所有全域擴充功能政策，請執行 gcloud preview compute global-vm-extension-policies list 指令並加上 --organization 旗標：

gcloud preview compute global-vm-extension-policies list \
  --organization=organizations/ORGANIZATION_ID \
  --page-size=PAGE_SIZE

更改下列內容：

ORGANIZATION_ID： Google Cloud 組織的 ID。
PAGE_SIZE：每頁傳回的結果數量上限。

如要查看組織中特定全域擴充功能政策的詳細資料，請執行 gcloud preview compute global-vm-extension-policies describe 指令並加上 --organization 旗標：

gcloud preview compute global-vm-extension-policies describe POLICY_NAME \
  --organization=organizations/ORGANIZATION_ID

更改下列內容：

POLICY_NAME：要查看的 VM 擴充功能政策名稱。
ORGANIZATION_ID： Google Cloud 組織的 ID。

REST

如要查看組織中的所有全域擴充功能政策，請向 organizationGlobalVmExtensionPolicies.list 方法傳送 GET 要求：

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

如要查看組織中特定全域擴充功能政策的詳細資料，請向 organizationGlobalVmExtensionPolicies.get 方法傳送 GET 要求：

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

更改下列內容：

POLICY_NAME：要查看的 VM 擴充功能政策名稱。
ORGANIZATION_ID： Google Cloud 組織的 ID。

查看資料夾中所有可用區的全域擴充功能政策

您可以列出資料夾中的所有全域 VM 擴充功能政策，或檢查特定資料夾範圍的全域政策，確認哪些擴充功能適用於該資料夾中的所有專案。

必要 IAM 權限

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

這個預先定義的角色具備查看資料夾範圍擴充政策所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

必須具備下列權限，才能查看資料夾範圍的擴充功能政策：

列出擴充功能政策： compute.folderVmExtensionPolicies.list
查看擴充功能政策的詳細資料： compute.folderVmExtensionPolicies.get

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

如要查看資料夾中的全域擴充功能政策，請選取下列其中一個選項：

gcloud

如要查看資料夾中的所有全域擴充功能政策，請執行 gcloud preview compute global-vm-extension-policies list 指令並加上 --folder 旗標：

gcloud preview compute global-vm-extension-policies list \
  --folder=folders/FOLDER_ID \
  --page-size=PAGE_SIZE

更改下列內容：

FOLDER_ID： Google Cloud 資料夾的 ID。
PAGE_SIZE：每頁傳回的結果數量上限。

如要查看資料夾中特定全域擴充政策的詳細資料，請執行 gcloud preview compute global-vm-extension-policies describe 指令並加上 --folder 旗標：

gcloud preview compute global-vm-extension-policies describe POLICY_NAME \
  --folder=folders/FOLDER_ID

更改下列內容：

POLICY_NAME：要查看的 VM 擴充功能政策名稱。
FOLDER_ID： Google Cloud 資料夾的 ID。

REST

如要查看資料夾中的所有全域擴充功能政策，請向 folderGlobalVmExtensionPolicies.list 方法傳送 GET 要求：

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

如要查看資料夾中特定全域擴充功能政策的詳細資料，請向 folderGlobalVmExtensionPolicies.get 方法傳送 GET 要求：

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

更改下列內容：

POLICY_NAME：要查看的 VM 擴充功能政策名稱。
FOLDER_ID： Google Cloud 資料夾的 ID。

查看專案中所有可用區的全域擴充功能政策

您可以查看專案中的全域 VM 擴充功能政策，監控推出進度，並檢查該專案中所有可用區的擴充功能設定。

必要 IAM 權限

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

這個預先定義的角色具備查看專案範圍擴充功能政策所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

必須具備下列權限，才能查看專案範圍的擴充功能政策：

列出擴充功能政策： compute.vmExtensionPolicies.list
查看擴充功能政策的詳細資料： compute.vmExtensionPolicies.get

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

如要查看專案中的全域擴充功能政策，請選取下列其中一個選項：

控制台

如要使用 Google Cloud 控制台查看專案中的全域 VM 擴充功能政策，請完成下列步驟：

前往 Google Cloud 控制台的「VM extension policies」(VM 擴充功能政策) 頁面。
前往「VM 擴充功能政策」頁面
按一下「Global policies」。這個分頁會列出專案中的所有全域 VM 擴充功能政策。

gcloud

如要查看專案中的所有全域擴充功能政策，請執行 gcloud compute global-vm-extension-policies list 指令：

gcloud compute global-vm-extension-policies list \
  --project=PROJECT_ID \
  --page-size=PAGE_SIZE

更改下列內容：

PROJECT_ID： Google Cloud 專案的 ID。
PAGE_SIZE：每頁傳回的結果數量上限。

如要查看專案中特定全域擴充功能政策的詳細資料，請執行 gcloud compute global-vm-extension-policies describe 指令：

gcloud compute global-vm-extension-policies describe POLICY_NAME \
  --project=PROJECT_ID

更改下列內容：

POLICY_NAME：要查看的 VM 擴充功能政策名稱。
PROJECT_ID： Google Cloud 專案的 ID。

REST

如要查看專案中的所有全域擴充功能政策，請向 globalVmExtensionPolicies.list 方法傳送 GET 要求：

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

如要查看專案中特定全域擴充功能政策的詳細資料，請向 globalVmExtensionPolicies.get 方法傳送 GET 要求：

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

更改下列內容：

POLICY_NAME：要查看的 VM 擴充功能政策名稱。
PROJECT_ID： Google Cloud 專案的 ID。

查看組織中某個可用區的可用區擴充功能政策

您可以列出特定可用區中組織範圍的 VM 擴充功能政策，或檢查單一政策，稽核整個組織的可用區層級強制執行規則。

必要 IAM 權限

這個預先定義的角色具備查看組織範圍擴充功能政策所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

必須具備下列權限，才能查看組織範圍的擴充功能政策：

列出擴充功能政策： compute.orgVmExtensionPolicies.list
查看擴充功能政策的詳細資料： compute.orgVmExtensionPolicies.get

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

如要查看組織中的可用區擴充政策，請選取下列其中一個選項：

gcloud

如要查看可用區中所有組織範圍的擴充功能政策，請執行 gcloud preview compute zone-vm-extension-policies list 指令並加上 --organization 旗標：

gcloud preview compute zone-vm-extension-policies list \
  --organization=organizations/ORGANIZATION_ID \
  --zone=ZONE \
  --page-size=PAGE_SIZE

更改下列內容：

ORGANIZATION_ID： Google Cloud 組織的 ID。
ZONE：要列出 VM 擴充功能政策的可用區名稱。
PAGE_SIZE：每頁傳回的結果數量上限。

如要查看特定組織範圍可用區擴充政策的詳細資料，請執行 gcloud preview compute zone-vm-extension-policies describe 指令並加上 --organization 旗標：

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

更改下列內容：

POLICY_NAME：要查看的 VM 擴充功能政策名稱。
ORGANIZATION_ID： Google Cloud 組織的 ID。
ZONE：VM 擴充功能政策所在的 Google Cloud 可用區。

REST

如要查看組織中的所有可用區擴充政策，請向 organizationZoneVmExtensionPolicies.list 方法傳送 GET 要求：

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

如要查看組織中特定可用區擴充政策的詳細資料，請向 organizationZoneVmExtensionPolicies.get 方法傳送 GET 要求：

GET 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：VM 擴充功能政策所在的 Google Cloud 可用區。

查看資料夾中某個可用區的可用區擴充功能政策

您可以列出特定可用區中，資料夾範圍的 VM 擴充功能政策，或檢查單一政策，驗證資料夾中專案的可用區層級擴充功能規則。

必要 IAM 權限

這個預先定義的角色具備查看資料夾範圍擴充政策所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

必須具備下列權限，才能查看資料夾範圍的擴充功能政策：

列出擴充功能政策： compute.folderVmExtensionPolicies.list
查看擴充功能政策的詳細資料： compute.folderVmExtensionPolicies.get

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

如要查看資料夾中的可用區擴充政策，請選取下列其中一個選項：

gcloud

如要查看區域中所有資料夾範圍的擴充功能政策，請執行 gcloud preview compute zone-vm-extension-policies list 指令並加上 --folder 旗標：

gcloud preview compute zone-vm-extension-policies list \
  --folder=folders/FOLDER_ID \
  --zone=ZONE \
  --page-size=PAGE_SIZE

更改下列內容：

FOLDER_ID： Google Cloud 資料夾的 ID。
ZONE：要列出 VM 擴充功能政策的可用區名稱。
PAGE_SIZE：每頁傳回的結果數量上限。

如要查看特定資料夾範圍可用區擴充政策的詳細資料，請執行 gcloud preview compute zone-vm-extension-policies describe 指令並加上 --folder 旗標：

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

更改下列內容：

POLICY_NAME：要查看的 VM 擴充功能政策名稱。
FOLDER_ID： Google Cloud 資料夾的 ID。
ZONE：VM 擴充功能政策所在的 Google Cloud 可用區。

REST

如要查看資料夾中的所有可用區擴充政策，請向 folderZoneVmExtensionPolicies.list 方法傳送 GET 要求：

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

如要查看資料夾中特定可用區擴充政策的詳細資料，請向 folderZoneVmExtensionPolicies.get 方法傳送 GET 要求：

GET 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：VM 擴充功能政策所在的 Google Cloud 可用區。

查看專案中某個可用區的可用區擴充功能政策

您可以列出特定可用區中專案範圍的 VM 擴充功能政策，或檢查單一政策，確認哪些擴充功能適用於該可用區中的執行個體。

必要 IAM 權限

這個預先定義的角色具備查看專案範圍擴充功能政策所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

必須具備下列權限，才能查看專案範圍的擴充功能政策：

列出擴充功能政策： compute.vmExtensionPolicies.list
查看擴充功能政策的詳細資料： compute.vmExtensionPolicies.get

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

如要查看專案中的可用區擴充政策，請選取下列其中一個選項：

控制台

如要使用 Google Cloud 控制台查看專案中的可用區 VM 擴充功能政策，請完成下列步驟：

前往 Google Cloud 控制台的「VM extension policies」(VM 擴充功能政策) 頁面。
前往「VM 擴充功能政策」頁面
如要查看特定擴充功能政策的詳細資料，請按一下政策名稱。

gcloud

如要查看可用區中所有專案範圍的擴充功能政策，請執行 gcloud compute zone-vm-extension-policies list 指令：

gcloud compute zone-vm-extension-policies list \
  --project=PROJECT_ID \
  --zone=ZONE \
  --page-size=PAGE_SIZE

更改下列內容：

PROJECT_ID： Google Cloud 專案的 ID。
ZONE：要列出 VM 擴充功能政策的可用區名稱。
PAGE_SIZE：每頁傳回的結果數量上限。

如要查看特定專案範圍可用區擴充政策的詳細資料，請執行 gcloud compute zone-vm-extension-policies describe 指令：

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

更改下列內容：

POLICY_NAME：要查看的 VM 擴充功能政策名稱。
PROJECT_ID： Google Cloud 專案的 ID。
ZONE：VM 擴充功能政策所在的 Google Cloud 可用區。

REST

如要查看專案中的所有可用區擴充政策，請向 zoneVmExtensionPolicies.list 方法傳送 GET 要求：

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

如要查看專案中特定可用區擴充政策的詳細資料，請向 zoneVmExtensionPolicies.get 方法傳送 GET 要求：

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

更改下列內容：

POLICY_NAME：要查看的 VM 擴充功能政策名稱。
PROJECT_ID： Google Cloud 專案的 ID。
ZONE：VM 擴充功能政策所在的 Google Cloud 可用區。

查看 VM 擴充功能和版本

您可以使用唯讀的 get 和 list 方法，查看 VM 擴充功能管理工具在整個組織、資料夾或專案中支援的 VM 擴充功能。您可以查看所有可用區或特定可用區內的擴充功能名稱、版本號碼和擴充功能支援等級。

查看組織中所有可用區的 VM 擴充功能

使用唯讀的 get 和 list 方法，查看 VM 擴充功能管理工具在貴組織所有可用區中支援的 VM 擴充功能，包括版本號碼和支援等級。

必要 IAM 權限

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

這個預先定義的角色具備查看組織中 VM 擴充功能所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

必須具備下列權限，才能查看組織中的 VM 擴充功能：

列出 VM 擴充功能：compute.orgVmExtensions.list
查看 VM 擴充功能的詳細資料：compute.orgVmExtensions.get

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

如要查看 VM 擴充功能管理工具在組織所有可用區支援的 VM 擴充功能和版本，請選取下列其中一個選項：

gcloud

如要列出 VM 擴充功能管理工具支援的所有 VM 擴充功能，以及貴組織所有可用區的支援等級，請執行 gcloud preview compute global-vm-extension-policies extensions list 指令並加上 --organization 旗標：

gcloud preview compute global-vm-extension-policies extensions list \
  --organization=organizations/ORGANIZATION_ID

更改下列內容：

ORGANIZATION_ID： Google Cloud 組織的 ID。

輸出內容會列出 VM 擴充功能管理工具支援的 VM 擴充功能、版本和擴充功能支援等級。

如要查看貴組織中特定 VM 擴充功能的詳細資料，請執行 gcloud preview compute global-vm-extension-policies extensions describe 指令並加上 --organization 旗標：

gcloud preview compute global-vm-extension-policies extensions describe EXTENSION_NAME \
  --organization=organizations/ORGANIZATION_ID

更改下列內容：

EXTENSION_NAME：VM 擴充功能的名稱 (例如 ops-agent、google-cloud-sap-extension 或 google-cloud-workload-extension)。
ORGANIZATION_ID： Google Cloud 組織的 ID。

REST

如要列出 VM 擴充功能管理工具支援的所有 VM 擴充功能，以及這些功能在組織內所有可用區的支援等級，請向 organizationGlobalVmExtensionPolicies.listVmExtensions 方法傳送 GET 要求：

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/global/vmExtensions

更改下列內容：

ORGANIZATION_ID： Google Cloud 組織的 ID。

回應會列出 VM 擴充功能管理工具支援的 VM 擴充功能、版本和擴充功能支援等級。

如要查看貴組織中特定 VM 擴充功能的詳細資料，請向 organizationGlobalVmExtensionPolicies.getVmExtension 方法傳送 GET 要求：

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/global/vmExtensions/EXTENSION_NAME

更改下列內容：

ORGANIZATION_ID： Google Cloud 組織的 ID。
EXTENSION_NAME：VM 擴充功能的名稱 (例如 ops-agent)。

查看資料夾中所有可用區的 VM 擴充功能

使用唯讀的 get 和 list 方法，查看 VM 擴充功能管理工具在資料夾中所有可用區支援的 VM 擴充功能，包括版本號碼和支援等級。

必要 IAM 權限

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

這個預先定義的角色具備查看資料夾中 VM 擴充功能所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

必須具備下列權限，才能查看資料夾中的 VM 擴充功能：

列出 VM 擴充功能：compute.folderVmExtensions.list
查看 VM 擴充功能的詳細資料：compute.folderVmExtensions.get

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

如要查看 VM 擴充功能管理工具在資料夾中所有可用區支援的 VM 擴充功能和版本，請選取下列其中一個選項：

gcloud

如要列出 VM 擴充功能管理工具支援的所有 VM 擴充功能，以及這些擴充功能在資料夾中所有可用區的支援等級，請執行 gcloud preview compute global-vm-extension-policies extensions list 指令並加上 --folder 旗標：

gcloud preview compute global-vm-extension-policies extensions list \
  --folder=folders/FOLDER_ID

更改下列內容：

FOLDER_ID： Google Cloud 資料夾的 ID。

輸出內容會列出 VM 擴充功能管理工具支援的 VM 擴充功能、版本和擴充功能支援等級。

如要查看資料夾中特定 VM 擴充功能的詳細資料，請執行 gcloud preview compute global-vm-extension-policies extensions describe 指令並加上 --folder 旗標：

gcloud preview compute global-vm-extension-policies extensions describe EXTENSION_NAME \
  --folder=folders/FOLDER_ID

更改下列內容：

EXTENSION_NAME：VM 擴充功能的名稱 (例如 ops-agent、google-cloud-sap-extension 或 google-cloud-workload-extension)。
FOLDER_ID： Google Cloud 資料夾的 ID。

REST

如要列出 VM 擴充功能管理工具支援的所有 VM 擴充功能，以及資料夾中所有可用區的支援等級，請傳送 GET 要求至 folderGlobalVmExtensionPolicies.listVmExtensions 方法：

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/global/vmExtensions

更改下列內容：

FOLDER_ID： Google Cloud 資料夾的 ID。

回應會列出 VM 擴充功能管理工具支援的 VM 擴充功能、版本和擴充功能支援等級。

如要查看資料夾中特定 VM 擴充功能的詳細資料，請向 folderGlobalVmExtensionPolicies.getVmExtension 方法傳送 GET 要求：

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/global/vmExtensions/EXTENSION_NAME

更改下列內容：

FOLDER_ID： Google Cloud 資料夾的 ID。
EXTENSION_NAME：VM 擴充功能的名稱 (例如 ops-agent)。

查看專案中所有可用區的 VM 擴充功能

使用唯讀的 get 和 list 方法，查看 VM 擴充功能管理工具在專案所有可用區中支援的 VM 擴充功能，包括版本號碼和支援等級。

必要 IAM 權限

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

這個預先定義的角色具備查看專案中 VM 擴充功能所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

必須具備下列權限，才能查看專案中的 VM 擴充功能：

列出 VM 擴充功能：compute.vmExtensions.list
查看 VM 擴充功能的詳細資料：compute.vmExtensions.get

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

如要查看 VM 擴充功能管理工具在專案所有可用區支援的 VM 擴充功能和版本，請選取下列其中一個選項：

gcloud

如要列出 VM 擴充功能管理工具支援的所有 VM 擴充功能，以及專案中所有可用區的支援層級，請執行 gcloud preview compute global-vm-extension-policies extensions list 指令：

gcloud preview compute global-vm-extension-policies extensions list \
  --project=PROJECT_ID

更改下列內容：

PROJECT_ID： Google Cloud 專案的 ID。

輸出內容會列出 VM 擴充功能管理工具支援的 VM 擴充功能、版本和擴充功能支援等級。

如要查看專案中特定 VM 擴充功能的詳細資料，請執行 gcloud preview compute global-vm-extension-policies extensions describe 指令：

gcloud preview compute global-vm-extension-policies extensions describe EXTENSION_NAME \
  --project=PROJECT_ID

更改下列內容：

EXTENSION_NAME：VM 擴充功能的名稱 (例如 ops-agent、google-cloud-sap-extension 或 google-cloud-workload-extension)。
PROJECT_ID： Google Cloud 專案的 ID。

REST

如要列出 VM 擴充功能管理工具支援的所有 VM 擴充功能，以及專案中所有可用區的支援等級，請向 globalVmExtensionPolicies.listVmExtensions 方法傳送 GET 要求：

GET https://compute.googleapis.com/compute/2026-10-01-preview/projects/PROJECT_ID/global/vmExtensions

更改下列內容：

PROJECT_ID： Google Cloud 專案的 ID。

下列 JSON 程式碼片段顯示範例回應，列出 VM 擴充功能管理工具支援的 VM 擴充功能，以及其擴充功能支援等級：

{
  "kind": "compute#globalVmExtensionList",
  "items": [
    {
      "kind": "compute#globalVmExtension",
      "name": "ops-agent",
      "versions": [
        "2.58.0",
        "2.57.0"
      ],
      "supportLevel": "GA",
      "selfLink": "https://www.googleapis.com/compute/2026-10-01-preview/projects/my-project/global/vmExtensions/ops-agent"
    }
  ]
}

如要查看專案中特定 VM 擴充功能的詳細資料，請向 globalVmExtensionPolicies.getVmExtension 方法傳送 GET 要求：

GET https://compute.googleapis.com/compute/2026-10-01-preview/projects/PROJECT_ID/global/vmExtensions/EXTENSION_NAME

更改下列內容：

PROJECT_ID： Google Cloud 專案的 ID。
EXTENSION_NAME：VM 擴充功能的名稱 (例如 ops-agent)。

查看組織中某個可用區的 VM 擴充功能

使用唯讀的 get 和 list 方法，查看 VM 擴充功能管理工具在貴組織特定可用區中支援的 VM 擴充功能，包括版本號碼和支援等級。

必要 IAM 權限

如要取得所需權限，查看組織中某個可用區的 VM 擴充功能，請要求管理員授予您組織的組織層級 Compute VM 擴充功能政策檢視者 (roles/compute.orgVmExtensionPolicyViewer) 或組織層級 Compute VM 擴充功能政策管理員 (roles/compute.orgVmExtensionPolicyAdmin) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備所需權限，可查看貴組織各可用區的 VM 擴充功能。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

您必須具備下列權限，才能查看組織中某個可用區的 VM 擴充功能：

列出 VM 擴充功能：compute.orgVmExtensions.list
查看 VM 擴充功能的詳細資料：compute.orgVmExtensions.get

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

如要查看 VM 擴充功能管理工具在貴組織某個可用區支援的 VM 擴充功能和版本，請選取下列其中一個選項：

gcloud

如要列出 VM 擴充功能管理工具支援的所有 VM 擴充功能，以及這些擴充功能在貴組織特定可用區的支援等級，請執行 gcloud preview compute zone-vm-extension-policies extensions list 指令並加上 --organization 旗標：

gcloud preview compute zone-vm-extension-policies extensions list \
  --organization=organizations/ORGANIZATION_ID \
  --zone=ZONE

更改下列內容：

ORGANIZATION_ID： Google Cloud 組織的 ID。
ZONE：要列出 VM 擴充功能的 Google Cloud 可用區 (例如 us-central1-a)。

輸出內容會列出 VM 擴充功能管理工具支援的 VM 擴充功能、版本和擴充功能支援等級。

如要查看貴組織中某個可用區內特定 VM 擴充功能的詳細資料，請執行 gcloud preview compute zone-vm-extension-policies extensions describe 指令並加上 --organization 旗標：

gcloud preview compute zone-vm-extension-policies extensions describe EXTENSION_NAME \
  --organization=organizations/ORGANIZATION_ID \
  --zone=ZONE

更改下列內容：

EXTENSION_NAME：VM 擴充功能的名稱 (例如 ops-agent)。
ORGANIZATION_ID： Google Cloud 組織的 ID。
ZONE：要查看擴充功能詳細資料的可用區。

REST

如要列出 VM 擴充功能管理工具支援的所有 VM 擴充功能，以及這些功能在貴組織特定可用區的支援等級，請向 organizationZoneVmExtensionPolicies.listVmExtensions 方法傳送 GET 要求：

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/zones/ZONE/vmExtensions

更改下列內容：

ORGANIZATION_ID： Google Cloud 組織的 ID。
ZONE：區域名稱 (例如 us-central1-a)。

回應會列出 VM 擴充功能管理工具支援的 VM 擴充功能、版本和擴充功能支援等級。

如要查看組織中某個可用區內特定 VM 擴充功能的詳細資料，請向 organizationZoneVmExtensionPolicies.getVmExtension 方法傳送 GET 要求：

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/zones/ZONE/vmExtensions/EXTENSION_NAME

更改下列內容：

ORGANIZATION_ID： Google Cloud 組織的 ID。
ZONE：可用區名稱。
EXTENSION_NAME：VM 擴充功能的名稱。

查看資料夾中某個可用區的 VM 擴充功能

使用唯讀 get 和 list 方法，查看 VM 擴充功能管理工具在資料夾中特定可用區支援的 VM 擴充功能，包括版本號碼和支援等級。

必要 IAM 權限

如要取得所需權限，以便查看資料夾中某個可用區的 VM 擴充功能，請要求管理員授予您資料夾的資料夾層級 Compute VM 擴充功能政策檢視者 (roles/compute.folderVmExtensionPolicyViewer) 或資料夾層級 Compute VM 擴充功能政策管理員 (roles/compute.folderVmExtensionPolicyAdmin) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備所需權限，可查看資料夾中某個可用區的 VM 擴充功能。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

您必須具備下列權限，才能查看資料夾中某個可用區的 VM 擴充功能：

列出 VM 擴充功能：compute.folderVmExtensions.list
查看 VM 擴充功能的詳細資料：compute.folderVmExtensions.get

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

如要查看 VM 擴充功能管理工具在資料夾中某個可用區支援的 VM 擴充功能和版本，請選取下列其中一個選項：

gcloud

如要列出 VM 擴充功能管理工具支援的所有 VM 擴充功能，以及這些功能在資料夾中特定可用區的支援等級，請執行 gcloud preview compute zone-vm-extension-policies extensions list 指令並加上 --folder 旗標：

gcloud preview compute zone-vm-extension-policies extensions list \
  --folder=folders/FOLDER_ID \
  --zone=ZONE

更改下列內容：

FOLDER_ID： Google Cloud 資料夾的 ID。
ZONE：要列出 VM 擴充功能的 Google Cloud 可用區 (例如 us-central1-a)。

輸出內容會列出 VM 擴充功能管理工具支援的 VM 擴充功能、版本和擴充功能支援等級。

如要查看資料夾中某個可用區內特定 VM 擴充功能的詳細資料，請執行 gcloud preview compute zone-vm-extension-policies extensions describe 指令並加上 --folder 旗標：

gcloud preview compute zone-vm-extension-policies extensions describe EXTENSION_NAME \
  --folder=folders/FOLDER_ID \
  --zone=ZONE

更改下列內容：

EXTENSION_NAME：VM 擴充功能的名稱 (例如 ops-agent)。
FOLDER_ID： Google Cloud 資料夾的 ID。
ZONE：要查看擴充功能詳細資料的可用區。

REST

如要列出 VM 擴充功能管理工具支援的所有 VM 擴充功能，以及這些擴充功能在資料夾中特定可用區的支援等級，請傳送 GET 要求至 folderZoneVmExtensionPolicies.listVmExtensions 方法：

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/zones/ZONE/vmExtensions

更改下列內容：

FOLDER_ID： Google Cloud 資料夾的 ID。
ZONE：區域名稱 (例如 us-central1-a)。

回應會列出 VM 擴充功能管理工具支援的 VM 擴充功能、版本和擴充功能支援等級。

如要查看資料夾中某個可用區內特定 VM 擴充功能的詳細資料，請向 folderZoneVmExtensionPolicies.getVmExtension 方法傳送 GET 要求：

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/zones/ZONE/vmExtensions/EXTENSION_NAME

更改下列內容：

FOLDER_ID： Google Cloud 資料夾的 ID。
ZONE：可用區名稱。
EXTENSION_NAME：VM 擴充功能的名稱。

查看專案可用區中的 VM 擴充功能

使用唯讀的 get 和 list 方法，查看 VM 擴充功能管理工具在專案特定可用區中支援的 VM 擴充功能，包括版本號碼和支援等級。

必要 IAM 權限

如要取得所需權限，查看專案可用區中的 VM 擴充功能，請要求管理員授予您專案的 Compute VM 擴充功能政策檢視者 (roles/compute.vmExtensionPolicyViewer) 或 Compute VM 擴充功能政策管理員 (roles/compute.vmExtensionPolicyAdmin) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備必要權限，可查看專案中某個可用區的 VM 擴充功能。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

如要查看專案中某個可用區的 VM 擴充功能，必須具備下列權限：

列出 VM 擴充功能：compute.vmExtensions.list
查看 VM 擴充功能的詳細資料：compute.vmExtensions.get

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

如要查看 VM 擴充功能管理工具在專案可用區中支援的 VM 擴充功能和版本，請選取下列其中一個選項：

gcloud

如要列出 VM 擴充功能管理工具支援的所有 VM 擴充功能，以及專案中特定可用區的支援等級，請執行 gcloud preview compute zone-vm-extension-policies extensions list 指令：

gcloud preview compute zone-vm-extension-policies extensions list \
  --zone=ZONE \
  --project=PROJECT_ID

更改下列內容：

ZONE：要列出 VM 擴充功能的 Google Cloud 可用區 (例如 us-central1-a)。
PROJECT_ID： Google Cloud 專案的 ID。

輸出內容會列出 VM 擴充功能管理工具支援的 VM 擴充功能、版本和擴充功能支援等級。

如要查看專案中某個可用區內特定 VM 擴充功能的詳細資料，請執行 gcloud preview compute zone-vm-extension-policies extensions describe 指令：

gcloud preview compute zone-vm-extension-policies extensions describe EXTENSION_NAME \
  --zone=ZONE \
  --project=PROJECT_ID

更改下列內容：

EXTENSION_NAME：VM 擴充功能的名稱 (例如 ops-agent)。
ZONE：要查看擴充功能詳細資料的可用區。
PROJECT_ID： Google Cloud 專案的 ID。

REST

如要列出 VM 擴充功能管理工具支援的所有 VM 擴充功能，以及這些功能在專案特定可用區的支援等級，請傳送 GET 要求至 zoneVmExtensionPolicies.listVmExtensions 方法：

GET https://compute.googleapis.com/compute/2026-10-01-preview/projects/PROJECT_ID/zones/ZONE/vmExtensions

更改下列內容：

PROJECT_ID： Google Cloud 專案的 ID。
ZONE：區域名稱 (例如 us-central1-a)。

回應會列出 VM 擴充功能管理工具支援的 VM 擴充功能、版本和擴充功能支援等級。

如要查看專案中某個可用區內特定 VM 擴充功能的詳細資料，請向 zoneVmExtensionPolicies.getVmExtension 方法傳送 GET 要求：

GET https://compute.googleapis.com/compute/2026-10-01-preview/projects/PROJECT_ID/zones/ZONE/vmExtensions/EXTENSION_NAME

更改下列內容：

PROJECT_ID： Google Cloud 專案的 ID。
ZONE：可用區名稱。
EXTENSION_NAME：VM 擴充功能的名稱。

查看執行個體的 VM 擴充功能狀態

如要將 VM 擴充功能安裝至 VM，請在組織、資料夾或專案層級建立全域或可用區擴充功能政策。單一政策可在單一 VM 安裝多個擴充功能，而資源階層中的多項政策可套用至同一個 VM。使用唯讀執行個體擴充功能狀態 list 和 get 方法，即可查看各個 VM 上已安裝擴充功能的執行階段狀態，不必連線至個別機器。這些方法可協助您查看每個已安裝擴充功能的最終有效設定和管理政策 (policyId)，或在安裝非預期擴充功能或擴充功能在執行個體上失敗時排解問題。

必要 IAM 權限

如要取得查看執行個體 VM 擴充功能狀態所需的權限，請要求管理員授予您專案的 Compute 檢視者 (roles/compute.viewer)、Compute 執行個體管理員 (v1) (roles/compute.instanceAdmin.v1) 或 Compute 管理員 (roles/compute.admin) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備查看執行個體 VM 擴充功能狀態所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

必須具備下列權限，才能查看執行個體的 VM 擴充功能狀態：

列出執行個體上的所有 VM 擴充功能狀態：compute.instances.listVmExtensionStates
取得執行個體上特定 VM 擴充功能的狀態：compute.instances.getVmExtensionState

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

列出執行個體的所有 VM 擴充功能狀態

如果政策在 VM 上安裝多個擴充功能、多項政策套用至同一個執行個體，或是在疑難排解期間發現非預期的擴充功能，請列出 VM 上的所有擴充功能狀態，查看每個已安裝擴充功能的最終有效設定和執行階段狀態。回應會顯示各個擴充功能的有效版本、強制執行狀態、健康狀態和管理政策 (policyId)。

如要查看執行個體上所有已安裝 VM 擴充功能的狀態，請選取下列其中一個選項：

gcloud

如要列出所有已安裝的 VM 擴充功能，並查看執行個體上的目前狀態，請執行 gcloud beta compute instances list-vm-extension-states 指令：

gcloud beta compute instances list-vm-extension-states INSTANCE_NAME \
    --zone=ZONE \
    --project=PROJECT_ID

請將下列變數替換為環境的值：

INSTANCE_NAME：VM 執行個體的名稱。
ZONE：執行個體所在的可用區 (例如 us-central1-a)。
PROJECT_ID： Google Cloud 專案的 ID。

這個指令會傳回表格，列出每個已安裝擴充功能的名稱、強制執行狀態和健康狀態：

EXTENSION_NAME  ENFORCEMENT_STATE  HEALTH_STATUS
ops-agent       INSTALLED          RUNNING

REST

如要列出所有已安裝的 VM 擴充功能，並查看執行個體上的目前狀態，請向 instances.listVmExtensionStates 方法傳送 GET 要求：

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/vmExtensionStates

請將下列變數替換為環境的值：

PROJECT_ID： Google Cloud 專案的 ID。
ZONE：執行個體所在的可用區。
INSTANCE_NAME：VM 執行個體的名稱或 ID。

下列 JSON 程式碼片段顯示範例回應，列出執行個體上已安裝擴充功能的狀態：

{
  "kind": "compute#vmExtensionStatesList",
  "items": [
    {
      "name": "ops-agent",
      "version": "2.58.0",
      "healthStatus": "RUNNING",
      "enforcementState": "INSTALLED",
      "healthMsg": "Plugin is running ok",
      "policyId": "projects/my-project/zones/us-central1-a/vmExtensionPolicies/prod-ops-policy"
    }
  ]
}

查看執行個體上特定 VM 擴充功能的狀態

如果有多項政策指定 VM，或已安裝的擴充功能未正常運作，請查看該擴充功能的狀態，瞭解最終生效的設定 (policyId 和版本) 和診斷狀態訊息。

如要查看執行個體上特定 VM 擴充功能的有效狀態和管理政策，請選取下列其中一個選項：

gcloud

如要擷取執行個體上特定 VM 擴充功能的有效狀態、使用中版本和管理政策，請執行 gcloud beta compute instances get-vm-extension-state 指令：

gcloud beta compute instances get-vm-extension-state INSTANCE_NAME \
    --extension-name=EXTENSION_NAME \
    --zone=ZONE \
    --project=PROJECT_ID

請將下列變數替換為環境的值：

INSTANCE_NAME：VM 執行個體的名稱。
EXTENSION_NAME：要檢查的擴充功能名稱 (例如 ops-agent)。
ZONE：執行個體所在的可用區。
PROJECT_ID： Google Cloud 專案的 ID。

REST

如要擷取執行個體上特定 VM 擴充功能的有效狀態、有效版本和管理政策，請向 instances.getVmExtensionState 方法傳送 GET 要求：

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/vmExtensionStates/EXTENSION_NAME

請將下列變數替換為環境的值：

PROJECT_ID： Google Cloud 專案的 ID。
ZONE：執行個體所在的可用區。
INSTANCE_NAME：VM 執行個體的名稱或 ID。
EXTENSION_NAME：VM 擴充功能的名稱 (例如 ops-agent)。

下列 JSON 程式碼片段顯示執行個體上單一 VM 擴充功能狀態的回應範例：

{
  "name": "ops-agent",
  "version": "2.58.0",
  "healthStatus": "RUNNING",
  "enforcementState": "INSTALLED",
  "enforcementMsg": "",
  "healthMsg": "Plugin is running ok",
  "policyId": "projects/my-project/zones/us-central1-a/vmExtensionPolicies/prod-ops-policy"
}

解讀 VM 擴充功能狀態欄位

擷取執行個體上的 VM 擴充功能狀態時，回應會包含多個欄位，分別回報強制執行的政策、有效版本、安裝進度，以及外掛程式的執行階段健康狀態。

下表說明 VmExtensionState 資源傳回的欄位：

欄位	說明
`name`	VM 擴充功能的 ID (例如 `ops-agent`)。
`version`	VM 執行個體上安裝的擴充功能有效版本。
`policyId`	在執行個體上強制執行這項擴充功能的有效 VM 擴充功能政策 ID。如果有多項政策指定 VM，這個欄位會指出優先順序解析後勝出的政策。
`enforcementState`	擴充功能強制執行程序的目前生命週期狀態。可能的值如下： `ENFORCEMENT_STATE_UNSPECIFIED`：未指定強制執行狀態。 `INSTALLING`：訪客代理程式正在安裝擴充功能。 `INSTALLED`：擴充功能已安裝在執行個體上。 `INSTALL_FAILED`：安裝失敗，且沒有可復原的穩定修訂版本。 `ROLLING_BACK`：訪客代理程式正在將擴充功能復原至上次記錄的穩定修訂版本。 `ROLLED_BACK`：擴充功能已復原至上一個穩定修訂版本。 `ROLLBACK_FAILED`：復原失敗。 `INCOMPATIBLE`：擴充功能版本的所有可用修訂版本，都與 VM 的作業系統或架構不相容。 `REMOVING`：訪客代理程式正在從執行個體中移除擴充功能。 `SERVICE_DISABLED`：專案中已停用這項擴充功能所需的服務 API。 `APPLYING_CONFIG`：訪客代理程式正在為擴充功能套用新設定，這可能需要重新啟動外掛程式。
`enforcementMsg`	如果擴充功能無法強制執行或發生安裝錯誤，客體代理程式會傳回診斷狀態訊息。
`healthStatus`	強制執行的擴充外掛程式執行階段健康狀態。如果尚未強制執行擴充功能，則不會指定這個值。可能的值如下： `HEALTH_STATUS_UNSPECIFIED`：未指定健康狀態。 `STARTING`：擴充功能程序正在啟動。 `RUNNING`：擴充功能程序正常運作。 `STOPPING`：擴充功能程序正在停止。 `STOPPED`：擴充功能程序已停止。 `CRASHED`：擴充功能程序已啟動，但意外停止執行。
`healthMsg`	擴充功能回報健康狀態的診斷訊息 (例如 `Plugin is running ok`)。

後續步驟

如要診斷推出失敗、檢查執行中的訪客程序，或檢查訪客代理程式偵錯記錄，請參閱「排解 VM 擴充功能問題」。
如要在 Cloud Logging 查詢過往的強制執行事件，以及稽核安裝或當機記錄，請參閱「查看 VM 擴充功能記錄」。
如要建立 Cloud Monitoring 資訊主頁，並設定代理程式健康狀態、CPU 和記憶體用量的快訊，請參閱「監控 VM 擴充功能」。
如要修改配置設定、變更固定的版本，或移除已部署的代理，請參閱「使用擴充功能政策管理 VM 擴充功能」。

查看 VM 擴充功能詳細資料和狀態 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

事前準備

政策和擴充功能查看限制

查看擴充功能政策

查看組織中所有可用區的全域擴充功能政策

必要 IAM 權限

所需權限

gcloud

REST

查看資料夾中所有可用區的全域擴充功能政策

必要 IAM 權限

所需權限

gcloud

REST

查看專案中所有可用區的全域擴充功能政策

必要 IAM 權限

所需權限

控制台

gcloud

REST

查看組織中某個可用區的可用區擴充功能政策

必要 IAM 權限

所需權限

gcloud

REST

查看資料夾中某個可用區的可用區擴充功能政策

必要 IAM 權限

所需權限

gcloud

REST

查看專案中某個可用區的可用區擴充功能政策

必要 IAM 權限

所需權限

控制台

gcloud

REST

查看 VM 擴充功能和版本

查看組織中所有可用區的 VM 擴充功能

必要 IAM 權限

所需權限

gcloud

REST

查看資料夾中所有可用區的 VM 擴充功能

必要 IAM 權限

所需權限

gcloud

REST

查看專案中所有可用區的 VM 擴充功能

必要 IAM 權限

所需權限

gcloud

REST

查看組織中某個可用區的 VM 擴充功能

必要 IAM 權限

所需權限

gcloud

REST

查看資料夾中某個可用區的 VM 擴充功能

必要 IAM 權限

所需權限

gcloud

REST

查看專案可用區中的 VM 擴充功能

必要 IAM 權限

所需權限

gcloud

REST

查看執行個體的 VM 擴充功能狀態

必要 IAM 權限

所需權限

列出執行個體的所有 VM 擴充功能狀態

gcloud

REST

查看執行個體上特定 VM 擴充功能的狀態

gcloud

REST

解讀 VM 擴充功能狀態欄位

後續步驟

查看 VM 擴充功能詳細資料和狀態