基于资源的承诺使用折扣

控制台

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

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

   转到“承诺使用折扣”

2. 如需购买承诺，请点击 add_box 购买承诺。系统会打开购买承诺使用折扣页面，并显示硬件标签页。

3. 在名称字段中，输入承诺的名称。

4. 在区域字段中，选择您要在其中承诺使用 Compute Engine 资源的区域。

5. 在承诺类型字段中，选择承诺的资源的机器家族系列。 对于 vCPU 和/或内存，您可以从以下承诺类型中进行选择：

   • 加速器优化的 A2，适用于 A2 机器类型资源
   • 加速器优化 A3，适用于 A3 Edge 和 A3 High 机器类型资源
   • 加速器优化 A3 Mega，适用于 A3 Mega 机器类型资源
   • 计算优化的 C2，适用于 C2 机器类型资源
   • 计算优化的 C2D，适用于 C2D 机器类型资源
   • 计算优化型 H3，适用于 H3 机器类型资源
   • 通用 C3，适用于 C3 机器类型资源
   • 通用 C3D，适用于 C3D 机器类型资源
   • 通用 C4，适用于 C4 机器类型资源
   • 通用 C4A，适用于 C4A 机器类型资源
   • 通用 C4D，适用于 C4D 机器类型资源
   • 通用 E2，适用于 E2 机器类型资源
   • 通用 N1，适用于 N1 机器类型资源
   • 通用 N2，适用于 N2 机器类型资源
   • 通用 N2D，适用于 N2D 机器资源
   • 通用 N4，适用于 N4 机器类型资源
   • 通用 T2D，适用于 Tau T2D 机器类型资源
   • 图形优化的 G2，适用于 G2 机器类型资源
   • 内存优化的 M1/M2，适用于 M1 或 M2 机器类型资源
   • 内存优化的 M3，适用于 M3 机器类型资源
   • 内存优化 M3，适用于 M4 机器类型资源
   • 内存优化 M4 6 TB，适用于具有 6 TB 内存的 M4 机器类型
   • 内存优化 X4 16TB，适用于具有 16 TB 内存的 X4 机器类型
   • 内存优化 X4 24TB，适用于具有 24 TB 内存的 X4 机器类型
   • 内存优化 X4 32TB，适用于具有 32 TB 内存的 X4 机器类型
   • 存储优化 Z3，适用于 Z3 机器类型资源

6. 在时长部分中，执行以下操作：

   1. 如需指定承诺方案，请选择 1 年或 3 年。此设置决定了承诺的预设期限。

   2. 可选。如需为承诺指定自定义期限，请点击延长结束日期切换开关，然后在日期字段中指定所需的自定义结束日期。如需了解详情，请参阅延长承诺期限。

7. 在核心数字段中，输入您要承诺购买的 vCPU 的数量。

8. 在内存字段中，输入您要承诺购买的内存量（以 GB 为单位）。

   只能以 0.25 GB 为增量来指定内存量。如需为承诺指定自定义内存值，请改用 gcloud CLI 或 REST。

9. 如需完成购买承诺的过程，请执行以下操作：

   1. 点击购买。
   2. 在购买承诺使用折扣对话框中，如果您同意服务专用条款，请再次点击购买。

gcloud

使用 gcloud CLI 运行 gcloud compute commitments create 命令：

gcloud compute commitments create COMMITMENT_NAME \
    --region REGION \
    --project PROJECT_ID \
    --resources vcpu=NUMBER_VCPUS,memory=MEMORY \
    --plan DURATION \
    --type COMMITMENT_TYPE

替换以下内容：

• COMMITMENT_NAME：您想要用来标识此承诺的名称。
• REGION：此承诺所适用的区域。每个区域都有不同的承诺价格。如需了解当前价格，请参阅价格表。
• PROJECT_ID：要为其创建承诺的项目的 ID。
• NUMBER_VCPUS：您愿意为其购买承诺的 vCPU 数量。vCPU 数量必须是等于或大于 0 的整数，可以是偶数或奇数。
• MEMORY：您愿意为其购买承诺的内存大小（以 MB 或 GB 为单位）。例如 1000MB。如果您未指定单位，则系统会默认使用 GB 单位。
• DURATION：承诺的期限（12-month 或 36-month）。

