在虚拟机中启用 PMU

gcloud

1. 创建一个空的 YAML 文件。

2. 如需将虚拟机的属性导出到您刚创建的 YAML 文件中，请使用 gcloud compute instances export 命令。

   gcloud compute instances export VM_NAME \
       --destination=YAML_FILE \
       --zone=ZONE
   

   替换以下内容：

   • VM_NAME：虚拟机的名称。

   • YAML_FILE：您在上一步中创建的 YAML 文件的路径。

   • ZONE：该虚拟机所在的可用区。

3. 在 YAML 配置文件中，添加 performanceMonitoringUnit 字段。如果 advancedMachineFeatures 字段不存在，则也添加该字段：

   advancedMachineFeatures:
     performanceMonitoringUnit: PMU_TYPE
   

   将 PMU_TYPE 替换为以下某个值：

   • 架构 PMU 类型：ARCHITECTURAL

   • 标准 PMU 类型：STANDARD

   • 增强型 PMU 类型：ENHANCED

4. 如需更新虚拟机并重启它，请使用 gcloud compute instances update-from-file 命令，并将 --most-disruptive-allowed-action 标志设置为 RESTART：

   gcloud compute instances update-from-file VM_NAME \
       --most-disruptive-allowed-action=RESTART \
       --source=YAML_FILE \
       --zone=ZONE
   

   替换以下内容：

   • VM_NAME：虚拟机的名称。

   • YAML_FILE：包含您在上一步中修改的配置数据的 YAML 文件的路径。

   • ZONE：该虚拟机所在的可用区。

REST

1. 创建一个空的 JSON 文件。

2. 如需查看现有虚拟机的属性，请向 instances.get 方法发出 GET 请求：

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

   替换以下内容：

   • PROJECT_ID：虚拟机所在项目的 ID。

   • ZONE：该虚拟机所在的可用区。

   • VM_NAME：现有虚拟机的名称。

3. 在您在上一步中创建的空 JSON 文件中，执行以下操作：

   1. 输入 GET 请求输出中的虚拟机属性。

   2. 在 advancedMachineFeatures 字段中，添加 performanceMonitoringUnit 字段。如果 advancedMachineFeatures 字段不存在，则也添加该字段：

      {
        "advancedMachineFeatures": {
          "performanceMonitoringUnit": "PMU_TYPE"
        },
        ...
      }
      

      将 PMU_TYPE 替换为以下某个值：

      • 架构 PMU 类型：ARCHITECTURAL

      • 标准 PMU 类型：STANDARD

      • 增强型 PMU 类型：ENHANCED

4. 如需更新虚拟机并重启它，请向 instances.update 方法发出 PUT 请求。在请求中，执行以下操作：

   • 在请求网址中，添加 mostDisruptiveAllowedAction 查询参数并设置为 RESTART。

   • 对于请求正文，请使用您在上述步骤中创建和更新的 JSON 文件中的虚拟机属性。

   请求类似于以下内容：

   PUT https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME?mostDisruptiveAllowedAction=RESTART
   
   {
     "advancedMachineFeatures": {
       "performanceMonitoringUnit": "PMU_TYPE"
     },
     ...
   }
   

gcloud

如需创建启用了 PMU 的虚拟机，请将 gcloud compute instances create 命令与 --performance-monitoring-unit 标志搭配使用：

gcloud compute instances create VM_NAME \
    --machine-type=MACHINE_TYPE \
    --performance-monitoring-unit=PMU_TYPE \
    --zone=ZONE

替换以下内容：

• VM_NAME：虚拟机的名称。

• MACHINE_TYPE：C4A 或 C4 机器类型。 如果您要启用增强型 PMU 类型，则必须指定具有 96 个或 192 个 vCPU 的 C4 机器类型。否则，创建虚拟机会失败。

• PMU_TYPE：要在虚拟机中启用的 PMU 类型。请指定以下某个值：

  • 架构 PMU 类型：architectural

  • 标准 PMU 类型：standard

  • 增强型 PMU 类型：enhanced

• ZONE：要在其中创建虚拟机的可用区。

REST

