将预留与承诺使用折扣相结合

gcloud

如需通过附加现有预留来购买承诺，请运行 gcloud compute commitments create 命令。在您的命令中，添加 --existing-reservation 标志以指定要附加到承诺的现有预留。为要附加的每个现有预留添加一次此���志。您可以将任意数量的现有预留附加到承诺。

例如，如需通过附加两个预留来购买承诺，请运行以下命令：

gcloud compute commitments create COMMITMENT_NAME \
    --region=REGION \
    --project=PROJECT_ID \
    --resources=vcpu=COMMITTED_VCPUS,memory=COMMITTED_MEMORY,local-ssd=COMMITTED_LOCAL_SSD \
    --resources-accelerator=count=COMMITTED_ACCELERATOR_COUNT,type=COMMITTED_ACCELERATOR_TYPE \
    --plan=DURATION \
    --type=COMMITMENT_TYPE \
    --existing-reservation=name='RESERVATION_NAME_1',zone='RESERVATION_ZONE_1' \
    --existing-reservation=name='RESERVATION_NAME_2',zone='RESERVATION_ZONE_2'

替换以下内容：

• COMMITMENT_NAME：承诺的名称。
• REGION：承诺所在的区域。
• PROJECT_ID：项目的 ID，您将在其中购买包含附加预留的承诺。
• DURATION：承诺的期限，12-month 或 36-month。

• COMMITMENT_TYPE：承诺类型。以下承诺类型支持 GPU 和/或本地 SSD 磁盘：

  • accelerator-optimized（适用于机器类型资源）
  • compute-optimized（适用于 C2 机器类型资源）
  • compute-optimized-c2d（适用于 C2D 机器类型资源）
  • compute-optimized-c3（适用于 C3 机器类型资源）
  • compute-optimized-c3d（适用于 C3D 机器类型资源）
  • general-purpose（适用于 N1 机器类型资源）
  • general-purpose-e2（适用于 E2 机器类型资源）
  • general-purpose-n2（适用于 N2 机器类型资源）
  • general-purpose-n2d（适用于 N2D 机器资源）
  • general-purpose-t2d（适用于 Tau T2D 机器类型资源）
  • 适用于 G2 机器类型资源的 graphics-optimized
  • memory-optimized（适用于M1 或 M2 机器类型资源）
  • memory-optimized-m3（适用于内存优化 M3 机器类型）

• COMMITTED_VCPUS：您的承诺中包含的 vCPU 数量。该数字必须是正整数。

• COMMITTED_MEMORY：您的承诺中包含的内存量，以 MB 或 GB 为单位。例如 10240MB 或 10GB。如果您未指定单位，Compute Engine 将使用 GB 作为单位。您可以按 0.25 GB 的增量购买内存。

• COMMITTED_LOCAL_SSD：您的承诺中包含的本地 SSD 空间，以 GB 为单位。每个本地 SSD 磁盘为 375 GB。

• COMMITTED_ACCELERATOR_COUNT：您的承诺中包含的 GPU 数量。

• COMMITTED_ACCELERATOR_TYPE：您的承诺中包含的 GPU 类型。

• RESERVATION_NAME_1 和 RESERVATION_NAME_2：要附加到承诺的现有预留的名称。

• RESERVATION_ZONE_1 和 RESERVATION_ZONE_2：要附加到承诺的现有预留的可用区。

示例：通过附加现有预留来购买承诺

假设项目 myproject 的 us-central1-a 和 us-central1-b 可用区中有两个预留 res-01 和 res-02。假设这些预留包含 4 个 NVIDIA P100 GPU 和 4 个本地 SSD 磁盘的总容量。如需在此项目的 us-central1 区域中为这些 GPU 和本地 SSD 磁盘购买新承诺，并将这些现有预留用作附加预留，请运行以下命令。请注意，示例承诺还包含 vCPU 和内存。

gcloud compute commitments create commitment-01 \
    --region=us-central1 \
    --project=myproject \
    --resources=vcpu=96,memory=624GB \
    --resources-accelerator=type=nvidia-tesla-v100,count=4 \
    --plan 12-month \
    --existing-reservation=name=res-01,zone=us-central1-a \
    --existing-reservation=name=res-02,zone=us-central1-b
    

REST

如需通过附加现有预留来购买承诺，请向 regionCommitments.insert 方法发出 POST 请求。在您的请求中添加 existingReservations 字段，以指定要附加到承诺的所有现有预留的逗号分隔列表。您可以将任意数量的现有预留附加到承诺。

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

{
  "name": "COMMITMENT_NAME",
  "plan": "DURATION",
  "type": COMMITMENT_TYPE,
  "resources":
  [
    {
      "amount": "COMMITTED_VCPUS",
      "type": "VCPU"
    },
    {
      "amount": "COMMITTED_MEMORY",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "COMMITTED_ACCELERATOR_TYPE",
      "amount": "COMMITTED_ACCELERATOR_COUNT",
      "type": "ACCELERATOR"
    }
    {
      "amount": "COMMITTED_LOCAL_SSD",
      "type": "LOCAL_SSD"
    }
  ],
  "existingReservations": "RESERVATION_URLs"
}

替换以下内容：

• COMMITMENT_NAME：承诺的名称。
• REGION：承诺所在的区域。
• PROJECT_ID：项目的 ID，您将在其中购买包含附加预留的承诺。
• DURATION：承诺的期限，TWELVE_MONTH 或 THIRTY_SIX_MONTH。