• COMMITMENT_TYPE：以下各项中的一项：

  • accelerator-optimized（适用于 A2 机器类型资源）
  • accelerator-optimized-a3，适用于 A3 Edge 和 A3 High 机器类型资源
  • accelerator-optimized-a3-mega，适用于 A3 Mega 机器类型资源
  • compute-optimized（适用于 C2 机器类型资源）
  • compute-optimized-c2d（适用于 C2D 机器类型资源）
  • compute-optimized-c3（适用于 C3 机器类型资源）
  • compute-optimized-c3d（适用于 C3D 机器类型资源）
  • compute-optimized-h3（适用于 H3 机器类型资源）
  • general-purpose（适用于 N1 机器类型资源）
  • general-purpose-c4（适用于 C4 机器类型资源）
  • general-purpose-c4a，适用于 C4A 机器类型资源
  • general-purpose-c4d，适用于 C4D 机器类型资源
  • general-purpose-e2（适用于 E2 机器类型资源）
  • general-purpose-n2（适用于 N2 机器类型资源）
  • general-purpose-n2d（适用于 N2D 机器资源）
  • general-purpose-n4（适用于 N4 机器类型资源）
  • general-purpose-t2d（适用于 Tau T2D 机器类型资源）
  • 适用于 G2 机器类型资源的 graphics-optimized
  • memory-optimized（适用于M1 或 M2 机器类型资源）
  • memory-optimized-m3（适用于 M3 机器类型资源）
  • memory-optimized-m4，适用于 M4 机器类型资源
  • memory-optimized-m4-6tb，适用于具有 6 TB 内存的实例的 M4 机器类型资源
  • memory-optimized-x4-16tb，适用于具有 16 TB 内存的实例的 X4 机器类型资源
  • memory-optimized-x4-24tb，适用于具有 24 TB 内存的实例的 X4 机器类型资源
  • memory-optimized-x4-32tb，适用于具有 32 TB 内存的实例的 X4 机器类型资源
  • storage-optimized-z3（适用于 Z3 机器类型资源）

  如果您未指定 --type 标志，则系统会使用默认值 general-purpose。

示例

• 如需为 N1 机器类型创建通用承诺使用合约，您可以按照以下示例编写并执行相应命令：

  gcloud compute commitments create example-commitment --region us-central1 \
    --resources vcpu=5,memory=33280MB --plan 12-month \
    --project=myproject
  

• 如需创建计算优化承诺，请使用 gcloud compute commitments create 命令。以下示例为计算优化机器类型购买 1 年期承诺：

  gcloud compute commitments create example-compute-optimized-commitment \
    --region us-central1 --resources vcpu=2,memory=3814GB --plan 12-month \
    --type compute-optimized --project=myproject
  

• 如需创建内存优化承诺，请使用以下命令示例：

  gcloud compute commitments create example-memory-optimized-commitment \
    --region us-central1 --resources vcpu=96,memory=1434MB \
    --plan 12-month --type memory-optimized \
    --project=myproject
  

• 如需创建加速器优化承诺，您必须使用 gcloud compute commitments create 命令购买包含支持附加预留的承诺。您还必须指定所需的资源（包括 GPU）总数。

  创建 GPU 承诺时，您需要指定 --accelerator 和 --resources-accelerator 标志。--accelerator 标志指定挂接到每个虚拟机的 GPU 数量。--resources-accelerator 标志指定承诺中的 GPU 总数。

  例如，以下承诺包括 96 个 vCPU、680 GB 内存、8 个 GPU 和 1 个相关的预留，以便在 us-central1-a 的 2 个虚拟机上使用这些 GPU。

  gcloud compute commitments create example-accelerator-optimized-commitment \
    --region=us-central1 \
    --project=myproject \
    --resources=vcpu=96,memory=680GB \
    --resources-accelerator=count=8,type=nvidia-tesla-a100 \
    --plan 12-month \
    --type accelerator-optimized \
  
    --reservation=reservation-01 \
    --reservation-zone=us-central1-a \
    --machine-type=a2-highgpu-4g \
    --accelerator=count=4,type=nvidia-tesla-a100 \
    --vm-count=2
  
  

