依資源計算的承諾使用折扣

主控台

使用 Google Cloud 控制台購買約定用量前，請選取要用來購買約定用量的專案。如果 Cloud Billing 帳戶已啟用CUD 共用，您可以使用該 Cloud Billing 帳戶中的任何專案購買使用承諾。選取專案後，請按照下列步驟操作：

1. 前往 Google Cloud 控制台的「承諾使用折扣」頁面。

   前往「承諾使用折扣」

2. 如要購買承諾方案，請按一下 add_box 「購買承諾方案」。系統會開啟「購買承諾使用折扣」頁面，並顯示「硬體」分頁。

3. 在「Name」(名稱) 欄位中，輸入約定的名稱。

4. 在「Region」(區域) 欄位中，選取要承諾使用 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
   • 適用於 M4 機器類型資源的記憶體最佳化 M4
   • 記憶體最佳化 M4 6 TB：適用於搭載 6 TB 記憶體的 M4 機器類型
   • 記憶體最佳化 X4 16 TB：適用於搭載 16 TB 記憶體的 X4 機器類型
   • 記憶體最佳化 X4 24TB：適用於搭載 24 TB 記憶體的 X4 機器類型
   • 記憶體最佳化 X4 32 TB：適用於搭載 32 TB 記憶體的 X4 機器類型
   • 適用於 Z3 機型資源的儲存空間最佳化 Z3

6. 在「時間長度」部分執行下列操作：

   1. 如要指定承諾方案，請選取「1 年」或「3 年」。這項設定會決定承諾的預設期限長度。

   2. (選用步驟) 如要指定自訂約期，請按一下「延長結束日期」切換鈕，然後在「日期」欄位中指定所需的自訂結束日期。詳情請參閱「延長承諾使用合約的期限」。

7. 在「核心」欄位中，輸入要承諾的 vCPU 數量。

8. 在「記憶體」欄位中，輸入您要承諾的記憶體量 (以 GB 為單位)。

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。記憶體可以 0.25 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 機型資源
  • graphics-optimized 適用於 G2 機器類型資源
  • memory-optimized 適用於 M1 或 M2 機型資源
  • memory-optimized-m3 適用於 M3 機型資源
  • memory-optimized-m4 M4 機型資源
  • memory-optimized-m4-6tb，適用於搭載 6 TB 記憶體的執行個體
  • memory-optimized-x4-16tb 適用於 X4 機器類型 適用於記憶體容量為 16 TB 的執行個體
  • memory-optimized-x4-24tb 適用於 X4 機器類型， 適用於記憶體容量為 24 TB 的執行個體
  • memory-optimized-x4-32tb 適用於 X4 機器類型， 適用於記憶體容量達 32 TB 的執行個體
  • 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 標記用於指定連結至每個 VM 的 GPU 數量。--resources-accelerator 標記用於指定承諾合約中的 GPU 總數。

  舉例來說，以下承諾產品包含 96 個 vCPU、680 GB 記憶體、8 個 GPU，以及可在 us-central1-a 的 2 個 VM 中使用這些 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 標記用於指定連結至每個 VM 的 GPU 數量。--resources-accelerator 標記用於指定承諾合約中的 GPU 總數。

  舉例來說，以下承諾產品包含 4 個 GPU，以及可在 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 機型資源
  • GRAPHICS_OPTIMIZED 適用於 G2 機器類型資源
  • 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. 在「Name」(名稱) 欄位中，輸入約定的名稱。

4. 在「Region」(區域) 欄位中，選取要承諾使用 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. 在「Duration」(時間長度) 部分執行下列步驟：

   1. 如要指定承諾方案，請選取「1 年」或「3 年」。這項設定會決定承諾的預設期限長度。

   2. (選用步驟) 如要為約期指定自訂期限，請按一下「延長結束日期」切換鈕，然後在「日期」欄位中指定自訂結束日期。詳情請參閱「延長承諾使用合約的期限」。

7. 在「核心」欄位中，輸入要承諾的 vCPU 數量。

8. 在「記憶體」欄位中，輸入您要承諾的記憶體量 (以 GB 為單位)。