• COMMITMENT_TYPE：承诺类型。以下承诺类型支持 GPU 和/或本地 SSD 磁盘：

  • GENERAL_PURPOSE_E2（适用于 E2 机器类型资源）
  • GENERAL_PURPOSE_N2（适用于 N2 机器类型资源）
  • GENERAL_PURPOSE_N2D（适用于 N2D 机器资源）
  • COMPUTE_OPTIMIZED_C3（适用于 C3 机器类型资源）
  • GENERAL_PURPOSE_C3D（适用于 C3D 机器类型资源）
  • GENERAL_PURPOSE_T2D（适用于 Tau T2D 机器类型资源）
  • GENERAL_PURPOSE（适用于 N1 机器类型资源）
  • COMPUTE_OPTIMIZED（适用于 C2 机器类型资源）
  • COMPUTE_OPTIMIZED_C2D（适用于 C2D 机器类型资源）
  • MEMORY_OPTIMIZED（适用于M1 或 M2 机器类型资源）
  • MEMORY_OPTIMIZED_M3（适用于内存优化 M3 机器类型）
  • ACCELERATOR_OPTIMIZED（适用于机器类型资源）
  • 适用于 G2 机器类型资源的 GRAPHICS_OPTIMIZED

• COMMITTED_VCPUS：您的承诺中包含的 vCPU 数量。该数字必须是正整数。

• COMMITTED_MEMORY：您的承诺中包含的内存量，以 MB 为单位。例如 10240MB。您可以按 256 MB 的增量购买内存。

• COMMITTED_LOCAL_SSD：您的承诺中包含的本地 SSD 存储空间，以 GB 为单位。每个本地 SSD 磁盘为 375 GB。

• COMMITTED_ACCELERATOR_COUNT：您的承诺中包含的 GPU 数量。

• COMMITTED_ACCELERATOR_TYPE：您的承诺中包含的 GPU 类型。

• RESERVATION_URLs：要附加到承诺的现有预留的网址的逗号分隔列表。例如，如需附加 res-1 和 res-2 这两个预留，请指定以下网址：

  "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/example-res-1",
  "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-c/reservations/example-res-2"
  

示例：通过附加现有预留来购买承诺

假设项目 myproject 的 us-central1-a 和 us-central1-b 可用区中有两个预留 res-01 和 res-02。假设这些预留包含 4 个 NVIDIA P100 GPU 和 4 个本地 SSD 磁盘的总容量。如需在此项目的 us-central1 区域中为这些 GPU 和本地 SSD 磁盘购买新承诺，并将这些现有预留用作附加预留，请发出以下 POST 请求。请注意，示例承诺还包含 vCPU 和内存。

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments

{
  "name": "commitment-01",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE"
  "resources":
  [
    {
      "amount": "96",
      "type": "VCPU"
    },
    {
      "amount": "638976",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "nvidia-tesla-v100",
      "amount": "4",
      "type": "ACCELERATOR"
    },
    {
      "amount": "1536000",
      "type": "LOCAL_SSD"
    }
  ],
  "existingReservations":
  [
    "https://www.googleapis.com/compute/v1/projects/my-project/zone/us-central1-a/reservations/res-01",
    "https://www.googleapis.com/compute/v1/projects/my-project/zone/us-central1-b/reservations/res-02"
  ]
}

控制台

在使用 Google Cloud 控制台购买承诺之前，请先选择要用于购买承诺的项目。如果为 Cloud Billing 账号启用了折扣共享，您可以使用该 Cloud Billing 账号中的任何项目购买承诺。选择项目后，请执行以下操作：

1. 在 Google Cloud 控制台中，转到承诺使用折扣页面。

   转到“承诺使用折扣”

2. 如需购买新的承诺，请点击购买使用承诺。

3. 为您的承诺使用合约命名，并选择您希望应用该承诺使用合约的区域。

4. 选择承诺类型。以下承诺类型提供适用于 GPU 和/或本地 SSD 磁盘的选项：

   • 通用 C3，适用于 C3 机器类型资源
   • 通用 C3D，适用于 C3D 机器类型资源
   • 通用 N2，适用于 N2 机器类型资源
   • 通用 N2D，适用于 N2D 机器类型资源
   • 通用 N1，适用于 N1 机器类型资源
   • 计算优化型 H3，适用于 H3 机器类型资源
   • 计算优化的 C2，适用于 C2 机器类型资源
   • 计算优化的 C2D，适用于 C2D 机器类型资源
   • 内存优化的 M1/M2，适用于 M1 和 M2 机器类型资源
   • 内存优化的 M3，适用于 M3 机器类型资源
   • 加速器优化的 A3（适用于 A3 机器类型资源）
   • 加速器优化的 A2，适用��� A2 机器类型资源
   • 图形优化的 G2，适用于 G2 机器类型资源

5. 选择承诺的持续时间（1 年或 3 年）。

6. 输入您要购买的核心数量和内存量。如果您只想承诺使用 GPU 或本地 SSD 磁盘，并且预留它们，但不承诺使用 vCPU 和内存，请为 vCPU 和内存承诺数量指定 0。

7. 点击添加 GPU，然后选择您要在承诺中包含的 GPU 类型和 GPU 数量。

8. 点击添加本地 SSD 并指定要承诺使用的磁盘数量。