如需创建启用了 PMU 的虚拟机，请向 instances.insert 方法发出 POST 请求。 在请求正文中，添加 performanceMonitoringUnit 字段：

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

{
  "name": "VM_NAME",
  "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
  "disks": [
    {
      "boot": true,
      "initializeParams": {
        "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
      }
    }
  ],
  "networkInterfaces": [
    {
      "network": "global/networks/default"
    }
  ],
  "advancedMachineFeatures": {
    "performanceMonitoringUnit": "PMU_TYPE"
  }
}

替换以下内容：

• PROJECT_ID：要在其中创建虚拟机的项目的 ID。

• ZONE：要在其中创建虚拟机的可用区。

• VM_NAME：虚拟机的名称。

• MACHINE_TYPE：C4A 或 C4 机器类型。 如果您要启用增强型 PMU 类型，则必须指定具有 96 个或 192 个 vCPU 的 C4 机器类型。否则，创建虚拟机会失败。

• IMAGE_PROJECT：映像所属的映像项目；例如 debian-cloud。如需详细了解支持的映像项目，请参阅公共映像。

• IMAGE：指定以下其中一项：

  • 操作系统映像的特定版本，例如 debian-12-bookworm-v20240617。

  • 映像系列，其格式必须为 family/IMAGE_FAMILY。此项指定最新的未弃用操作系统映像。例如，如果您指定 family/debian-12，则系统会使用 Debian 12 映像系列中的最新版本。如需详细了解如何使用映像系列，请参阅映像系列最佳实践。

• PMU_TYPE：要在虚拟机中启用的 PMU 类型。请指定以下某个值：

  • 架构 PMU 类型：ARCHITECTURAL

  • 标准 PMU 类型：STANDARD

  • 增强型 PMU 类型：ENHANCED

gcloud

如需批量创建启用了 PMU 的虚拟机，请将 gcloud compute instances bulk create 命令与 --performance-monitoring-unit 标志搭配使用。

例如，如需在单个可用区中批量创建虚拟机并指定名称模式，请运行以下命令：

gcloud compute instances bulk create \
    --count=COUNT \
    --machine-type=MACHINE_TYPE \
    --name-pattern="NAME_PATTERN" \
    --performance-monitoring-unit=PMU_TYPE \
    --zone=ZONE

替换以下内容：

• COUNT：要创建的虚拟机数量。

• MACHINE_TYPE：C4A 或 C4 机器类型。 如果您要启用增强型 PMU 类型，则必须指定具有 96 个或 192 个 vCPU 的 C4 机器类型。否则，创建虚拟机会失败。

