結合保留項目與承諾使用折扣

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

主控台

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

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

   前往「承諾使用折扣」

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

3. 在「Name」 欄位中，輸入承諾名稱。

4. 在「Region」(區域) 欄位中，選取要提交至 Compute Engine 資源的區域。

5. 在「Commitment type」欄位中，選取已承諾資源的機器系列。下列承諾類型提供 GPU、本機 SSD 磁碟或兩者的選項：

   • 適用於 A2 機器類型資源的加速器最佳化 A2
   • 適用於 A3 Edge 和 A3 High 機型資源的加速器最佳化 A3
   • 加速器最佳化 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. 在「Cores」欄位中，輸入要提交的 vCPU 數量。

8. 在「Memory」欄位中，輸入要提交的記憶體大小 (以 GB 為單位)。

9. 如要承諾使用 GPU，請在「GPU」部分按一下 add「新增 GPU」，然後執行下列操作：

   1. 在「GPU type」欄位中，選取 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 機器資源)
  • 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 磁碟。如要在這個專案的 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 機器資源)
  • 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：美國和加拿大太平洋時間 (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 控制台的「Committed use discounts」(承諾使用折扣) 頁面。

   前往「承諾使用折扣」

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

3. 在「Name」 欄位中，輸入承諾名稱。

4. 在「Region」(區域) 欄位中，選取要提交至 Compute Engine 資源的區域。

5. 在「Commitment type」欄位中，選取已承諾資源的機器系列。下列承諾類型提供 GPU、本機 SSD 磁碟或兩者的選項：

   • 適用於 A2 機器類型資源的加速器最佳化 A2
   • 適用於 A3 Edge 和 A3 High 機型資源的加速器最佳化 A3
   • 加速器最佳化 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. 在「Cores」欄位中，輸入要提交的 vCPU 數量。

8. 在「Memory」欄位中，輸入要提交的記憶體大小 (以 GB 為單位)。

9. 如要承諾使用 GPU，請在「GPU」部分按一下 add「新增 GPU」，然後執行下列操作：

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

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

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

    1. 按一下「新增預訂」。系統會顯示「New reservation」部分。
    2. 在「名稱」欄位中，輸入已連結預訂的名稱。
    3. 在「Region」欄位中，選取與承諾相同的地區。
    4. 在「Zone」(可用區) 欄位中，選取要保留資源的可用區。

    5. 在「分享類型」部分，指定您要如何分享此預訂，可使用下列任一方式：

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

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

       • 如要讓屬性相符的 VM 自動使用這個預留項目，請按一下「Use reservation automatically」(預設)。
       • 如要只在建立相符屬性 (明確指定這個保留項目名稱) 的 VM 時使用這個保留項目的資源，請按一下「Select specific reservation」(選取特定保留項目)。

    7. 在「Resource details」(資源詳細資料) 專區，執行下列操作：

       1. 在「VM 執行個體數量」欄位中，輸入要保留的 VM 執行個體數量。

       2. 在「機器設定」部分，使用下列任一方式指定保留 VM 的屬性：

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

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

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

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

                • General purpose：適用於一般用途機器系列
                • 運算最佳化：適用於運算最佳化機器系列
                • 針對記憶體最佳化機器系列，使用記憶體最佳化
                • GPU (加速器最佳化機器系列)

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

             3. 在「Machine type」(機器類型) 欄位中，使用下列任一方式指定預先定義或自訂機器類型：

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

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

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

                2. 選用步驟：如要保留 GPU，請按一下 add「新增 GPU」。接著，在「GPU 類型」和「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 承諾

假設您想在 us-central1 區域購買包含 4 個 NVIDIA V100 GPU 的承諾產品 commitment-01。您想建立新的保留項目 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 或記憶體，請將 0 指定為 vCPU 和記憶體數量的值。舉例來說，假設您想在 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 承諾

假設您想在 us-central1 區域購買包含 4 個 NVIDIA V100 GPU 的承諾產品 commitment-01。您需要建立新的保留項目 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 或記憶體，請將 0 指定為 vCPU 和記憶體數量的值。舉例來說，假設您想在 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"
    }
  ]
}

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
     local_ssd:
     - 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
     local_ssd:
     - 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 磁碟在目前已連結的保留空間中，為每個保留 VM 使用的介面類型。有效選項為：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：您要在新的替換預留項目中預留的 VM 數量。

   • REPLACEMENT_RESERVATION_MACHINE_TYPE：您希望新替換預留項目中的 VM 採用的機器類型。

     • 如果是預先定義的機器類型，請使用 MACHINE_FAMILY-standard-CPUS 格式，例如 n2-standard-4。
     • 如果是自訂機器類型，請使用 MACHINE_FAMILY-custom-CPUS-MEMORY 格式，例如 n2-custom-4-5120。如需相關限制的完整清單，請參閱自訂機器類型的規格。

     更改下列內容：

     • MACHINE_FAMILY：機器類型系列；例如，針對 N2 VM 指定 n2。
     • CPUS：vCPU 數量。
     • MEMORY：保留 VM 的總記憶體。記憶體必須是 256 MB 的倍數，且須以 MB 為單位來提供，例如，如要建立具有 4 個 vCPU 和 5 GB 記憶體 (即 5120 MB) 的 N2 VM，請使用 n2-custom-4-5120。

   • REPLACEMENT_RESERVATION_NUMBER_OF_ACCELERATORS：在替換保留項目中，每個 VM 要新增的 GPU 數量。

   • REPLACEMENT_RESERVATION_ACCELERATOR_TYPE：您要在替換預訂中新增的加速器類型。

   • REPLACEMENT_RESERVATION_INTERFACE_1 和 REPLACEMENT_RESERVATION_INTERFACE_2：您希望每個保留 VM 使用的「Local SSD」(本機 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=3000 \
      --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 VM，每個 VM 各有 1 個 P100 GPU 和 2 個 scsi 介面類型的本機 SSD 磁碟。n1-standard-4 機器類型會為每個 VM 使用 4 個 vCPU 和 15 GB。

取代附加的預訂範例

假設您想將附加的預留項目 res-1 替換為新的附加預留項目 res-2，並將預留資源變更為下列項目：

^*具體來說，附加的保留項目範例 res-1 會保留 4 個 n1-standard-4 VM，每個 VM 各有 1 個 P100 GPU 和 2 個 scsi 介面類型的本機 SSD 磁碟。n1-standard-4 機器類型會為每個 VM 使用 4 個 vCPU 和 15 GB。

^†具體來說，替換的附加保留項目會定義 res-2，這個保留項目會保留 2 個 n1-standard-8 VM，每個 VM 包含 1 個 P100 GPU 和 4 個 scsi 介面類型的本機 SSD 磁碟。此外，res-2 與其他 2 個專案共用，分別是 project-1 和 project-2，並由目前專案 my-project 擁有。n1-standard-8 機器類型會為每個 VM 使用 8 個 vCPU 和 30 GB。

如要將 my-commitment-with-reservations 承諾的附加預留項目 res-1 替換為 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 \
       --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"
          }
         }
      }
    }
  ]
}