9. 如需创建���留并将其附加到承诺，请点击添加预留。

   1. 在名称字段中，为预留输入名称。
   2. 选择您要预留资源的区域和可用区。
   3. 选择您偏好的共享类型：
      • 如需为单个项目创建预留，请选择本地。
      • 如需在多个项目之间创建共享预留，请选择共享。如需与其他项目共享此预留，请点击 add 添加项目，然后从当前项目的组织中选择所需的项目。

   4. 在搭配虚拟机实例使用字段中，选择以下选项之一：

      • 如需在创建通过名称明确指向此预留的匹配虚拟机时使用此预留的资源，请选择选择特定预留。
      • 如需允许匹配的虚拟机实例自动使用此预留，请选择自动使用预留。

   5. 在虚拟机实例数量字段中，输入要预留的虚拟机实例数量。

   6. 指定您要为每个虚拟机实例预留的资源：

      • 如果您要预留与现有实例模板匹配的虚拟机，请选择使用实例模板，然后从列表中选择一个实例模板。
      • 否则，请选择指定机器类型并指定以下内容：
        1. 在机器系列字段中，选择机器系列：通用、优化计算、内存优化或 GPU。
        2. 在系列和机器类型字段中，选择机器系列和机器类型。
        3. 可选：指定满足最低要求的 CPU 平台和/或 GPU：
           1. 点击 CPU 平台和 GPU 以展开该部分。
           2. 可选：如需指定满足最低要求的 CPU 平台，请在 CPU 平台列表中选择一个选项。
           3. 可选：如需添加 GPU，请点击 add 添加 GPU。然后，在 GPU 类型和 GPU 数量字段中，选择每个虚拟机的 GPU 类型和数量。
        4. 可选：添加本地 SSD 磁盘：
           1. 在磁盘数量字段中，选择每个虚拟机的本地 SSD 磁盘数量。
           2. 在接口类型字段中，选择本地 SSD 磁盘的接口。

   7. 如需完成为此预留指定属性，请点击完成。

10. 点击购买按钮以购买承诺。

11. 阅读购买条款，并在准备好购买承诺时点击购买。

gcloud

如需在购买承诺时创建附加预留，请运行 gcloud compute commitments create 命令。

根据您要附加单个预留还是多个预留，通过以下方式之一运行该命令：

• 如需创建单个预留并附加到承诺，请运行以下命令来定义附加预留的属性：

  gcloud compute commitments create COMMITMENT_NAME \
      --region=REGION \
      --project=PROJECT_ID \
      --plan DURATION \
      --type COMMITMENT_TYPE
      --resources=vcpu=COMMITTED_VCPUS,memory=COMMITTED_MEMORY,local-ssd=COMMITTED_LOCAL_SSD \
      --resources-accelerator=count=COMMITTED_ACCELERATOR_COUNT,type=COMMITTED_ACCELERATOR_TYPE \
      --reservation=RESERVATION_NAME \
      --reservation-zone=RESERVATION_ZONE \
      --machine-type=RESERVED_MACHINE_TYPE \
      --require-specific-reservation=REQUIRE_SPECIFIC_RESERVATION_VALUE \
      --vm-count=NUMBER_OF_RESERVED_VMs \
      --accelerator=type=RESERVED_ACCELERATOR_TYPE,count=RESERVED_ACCELERATOR_COUNT \
      --local-ssd=interface=INTERFACE_1,size=375 \
      --local-ssd=interface=INTERFACE_2,size=375 \
      --minimum-cpu-platform=MINIMUM_CPU_PLATFORM \
      --share-setting=SHARE_SETTING \
      --share-with=CONSUMER_PROJECT_ID_1,CONSUMER_PROJECT_ID_2
  

• 如需创建多个预留并附加到承诺，请使用 YAML 文件定义预留的属性，然后在用于购买承诺的命令中指定该 YAML 文件。（可选）您还可以使用此 YAML 文件方法创建单个预留并附加到承诺。如需使用此方法创建附加预留，请执行以下操作：

  1. 在当前目录中创建 YAML 文件，并指定每个附加预留的配置。例如，如需指定与两个指定 GPU、两个本地 SSD 磁盘和满足最低要求的 CPU 平台的项目共享的共享预留的配置，请在 YAML 文件中添加以下文本：

     - reservation: RESERVATION_NAME
       reservation_zone: RESERVATION_ZONE
       require_specific_reservation: REQUIRE_SPECIFIC_RESERVATION_VALUE
       vm_count: NUMBER_OF_RESERVED_VMs
       machine_type: RESERVED_MACHINE_TYPE
       accelerator:
       - count: RESERVED_ACCELERATOR_COUNT
         type: RESERVED_ACCELERATOR_TYPE
       localssd:
       - interface: INTERFACE_1
         size: 375
       - interface: INTERFACE_2
         size: 375
       project: OWNER_PROJECT_ID
       minimum-cpu-platform: MINIMUM_CPU_PLATFORM
       share-setting: SHARE_SETTING
       share-with:
       - CONSUMER_PROJECT_ID_1
       - CONSUMER_PROJECT_ID_2
     
     

     如需为多个预留指定配置，请为要创建的每个预留重复这些属性。您可以将任意数量的现有预留附加到承诺。

  2. 运行 gcloud compute commitments create 命令并添加 --reservation-from-file 标志。

     gcloud compute commitments create COMMITMENT_NAME \
         --region REGION \
         --project PROJECT_ID \
         --plan DURATION \
         --type COMMITMENT_TYPE \
         --resources=vcpu=COMMITTED_VCPUS,memory=COMMITTED_MEMORY,local-ssd=COMMITTED_LOCAL_SSD \
         --resources-accelerator=count=COMMITTED_ACCELERATOR_COUNT,type=COMMITTED_ACCELERATOR_TYPE \
         --reservations-from-file=YAML_FILE
     

将以下字段替换为承诺和附加预留的相应属性：

只有在请求时目标可用区中有足够的指定机器类型资源和足够的配额时，Compute Engine 才会创建承诺和附加预留。如果您的购买成功，您会看到如下所示的成功消息：