• 如需为 GPU 和/或本地 SSD 磁盘创建承诺，您必须使用 gcloud compute commitments create 命令购买包含附加预留的承诺。

  创建 GPU 承诺时，您需要指定 --accelerator 和 --resources-accelerator 标志。--accelerator 标志指定挂接到每个虚拟机的 GPU 数量。--resources-accelerator 标志指定承诺中的 GPU 总数。

  例如，以下承诺包括 4 个 GPU 和 1 个相关的预留，以便在 us-central1-a 的 2 个实例中使用这些 GPU。

  gcloud compute commitments create example-reservation-commitment \
    --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
    
  

REST

在 API 中，向 regionCommitments.insert 方法发出一个 POST 请求，其请求正文中包含有关承诺的信息：

https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments?requestId=OPTIONAL_UNIQUE_ID

资源标头应包含以下内容：

• name：表示承诺的名称
• plan：表示承诺的期限，只能选择 TWELVE_MONTH 或 THIRTY_SIX_MONTH
• resources：用于指定内存大小和 vCPU 数量。内存必须以 MB 为单位指定。您必须在 resources 部分中同时指定 VCPU 和 MEMORY。

• 承诺的 type，可以是以下项目之一：

  • ACCELERATOR_OPTIMIZED（适用于 A2 机器类型资源）
  • ACCELERATOR_OPTIMIZED_A3，适用于 A3 Edge 和 A3 High 机器类型资源
  • ACCELERATOR_OPTIMIZED_A3_MEGA，适用于 A3 Mega 机器类型资源
  • COMPUTE_OPTIMIZED（适用于 C2 机器类型资源）
  • COMPUTE_OPTIMIZED_C2D（适用于 C2D 机器类型资源）
  • COMPUTE_OPTIMIZED_C3（适用于 C3 机器类型资源）
  • COMPUTE_OPTIMIZED_C3D（适用于 C3D 机器类型资源）
  • COMPUTE_OPTIMIZED_H3（适用于 H3 机器类型资源）
  • GENERAL_PURPOSE（适用于 N1 机器类型资源）
  • GENERAL_PURPOSE_C4（适用于 C4 机器类型资源）
  • GENERAL_PURPOSE_C4A，适用于 C4A 机器类型资源
  • GENERAL_PURPOSE_C4D，适用于 C4D 机器类型资源
  • GENERAL_PURPOSE_E2（适用于 E2 机器类型资源）
  • GENERAL_PURPOSE_N2（适用于 N2 机器类型资源）
  • GENERAL_PURPOSE_N2D（适用于 N2D 机器资源）
  • GENERAL_PURPOSE_N4（适用于 N4 机器类型资源）
  • GENERAL_PURPOSE_T2D（适用于 Tau T2D 机器类型资源）
  • 适用于 G2 机器类型资源的 GRAPHICS_OPTIMIZED
  • MEMORY_OPTIMIZED（适用于M1 或 M2 机器类型资源）
  • MEMORY_OPTIMIZED_M3（适用于 M3 机器类型资源）
  • MEMORY_OPTIMIZED_M4，适用于 M4 机器类型资源
  • MEMORY_OPTIMIZED_M4_6TB，适用于具有 6 TB 内存的实例的 M4 机器类型资源
  • MEMORY_OPTIMIZED_X4_16TB，适用于具有 16 TB 内存的实例的 X4 机器类型资源）
  • MEMORY_OPTIMIZED_X4_24TB，适用于具有 24 TB 内存的实例的 X4 机器类型资源
  • MEMORY_OPTIMIZED_X4_32TB，适用于具有 32 TB 内存的实例的 X4 机器类型资源
  • STORAGE_OPTIMIZED_Z3（适用于 Z3 机器类型资源）