將下列內容替換為承諾、目前的預訂和替換預訂的對應屬性：

替換承諾中附加的保留項目範例

為說明這項功能，本節將展示含有附加保留項目的承諾範例，以及如何取代附加的範例保留項目。

附帶保留項目的承諾範例

舉例來說，假設您想為 my-commitment-with-reservations 承諾，替換附加的預留項目 res-1，該承諾是透過提出下列 POST 要求購買：

  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 VM，每個 VM 各有 1 個 P100 GPU 和 2 個 scsi 介面類型的本機 SSD 磁碟。n1-standard-4 機器類型會為每個 VM 使用 4 個 vCPU 和 15 GB。

取代附加的預訂範例

假設您想將附加的預留項目 res-1 替換為新的附加預留項目 res-2，並將預留資源變更為下列項目：

^*具體來說，附加的保留項目範例 res-1 會保留 4 個 n1-standard-4 VM，每個 VM 各有 1 個 P100 GPU 和 2 個 scsi 介面類型的本機 SSD 磁碟。n1-standard-4 機器類型會為每個 VM 使用 4 個 vCPU 和 15 GB。

^†具體來說，替換的附加保留項目會定義 res-2，這個保留項目會保留 2 個 n1-standard-8 VM，每個 VM 包含 1 個 P100 GPU 和 4 個 scsi 介面類型的本機 SSD 磁碟。此外，res-2 與其他 2 個專案共用，分別是 project-1 和 project-2，並由目前專案 my-project 擁有。n1-standard-8 機器類型會為每個 VM 使用 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"
      }
    ]
  }