Created[https://www.googleapis.com/compute/v1/projects/your-project/regions/your-region/commitments/your-commitment-name]

通过创建要附加的新预留来购买承诺的示例

以下示例场景和命令展示了如何通过创建要附加到承诺的新预留来为 GPU 和/或本地 SSD 磁盘购买承诺。

示例 1：通过附加单个新预留为 GPU 购买承诺

假设您要在 us-central1 区域中购买包含 4 个 NVIDIA V100 GPU 的承诺 commitment-01。您要创建新预留 reservation-01 作为这些 GPU 的附加预留。假设您还想要指定 Compute Engine 在 us-central1-a 可用区中的 2 个 n1-standard-32 虚拟机上使用这些预留的 GPU。如需购买此示例承诺及其附加预留，请运行以下命令：

gcloud compute commitments create commitment-01 \
    --region=us-central1 \
    --project=myproject \
    --resources=vcpu=96,memory=624GB \
    --resources-accelerator=type=nvidia-tesla-v100,count=4 \
    --plan 12-month \
    --reservation=reservation-01 \
    --reservation-zone=us-central1-a \
    --machine-type=n1-standard-32 \
    --accelerator=type=nvidia-tesla-v100,count=2 \
    --vm-count=2

示例 2：为 GPU 购买承诺，但不为 vCPU 或内存购买承诺

如需为 GPU 和本地 SSD 磁盘购买承诺并预留 GPU 和本地 SSD 磁盘，但不为 vCPU 或内存购买承诺，请指定 0 作为 vCPU 和内存数量的值。例如，假设您想要为 us-west2 区域中的单个 NVIDIA P4 GPU 购买承诺 commitment-02。您还希望创建新的预留作为附加预留，并指定 Compute Engine 在 us-west2-b 可用区中的 n1-standard-2 虚拟机上使用预留的 GPU。如需购买此示例承诺及其附加预留，请运行以下命令：

gcloud compute commitments create commitment-02 \
    --region=us-west2 \
    --project=myproject \
    --resources=vcpu=0,memory=0 \
    --resources-accelerator=type=nvidia-tesla-p4,count=1 \
    --plan 12-month \
    --reservation=reservation-01 \
    --reservation-zone=us-west2-b \
    --machine-type=n1-standard-2 \
    --accelerator=type=nvidia-tesla-p4,count=1 \
    --vm-count=1

示例 3：通过附加多个新预留为 GPU 和本地 SSD 磁盘购买承诺

假设您想要为 us-central1 区域中的 1 个 NVIDIA V 100 GPU 和 2 个本地 SSD 磁盘购买承诺 commitment-03。您还希望在 us-central1-a 可用区中创建和附加两个预留。在第一个预留 res-01 中，您想要预留 1 个 n1-standard-2 虚拟机和 1 个 GPU。您希望将 res-01 设置为指定的预留，这表示您必须明确指定该预留的名称才能使用其预留的虚拟机。在第二个预留 res-02 中，您想要预留 1 个 n1-standard-8 虚拟机，并挂接 2 种本地 SSD 磁盘。

如需购买包含附加预留的此示例承诺，请先创建具有两个预留属性的 YAML 文件。

- reservation: res-01
  reservation_zone: us-central1-a
  require_specific_reservation: true
  vm_count: 1
  machine_type: n1-standard-2
  accelerator:
  - count: 1
    type: nvidia-tesla-v100
- reservation: res-02
  reservation_zone: us-central1-a
  vm_count: 1
  machine_type: n1-standard-8
  local_ssd:
  - interface: scsi
    size: 375
  - interface: nvme
    size: 375

创建 YAML 文件后，如需完成购买承诺及其附加预留的操作，请运行以下命令。请注意，示例承诺还包含 vCPU 和内存资源。

gcloud compute commitments create commitment-03 \
    --region=us-central1 \
    --project=myproject \
    --resources=vcpu=96,memory=624,local-ssd=750 \
    --resources-accelerator=type=nvidia-tesla-v100,count=1 \
    --plan 12-month \
    --reservations-from-file=YAML_FILE

REST

如需在购买承诺时创建附加预留，请向 regionCommitments.insert 方法发出 POST 请求。在请求中添加 reservations 字段，以定义要创建和附加的所有新预留的列表。您可以将任意数量的现有预留附加到承诺。

• 如需通过手动指定所有虚拟机属性来创建新预留，请添加 instanceProperties 字段并排除 sourceInstanceTemplate 字段。

  例如，如需手动指定与两个指定 GPU、两个本地 SSD 磁盘和满足最低要求的 CPU 平台的项目共享的共享预留的配置，请发出以下请求：

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments
  
  {
  "name": "COMMITMENT_NAME",
  "plan": "DURATION",
  "type": COMMITMENT_TYPE,
  "resources":
  [
    {
      "amount": "COMMITTED_VCPUS",
      "type": "VCPU"
    },
    {
      "amount": "COMMITTED_MEMORY",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "COMMITTED_ACCELERATOR_TYPE",
      "amount": "COMMITTED_ACCELERATOR_COUNT",
      "type": "ACCELERATOR"
    }
    {
      "amount": "COMMITTED_LOCAL_SSD",
      "type": "LOCAL_SSD"
    }
  ],
  "reservations":
  [
    {
      "name": "RESERVATION_NAME",
      "specificReservation":
      {
        "count": "NUMBER_OF_RESERVED_VMS",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": "RESERVED_ACCELERATOR_COUNT",
              "acceleratorType": "RESERVED_ACCELERATOR_TYPE"
            }
          ],
          "localSsds":
          [
            {
              "diskSizeGb": "375",
              "interface": "RESERVED_INTERFACE_1"
            },
            {
              "diskSizeGb": "375",
              "interface": "RESERVED_INTERFACE_2"
            }
          ],
          "machineType": "RESERVED_MACHINE_TYPE",
          "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
        }
      },
      "specificReservationRequired": REQUIRE_SPECIFIC_RESERVATION_VALUE",
      "zone": "RESERVED_ZONE",
      "shareSettings":
      {
        "shareType": "SPECIFIC_PROJECTS",
        "projectMap":
        {
          "CONSUMER_PROJECT_ID_1":
          {
            "projectId": "CONSUMER_PROJECT_ID_1"
          },
          "CONSUMER_PROJECT_ID_2":
          {
            "projectId": "CONSUMER_PROJECT_ID_2"
          }
        }
      }
    }
  ]
  }
  
  