• NAME_PATTERN：虚拟机的名称模式。如需替换虚拟机名称中的数字序列，请使用哈希值 (#) 字符序列。例如，使用 vm-# 作为名称模式将生成名称以 vm-1、vm-2 开头的虚拟机，一直到由 COUNT 指定的虚拟机数量。

• PMU_TYPE：要在虚拟机中启用的 PMU 类型。请指定以下某个值：

  • 架构 PMU 类型：architectural

  • 标准 PMU 类型：standard

  • 增强型 PMU 类型：enhanced

• ZONE：要在其中批量创建虚拟机的可用区。

REST

如需批量创建启用了 PMU 的虚拟机，请向 instances.bulkInsert 方法发出 POST 请求。在请求正文中，添加 performanceMonitoringUnit 字段。

例如，如需在单个可用区中批量创建虚拟机并指定名称模式，请发出 POST 请求，如下所示：

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert

{
  "count": COUNT,
  "namePattern": "NAME_PATTERN",
  "instanceProperties": {
    "machineType": "MACHINE_TYPE",
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "advancedMachineFeatures": {
      "performanceMonitoringUnit": "PMU_TYPE"
    }
  }
}

替换以下内容：

• PROJECT_ID：要在其中批量创建虚拟机的项目的 ID。

• ZONE：要在其中批量创建虚拟机的可用区。

• COUNT：要创建的虚拟机数量。

• NAME_PATTERN：虚拟机的名称模式。如需替换虚拟机名称中的数字序列，请使用哈希值 (#) 字符序列。例如，使用 vm-# 作为名称模式将生成名称以 vm-1、vm-2 开头的虚拟机，一直到由 COUNT 指定的虚拟机数量。

• MACHINE_TYPE：C4A 或 C4 机器类型。 如果您要启用增强型 PMU 类型，则必须指定具有 96 个或 192 个 vCPU 的 C4 机器类型。否则，创建虚拟机会失败。

• IMAGE_PROJECT：映像所属的映像项目；例如 debian-cloud。如需详细了解支持的映像项目，请参阅公共映像。

• IMAGE：指定以下其中一项：

  • 操作系统映像的特定版本，例如 debian-12-bookworm-v20240617。

  • 映像系列，其格式必须为 family/IMAGE_FAMILY。此项指定最新的未弃用操作系统映像。例如，如果您指定 family/debian-12，则系统会使用 Debian 12 映像系列中的最新版本。如需详细了解如何使用映像系列，请参阅映像系列最佳实践。

• PMU_TYPE：要在虚拟机中启用的 PMU 类型。请指定以下某个值：

  • 架构 PMU 类型：ARCHITECTURAL

  • 标准 PMU 类型：STANDARD

  • 增强型 PMU 类型：ENHANCED

gcloud

如需创建启用了 PMU 的实例模板，请将 gcloud compute instance-templates create 命令与 --performance-monitoring-unit 标志搭配使用。如需创建区域级实例模板，您还必须添加 --instance-template-region 标志。

例如，如需创建启用了 PMU 的区域级实例模板，请运行以下命令：

gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --instance-template-region=REGION \
    --machine-type=MACHINE_TYPE \
    --performance-monitoring-unit=PMU_TYPE

替换以下内容：

• INSTANCE_TEMPLATE_NAME：实例模板的名称。

• REGION：要在其中创建实例模板的区域。

• MACHINE_TYPE：C4A 或 C4 机器类型。 如果您要启用增强型 PMU 类型，则必须指定具有 96 个或 192 个 vCPU 的 C4 机器类型。否则，创建虚拟机会失败。

• PMU_TYPE：要在实例模板中包含的 PMU 类型。请指定以下某个值：

  • 架构 PMU 类型：architectural

  • 标准 PMU 类型：standard

  • 增强型 PMU 类型：enhanced

REST

如需创建启用了 PMU 的实例模板，请向以下方法之一发出 POST 请求：

• 如需创建全球实例模板：instanceTemplates.insert 方法。

• 如需创建区域级实例模板：regionInstanceTemplates.insert 方法。

在请求正文中，添加 performanceMonitoringUnit 字段。

例如，如需创建启用了 PMU 的区域级实例模板，请发出 POST 请求，如下所示：

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceTemplates

{
  "name": "INSTANCE_TEMPLATE_NAME",
  "properties": {
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "machineType": "MACHINE_TYPE",
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "advancedMachineFeatures": {
      "performanceMonitoringUnit": "PMU_TYPE"
    }
  }
}

替换以下内容：

• PROJECT_ID：要创建实例模板的项目 ID。

• REGION：要创建实例模板的区域。

• INSTANCE_TEMPLATE_NAME：实例模板的名称。

• IMAGE_PROJECT：映像所属的映像项目；例如 debian-cloud。如需详细了解支持的映像项目，请参阅公共映像。

• IMAGE：指定以下其中一项：

  • 操作系统映像的特定版本，例如 debian-12-bookworm-v20240617。

  • 映像系列，其格式必须为 family/IMAGE_FAMILY。此项指定最新的未弃用操作系统映像。例如，如果您指定 family/debian-12，则系统会使用 Debian 12 映像系列中的最新版本。如需详细了解如何使用映像系列，请参阅映像系列最佳实践。

• MACHINE_TYPE：C4A 或 C4 机器类型。 如果您要启用增强型 PMU 类型，则必须指定具有 96 个或 192 个 vCPU 的 C4 机器类型。否则，创建虚拟机会失败。

• PMU_TYPE：要在实例模板中包含的 PMU 类型。请指定以下某个值：

  • 架构 PMU 类型：ARCHITECTURAL

  • 标准 PMU 类型：STANDARD

  • 增强型 PMU 类型：ENHANCED