查看虚拟机扩展程序详情和状态

您可以通过在组织、文件夹或项目级层创建全局或可用区级扩展程序政策,在 Compute Engine 虚拟机实例上安装虚拟机扩展程序。一项政策可以在单个虚拟机上安装多个扩展程序,并且多项政策可以应用于同一虚拟机。

本文档介绍了如何在 Google Cloud 资源层次结构中使用只读 get 和 list 方法来执行以下任务:

  • 查看资源层次结构中的扩展程序政策。列出全局或可用区虚拟机扩展程序政策,以查看整个组织、文件夹或项目的政策详情和发布状态。
  • 查看虚拟机扩展程序和版本。列出虚拟机扩展程序管理器支持的虚拟机扩展程序,或查看组织、文件夹或项目中所有可用区或特定可用区内的扩展程序详细信息(包括版本号和支持级别)。
  • 查看每个虚拟机上已安装扩展程序的状态。当某项政策在虚拟机上安装了多个扩展程序时,列出实例上安装的所有虚拟机扩展程序及其运行时状态;或者当多项政策应用于同一虚拟机时,查看最终生效的配置和主导政策 (policyId)。
  • 排查实例上的扩展程序问题。在虚拟机实例上安装了意外扩展程序或扩展程序失败时,查看安装进度、运行时健康状况和诊断消息。

准备工作

在查看虚拟机扩展程序政策、检索虚拟机扩展程序详细信息或检查虚拟机实例上的扩展程序状态之前,请先完成以下前提条件:

政策和扩展程序查看限制

查看虚拟机扩展程序政策、扩展程序详细信息和实例状态时,请考虑以下操作限制:

  • 您只能使用 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 控制台查看项目中的全局虚拟机扩展程序政策,请完成以下步骤:

  1. 在 Google Cloud 控制台中,前往虚拟机扩展程序政策页面。

    前往“虚拟机扩展程序政策”

  2. 点击全局政策。 此标签页列出了项目中的所有全局虚拟机扩展程序政策。

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 控制台查看项目中的可用区级虚拟机扩展程序政策,请完成以下步骤:

  1. 在 Google Cloud 控制台中,前往虚拟机扩展程序政策页面。

    前往“虚拟机扩展程序政策”

  2. 如需查看特定扩展程序政策的详细信息,请点击该政策的名称。

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 扩展程序违规处置流程的当前生命周期状态。可能的值包括下列项:
  • ENFORCEMENT_STATE_UNSPECIFIED:未指定强制执行状态。
  • INSTALLING:客机代理正在安装扩展程序。
  • INSTALLED:扩展程序已安装在实例上。
  • INSTALL_FAILED:安装失败,并且没有可供回滚的先前稳定修订版本。
  • ROLLING_BACK:客机代理正在将扩展程序回滚到上次记录的稳定修订版本。
  • ROLLED_BACK:扩展程序已回滚到上一个稳定修订版本。
  • ROLLBACK_FAILED:回滚尝试失败。
  • INCOMPATIBLE:扩展程序版本的所有可用修订版本均与虚拟机的操作系统或架构不兼容。
  • REMOVING:客机代理正在从实例中移除扩展程序。
  • SERVICE_DISABLED:此扩展程序所需的服务 API 在项目中处于停用状态。
  • APPLYING_CONFIG:客机代理正在将新配置应用于扩展程序,这可能涉及重启插件。
enforcementMsg 如果扩展程序未能强制执行或遇到安装错误,客机代理会返回诊断状态消息。
healthStatus 强制执行的扩展程序插件的运行时运行状况。如果尚未强制执行该扩展程序,则此值未指定。可能的值包括下列项:
  • HEALTH_STATUS_UNSPECIFIED:未指定健康状态。
  • STARTING:扩展程序进程正在启动。
  • RUNNING:扩展程序进程正在正常运行。
  • STOPPING:扩展程序进程正在停止。
  • STOPPED:扩展程序进程已停止。
  • CRASHED:扩展程序进程已启动,但意外停止运行。
healthMsg 扩展程序报告的有关其运行状况的诊断消息(例如 Plugin is running ok)。

后续步骤