• 如需通过指定实例模板创建新预留，请添加 sourceInstanceTemplate 字段并排除 instanceProperties 字段。

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments
  
  {
  "name": "COMMITMENT_NAME",
  "plan": "DURATION",
  "type": COMMITMENT_TYPE,
  "resources":
  [
    {
      "amount": "COMMITTED_VCPUS",
      "type": "VCPU"
    },
    {
      "amount": "COMMITTED_MEMORY",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "COMMITTED_ACCELERATOR_TYPE",
      "amount": "COMMITTED_ACCELERATOR_COUNT",
      "type": "ACCELERATOR"
    }
    {
      "amount": "COMMITTED_LOCAL_SSD",
      "type": "LOCAL_SSD"
    }
  ],
  "reservations":
  [
    {
      "name": "RESERVATION_NAME",
      "specificReservation":
      {
        "count": "NUMBER_OF_RESERVED_VMS",
        "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME"
      },
      "specificReservationRequired": REQUIRE_SPECIFIC_RESERVATION_VALUE",
      "zone": "RESERVED_ZONE",
      "shareSettings":
      {
        "shareType": "SPECIFIC_PROJECTS",
        "projectMap":
        {
          "CONSUMER_PROJECT_ID_1":
          {
            "projectId": "CONSUMER_PROJECT_ID_1"
          },
          "CONSUMER_PROJECT_ID_2":
          {
            "projectId": "CONSUMER_PROJECT_ID_2"
          }
        }
      }
    }
  ]
  }
  
  

将以下字段替换为承诺和附加预留的相应属性：

只有在请求时目标可用区中有足够的指定机器类型资源和足够的配额时，Compute Engine 才会创建承诺和附加预留。如果购买成功，Compute Engine 会为您的 REST API 请求返回 200 状态。

通过创建要附加的新预留来购买承诺的示例

以下示例场景和命令展示了如何通过创建要附加到承诺的新预留来为 GPU 和/或本地 SSD 磁盘购买承诺。

示例 1：通过附加单个新预留为 GPU 购买承诺

假设您要在 us-central1 区域中购买包含 4 个 NVIDIA V100 GPU 的承诺 commitment-01。您要创建新预留 reservation-01 作为这些 GPU 的附加预留。假设您还想要指定 Compute Engine 在 us-central1-a 可用区中的 2 个 n1-standard-8 虚拟机上使用这些预留的 GPU。如需购买此示例承诺及其附加预留，请发出以下 POST 请求：

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments

{
  "name": "commitment-01",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE"
  "resources":
  [
    {
      "amount": "96",
      "type": "VCPU"
    },
    {
      "amount": "638976",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "nvidia-tesla-v100",
      "amount": "4",
      "type": "ACCELERATOR"
    }
  ],
  "reservations":
  [
    {
      "name": "reservation-01",
      "specificReservation":
      {
        "count": "2",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": 2,
              "acceleratorType": "nvidia-tesla-v100"
            }
          ],
          "machineType": "n1-standard-8"
        }
      },
      "specificReservationRequired": false,
      "zone": "us-central1-a"
    }
  ]
}

示例 2：为 GPU 购买承诺，但不为 vCPU 或内存购买承诺

如需为 GPU 和本地 SSD 磁盘购买承诺并预留 GPU 和本地 SSD 磁盘，但不为 vCPU 或内存购买承诺，请指定 0 作为 vCPU 和内存数量的值。例如，假设您想要为 us-west2 区域中的单个 NVIDIA P4 GPU 购买承诺 commitment-02。您还希望创建新的预留作为附加预留，并指定 Compute Engine 在 us-west2-b 可用区中的 n1-standard-2 虚拟机上使用预留的 GPU。如需购买此示例承诺及其附加预留，请发出以下 POST 请求：

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-west2/commitments

{
  "name": "commitment-02",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE",
  "resources":
  [
    {
      "amount": "0",
      "type": "VCPU"
    },
    {
      "amount": "0",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "nvidia-tesla-p4",
      "amount": "4",
      "type": "ACCELERATOR"
    }
  ],
  "reservations":
  [
    {
      "name": "reservation-01",
      "specificReservation":
      {
        "count": "1",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": 4,
              "acceleratorType": "nvidia-tesla-p4"
            }
          ],
          "machineType": "n1-standard-2"
        }
      },
      "specificReservationRequired": false,
      "zone": "us-west2-b"
    }
  ]
}

示例 3：通过附加多个新预留为 GPU 和本地 SSD 磁盘购买承诺

假设您想要为 us-central1 区域中的 1 个 NVIDIA V 100 GPU 和 2 个本地 SSD 磁盘购买承诺 commitment-03。您还希望在 us-central1-a 可用区中创建和附加两个预留。在第一个预留 res-01 中，您想要预留 1 个 n1-standard-2 虚拟机和 1 个 GPU。您希望将 res-01 设置为指定的预留，这表示您必须明确指定该预留的名称才能使用其预留的虚拟机。在第二个预留 res-02 中，您想要预留 1 个 n1-standard-8 虚拟机，并挂接 2 种本地 SSD 磁盘。如需购买带有附加预留的此示例承诺，请发出以下 POST 请求。请注意，示例承诺还包含 vCPU 和内存资源。

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments

