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

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

本文說明如何使用 Cloud de Confiance by S3NS 資源階層中的唯讀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 擴充功能詳細資料和執行個體擴充功能狀態。您無法在Cloud de Confiance 控制台中查看 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

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

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

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

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

必要 IAM 權限

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

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

所需權限

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

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

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

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

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

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

必要 IAM 權限

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

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

所需權限

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

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

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

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

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

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

必要 IAM 權限

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

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

所需權限

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

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

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

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

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

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

必要 IAM 權限

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

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

所需權限

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

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

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

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

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

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

必要 IAM 權限

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

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

所需權限

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

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

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

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

查看 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 擴充功能和版本，請選取下列其中一個選項：

查看資料夾中所有可用區的 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 擴充功能和版本，請選取下列其中一個選項：

查看專案中所有可用區的 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 擴充功能和版本，請選取下列其中一個選項：

查看組織中某個可用區的 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 擴充功能和版本，請選取下列其中一個選項：

查看資料夾中某個可用區的 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 擴充功能和版本，請選取下列其中一個選項：

查看專案可用區中的 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 擴充功能和版本，請選取下列其中一個選項：

查看執行個體的 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 擴充功能的狀態，請選取下列其中一個選項：

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

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

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

解讀 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 擴充功能」。