您可以通过在组织、文件夹或项目级层创建全局或可用区级扩展程序政策,在 Compute Engine 虚拟机实例上安装虚拟机扩展程序。一项政策可以在单个虚拟机上安装多个扩展程序,并且多项政策可以应用于同一虚拟机。
本文档介绍了如何在 Google Cloud 资源层次结构中使用只读 get 和 list 方法来执行以下任务:
- 查看资源层次结构中的扩展程序政策。列出全局或可用区虚拟机扩展程序政策,以查看整个组织、文件夹或项目的政策详情和发布状态。
- 查看虚拟机扩展程序和版本。列出虚拟机扩展程序管理器支持的虚拟机扩展程序,或查看组织、文件夹或项目中所有可用区或特定可用区内的扩展程序详细信息(包括版本号和支持级别)。
- 查看每个虚拟机上已安装扩展程序的状态。当某项政策在虚拟机上安装了多个扩展程序时,列出实例上安装的所有虚拟机扩展程序及其运行时状态;或者当多项政策应用于同一虚拟机时,查看最终生效的配置和主导政策 (
policyId)。 - 排查实例上的扩展程序问题。在虚拟机实例上安装了意外扩展程序或扩展程序失败时,查看安装进度、运行时健康状况和诊断消息。
准备工作
在查看虚拟机扩展程序政策、检索虚拟机扩展程序详细信息或检查虚拟机实例上的扩展程序状态之前,请先完成以下前提条件:
- 请参阅虚拟机扩展程序管理器简介,了解扩展程序政策如何管理虚拟机舰队中的客机代理插件。
- 如果您尚未将扩展程序部署到实例,请先创建政策。如需了解详情,请参阅通过创建扩展程序政策来安装虚拟机扩展程序。
- 确保您拥有查看扩展程序政策、检索扩展程序详细信息以及检查实例扩展程序状态所需的 Identity and Access Management 权限。
政策和扩展程序查看限制
查看虚拟机扩展程序政策、扩展程序详细信息和实例状态时,请考虑以下操作限制:
- 您只能使用 Google Cloud CLI 或 Compute Engine REST API 查看文件夹级和组织级虚拟机扩展程序政策。
- 您只能使用 Google Cloud CLI 或 Compute Engine REST API 检索虚拟机扩展程序详细信息和实例扩展程序状态。您无法在Google Cloud 控制台中查看虚拟机扩展程序详细信息或每个实例的扩展程序状态。
- 实例扩展程序状态 API(
getVmExtensionState和listVmExtensionStates)仅报告由虚拟机扩展程序管理器政策安装和管理的扩展程序的运行时状态。这些 API 不会报告您在虚拟机扩展程序管理器之外手动安装的独立代理的状态。
查看扩展程序政策
您可以在组织、文件夹或项目级层列出虚拟机扩展程序政策或检查特定政策的配置详细信息。
查看组织中所有可用区的全局扩展程序政策
您可以列出组织中的所有全局虚拟机扩展程序政策,也可以检查特定组织级全局政策,以审核整个机群的扩展程序发布情况。
必需的 IAM 权限
如需获得查看组织级层扩展政策所需的权限,请让管理员为您授予贵组织的组织级层 Compute 虚拟机扩展政策查看者 (roles/compute.orgVmExtensionPolicyViewer) 或组织级层 Compute 虚拟机扩展政策管理员 (roles/compute.orgVmExtensionPolicyAdmin) IAM 角色。
如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
此预定义角色包含查看组织级扩展程序政策所需的权限。如需查看所需的确切权限,请展开所需权限部分:
所需权限
查看组织级扩展程序政策需要以下权限:
-
列出扩展程序政策:
compute.orgVmExtensionPolicies.list -
查看扩展程序政策的详细信息:
compute.orgVmExtensionPolicies.get
如需查看组织中的全局扩展程序政策,请选择以下选项之一:
gcloud
如需查看组织中的所有全局扩展程序政策,请运行带有 --organization 标志的 gcloud preview compute global-vm-extension-policies list 命令:
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:您要查看的虚拟机扩展程序政策的名称。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:您要查看的虚拟机扩展程序政策的名称。ORGANIZATION_ID:您的 Google Cloud 组织的 ID。
查看文件夹中所有可用区的全局扩展程序政策
您可以列出文件夹中的所有全局虚拟机扩展程序政策,也可以检查特定文件夹级全局政策,以验证哪些扩展程序适用于该文件夹中的所有项目。
必需的 IAM 权限
如需获得查看文件夹级扩展政策所需的权限,请让管理员为您授予文件夹的 Folder level Compute VM extension policies viewer (roles/compute.folderVmExtensionPolicyViewer) 或 Folder level Compute VM extension policies admin (roles/compute.folderVmExtensionPolicyAdmin) IAM 角色。
如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
此预定义角色包含查看文件夹级扩展政策所需的权限。如需查看所需的确切权限,请展开所需权限部分:
所需权限
查看文件夹级扩展程序政策需要以下权限:
-
列出扩展程序政策:
compute.folderVmExtensionPolicies.list -
查看扩展程序政策的详细信息:
compute.folderVmExtensionPolicies.get
如需查看文件夹中的全局扩展程序政策,请选择以下选项之一:
gcloud
如需查看文件夹中的所有全局扩展程序政策,请运行带有 --folder 标志的 gcloud preview compute global-vm-extension-policies list 命令:
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:您要查看的虚拟机扩展程序政策的名称。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:您要查看的虚拟机扩展程序政策的名称。FOLDER_ID: Google Cloud 文件夹的 ID。
查看项目中所有可用区的全局扩展程序政策
您可以查看项目中的全局虚拟机扩展程序政策,以监控发布进度并检查该项目中所有可用区的扩展程序配置。
必需的 IAM 权限
如需获得查看项目级扩展程序政策所需的权限,请让管理员为您授予项目的 Compute VM 扩展程序政策 Viewer (roles/compute.vmExtensionPolicyViewer) 或 Compute VM 扩展程序政策 Admin (roles/compute.vmExtensionPolicyAdmin) IAM 角色。
如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
此预定义角色可提供查看项目级扩展程序政策所需的权限。如需查看所需的确切权限,请展开所需权限部分:
所需权限
查看项目级扩展程序政策需要以下权限:
-
列出扩展程序政策:
compute.vmExtensionPolicies.list -
查看扩展程序政策的详细信息:
compute.vmExtensionPolicies.get
如需查看项目中的全局扩展程序政策,请选择以下选项之一:
控制台
如需使用 Google Cloud 控制台查看项目中的全局虚拟机扩展程序政策,请完成以下步骤:
- 在 Google Cloud 控制台中,前往虚拟机扩展程序政策页面。
- 点击全局政策。 此标签页列出了项目中的所有全局虚拟机扩展程序政策。
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:您要查看的虚拟机扩展程序政策的名称。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:您要查看的虚拟机扩展程序政策的名称。PROJECT_ID:您的 Google Cloud 项目的 ID。
查看整个组织中某个可用区内的可用区级扩展程序政策
您可以列出特定可用区中组织范围内的虚拟机扩展程序政策,也可以检查单个政策,以审核整个组织中可用区级强制执行规则。
必需的 IAM 权限
如需获得查看组织级层扩展政策所需的权限,请让管理员为您授予贵组织的组织级层 Compute 虚拟机扩展政策查看者 (roles/compute.orgVmExtensionPolicyViewer) 或组织级层 Compute 虚拟机扩展政策管理员 (roles/compute.orgVmExtensionPolicyAdmin) IAM 角色。
如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
此预定义角色包含查看组织级扩展程序政策所需的权限。如需查看所需的确切权限,请展开所需权限部分:
所需权限
查看组织级扩展程序政策需要以下权限:
-
列出扩展程序政策:
compute.orgVmExtensionPolicies.list -
查看扩展程序政策的详细信息:
compute.orgVmExtensionPolicies.get
如需查看组织中的可用区级扩展政策,请选择以下选项之一:
gcloud
如需查看可用区中的所有组织级扩展程序政策,请运行带有 --organization 标志的 gcloud preview compute zone-vm-extension-policies list 命令:
gcloud preview compute zone-vm-extension-policies list \ --organization=organizations/ORGANIZATION_ID \ --zone=ZONE \ --page-size=PAGE_SIZE
替换以下内容:
ORGANIZATION_ID:您的 Google Cloud 组织的 ID。ZONE:您要列出其中的虚拟机扩展程序政策的可用区的名称。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:您要查看的虚拟机扩展程序政策的名称。ORGANIZATION_ID:您的 Google Cloud 组织的 ID。ZONE:虚拟机扩展程序政策所在的 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:您要查看的虚拟机扩展程序政策的名称。ORGANIZATION_ID:您的 Google Cloud 组织的 ID。ZONE:虚拟机扩展程序政策所在的 Google Cloud 可用区。
查看文件夹中某个可用区内的可用区级扩展程序政策
您可以列出特定可用区中文件夹级虚拟机扩展程序政策,也可以检查单个政策,以验证文件夹中项目的可用区级扩展程序规则。
必需的 IAM 权限
如需获得查看文件夹级扩展政策所需的权限,请让管理员为您授予文件夹的 Folder level Compute VM extension policies viewer (roles/compute.folderVmExtensionPolicyViewer) 或 Folder level Compute VM extension policies admin (roles/compute.folderVmExtensionPolicyAdmin) IAM 角色。
如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
此预定义角色包含查看文件夹级扩展政策所需的权限。如需查看所需的确切权限,请展开所需权限部分:
所需权限
查看文件夹级扩展程序政策需要以下权限:
-
列出扩展程序政策:
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:您要列出其中的虚拟机扩展程序政策的可用区的名称。PAGE_SIZE:每页返回的结果数上限。
如需查看特定文件夹级可用区级扩展程序政策的详细信息,请运行带有 --folder 标志的 gcloud preview compute zone-vm-extension-policies describe 命令:
gcloud preview compute zone-vm-extension-policies describe POLICY_NAME \ --folder=folders/FOLDER_ID \ --zone=ZONE
替换以下内容:
POLICY_NAME:您要查看的虚拟机扩展程序政策的名称。FOLDER_ID: Google Cloud 文件夹的 ID。ZONE:虚拟机扩展程序政策所在的 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:您要查看的虚拟机扩展程序政策的名称。FOLDER_ID: Google Cloud 文件夹的 ID。ZONE:虚拟机扩展程序政策所在的 Google Cloud 可用区。
查看项目中某个可用区内的可用区级扩展程序政策
您可以列出特定可用区中项目范围内的虚拟机扩展程序政策,也可以检查单个政策,以验证哪些扩展程序适用于该可用区中的实例。
必需的 IAM 权限
如需获得查看项目级扩展程序政策所需的权限,请让管理员为您授予项目的 Compute VM 扩展程序政策 Viewer (roles/compute.vmExtensionPolicyViewer) 或 Compute VM 扩展程序政策 Admin (roles/compute.vmExtensionPolicyAdmin) IAM 角色。
如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
此预定义角色可提供查看项目级扩展程序政策所需的权限。如需查看所需的确切权限,请展开所需权限部分:
所需权限
查看项目级扩展程序政策需要以下权限:
-
列出扩展程序政策:
compute.vmExtensionPolicies.list -
查看扩展程序政策的详细信息:
compute.vmExtensionPolicies.get
如需查看项目中的可用区级扩展程序政策,请选择以下选项之一:
控制台
如需使用 Google Cloud 控制台查看项目中的可用区级虚拟机扩展程序政策,请完成以下步骤:
- 在 Google Cloud 控制台中,前往虚拟机扩展程序政策页面。
- 如需查看特定扩展程序政策的详细信息,请点击该政策的名称。
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:您要列出其中的虚拟机扩展程序政策的可用区的名称。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:您要查看的虚拟机扩展程序政策的名称。PROJECT_ID:您的 Google Cloud 项目的 ID。ZONE:虚拟机扩展程序政策所在的 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:您要查看的虚拟机扩展程序政策的名称。PROJECT_ID:您的 Google Cloud 项目的 ID。ZONE:虚拟机扩展程序政策所在的 Google Cloud 可用区。
查看虚拟机扩展程序和版本
您可以使用只读 get 和 list 方法查看虚拟机扩展程序管理器在您的组织、文件夹或项目中支持的虚拟机扩展程序。您可以查看所有可用区或特定可用区中的扩展程序名称、版本号和扩展程序支持级别。
查看组织中所有可用区内的虚拟机扩展程序
使用只读 get 和 list 方法可查看虚拟机扩展程序管理器在您组织的所有可用区中支持的虚拟机扩展程序,包括其版本号和支持级别。
必需的 IAM 权限
如需获得查看整个组织的虚拟机扩展程序所需的权限,请让管理员向您授予组织的组织级 Compute 虚拟机扩展程序政策查看者 (roles/compute.orgVmExtensionPolicyViewer) 或组织级 Compute 虚拟机扩展程序政策管理员 (roles/compute.orgVmExtensionPolicyAdmin) IAM 角色。
如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
此预定义角色可提供查看整个组织中的虚拟机扩展程序所需的权限。如需查看所需的确切权限,请展开所需权限部分:
所需权限
查看整个组织的虚拟机扩展程序需要以下权限:
-
列出虚拟机扩展程序:
compute.orgVmExtensions.list -
查看虚拟机扩展程序的详细信息:
compute.orgVmExtensions.get
如需查看虚拟机扩展程序管理器在贵组织的所有可用区中支持的虚拟机扩展程序和版本,请选择以下选项之一:
gcloud
如需列出虚拟机扩展程序管理器支持的所有虚拟机扩展程序及其在组织中所有可用区的支持级别,请运行带有 --organization 标志的 gcloud preview compute global-vm-extension-policies extensions list 命令:
gcloud preview compute global-vm-extension-policies extensions list \ --organization=organizations/ORGANIZATION_ID
替换以下内容:
ORGANIZATION_ID:您的 Google Cloud 组织的 ID。
输出会列出虚拟机扩展程序管理器支持的虚拟机扩展程序、其版本以及扩展程序支持级别。
如需查看组织中特定虚拟机扩展程序的详细信息,请运行 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:虚拟机扩展程序的名称(例如ops-agent、google-cloud-sap-extension或google-cloud-workload-extension)。ORGANIZATION_ID:您的 Google Cloud 组织的 ID。
REST
如需列出虚拟机扩展程序管理器支持的所有虚拟机扩展程序及其在组织中所有可用区的支持级别,请向 organizationGlobalVmExtensionPolicies.listVmExtensions 方法发送 GET 请求:
GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/global/vmExtensions
替换以下内容:
ORGANIZATION_ID:您的 Google Cloud 组织的 ID。
响应会列出虚拟机扩展程序管理器支持的虚拟机扩展程序、其版本以及扩展程序支持级别。
如需查看组织中特定虚拟机扩展程序的详细信息,请向 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:虚拟机扩展程序的名称(例如ops-agent)。
查看文件夹中所有可用区内的虚拟机扩展程序
使用只读 get 和 list 方法可查看虚拟机扩展程序管理器在文件夹中所有可用区内支持的虚拟机扩展程序,包括其版本号和支持级别。
必需的 IAM 权限
如需获得查看文件夹中虚拟机扩展程序所需的权限,请让管理员向您授予文件夹的文件夹级 Compute 虚拟机扩展程序政策 Viewer (roles/compute.folderVmExtensionPolicyViewer) 或文件夹级 Compute 虚拟机扩展程序政策 Admin (roles/compute.folderVmExtensionPolicyAdmin) IAM 角色。如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
此预定义角色可提供查看文件夹中虚拟机扩展程序所需的权限。如需查看所需的确切权限,请展开所需权限部分:
所需权限
如需查看文件夹中的虚拟机扩展程序,您需要具备以下权限:
-
列出虚拟机扩展程序:
compute.folderVmExtensions.list -
查看虚拟机扩展程序的详细信息:
compute.folderVmExtensions.get
如需查看虚拟机扩展程序管理器在文件夹中所有可用区内支持的虚拟机扩展程序和版本,请选择以下选项之一:
gcloud
如需列出虚拟机扩展程序管理器支持的所有虚拟机扩展程序及其在文件夹中所有可用区的支持级别,请运行带有 --folder 标志的 gcloud preview compute global-vm-extension-policies extensions list 命令:
gcloud preview compute global-vm-extension-policies extensions list \ --folder=folders/FOLDER_ID
替换以下内容:
FOLDER_ID: Google Cloud 文件夹的 ID。
输出会列出虚拟机扩展程序管理器支持的虚拟机扩展程序、其版本以及扩展程序支持级别。
如需查看文件夹中特定虚拟机扩展程序的详细信息,请运行 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:虚拟机扩展程序的名称(例如ops-agent、google-cloud-sap-extension或google-cloud-workload-extension)。FOLDER_ID: Google Cloud 文件夹的 ID。
REST
如需列出虚拟机扩展程序管理器支持的所有虚拟机扩展程序及其在文件夹中所有可用区的支持级别,请向 folderGlobalVmExtensionPolicies.listVmExtensions 方法发送 GET 请求:
GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/global/vmExtensions
替换以下内容:
FOLDER_ID: Google Cloud 文件夹的 ID。
响应会列出虚拟机扩展程序管理器支持的虚拟机扩展程序、其版本以及扩展程序支持级别。
如需查看文件夹中特定虚拟机扩展程序的详细信息,请向 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:虚拟机扩展程序的名称(例如ops-agent)。
查看项目中所有可用区内的虚拟机扩展程序
使用只读 get 和 list 方法,查看虚拟机扩展程序管理器在您项目的所有可用区中支持的虚拟机扩展程序,包括其版本号和支持级别。
必需的 IAM 权限
如需获得查看项目中虚拟机扩展程序所需的权限,请让管理员向您授予项目的 Compute 虚拟机扩展程序政策 Viewer (roles/compute.vmExtensionPolicyViewer) 或 Compute 虚拟机扩展程序政策 Admin (roles/compute.vmExtensionPolicyAdmin) IAM 角色。如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
此预定义角色包含查看项目中的虚拟机扩展程序所需的权限。如需查看所需的确切权限,请展开所需权限部分:
所需权限
如需查看项目中的虚拟机扩展程序,您需要具备以下权限:
-
列出虚拟机扩展程序:
compute.vmExtensions.list -
查看虚拟机扩展程序的详细信息:
compute.vmExtensions.get
如需查看虚拟机扩展程序管理器在您项目的所有可用区中支持的虚拟机扩展程序和版本,请选择以下选项之一:
gcloud
如需列出虚拟机扩展程序管理器支持的所有虚拟机扩展程序及其在项目所有可用区中的支持级别,请运行 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。
输出会列出虚拟机扩展程序管理器支持的虚拟机扩展程序、其版本以及扩展程序支持级别。
如需查看项目中特定虚拟机扩展程序的详细信息,请运行 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:虚拟机扩展程序的名称(例如ops-agent、google-cloud-sap-extension或google-cloud-workload-extension)。PROJECT_ID:您的 Google Cloud 项目的 ID。
REST
如需列出虚拟机扩展程序管理器支持的所有虚拟机扩展程序及其在项目所有可用区中的支持级别,请向 globalVmExtensionPolicies.listVmExtensions 方法发送 GET 请求:
GET https://compute.googleapis.com/compute/2026-10-01-preview/projects/PROJECT_ID/global/vmExtensions
替换以下内容:
PROJECT_ID:您的 Google Cloud 项目的 ID。
以下 JSON 代码段展示了一个示例响应,其中列出了虚拟机扩展程序管理器支持的虚拟机扩展程序及其扩展程序支持级别:
{
"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"
}
]
}
如需查看项目中特定虚拟机扩展程序的详细信息,请向 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:虚拟机扩展程序的名称(例如ops-agent)。
查看组织中某个可用区内的虚拟机扩展程序
使用只读 get 和 list 方法,查看虚拟机扩展程序管理器在整个组织中的特定可用区内支持的虚拟机扩展程序,包括其版本号和支持级别。
必需的 IAM 权限
如需获得在整个组织中查看可用区内虚拟机扩展程序所需的权限,请让管理员为您授予组织的组织级 Compute 虚拟机扩展程序政策 Viewer (roles/compute.orgVmExtensionPolicyViewer) 或组织级 Compute 虚拟机扩展程序政策 Admin (roles/compute.orgVmExtensionPolicyAdmin) IAM 角色。
如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
此预定义角色包含在整个组织中查看可用区内虚拟机扩展程序所需的权限。如需查看所需的确切权限,请展开所需权限部分:
所需权限
如需在整个组织中查看可用区中的虚拟机扩展程序,您需要具备以下权限:
-
列出虚拟机扩展程序:
compute.orgVmExtensions.list -
查看虚拟机扩展程序的详细信息:
compute.orgVmExtensions.get
如需查看虚拟机扩展程序管理器在您组织中的某个可用区内支持的虚拟机扩展程序和版本,请选择以下选项之一:
gcloud
如需列出虚拟机扩展程序管理器支持的所有虚拟机扩展程序及其在整个组织中特定可用区内的支持级别,请运行带有 --organization 标志的 gcloud preview compute zone-vm-extension-policies extensions list 命令:
gcloud preview compute zone-vm-extension-policies extensions list \ --organization=organizations/ORGANIZATION_ID \ --zone=ZONE
替换以下内容:
ORGANIZATION_ID:您的 Google Cloud 组织的 ID。ZONE:您要列出其中的虚拟机扩展程序的 Google Cloud 可用区(例如us-central1-a)。
输出会列出虚拟机扩展程序管理器支持的虚拟机扩展程序、其版本以及扩展程序支持级别。
如需查看组织中某个可用区内特定虚拟机扩展程序的详细信息,请运行 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:虚拟机扩展程序的名称(例如ops-agent)。ORGANIZATION_ID:您的 Google Cloud 组织的 ID。ZONE:您要查看其扩展程序详细信息的可用区。
REST
如需列出虚拟机扩展程序管理器支持的所有虚拟机扩展程序及其在组织中特定可用区内的支持级别,请向 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)。
响应会列出虚拟机扩展程序管理器支持的虚拟机扩展程序、其版本以及扩展程序支持级别。
如需查看组织中某个可用区内特定虚拟机扩展程序的详细信息,请向 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:虚拟机扩展程序的名称。
查看文件夹中某个可用区内的虚拟机扩展程序
使用只读 get 和 list 方法,可查看虚拟机扩展程序管理器在文件夹中特定可用区内支持的虚拟机扩展程序,包括其版本号和支持级别。
必需的 IAM 权限
如需获得查看文件夹中某个可用区内的虚拟机扩展程序所需的权限,请让管理员为您授予文件夹的文件夹级 Compute 虚拟机扩展程序政策 Viewer (roles/compute.folderVmExtensionPolicyViewer) 或文件夹级 Compute 虚拟机扩展程序政策 Admin (roles/compute.folderVmExtensionPolicyAdmin) IAM 角色。如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
此预定义角色包含查看文件夹中某个可用区内的虚拟机扩展程序所需的权限。如需查看所需的确切权限,请展开所需权限部分:
所需权限
如需查看文件夹中某个可用区内的虚拟机扩展程序,您需要具备以下权限:
-
列出虚拟机扩展程序:
compute.folderVmExtensions.list -
查看虚拟机扩展程序的详细信息:
compute.folderVmExtensions.get
如需查看虚拟机扩展程序管理器在文件夹中某个可用区内支持的虚拟机扩展程序和版本,请选择以下选项之一:
gcloud
如需列出虚拟机扩展程序管理器支持的所有虚拟机扩展程序及其在文件夹中特定可用区内的支持级别,请运行带有 --folder 标志的 gcloud preview compute zone-vm-extension-policies extensions list 命令:
gcloud preview compute zone-vm-extension-policies extensions list \ --folder=folders/FOLDER_ID \ --zone=ZONE
替换以下内容:
FOLDER_ID: Google Cloud 文件夹的 ID。ZONE:您要列出其中的虚拟机扩展程序的 Google Cloud 可用区(例如us-central1-a)。
输出会列出虚拟机扩展程序管理器支持的虚拟机扩展程序、其版本以及扩展程序支持级别。
如需查看文件夹中某个可用区内特定虚拟机扩展程序的详细信息,请运行 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:虚拟机扩展程序的名称(例如ops-agent)。FOLDER_ID: Google Cloud 文件夹的 ID。ZONE:您要查看其扩展程序详细信息的可用区。
REST
如需列出虚拟机扩展程序管理器支持的所有虚拟机扩展程序及其在文件夹中特定可用区内的支持级别,请向 folderZoneVmExtensionPolicies.listVmExtensions 方法发送 GET 请求:
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)。
响应会列出虚拟机扩展程序管理器支持的虚拟机扩展程序、其版本以及扩展程序支持级别。
如需查看文件夹中某个可用区内特定虚拟机扩展程序的详细信息,请向 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:虚拟机扩展程序的名称。
查看项目中某个可用区内的虚拟机扩展服务
使用只读 get 和 list 方法可查看虚拟机扩展程序管理器在项目特定可用区中支持的虚拟机扩展程序,包括其版本号和支持级别。
必需的 IAM 权限
如需获得查看项目中可用区内的虚拟机扩展程序所需的权限,请让管理员向您授予项目的 Compute 虚拟机扩展程序政策查看者 (roles/compute.vmExtensionPolicyViewer) 或 Compute 虚拟机扩展程序政策管理员 (roles/compute.vmExtensionPolicyAdmin) IAM 角色。
如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
此预定义角色包含查看项目中可用区内的虚拟机扩展程序所需的权限。如需查看所需的确切权限,请展开所需权限部分:
所需权限
如需查看项目中某个可用区内的虚拟机扩展程序,您需要具备以下权限:
-
列出虚拟机扩展程序:
compute.vmExtensions.list -
查看虚拟机扩展程序的详细信息:
compute.vmExtensions.get
如需查看虚拟机扩展程序管理器在您项目中的某个可用区内支持的虚拟机扩展程序和版本,请选择以下选项之一:
gcloud
如需列出虚拟机扩展程序管理器支持的所有虚拟机扩展程序及其在项目特定可用区中的支持级别,请运行 gcloud preview compute zone-vm-extension-policies extensions list 命令:
gcloud preview compute zone-vm-extension-policies extensions list \ --zone=ZONE \ --project=PROJECT_ID
替换以下内容:
ZONE:您要列出其中的虚拟机扩展程序的 Google Cloud 可用区(例如us-central1-a)。PROJECT_ID:您的 Google Cloud 项目的 ID。
输出会列出虚拟机扩展程序管理器支持的虚拟机扩展程序、其版本以及扩展程序支持级别。
如需查看项目中某个可用区内特定虚拟机扩展程序的详细信息,请运行 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:虚拟机扩展程序的名称(例如ops-agent)。ZONE:您要查看其扩展程序详细信息的可用区。PROJECT_ID:您的 Google Cloud 项目的 ID。
REST
如需列出虚拟机扩展程序管理器支持的所有虚拟机扩展程序及其在项目特定可用区中的支持级别,请向 zoneVmExtensionPolicies.listVmExtensions 方法发送 GET 请求:
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)。
响应会列出虚拟机扩展程序管理器支持的虚拟机扩展程序、其版本以及扩展程序支持级别。
如需查看项目中某个可用区内特定虚拟机扩展程序的详细信息,请向 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:虚拟机扩展程序的名称。
查看实例上的虚拟机扩展程序状态
您可以通过在组织、文件夹或项目级层创建全局或可用区级扩展程序政策,在虚拟机上安装虚拟机扩展程序。一项政策可以在单个虚拟机上安装多个扩展程序,并且资源层次结构中的多项政策可以应用于同一虚拟机。使用只读实例扩展程序状态 list 和 get 方法,无需连接到各个机器,即可查看每个虚拟机上已安装扩展程序的运行时状态。这些方法可帮助您查看每个已安装扩展程序的最终有效配置和管理政策 (policyId),或在实例上安装了意外扩展程序或扩展程序失败时进行问题排查。
必需的 IAM 权限
如需获得查看实例上虚拟机扩展程序状态所需的权限,请让管理员向您授予项目的 Compute Viewer (roles/compute.viewer)、Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) 或 Compute Admin (roles/compute.admin) IAM 角色。
如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
此预定义角色可提供查看实例上的虚拟机扩展程序状态所需的权限。如需查看所需的确切权限,请展开所需权限部分:
所需权限
查看实例上的虚拟机扩展程序状态需要以下权限:
-
列出实例上的所有虚拟机扩展程序状态:
compute.instances.listVmExtensionStates -
获取实例上特定虚拟机扩展程序的状态:
compute.instances.getVmExtensionState
列出实例上的所有虚拟机扩展程序状态
当某项政策在虚拟机上安装了多个扩展程序、多项政策适用于同一实例,或者您在问题排查期间发现意外扩展程序时,请列出虚拟机上的所有扩展程序状态,以查看每个已安装扩展程序的最终有效配置和运行时状态。响应会显示每个扩展程序的有效版本、强制执行状态、运行状况和管理政策 (policyId)。
如需查看实例上所有已安装虚拟机扩展程序的状态,请选择以下选项之一:
gcloud
如需列出所有已安装的虚拟机扩展程序并查看其在实例上的当前状态,请运行 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:虚拟机实例的名称。ZONE:实例所在的可用区(例如us-central1-a)。PROJECT_ID:您的 Google Cloud 项目的 ID。
该命令会返回一个表格,其中列出了每个已安装扩展程序的名称、强制执行状态和健康状态:
EXTENSION_NAME ENFORCEMENT_STATE HEALTH_STATUS
ops-agent INSTALLED RUNNING
REST
如需列出所有已安装的虚拟机扩展程序并查看其在实例上的当前状态,请向 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:虚拟机实例的名称或 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"
}
]
}
查看实例上特定虚拟机扩展程序的状态
当多个政策以某个虚拟机为目标,或者已安装的扩展程序未按预期运行时,请查看该特定扩展程序的状态,以了解其最终有效配置(policyId 和版本)以及诊断状态消息。
如需查看实例上特定虚拟机扩展程序的有效状态和治理政策,请选择以下选项之一:
gcloud
如需检索实例上特定虚拟机扩展程序的有效状态、有效版本和控制政策,请运行 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:虚拟机实例的名称。EXTENSION_NAME:要检查的扩展程序的名称(例如ops-agent)。ZONE:实例所在的可用区。PROJECT_ID:您的 Google Cloud 项目的 ID。
REST
如需检索实例上特定虚拟机扩展程序的有效状态、有效版本和控制政策,请向 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:虚拟机实例的名称或 ID。EXTENSION_NAME:虚拟机扩展程序的名称(例如ops-agent)。
以下 JSON 代码段展示了实例上单个虚拟机扩展程序状态的示例响应:
{
"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"
}
解读虚拟机扩展程序状态字段
当您检索实例上虚拟机扩展程序的状态时,响应中会包含报告插件的强制执行政策、活跃版本、安装进度和运行时健康状况的字段。
下表介绍了 VmExtensionState 资源返回的字段:
| 字段 | 说明 |
|---|---|
name |
虚拟机扩展程序的标识符(例如 ops-agent)。 |
version |
虚拟机实例上安装的扩展程序的有效版本。 |
policyId |
在实例上强制执行此扩展程序的有效虚拟机扩展程序政策的标识符。如果有多项政策以该虚拟机为目标,此字段会指明在优先级解析后胜出的政策。 |
enforcementState |
扩展程序违规处置流程的当前生命周期状态。可能的值包括下列项:
|
enforcementMsg |
如果扩展程序未能强制执行或遇到安装错误,客机代理会返回诊断状态消息。 |
healthStatus |
强制执行的扩展程序插件的运行时运行状况。如果尚未强制执行该扩展程序,则此值未指定。可能的值包括下列项:
|
healthMsg |
扩展程序报告的有关其运行状况的诊断消息(例如 Plugin is running ok)。 |
后续步骤
- 如需诊断失败的发布、检查正在运行的客机进程或检查客机代理调试日志,请参阅排查虚拟机扩展程序问题。
- 如需在 Cloud Logging 中查询历史强制执行事件并审核安装或崩溃记录,请参阅查看虚拟机扩展程序日志。
- 如需构建 Cloud Monitoring 信息中心并针对代理健康状况、CPU 和内存用量设置提醒,请参阅监控虚拟机扩展程序。
- 如需修改配置设置、更改固定版本或移除已部署的代理,请参阅使用扩展程序政策管理虚拟机扩展程序。