{
  "name": "commitment-03",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE",
  "resources":
  [
    {
      "amount": "96",
      "type": "VCPU"
    },
    {
      "amount": "638976",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "nvidia-tesla-v100",
      "amount": "1",
      "type": "ACCELERATOR"
    },
    {
      "amount": "768000",
      "type": "LOCAL_SSD"
    }
  ],
  "reservations":
  [
    {
      "name": "res-01",
      "specificReservation":
      {
        "count": "1",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": 1,
              "acceleratorType": "nvidia-tesla-v100"
            }
          ],
          "machineType": "n1-standard-2"
        }
      },
      "specificReservationRequired": true,
      "zone": "us-central1-a"
    },
    {
      "name": "res-02",
      "specificReservation":
      {
        "count": "1",
        "instanceProperties":
        {
          "localSsds":
          [
            {
              "diskSizeGb": "375",
              "interface": "SCSI"
            },
            {
              "diskSizeGb": "375",
              "interface": "NVME"
            }
          ]
          "machineType": "n1-standard-8"
        }
      },
      "specificReservationRequired": false,
      "zone": "us-central1-a"
    }
  ]
}

gcloud

如需替换附加到承诺的预留，请执行以下操作：

1. 使用以下附加预留的配置在当前目录中创建 YAML 文件：

   • 您要替换的当前预留。

     如需检索此预留的详细信息，请参阅查看预留详细信息。

   • 新的替换预留。

   YAML 文件的内容类似于以下内容：

   - reservation: CURRENT_RESERVATION_NAME
     reservation_zone: CURRENT_RESERVATION_ZONE
     vm_count: 0
     machine_type: CURRENT_RESERVATION_MACHINE_TYPE
     accelerator:
     - count: CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS
       type: CURRENT_RESERVATION_ACCELERATOR_TYPE
     localssd:
     - interface: CURRENT_RESERVATION_INTERFACE_1
       size: 375
     - interface: CURRENT_RESERVATION_INTERFACE_2
       size: 375
     project: CURRENT_RESERVATION_PROJECT_ID
     share-setting: CURRENT_RESERVATION_SHARE_SETTING
     share-with:
     - CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1
     - CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2
   - reservation: REPLACEMENT_RESERVATION_NAME
     reservation_zone: REPLACEMENT_RESERVATION_ZONE
     vm_count: REPLACEMENT_RESERVATION_NUMBER_OF_VMs
     machine_type: REPLACEMENT_RESERVATION_MACHINE_TYPE
     accelerator:
     - count: REPLACEMENT_RESERVATION_ACCELERATOR_COUNT
       type: REPLACEMENT_RESERVATION_ACCELERATOR_TYPE
     localssd:
     - interface: REPLACEMENT_RESERVATION_INTERFACE_1
       size: 375
     - interface: REPLACEMENT_RESERVATION_INTERFACE_2
       size: 375
     project: REPLACEMENT_RESERVATION_PROJECT_ID
     share-setting: REPLACEMENT_RESERVATION_SHARE_SETTING
     share-with:
     - REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1
     - REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2
   
   

   将以下内容替换为当前预留和替换预留的相应属性：

   当前预留

   对于当前预留，以下所有属性必须与您查看预留时完全相同。省略当前预留尚未拥有的任何属性的字段。

   • CURRENT_RESERVATION_NAME：当前附加预留的名称。
   • CURRENT_RESERVATION_ZONE：当前附加预留的可用区。
   • CURRENT_RESERVATION_MACHINE_TYPE：当前附加预留的机器类型。
   • CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS：当前附加预留中预留的 GPU 数量。
   • CURRENT_RESERVATION_ACCELERATOR_TYPE：当前附加预留中预留的加速器类型。
   • CURRENT_RESERVATION_INTERFACE_1 和 CURRENT_RESERVATION_INTERFACE_2：在当前附加预留中每个预留虚拟机的本地 SSD 磁盘使用的接口类型。有效选项包括 scsi 和 nvme。每个本地 SSD 磁盘为 375 GB。对所有预留的本地 SSD 磁盘重复 local_ssd 参数。
   • CURRENT_RESERVATION_PROJECT_ID：包含承诺和附加预留的当前项目的项目 ID。如果在多个使用方项目之间共享当前附加预留，请指定此字段。
   • CURRENT_RESERVATION_SHARE_SETTING：当前预留的共享类型。如果在多个使用方项目之间共享当前附加预留，请将此字段的值指定为 projects。
   • CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1 和 CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2：您与之共享当前附加预留的项目的项目 ID，例如 project-1 和 project-2。

   替换预留

   对于替换预留，根据需要设置以下属性。确保指定这些属性时满足所有要求。忽略您不想使用的任何其他字段。

   • REPLACEMENT_RESERVATION_NAME：新替换预留的名称。
   • REPLACEMENT_RESERVATION_ZONE：新替换预留的可用区。
   • REPLACEMENT_RESERVATION_NUMBER_OF_VMS：您要在新替换预留中预留的虚拟机数量。

   • REPLACEMENT_RESERVATION_MACHINE_TYPE：要用于新替换预留中的虚拟机的机器类型。

     • 对于预定义机器类型，请使用 MACHINE_FAMILY-standard-CPUS 格式；例如 n2-standard-4。
     • 对于自定义机器类型，请使用 MACHINE_FAMILY-custom-CPUS-MEMORY 格式；例如 n2-custom-4-5120。如需查看限制条件的完整列表，请参阅自定义机器类型的规范。

     替换以下内容：

     • MACHINE_FAMILY：机器类型系列；例如，为 N2 虚拟机指定 n2。
     • CPUS：vCPU 的数量。
     • MEMORY：预留虚拟机的总内存。内存必须是 256 MB 的整数倍，且必须以 MB 为单位提供；例如，如需创建配备 4 个 vCPU 和 5 GB 内存（大小为 5120 MB）的 N2 虚拟机，请使用 n2-custom-4-5120。

   • REPLACEMENT_RESERVATION_NUMBER_OF_ACCELERATORS：您要在替换预留中为每个虚拟机添加的 GPU 数量。

   • REPLACEMENT_RESERVATION_ACCELERATOR_TYPE：您要在替换预留中添加的加速器类型。

   • REPLACEMENT_RESERVATION_INTERFACE_1 和 REPLACEMENT_RESERVATION_INTERFACE_2：您希望每个预留虚拟机的本地 SSD 磁盘使用的接口类型。有效选项包括 scsi 和 nvme。 每个本地 SSD 磁盘为 375 GB。对���添加的每个本地 SSD 磁盘重复 local_ssd 参数。您最多可以指定 24 个本地 SSD 磁盘。

   • REPLACEMENT_RESERVATION_PROJECT_ID：包含承诺和附加预留的当前项目的项目 ID。如果要在多个使用方项目之间共享替换预留，请指定此字段。

   • REPLACEMENT_RESERVATION_SHARE_SETTING：替换预留的共享类型。如果要在多个使用方项目之间共享替换预留，请将此字段的值指定为 projects。

   • REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1 和 REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2：可以共享此预留的项目的项目 ID，例如 project-1,project-2。您最多可以添加 100 个使用方项目。 这些项目必须与所有者项目位于同一组织中。请勿添加 REPLACEMENT_RESERVATION_PROJECT_ID，默认情况下，它可以使用此预留。