9. 如要承諾使用 GPU，請在「GPUs」(GPU) 專區中，按一下 add「Add GPU」(新增 GPU)，然後執行下列操作：

   1. 在「GPU type」(GPU 類型) 欄位中，選取 GPU 類型。
   2. 在「Number of GPUs」(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 機器資源)
  • graphics-optimized 適用於 G2 機器類型資源
  • memory-optimized-m3 適用於 M3 機型資源
  • storage-optimized-z3：適用於 Z3 機器類型資源

• 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 磁碟。如要為這些 GPU 和本機 SSD 磁碟，在這個專案的 us-central1 區域中購買新的承諾，並將這些現有保留項目做為附加保留項目，請執行下列指令。請注意，範例承諾也包含 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 機器資源)
  • GRAPHICS_OPTIMIZED 適用於 G2 機器類型資源
  • MEMORY_OPTIMIZED_M3 適用於 M3 機型資源
  • STORAGE_OPTIMIZED_Z3：適用於 Z3 機器類型資源

• 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 類型。

• CUSTOM_END_DATE：選用。自訂約期結束日期，格式必須為 YYYY-MM-DD。舉例來說，如要將自訂結束日期設為 2024 年 4 月 20 日，請將日期格式設為 2024-04-20。

• END_TIME：美國和加拿大太平洋時間凌晨 12 點 (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 磁碟。如要為這些 GPU 和本機 SSD 磁碟，在這個專案的 us-central1 區域購買新的承諾，並將這些現有保留項目做為附加保留項目，請提出下列 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. 在「Name」(名稱) 欄位中，輸入約定的名稱。

4. 在「Region」(區域) 欄位中，選取要承諾使用 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，請在「GPUs」(GPU) 專區中，按一下 add「Add GPU」(新增 GPU)，然後執行下列操作：

   1. 在「GPU type」(GPU 類型) 欄位中，選取 GPU 類型。
   2. 在「Number of GPUs」(GPU 數量) 欄位中，輸入 GPU 數量。
   3. 選用：如果您的 GPU 型號支援適用於圖形工作負載的 NVIDIA RTX 虛擬工作站 (vWS)，且您打算執行需要大量圖形的工作負載，請選取「啟用虛擬工作站 (NVIDIA GRID)」核取方塊。

10. 如要承諾使用本機 SSD 磁碟，請在「本機 SSD」部分中，按一下 add「新增 SSD」，然後在「SSD 數量」欄位中指定磁碟數量。

11. 如要建立新的預留項目並附加至承諾，請在「預留項目」欄位中選取「建立預留項目」，然後執行下列步驟。針對要建立及連結的每個新預訂項目，重複執行這個步驟。

    1. 按一下「新增預留項目」。系統會顯示「New reservation」(新增預留項目) 區段。
    2. 在「Name」(名稱) 欄位中，輸入附加預留項目的名稱。
    3. 在「Region」(區域) 欄位中，選取與約期相同的區域。
    4. 在「Zone」(可用區) 欄位中，選取要預留資源的可用區。

    5. 在「Share type」(共用類型) 部分，指定要如何共用這項預訂，方法如下：

       • 如要建立單一專案預留項目，請選取「本機」。
       • 如要建立與多個專案共用的預留項目，請選取「共用」。接著，如要指定要共用此預訂項目的專案，請按一下「新增專案」add，然後從目前專案的機構中選取所需專案。

    6. 在「Use with VM instance」(搭配 VM 執行個體使用) 欄位中，選取 VM 使用保留項目的方式：

       • 如要允許屬性相符的 VM 自動使用這個預留項目，請按一下「自動使用預留項目」(預設)。
       • 如要只有在建立屬性相符的 VM 時，才使用這個保留項目的資源，且 VM 會明確指定這個保留項目的名稱，請按一下「選取特定保留項目」。

    7. 在「資源詳細資料」部分，執行下列操作：

       1. 在「Number of VM instances」(VM 執行個體數量) 欄位中，輸入要預留的 VM 執行個體數量。

       2. 在「機器設定」部分中，透過下列其中一種方式指定預留 VM 的屬性：

          1. 如要使用現有的執行個體範本指定 VM 的屬性，請選取「使用執行個體範本」。

             在「執行個體範本」欄位中，選取指定的機器系列與承諾相同的執行個體範本。如果您選取區域執行個體範本，該範本的區域也必須與承諾中指定的區域相符。

          2. 如要手動指定 VM 的屬性，請選取「選取機型」，然後執行下列操作：

             1. 選取適用於您為約定指定機器系列的機器家族：

                • 一般用途：適用於一般用途機器系列
                • 運算最佳化：適用於運算最佳化機器系列
                • 記憶體最佳化：適用於記憶體最佳化機器系列
                • 加速器最佳化機型系列的 GPU

             2. 在含有「系列」欄的表格中，選取您為承諾指定的相同機器系列。

             3. 在「Machine type」(機器類型) 欄位中，透過下列其中一種方式指定預先定義或自訂的機器類型：

                1. 如要選擇預先定義的機器類型，請選取「預設」，然後選取所需的機器類型。
                2. 如要選擇自訂機器類型，請選取「自訂」，然後指定所需的核心和記憶體。

             4. 如要指定最低 CPU 平台、GPU 或兩者，請展開「CPU Platform and GPU」(CPU 平台和 GPU)expand_more 選單，然後執行下列操作：

                1. 選用：如要指定最低 CPU 平台，請在「CPU Plaform」(CPU 平台) 清單中選取選項。

                2. 選用：如要預留 GPU，請按一下「新增 GPU」add。 然後在「GPU type」(GPU 類型) 和「Number of GPUs」(GPU 數量) 欄位中，選取每個 VM 的 GPU 類型和數量。

             5. 如要預留本機 SSD 磁碟，請按照下列步驟操作：

                1. 在「磁碟數量」欄位中，選取每個 VM 要使用的本機 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 的承諾方案

假設您想在 commitment-01 us-central1 區域購買承諾，其中包含 4 個 NVIDIA V100 GPU。您想建立新的預留項目 reservation-01，做為這些 GPU 的附加預留項目。假設您也想指定 Compute Engine 在 us-central1-a 區域的 2 個 n1-standard-32 VM 中使用這些保留的 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 磁碟，而不承諾使用 vCPU 或記憶體，請將 vCPU 和記憶體數量指定為 0。舉例來說，假設您想在 us-west2 區域購買單一 NVIDIA P4 GPU 的承諾方案 commitment-02。您也想建立新的保留項目做為附加的保留項目，並指定 Compute Engine 在 us-west2-b 區域的 n1-standard-2 VM 上使用保留的 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 VM，其中包含 1 個 GPU。您想將 res-01 設為指定保留項目，也就是必須明確指定該保留項目的名稱，才能使用其中的預留 VM。在第二個預訂項目 res-02 中，您想預訂 1 個 n1-standard-8 VM，並附加 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 欄位，定義要建立及附加的所有新預訂清單。您可以將任意數量的現有預留項目附加至年約。

• 如要手動指定所有 VM 屬性來建立新預訂，請加入 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 的承諾方案

假設您想在 commitment-01 us-central1 區域購買承諾，其中包含 4 個 NVIDIA V100 GPU。您想建立新的預留項目 reservation-01，做為這些 GPU 的附加預留項目。假設您也想指定 Compute Engine，在 us-central1-a 區域的 2 個 n1-standard-8 VM 中使用這些保留的 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 磁碟，而不承諾使用 vCPU 或記憶體，請將 vCPU 和記憶體數量指定為 0。舉例來說，假設您想在 us-west2 地區購買單一 NVIDIA P4 GPU 的承諾 commitment-02。您也想建立新的保留項目做為附加的保留項目，並指定 Compute Engine 在 us-west2-b 區域的 n1-standard-2 VM 上使用保留的 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 VM，其中包含 1 個 GPU。您想將 res-01 設為指定保留項目，也就是必須明確指定該保留項目的名稱，才能使用其中的預留 VM。在第二個預訂項目 res-02 中，您想預訂 1 個 n1-standard-8 VM，並附加 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 控制台的「Committed Use Discounts」(承諾使用折扣) 頁面。

   前往「Committed Use Discounts」(承諾使用折扣) 頁面

2. 按一下 [Purchase commitment] (購買承諾產品) 以購買新的承諾產品。
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 地區，為 4 個 SAP 授權 (每個授權 3 到 4 個核心) 簽訂 36 個月：

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 個月，每項授權有 1 到 2 個核心的 2 項 SLES for SAP 授權：

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 地區，為 4 個 SLES for SAP 授權 (每個授權 3 到 4 個核心) 簽訂 36 個月。

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"
    }]
  }
]