例如，以下示例将创建一个为期 1 年的承诺使用合约，包含 5 个 vCPU 和 18.75 GB 内存：

{
    "name": "example-commitment",
    "plan": "TWELVE_MONTH",
    "type": "GENERAL_PURPOSE",
    "resources": [
        {
            "amount": "5",
            "type": "VCPU"
        },
        {
            "amount": "19200",
            "type": "MEMORY"
        }
    ]
}

如需创建内存优化承诺，请添加 type 属性。以下示例演示了如何为 m1-megamem-96 机器类型购买 1 年期的承诺：

{
    "name": "example-memory-optimized-commitment",
    "plan": "TWELVE_MONTH",
    "type": "MEMORY_OPTIMIZED",
    "resources": [
        {
            "amount": "96",
            "type": "VCPU"
        },
        {
            "amount": "1434",
            "type": "MEMORY"
        }
      ]
}```

To create a compute-optimized commitment, include the `type` property. The
following example, purchases a 1 year commitment for a `c2-standard-16`
machine type:

```json
{
    "name": "example-compute-optimized-commitment",
    "plan": "TWELVE_MONTH",
    "type": "COMPUTE_OPTIMIZED",
    "resources": [
        {
            "amount": "16",
            "type": "VCPU"
        },
        {
            "amount": "1434",
            "type": "MEMORY"
        }
    ]
}

控制台

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

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

   转到“承诺使用折扣”

2. 如需购买承诺，请点击 add_box 购买承诺。系统会打开购买承诺使用折扣页面，并显示硬件标签页。

3. 在名称字段中，输入承诺的名称。

4. 在区域字段中，选择您要在其中承诺使用 Compute Engine 资源的区域。

5. 在承诺类型字段中，选择承诺的资源的机器家族系列。以下承诺类型提供适用于 GPU 和/或本地 SSD 磁盘的选项：

   • 加速器优化的 A2，适用于 A2 机器类型资源
   • 加速器优化 A3，适用于 A3 Edge 和 A3 High 机器类型资源
   • 加速器优化 A3 Mega，适用于 A3 Mega 机器类型资源
   • 计算优化的 C2，适用于 C2 机器类型资源
   • 计算优化的 C2D，适用于 C2D 机器类型资源
   • 通用 C3，适用于 C3 机器类型资源
   • 通用 C3D，适用于 C3D 机器类型资源
   • 通用 N1，适用于 N1 机器类型资源
   • 通用 N2，适用于 N2 机器类型资源
   • 通用 N2D，适用于 N2D 机器类型资源
   • 图形优化的 G2，适用于 G2 机器类型资源
   • 内存优化的 M3，适用于 M3 机器类型资源
   • 存储优化 Z3，适用于 Z3 机器类型资源

6. 在时长部分，执行以下操作：

   1. 如需指定承诺方案，请选择 1 年或 3 年。此设置决定了承诺的预设期限。

   2. 可选。如需为承诺指定自定义期限，请点击延长结束日期切换开关，然后在日期字段中指定自定义结束日期。如需了解详情，请参阅延长承诺期限。

7. 在核心数字段中，输入您要承诺购买的 vCPU 的数量。

8. 在内存字段中，输入您要承诺购买的内存量（以 GB 为单位）。

   只能以 0.25 GB 为增量来指定内存量。如需为承诺指定自定义内存值，请改用 gcloud CLI 或 REST。