2. 运行 gcloud beta compute commitments update-reservations 命令并使用 --reservations-from-file 标志指定 YAML 文件的路径。

   gcloud beta compute commitments update-reservations COMMITMENT_NAME \
       --project= PROJECT_ID \
       --region= REGION \
       --reservations-from-file= YAML_FILE
   

   替换以下内容：

   • COMMITMENT_NAME：含附加预留的承诺的名称。
   • PROJECT_ID：含附加预留的承诺的项目 ID。
   • REGION：承诺所在的区域。
   • YAML_FILE：包含当前预留和替换预留的配置的 YAML 文件的路径。

替换附加到承诺的预留的示例

为了演示这一点，本部分显示含附加预留的承诺示例，以及如何替换附加预留示例。

含附加预留的承诺示例

例如，假设您要使用以下命令更新购买的 my-commitment-with-reservations 承诺的附加预留：

  gcloud beta compute commitments create my-commitment-with-reservations \
      --region=asia-east1 \
      --resources=vcpu=16,memory=60GB,local-ssd=3000GB \
      --resources-accelerator=type=nvidia-tesla-p100,count=4 \
      --plan=12-month \
      --type=general-purpose \
      --reservations-from-file=one-reservation.yaml

在本示例中，假设运行此命令时，one-reservation.yaml 是当前目录中的一个文件，其中包含以下内容，用于定义名为 res-1 的附加预留。

  - reservation: res-1
    reservation_zone: asia-east1-a
    vm_count: 4
    machine_type: n1-standard-4
    accelerator:
    - count: 1
      type: nvidia-tesla-p100
    local_ssd:
    - interface: scsi
      size: 375
    - interface: scsi
      size: 375

此 my-commitment-with-reservations 承诺和附加的预留 res-1 产生了以下承诺和预留资源：

^*具体来说，附加预留示例 res-1 预留 4 个 n1-standard-4 虚拟机，每个虚拟机具有 1 个 P100 GPU 和 2 个接口类型为 scsi 的本地 SSD 磁盘。n1-standard-4 机器类型为每个虚拟机使用 4 个 vCPU 和 15 GB。

替换附加预留示例

假设您要将附加预留 res-1 替换为新的附加预留 res-2，并将预留资源更改为以下内容：

^*具体来说，附加预留示例 res-1 预留 4 个 n1-standard-4 虚拟机，每个虚拟机具有 1 个 P100 GPU 和 2 个接口类型为 scsi 的本地 SSD 磁盘。n1-standard-4 机器类型为每个虚拟机使用 4 个 vCPU 和 15 GB。

^†具体而言，替换附加预留定义了 res-2，它预留 2 个 n1-standard-8 虚拟机，每个虚拟机具有 1 个 P100 GPU 和 4 个接口类型为 scsi 的本地 SSD 磁盘。此外，res-2 已与其他 2 个项目（project-1 和 project-2）共享，并且归当前项目 my-project 所有。n1-standard-8 机器类型为每个虚拟机使用 8 个 vCPU 和 30 GB。

如需将附加预留 res-1 替换为 my-commitment-with-reservations 承诺的 res-2，请执行以下操作：

1. 在当前目录中创建一个名为 two-reservations.yaml 的文件，该文件包含以下内容：

   - reservation: res-1
     reservation_zone: asia-east1-a
     vm_count: 0
     machine_type: n1-standard-4
     accelerator:
     - count: 1
       type: nvidia-tesla-p100
     local_ssd:
     - interface: scsi
       size: 375
     - interface: scsi
       size: 375
   - reservation: res-2
     reservation_zone: asia-east1-a
     vm_count: 2
     machine_type: n1-standard-8
     accelerator:
     - count: 2
       type: nvidia-tesla-p100
     project: my-project
     share-setting: projects
     share-with:
     - project-1
     - project-2
     local_ssd:
     - interface: scsi
       size: 375
     - interface: scsi
       size: 375
     - interface: scsi
       size: 375
     - interface: scsi
       size: 375
   

2. 运行以下命令：

   gcloud beta compute commitments update-reservations my-commitment-with-reservations \
       --region=asia-east1-a \
       --reservations-from-file=two-reservations.yaml
   

REST

如需替换附加到承诺的预留，请使用 regionCommitments.updateReservations 方法发出 POST 请求。

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/COMMITMENT_ZONE/commitments/COMMITMENT_NAME/updateReservations

{
  "reservations":
  [
    {
      "name": "REPLACEMENT_RESERVATION_NAME",
      "specificReservation":
      {
        "count": "REPLACEMENT_RESERVATION_NUMBER_OF_VMS",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": "REPLACEMENT_RESERVATION_NUMBER_OF_ACCELERATORS",
              "acceleratorType": "REPLACEMENT_RESERVATION_ACCELERATOR_TYPE"
            }
          ],
          "localSsds":
          [
            {
              "diskSizeGb": "375",
              "interface": "REPLACEMENT_RESERVATION_INTERFACE_1"
            },
            {
              "diskSizeGb": "375",
              "interface": "REPLACEMENT_RESERVATION_INTERFACE_2"
            }
          ],
          "machineType": "REPLACEMENT_RESERVATION_MACHINE_TYPE"

        }
      },
      "zone": "REPLACEMENT_RESERVATION_ZONE",
      "shareSettings":
      {
        "shareType": "SPECIFIC_PROJECTS",
        "projectMap":
        {
          "REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1":
          {
            "projectId": "REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1"
          },
          "REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2":
          {
            "projectId": "REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2"
          }
         }
      }
    },
    {
      "name": "CURRENT_RESERVATION_NAME",
      "specificReservation":
      {
        "count": "0",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": "CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS",
              "acceleratorType": "CURRENT_RESERVATION_ACCELERATOR_TYPE"
            }
          ],
          "localSsds":
          [
            {
              "diskSizeGb": "375",
              "interface": "CURRENT_RESERVATION_INTERFACE_1"
            },
            {
              "diskSizeGb": "375",
              "interface": "CURRENT_RESERVATION_INTERFACE_2"
            }
          ],
          "machineType": "CURRENT_RESERVATION_MACHINE_TYPE"

        }
      },
      "zone": "CURRENT_RESERVATION_ZONE",
      "shareSettings":
      {
        "shareType": "SPECIFIC_PROJECTS",
        "projectMap":
        {
          "CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1":
          {
            "projectId": "CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1"
          },
          "CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2":
          {
            "projectId": "CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2"
          }
         }
      }
    }
  ]
}

将以下内容替换为承诺、当前预留和替换预留的相应属性：

替换附加到承诺的预留的示例

为了演示这一点，本部分显示含附加预留的承诺示例，以及如何替换附加预留示例。

含附加预留的承诺示例

例如，假设您想要通过发出以下 POST 请求，替换购买的 my-commitment-with-reservations 承诺的附加预留 res-1：

  POST https://compute.googleapis.com/compute/beta/projects/my-project/regions/asia-east1/commitments

  {
    "name": "my-commitment-with-reservations",
    "plan": "TWELVE_MONTH",
    "reservations":
    [
      {
        "name": "res-1",
        "specificReservation":
        {
          "count": "4",
          "instanceProperties":
          {
            "guestAccelerators":
            [
              {
                "acceleratorCount": "1",
                "acceleratorType": "nvidia-tesla-p100"
              }
            ],
            "localSsds":
            [
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              }
            ],
            "machineType": "n1-standard-4"
          }
        },
        "zone": "asia-east1-a"
      }
    ],
    "resources":
    [
      {
        "amount": "16",
        "type": "VCPU"
      },
      {
        "amount": "61440",
        "type": "MEMORY"
      },
      {
        "acceleratorType": "nvidia-tesla-p100",
        "amount": "4",
        "type": "ACCELERATOR"
      }
      {
        "amount": "3072000",
        "type": "LOCAL_SSD"
      }
    ],
    "type": "GENERAL_PURPOSE"
  }

此 my-commitment-with-reservations 承诺和附加的预留 res-1 产生了以下承诺和预留资源：

^*具体来说，附加预留示例 res-1 预留 4 个 n1-standard-4 虚拟机，每个虚拟机具有 1 个 P100 GPU 和 2 个接口类型为 scsi 的本地 SSD 磁盘。n1-standard-4 机器类型为每个虚拟机使用 4 个 vCPU 和 15 GB。

替换附加预留示例

假设您要将附加预留 res-1 替换为新的附加预留 res-2，并将预留资源更改为以下内容：

^*具体来说，附加预留示例 res-1 预留 4 个 n1-standard-4 虚拟机，每个虚拟机具有 1 个 P100 GPU 和 2 个接口类型为 scsi 的本地 SSD 磁盘。n1-standard-4 机器类型为每个虚拟机使用 4 个 vCPU 和 15 GB。

^†具体而言，替换附加预留定义了 res-2，它预留 2 个 n1-standard-8 虚拟机，每个虚拟机具有 1 个 P100 GPU 和 4 个接口类型为 scsi 的本地 SSD 磁盘。此外，res-2 已与其他 2 个项目（project-1 和 project-2）共享，并且归当前项目 my-project 所有。n1-standard-8 机器类型为每个虚拟机使用 8 个 vCPU 和 30 GB。

如需将 my-commitment-with-reservations 承诺的附加预留 res-1 替换为 res-2，请使用 regionCommitments.updateReservations 方法发出以下 POST 请求：

  POST https://compute.googleapis.com/compute/beta/projects/my-project/regions/asia-east1/commitments/my-commitment-with-reservations/updateReservations

  {
    "reservations":
    [
      {
        "name": "res-2",
        "specificReservation":
        {
          "count": "2",
          "instanceProperties":
          {
            "guestAccelerators":
            [
              {
                "acceleratorCount": 2,
                "acceleratorType": "nvidia-tesla-p100"
              }
            ],
            "localSsds":
            [
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              }
            ],
            "machineType": "n1-standard-8"
          }
        },
        "zone": "asia-east1-a"
      },
      {
        "name": "res-1",
        "specificReservation":
        {
          "count": "0",
          "instanceProperties":
          {
            "guestAccelerators":
            [
              {
                "acceleratorCount": 1,
                "acceleratorType": "nvidia-tesla-p100"
              }
            ],
            "localSsds":
            [
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              }
            ],
            "machineType": "n1-standard-4"
          }
        },
        "zone": "asia-east1-a"
      }
    ]
  }