9. 如需承诺使用 GPU，请在 GPU 部分中点击 add 添加 GPU，然后执行以下操作：

   1. 在 GPU 类型字段中，选择 GPU 类型。
   2. 在 GPU 数量字段中，输入 GPU 数量。
   3. 可选：如果您的 GPU 模型支持适用于图形工作负载的 NVIDIA RTX 虚拟工作站 (vWS)，并且您计划运行图形密集型工作负载，请选中启用虚拟工作站 (NVIDIA GRID) 复选框。

10. 如需承诺使用本地 SSD 磁盘，请在本地 SSD 部分中点击 add 添加 SSD，然后在 SSD 数量字段中指定磁盘数量。

11. 如需将一个或多个现有预留附加到承诺，请在预留字段中选择附加现有预留。

    Google Cloud 控制台会显示项目中其区域、机器类型和 GPU 类型与承诺一致的所有预留的列表。之后，执行以下操作：

    1. 可选。如需查看具有特定属性的预留，请在过滤条件菜单中，为所需的属性添加或移除过滤条件。
    2. 选择您要附加到承诺的所有预留。

12. 如需完成购买承诺及附加预留的过程，请执行以下操作：

    1. 点击购买。
    2. 在购买承诺使用折扣对话框中，如果您同意服务专用条款，请再次点击购买。

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 \
    --custom-end-time=CUSTOM_END_DATE \
    --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。
• CUSTOM_END_DATE：可选。期限的自定义结束日期，其格式必须为 YYYY-MM-DD。例如，如需指定自定义结束日期为 2024 年 4 月 20 日，请将其格式设置为 2024-04-20。

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

  • accelerator-optimized（适用于 A2 机器类型资源）
  • accelerator-optimized-a3，适用于 A3 Edge 和 A3 High 机器类型资源
  • accelerator-optimized-a3-mega，适用于 A3 Mega 机器类型资源
  • compute-optimized（适用于 C2 机器类型资源）
  • compute-optimized-c2d（适用于 C2D 机器类型资源）
  • compute-optimized-c3（适用于 C3 机器类型资源）
  • compute-optimized-c3d（适用于 C3D 机器类型资源）
  • general-purpose（适用于 N1 机器类型资源）
  • general-purpose-n2（适用于 N2 机器类型资源）
  • general-purpose-n2d（适用于 N2D 机器资源）
  • 适用于 G2 机器类型资源的 graphics-optimized
  • memory-optimized-m3（适用于 M3 机器类型资源）
  • storage-optimized-z3，适用于 Z3 机器类型资源

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

• COMMITTED_MEMORY：您的承诺中包含的内存量，以 MB 或 GB 为单位。例如 10240MB 或 10GB。如果您未指定单位，Compute Engine 将使用 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,local-ssd=1500 \
    --resources-accelerator=type=nvidia-tesla-p100,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"
    }
  ],
  "customEndTimestamp": "CUSTOM_END_DATETEND_TIMEZ",
  "existingReservations": "RESERVATION_URLs"
}

替换以下内容：

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

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

  • ACCELERATOR_OPTIMIZED（适用于 A2 机器类型资源）
  • ACCELERATOR_OPTIMIZED_A3，适用于 A3 Edge 和 A3 High 机器类型资源
  • ACCELERATOR_OPTIMIZED_A3_MEGA，适用于 A3 Mega 机器类型资源
  • COMPUTE_OPTIMIZED（适用于 C2 机器类型资源）
  • COMPUTE_OPTIMIZED_C2D（适用于 C2D 机器类型资源）
  • COMPUTE_OPTIMIZED_C3（适用于 C3 机器类型资源）
  • COMPUTE_OPTIMIZED_C3D（适用于 C3D 机器类型资源）
  • GENERAL_PURPOSE（适用于 N1 机器类型资源）
  • GENERAL_PURPOSE_N2（适用于 N2 机器类型资源）
  • GENERAL_PURPOSE_N2D（适用于 N2D 机器资源）
  • 适用于 G2 机器类型资源的 GRAPHICS_OPTIMIZED
  • MEMORY_OPTIMIZED_M3（适用于 M3 机器类型资源）
  • STORAGE_OPTIMIZED_Z3，适用于 Z3 机器类型资源

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

• COMMITTED_MEMORY：您的承诺中包含的内存量，以 MB 为单位。例如 10240MB。

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

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

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

• CUSTOM_END_DATE：可选。期限的自定义结束日期，其格式必须为 YYYY-MM-DD。例如，如需指定自定义结束日期为 2024 年 4 月 20 日，请将其格式设置为 2024-04-20。

• END_TIME：美国和加拿大太平洋时间（UTC-8 或 UTC-7）的零点，采用世界协调时间 (UTC) 的偏移量格式。仅当您为承诺指定了自定义结束日期时，才需要指定此值。请指定以下某个值：

  • 夏令时期间：07:00:00
  • 其他时间段：08:00:00

• 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-p100",
      "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 账号启用了 CUD 共享，则您可以使用该 Cloud Billing 账号中的任何项目购买承诺。选择项目后，请执行以下操作：

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

   转到“承诺使用折扣”

2. 如需购买承诺，请点击 add_box 购买承诺。系统会打开购买承诺使用折扣页面，并显示硬件标签页。

3. 在名称字段中，输入承诺的名称。

4. 在区域字段中，选择您要在其中承诺使用 Compute Engine 资源的区域。

5. 在承诺类型字段中，选择承诺的资源的机器家族系列。以下承诺类型提供适用于 GPU 和/或本地 SSD 磁盘的选项：

   • 加速器优化的 A2，适用于 A2 机器类型资源
   • 加速器优化 A3，适用于 A3 Edge 和 A3 High 机器类型资源
   • 加速器优化 A3 Mega，适用于 A3 Mega 机器类型资源
   • 计算优化的 C2，适用于 C2 机器类型资源
   • 计算优化的 C2D，适用于 C2D 机器类型资源
   • 通用 C3，适用于 C3 机器类型资源
   • 通用 C3D，适用于 C3D 机器类型资源
   • 通用 N1，适用于 N1 机器类型资源
   • 通用 N2，适用于 N2 机器类型资源
   • 通用 N2D，适用于 N2D 机器类型资源
   • 图形优化的 G2，适用于 G2 机器类型资源
   • 内存优化的 M3，适用于 M3 机器类型资源
   • 存储优化 Z3，适用于 Z3 机器类型资源

6. 在时长部分，选择 1 年或 3 年作为承诺的期限。

7. 在核心数字段中，输入您要承诺使用的 vCPU 的数量。

8. 在内存字段中，输入您要承诺使用的内存量（以 GB 为单位）。

9. 如需承诺使用 GPU，请在 GPU 部分中点击 add 添加 GPU，然后执行以下操作：

   1. 在 GPU 类型字段中，选择 GPU 类型。
   2. 在 GPU 数量字段中，输入 GPU 数量。
   3. 可选：如果您的 GPU 模型支持适用于图形工作负载的 NVIDIA RTX 虚拟工作站 (vWS)，并且您计划运行图形密集型工作负载，请选中启用虚拟工作站 (NVIDIA GRID) 复选框。

10. 如需承诺使用本地 SSD 磁盘，请在本地 SSD 部分中点击 add 添加 SSD，然后在 SSD 数量字段中指定磁盘数量。

11. 如需创建新的预留并将其附加到承诺，请在预留字段中选择创建预留，然后执行以下操作。针对您要创建和附加的每个新预留重复此步骤。

    1. 点击添加预留。系统会显示新预留部分。
    2. 在名称字段中，输入附加预留的名称。
    3. 在区域字段中，选择与您的承诺相同的区域。
    4. 在可用区字段中，选择您要在其中预留资源的可用区。

    5. 在共享类型部分中，通过以下方式之一指定您希望如何共享此预留：

       • 如需创建单项目预留，请选择本地。
       • 如需创建与多个项目共享的预留，请选择共享。然后，如需指定要与之共享此预留的项目，请点击 add 添加项目，然后从当前项目的组织中选择所需的项目。

    6. 在搭配虚拟机实例使用字段中，通过以下方式之一选择您希望虚拟机如何使用预留：

       • 如需允许具有匹配属性的虚拟机自动使用此预留，请点击自动使用预留（默认）。
       • 如需只有在创建具有匹配属性且通过名称明确指向此预留的虚拟机时使用此预留的资源，请点击选择特定预留。

    7. 在资源详情部分中，执行以下操作：

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

       2. 在机器配置部分中，通过以下方式之一指定预留虚拟机的属性：

          1. 如需使用现有实例模板指定虚拟机的属性，请选择使用实例模板。

             在实例模板字段中，选择一个实例模板，以指定与您的承诺相同的机器家族系列。如果您选择区域级实例模板，则该实例模板的区域也必须与您的承诺中指定的区域一致。

          2. 如需手动指定虚拟机的属性，请选择选择机器类型，然后执行以下操作：

             1. 选择适用于您为承诺指定的机器系列的机器家族：

                • 通用，适用于通用机器系列
                • 计算优化，适用于计算优化机器系列
                • 内存优化，适用于内存优化机器系列
                • GPU，适用于加速器优化机器系列

             2. 在包含系列列的表中，选择您为承诺指定的同一机器系列。

             3. 在机器类型字段中，通过以下方式之一指定预定义或自定义机器类型：

                1. 如需选择预定义机器类型，请选择预设，然后选择所需的机器类型。
                2. 如需选择自定义机器类型，请选择自定义，然后指定所需的核心数和内存。

             4. 如需指定满足最低要求的 CPU 平台和/或 GPU，请展开 expand_more CPU 平台和 GPU 菜单，然后执行以下操作：

                1. 可选：如需指定满足最低要求的 CPU 平台，请在 CPU 平台列表中选择一个选项。

                2. 可选：如需预留 GPU，请点击 add 添加 GPU。然后，在 GPU 类型和 GPU 数量字段中，选择每个虚拟机的 GPU 类型和数量。

             5. 如需预留本地 SSD 磁盘，请执行以下操作：

                1. 在磁盘数量字段中，选择每个虚拟机所需的本地 SSD 磁盘的数量。
                2. 在接口类型字段中，选择本地 SSD 磁盘的接口。

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

12. 如需完成购买承诺及附加预留的过程，请执行以下操作：

    1. 点击购买。
    2. 在购买承诺使用折扣对话框中，如果您同意服务专用条款，请再次点击购买。

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 \
      --custom-end-time=CUSTOM_END_DATE \
      --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 V100 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"
    }
  ],
  "customEndTimestamp": "CUSTOM_END_DATETEND_TIMEZ",
  "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"
    }
  ],
  "customEndTimestamp": "CUSTOM_END_DATETEND_TIMEZ",
  "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 V100 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"
    }
  ]
}

控制台

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

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

   转到“承诺使用折扣”页面

2. 点击购买承诺以购买新的承诺使用合约。
3. 点击新许可承诺使用折扣，以购买新的许可承诺。
4. 为您的承诺命名，并选择您希望应用该承诺的区域。
5. 选择承诺的持续时间（1 年或 3 年）。
6. 选择许可系列。
7. 选择许可类型和数量。
8. 选择许可数量。
9. 点击购买。

gcloud

使用 gcloud CLI 运行 gcloud compute commitments create-license 命令可购买许可承诺。

gcloud compute commitments create-license COMMITMENT_NAME \
    --license `LICENSE_URI`
    --amount NUMBER_OF_LICENSES \
    --cores-per-license CORES_PER_LICENSE \
    --plan PLAN \
    --region REGION \

替换以下内容：

• COMMITMENT_NAME：您的承诺的名称。
• LICENSE_URI：许可 URI。例如 https://www.googleapis.com/compute/v1/projects/myproject/global/licenses/sles-sap-12
• NUMBER_OF_LICENSES：您计划购买的许可数量。
• CORES_PER_LICENSE：每个许可的核心数量。输入 1-2 3-4 或 5+。
• PLAN：输入方案长度：12-month 或 36-month。
• REGION：此承诺适用的地区。

例如，以下承诺适用于 us-central1 区域期限长达 36 个月的 4 个 SAP 许可，每个许可有 3-4 个核心：

gcloud compute commitments create-license commitment-1
    --license https://www.googleapis.com/compute/v1/projects/myproject/global/licenses/sles-12
    --amount=4
    --cores-per-license=3-4
    --plan=36-month
    --region=us-central1

例如，以下承诺适用于 us-central1 区域期限长达 12 个月的 2 个 SLES for SAP 许可，每个许可有 1-2 个核心：

gcloud compute commitments create-license commitment-2
    --license https://www.googleapis.com/compute/v1/projects/myproject/global/licenses/sles-sap-12
    --amount=2
    --cores-per-license=1-2
    --plan=12-month
    --region=us-central1

REST

使用 regionCommitments.insert 方法并添加 licenseResource 字段来定义许可承诺的属性。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments?requestId=OPTIONAL_UNIQUE_ID

{
    "name": COMMITMENT_NAME,
    "plan": PLAN,
    "category": "LICENSE",
    "licenseResource": {
      "coresPerLicense": CORES_PER_LICENSE,
      "amount": NUMBER_OF_LICENSES,
      "license": `LICENSE_URI`
      }
}

替换以下内容：

• COMMITMENT_NAME：您的承诺的名称。
• LICENSE_URI：许可 URI。例如 https://www.googleapis.com/compute/v1/projects/myproject/global/licenses/sles-sap-12
• NUMBER_OF_LICENSES：您计划购买的许可数量。
• CORES_PER_LICENSE：每个许可的核心数量。输入 1-2 3-4 或 5+。
• PLAN：输入方案长度：12-month 或 36-month。
• REGION：此承诺适用的地区。

例如，以下承诺适用于 us-central1 区域期限长达 36 个月的 4 个 SLES for SAP 许可，每个许可有 3-4 个核心。

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

{
    "name": "commitment-3",
    "plan": "THIRTY_SIX_MONTH",
    "category": "LICENSE",
    "licenseResource": {
      "coresPerLicense": "3-4",
      "amount": "4",
      "license": "https://www.googleapis.com/compute/v1/projects/suse-sap-cloud/global/licenses/sles-sap-12"
      }
}

控制台

在 Google Cloud 控制台中，前往承诺使用折扣页面查看承诺列表。

转到“承诺使用折扣”

gcloud

使用 commitments list 命令发出请求：

gcloud compute commitments list

该工具将返回一个承诺列表：

 NAME              REGION    END_TIMESTAMP                  STATUS
 my-commitment     us-east1  2018-03-17T00:00:00.000-07:00  NOT_YET_ACTIVE

REST

您可以通过向以下网址发出 aggregatedList 请求来获取所有区域中的承诺列表：

https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/commitments

该请求将返回一个承诺列表：

"commitments": [
{
  "kind": "compute#commitment",
  "id": "3294122326373778983",
  "creationTimestamp": "2017-02-09T15:18:32.411-08:00",
  "name": "example-commitment",
  "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/commitments/example-commitment",
  "status": "NOT_YET_ACTIVE",
  "statusMessage": "The commitment is not yet active (its startTimestamp is in the future). It will not apply to current resource usage.",
  "plan": "TWELVE_MONTH",
  "startTimestamp": "2017-02-10T00:00:00.000-08:00",
  "endTimestamp": "2018-02-10T00:00:00.000-08:00",
  "resources": [
    {
      "type": "VCPU",
      "amount": "5"
    },
    {
      "type": "MEMORY",
      "amount": "32500"
    }]
  }
]