延長承諾使用合約的約期

本文說明如何延長以 Compute Engine 硬體資源為準的承諾約期，超過預先設定的 1 年和 3 年選項。

延長約期可讓您彈性延長承諾的約期，不再受限於預設的 1 年或 3 年，並指定自選的自訂約期長度，例如 2 年、3.5 年或 5.5 年。延長承諾的約期後，您就能根據資源使用需求自訂約期，並在更長的時間內持續享有承諾使用折扣 (CUD)。您可以按照下列方式延長 1 年和 3 年承諾的期限：

• 1 年期承諾：您可以指定大於 1 年且小於 3 年的自訂約期。
• 3 年期承諾：您可以指定大於 3 年且小於 6 年的自訂約期。

如要透過其他方式延長承諾期，請參閱下列替代方案：

• 如果您簽訂 1 年期合約，且希望享有更高的折扣率和更長的合約期限，請升級合約。
• 如要讓承諾使用合約在到期後自動續約一或多個完整週期，請啟用承諾使用合約的自動續約功能。

延期功能的運作方式

承諾會在特定期間內生效，該期間由開始和結束日期定義，稱為「期限」。如果承諾方案啟用自動續約功能，每次續約時都會開始新的期限。延長期限時，您只會修改承諾持續期的結束日期，也就是您要求延長時的有效期限。

您可以延長承諾的現行約期，並指定未來的結束日期，藉此設定自訂約期。您的承諾就會變成自訂期限承諾。如果是 1 年期承諾，自目前方案的開始日期起算，自訂結束日期可介於 1 到 3 年之間 (但不能剛好是 3 年)。如果是 3 年期合約，自目前合約期開始日期起算，自訂結束日期可介於 3 年至 6 年之間 (但不能剛好是 6 年)。

無論是新約還是現有合約，您都可以按照下列步驟延長期限：

• 新承諾：您可以在購買承諾時指定自訂結束日期。
• 現有承諾：承諾生效後，您可以更新承諾的屬性，藉此指定或更新自訂結束日期。

您提出承諾方案的續約要求後，變更會在隔天美國和加拿大太平洋時間 (即 UTC-8，日光節約時間實行期間則為 UTC-7) 凌晨 12 點生效。約期會持續有效，直到新的自訂結束日期為止，且約期會相應調整。延長承諾的期限不會影響承諾的其他屬性：

• 名稱
• 開始日期
• 區域
• 專案
• 承諾使用合約類型
• 承諾使用方案
• 自動續約狀態
• 已提交的資源

延長承諾使用期限不會改變您因承諾使用而獲得的 CUD 費率。

與承諾方案相關聯的預訂，在延長的期限內會繼續存在，除非您手動更換。

延長期限資格申請時限

承諾期開始後，您可以在有限時間內要求延長期限。這段時間稱為「續約資格期限」。

無論承諾的期限是預設還是自訂，承諾的延期資格時間範圍取決於您對承諾執行的最新作業。視作業而定，延期資格時間範圍的適用方式如下：

• 新購買的承諾使用合約：如果是 1 年期承諾使用合約，資格申請期限最長為承諾使用合約啟用後的 4 個月。如果承諾使用 3 年，資格申請期限會在承諾啟用後 1 年內開放。

• 自動續約的承諾使用合約：如果承諾使用合約自動續約，資格期限會在續約期開始時重新計算。如果是 1 年期方案，您可以在續約後 4 個月內申請。如果是 3 年期方案，資格申請期限最長為續約期開始後 1 年。

• 合併承諾使用合約：如果合併的承諾使用合約有不同的適用時間範圍，Compute Engine 會為合併後的承諾使用合約，採用最早結束的適用時間範圍。

• 分割承諾使用合約：分割承諾使用合約後，無論是調整大小的來源承諾使用合約，還是新的分割承諾使用合約，適用資格的時間範圍都維持不變。

• 升級的承諾：將 1 年期承諾升級為 3 年期承諾時，Compute Engine 也會更新承諾的適用資格時間範圍。更新後的期限最長為 1 年，自當期開始起算。

  舉例來說，假設 1 年期合約的開始日期為 2024 年 1 月 1 日，原始 1 年期方案的申請時限為 2024 年 5 月 1 日。假設您在 2024 年 4 月 1 日將這項承諾升級為 3 年期承諾，升級後，承諾的更新資格期限將延長至 2025 年 1 月 1 日。

多次延長期限

您可以在約期延長資格期間內，多次延長約期。在任何一天，只要您每次都指定較晚的結束日期，您都可以針對任何有效的承諾，在美國和加拿大太平洋時間 (UTC-8 或 UTC-7) 隔天凌晨 12 點前，多次提出延長期限要求。不過，Google 建議您盡量減少在同一天為單一約期提出的延期要求次數。

特定結束日期的延期生效後，承諾的自訂結束日期會更新，您無法取消延期或縮短承諾期限。您只能針對晚於最近指定結束日期的結束日期，執行後續的延期作業。

待處理的承諾更新要求造成的影響

如果現有有效合約已有待處理的更新要求，只有在待處理要求也是展延期限時，您才能提出新的展延期限要求。如果待處理的承諾更新要求 (例如合併、分割、升級或自動續訂設定更新) 尚未完成，請等待這些作業完成並生效後，再要求延長期限。次日午夜更新生效後，您即可申請延長該承諾的期限。

價格相關注意事項

承諾使用費用是所有承諾資源折扣價格的總和。延長承諾使用合約期限後，資源的折扣價格在整個自訂期限內都不會變動，即使以量計價價格有所變動也是如此。如要進一步瞭解資源價格，請參閱 Compute Engine 定價

注意： 如果合併或分割承諾使用合約，承諾資源的折扣價格可能會在合併或分割生效當天變更。

配額注意事項

如要在購買承諾時指定自訂結束日期，您必須有足夠的配額，可供承諾和承諾資源使用。如要為現有約期指定自訂結束日期，通常不需要申請任何額外配額。

延長期限對日後承諾作業的影響

如果承諾使用合約的期限為自訂，對自訂期限承諾使用合約執行任何後續承諾使用合約管理作業，可能會影響自訂到期日和資格期限。下列各節說明在其他約期作業期間，自訂期限約期的行為：

自動續約的自訂期限承諾

自動續約的承諾方案續約期限，一律與承諾方案預設的期限長度相同，也就是 1 年或 3 年。折扣百分比也相同。即使承諾方案的 自訂約期，Compute Engine 續約時仍會採用預設的 1 年或 3 年約期。自訂約期承諾不會自動續約，而是會續約一年。如需範例，請參閱下列內容：

• 如果自訂的約期為 1.5 年，則續約時只能再續約 1 年。
• 如果自訂期限為 5.5 年，則續約期限僅為 3 年。

如果希望自訂期限承諾在續約後維持更長的時間，可以在續約後申請再次延長期限。續約期開始時，延長期限的資格也會重新計算。如果承諾期為 1 年，續約後最多 4 個月內仍可申請。如果是 3 年期方案，續約後最多可保留 1 年。

舉例來說，假設 1 年期合約的開始日期為 2024 年 1 月 1 日，您延長這項承諾的期限，並指定自訂結束日期為 2025 年 6 月 30 日。如果您也為承諾使用合約啟用自動續約功能，系統將於 2025 年 7 月 1 日為您的承諾使用合約續約一年。續訂期限的結束日期為 2026 年 6 月 30 日。續約期間的延期資格申請期限將延長至 2025 年 11 月 1 日。

如要進一步瞭解如何自動續約承諾使用合約，請參閱「自動續約承諾使用合約」。

合併自訂條款承諾

無論承諾使用合約的期限是自訂還是預設，合併作業的行為都相同。合併後的承諾會沿用下列屬性：

• 來源承諾中最遠的未來結束日期，無論是否為自訂結束日期。
• 來源承諾中最早結束的資格期間。

舉例來說，假設您想合併兩項自訂期限的 1 年期方案。第一個約期的開始日期為 2024 年 1 月 1 日，自訂結束日期為 2025 年 6 月 30 日。第一項承諾的資格期限將於 2024 年 5 月 1 日截止。第二個承諾的開始日期為 2024 年 2 月 1 日，自訂結束日期為 2025 年 7 月 30 日。第二項承諾的資格期限為 2024 年 6 月 1 日。如果您在 2024 年 4 月 1 日合併這些約定，合併後的約定會沿用 2025 年 7 月 30 日做為結束日期。合併後承諾的資格申請期限為 2024 年 5 月 1 日。

如要進一步瞭解如何合併承諾，請參閱「合併承諾」。

拆分自訂條款承諾

無論是自訂期限還是預設期限的約期，分割作業的行為都相同。縮放大小後的來源承諾和新分割的承諾會保留相同的自訂結束日期，以及符合資格的續約期限。

舉例來說，假設您的 1 年期合約開始日期為 2024 年 1 月 1 日，自訂結束日期為 2025 年 6 月 30 日。承諾的資格期限將於 2024 年 5 月 1 日結束。假設您在 2024 年 3 月 1 日將這項承諾分割為兩項獨立承諾。新拆分的承諾會沿用 2025 年 6 月 30 日的自訂結束日期，且資格期限會維持到 2024 年 5 月 1 日。

如要進一步瞭解如何分割使用承諾，請參閱「分割使用承諾」一文。

升級自訂條款承諾

您可以升級約期為 1 年的承諾使用合約。這項作業的運作方式與升級預設期限的承諾方案相同。升級自訂期限的 1 年期承諾時，Compute Engine 會執行下列作業：

• 將承諾方案變更為 3 年
• 將約期結束日期延後兩年。

舉例來說，假設您的 1 年期約定開始日期為 2024 年 1 月 1 日，自訂結束日期為 2025 年 6 月 30 日。原始 1 年期方案的資格申請期限為 2024 年 5 月 1 日。如果您在 2024 年 4 月 1 日升級這項約期，約期就會變更為 3 年，結束日期為 2027 年 6 月 30 日。承諾的更新資格期限仍維持不變，將於 2025 年 1 月 1 日截止。您也會開始享有適用於 3 年期方案的 CUD 費率。

如要進一步瞭解如何升級承諾，請參閱「升級承諾」。

限制

以下限制適用於以資源為準的承諾期限延長：

• 只有硬體資源承諾可以延長期限。
• 您無法延長非使用中或過期承諾使用合約的期限。
• 如果是 1 年期承諾，您無法指定自訂結束日期，導致總承諾期為 3 年以上。建議您改為升級承諾，將承諾方案從 1 年期變更為 3 年期。
• 如果是 3 年期承諾，您無法指定自訂結束日期，導致總承諾期為 6 年或更長。建議您改為啟用承諾使用合約的自動續約功能。啟用自動續約後，承諾使用合約會自動續約，再延長 3 年。
• 自訂約期續約時，新約期會採用方案定義的 1 年或 3 年期限，而非自訂期限。
• 如果現有有效合約已有待處理的合約更新要求，只有在待處理的要求也是延長期限時，您才能提出新的期限延長要求。如果合約有任何其他待處理的更新要求 (例如合併、分割、升級或自動續訂設定更新)，您必須等到隔天午夜過後，待處理作業完成且更新生效，才能要求延長期限。

需求條件

如要順利延長合約期限，必須符合下列條件：

• 必須在承諾的延長期限資格期間內提出延長期限要求。
• 如果是 1 年期承諾，自目前合約的開始日期起算，自訂結束日期必須介於 1 到 3 年之間 (但不能剛好是 3 年)。
• 如果是 3 年期承諾，自目前合約的開始日期起算，自訂結束日期必須介於 3 到 6 年之間 (但不能剛好是 6 年)。
• 該約期不得有任何其他進行中或待處理的合併、分割、升級或續約作業。

最佳做法

延長合約期限時，Google 建議您遵循下列最佳做法：

• 提出延長期限要求前，請先等待所有其他待處理的承諾作業完成，並確認更新生效。
• 盡量減少同一天對單一約期提出的延期要求次數。

購買承諾使用合約時延長約期

購買承諾使用合約時，您可以指定自訂結束日期，延長預設的 1 年或 3 年期限。

這項工作需要的權限

如要執行這項工作，您必須具備以下權限：

• 專案或機構的 compute.commitments.create 權限。

如要在購買承諾時延長承諾期，請使用下列任一選項：

控制台

購買約定用量前，請先在 Google Cloud 控制台選取要用於購買約定用量的專案。如果 Cloud Billing 帳戶已啟用CUD 共用功能，您可以使用該帳戶的任何專案購買使用承諾。

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

   前往「承諾使用折扣」

   「Commitment list」(承諾清單) 頁面隨即開啟，並顯示「Hardware commitments」(硬體承諾) 分頁。

2. 按一下 「購買使用承諾」。

   系統會開啟「購買承諾使用折扣」頁面，並顯示「硬體」分頁。

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

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

5. 在「承諾類型」欄位中，選取承諾資源的機器系列。可用的承諾類型選項如下：

   • 如果是 A2 機型，請選取「加速器最佳化 A2」
   • 如果是 A3 Edge 和 A3 High 機型，請選取「加速器最佳化 A3」
   • 如果是 A3 Mega 機型，請選取「Accelerator-optimized A3 Mega」(加速器最佳化 A3 Mega)。
     注意：如果是 A4X、A4 或 A3 Ultra 機型，請務必使用「future reservations in AI Hypercomputer」(AI Hypercomputer 的未來預留項目) 消費選項購買承諾。詳情請參閱「 透過帳戶團隊預留容量」。
   • 如果是 G2 機型，請選取「圖形最佳化 G2」
   • 如果是 G4 機型，請選取「圖形最佳化 G4」
   • 如果是 C2 機型，請選取「運算最佳化 C2」
   • 如果是 C2D 機型，請選取「運算最佳化 C2D」
   • 如果是 H3 機型，請選取「運算最佳化 H3」
   • 如為 H4D 機型，請選取「運算最佳化 H4D」
   • 如果是 C3 機型，請選取「一般用途 C3」
   • 如果是 C3D 機器類型，請選取「一般用途 C3D」
     注意：如果是 C3 和 C3D 承諾類型，承諾類型指定的機器系列會因介面而異：

     • 在 gcloud CLI 和 REST 中，承諾類型值會使用「運算最佳化」做為機器系列，即使 C3 和 C3D 屬於一般用途機器系列也是如此。
     • 在 Google Cloud 控制台中，承諾類型值會使用正確的機器系列：一般用途。

     請務必選取與所用介面相應的正確承諾類型值。
   • 如果是 C4 機型，請選取「General-Purpose C4」(一般用途 C4)
   • 如果是 C4A 機型，請選取「一般用途 C4A」
   • 如果是 C4D 機型，請選取「一般用途 C4D」
   • 如果是 E2 機型，請選取「General-Purpose E2」
   • 如果是 N1 機器類型，請選取「General-Purpose N1」
   • 如果是 N2 機器類型，請選取「General-Purpose N2」
   • 如果是 N2D 機器類型，請選取「General-Purpose N2D」
   • 如為 N4 機型，請選取「General-Purpose N4」(一般用途 N4)
   • 如為 N4D 機器類型，請選取「一般用途 N4D」
   • 如要使用 N4A 機器類型，請選取「一般用途 N4A」 (預先發布版；正式發布後即可使用 CUD)
   • 如果是 Tau T2D 機型，請選取「一般用途 T2D」
   • 如果是 M1 或 M2 機型，請選取「記憶體最佳化 M1/M2」
   • 如果是 M3 機型，請選取「記憶體最佳化 M3」
   • 如果是 M4 機型，請選取「記憶體最佳化 M4」
   • 如要使用搭載 6 TB 記憶體的 M4 機器類型，請選取「記憶體最佳化 M4 6TB」
   • 如要使用 6 TB 記憶體的 X4 機器類型，請選取「Memory-optimized X4 480 6T」(記憶體最佳化 X4 480 6T)
   • 如要使用 8 TB 記憶體的 X4 機器類型，請選取「Memory-optimized X4 480 8T」(記憶體最佳化 X4 480 8T)
   • 如要使用 12 TB 記憶體的 X4 機器類型，請選取「Memory-optimized X4 960 12T」(記憶體最佳化 X4 960 12T)
   • 如要使用 16 TB 記憶體的 X4 機器類型，請選取「Memory-optimized X4 960 16T」
   • 如要使用 24 TB 記憶體的 X4 機器類型，請選取「Memory-optimized X4 1440 24T」(記憶體最佳化 X4 1440 24T)
   • 如要使用 32 TB 記憶體的 X4 機器類型，請選取「Memory-optimized X4 1920 32T」
   • 如果是 Z3 機型，請選取「儲存空間最佳化 Z3」

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

   1. 如要選擇承諾方案，請選取「1 年」或「3 年」。 這項選擇會定義承諾的最低期限。
   2. 如要指定自訂的約期結束日期，請按一下「延長結束日期」切換鈕，然後在「日期」欄位中指定自訂的結束日期。

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

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

   記憶體只能以 0.25 GB 為單位指定。如要為約期指定自訂記憶體值，請改用 gcloud CLI 或 REST。

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

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

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

11. 如果您在承諾中指定了任何 GPU 或本機 SSD 磁碟，請透過下列其中一種方式，附加這些資源的相符保留項目。針對要附加的每個新預訂重複這個步驟。

    1. 如要將一或多個現有預留項目加入承諾使用合約，請在「預留項目」欄位中選取「加入現有預留項目」，然後按照「加入現有預留項目」一節中的步驟操作。
    2. 如要建立新的預留項目並附加至約定，請在「預留項目」欄位中選取「建立預留項目」，然後按照「建立新的預留項目並附加」一節中的步驟操作。

12. 如要完成購買承諾，請按照下列步驟操作：

    1. 按一下「購買」。
    2. 在「購買預先承諾用量折扣」對話方塊中，如果您同意服務專屬條款，請再次按一下「購買」。

gcloud

如要購買具有自訂延長期限的承諾，請執行 gcloud compute commitments create 指令，並加入 --custom-end-time 旗標。

舉例來說，如要購買 vCPU、記憶體或兩者的承諾方案，請使用下列指令：

gcloud compute commitments create COMMITMENT_NAME \
    --region=REGION \
    --project=PROJECT_ID \
    --plan=COMMITMENT_PLAN \
    --type=COMMITMENT_TYPE \
    --resources=vcpu=NUMBER_VCPUS,memory=MEMORY \
    --custom-end-time=CUSTOM_END_DATE

更改下列內容：

• COMMITMENT_NAME：承諾名稱
• REGION：承諾的區域，以及您要承諾購買 Compute Engine 資源的區域。
• PROJECT_ID：專案 ID

• COMMITMENT_PLAN：承諾方案。這項屬性也會決定您必須承諾購買資源的最低時間長度。請指定下列其中一個值：

  • 承諾使用 1 年：12-month
  • 承諾使用 3 年：36-month。

• COMMITMENT_TYPE：您要承諾購買資源的機器系列。可用的選項如下：

  • 如為 A2 機型，請使用 accelerator-optimized
  • 如為 A3 Edge 和 A3 High 機型，請使用 accelerator-optimized-a3
  • 如為 A3 Mega 機型，請使用 accelerator-optimized-a3-mega
    注意：如為 A4X、A4 或 A3 Ultra 機型，請務必使用 AI Hypercomputer 的未來預留項目消費選項購買承諾。詳情請參閱「 透過帳戶團隊預留容量」。
  • 如為 G2 機型，請使用 graphics-optimized
  • 如為 G4 機型，請使用 graphics-optimized-g4
  • 如為 C2 機型，請使用 compute-optimized
  • 如為 C2D 機型，請使用 compute-optimized-c2d
  • 如為 C3 機型，請使用 compute-optimized-c3
  • 如果是 C3D 機型，請使用 compute-optimized-c3d
    注意：如果是 C3 和 C3D 承諾類型，承諾類型指定的機器系列會因介面而異：

    • 在 gcloud CLI 和 REST 中，承諾類型值會使用「運算最佳化」做為機器系列，即使 C3 和 C3D 屬於一般用途機器系列也是如此。
    • 在 Google Cloud 控制台中，承諾類型值會使用正確的機器系列：一般用途。

    請務必選取與所用介面相應的正確承諾類型值。
  • 如為 H3 機型，請使用 compute-optimized-h3
  • 如為 H4D 機型，請使用 compute-optimized-h4d
  • 若為 N1 機器類型，請使用 general-purpose
  • 如為 C4 機型，請使用 general-purpose-c4
  • 如為 C4A 機型，請使用 general-purpose-c4a
  • 如為 C4D 機型，請使用 general-purpose-c4d
  • 若為 E2 機器類型，請使用 general-purpose-e2
  • 如果是 N2 機器類型，請使用 general-purpose-n2
  • 如果是 N2D 機器類型，請使用 general-purpose-n2d
  • 如為 N4 機型，請使用 general-purpose-n4
  • 如為 N4D 機器類型，請使用 general-purpose-n4d
  • 如為 N4A 機器類型，請使用 general-purpose-n4a (預先發布版；CUD 將於正式發布時推出)
  • 如為 Tau T2D 機型，請使用 general-purpose-t2d
  • 如果是 M1 或 M2 機型，請使用 memory-optimized
  • 如為 M3 機型，請使用 memory-optimized-m3
  • 如為 M4 機型，請使用 memory-optimized-m4
  • 如要使用搭載 6 TB 記憶體的 M4 機器類型，請使用 memory-optimized-m4-6tb
  • 如要使用搭載 6 TB 記憶體的 X4 機器類型，請使用 memory-optimized-x4-6t
  • 如要使用 8 TB 記憶體的 X4 機器類型，請使用 memory-optimized-x4-8t
  • 如為搭載 12 TB 記憶體的 X4 機器類型，請使用 memory-optimized-x4-12t
  • 如要使用記憶體為 16 TB 的 X4 機器類型，請使用 memory-optimized-x4-960-16t
  • 如要使用搭載 24 TB 記憶體的 X4 機器類型，請使用 memory-optimized-x4-1440-24t
  • 如要使用搭載 32 TB 記憶體的 X4 機器類型，請使用 memory-optimized-x4-1920-32t
  • 如為 Z3 機型，請使用 storage-optimized-z3

  如果您未指定 --type 標記，Compute Engine 會使用 general-purpose 做為預設值。

• NUMBER_VCPUS：您要承諾購買的 vCPU 數量。

• MEMORY：您要購買的記憶體量，以 MB 或 GB 為單位，例如 1000MB 或 100GB。如未指定單位，Compute Engine 會預設使用 GB。

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

如要瞭解購買 GPU 和/或本機 SSD 磁碟承諾時，如何延長期限的詳細語法，請參閱購買附加保留項目的承諾。

舉例來說，假設您在 us-central1 地區為 4 個 N1 vCPU 和 9 GB 記憶體建立 1 年期承諾，並將其命名為 example-commitment。假設您想在 2024 年 1 月 1 日購買這項約定，並希望自訂期限，在 2025 年 6 月 30 日結束。如要購買這項約期，請執行下列指令：

gcloud compute commitments create example-commitment \
    --region=us-central1 \
    --project=my-project
    --plan=12-month \
    --type=general-purpose
    --resources=memory=9GB,vcpu=4 \
    --custom-end-time=2025-07-01

REST

如要購買自訂延長期限的承諾使用合約，請對 regionCommitments.insert 方法發出 POST 要求。在要求主體中，請納入 customEndTimestamp 欄位。

舉例來說，如要購買 vCPU、記憶體或二者的承諾方案，請使用下列 POST 要求主體：

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments
{
    "name": "COMMITMENT_NAME",
    "plan": "COMMITMENT_PLAN",
    "type": "COMMITMENT_TYPE",
    "resources":
    [
        {
            "amount": "NUMBER_VCPUS",
            "type": "VCPU"
        },
        {
            "amount": "MEMORY",
            "type": "MEMORY"
        },
    ],
    "customEndTimestamp": "CUSTOM_END_DATETEND_TIMEZ",
}

更改下列內容：

• COMMITMENT_NAME：承諾名稱
• REGION：承諾的區域，以及您要承諾購買 Compute Engine 資源的區域。
• PROJECT_ID：專案 ID

• COMMITMENT_PLAN：承諾方案。這項屬性也會決定您必須承諾購買資源的最低時間長度。請指定下列其中一個值：

  • 承諾使用 1 年：TWELVE_MONTH
  • 承諾使用 3 年：THIRTY_SIX_MONTH。

• COMMITMENT_TYPE：您要承諾購買資源的機器系列。可用的選項如下：

  • 如為 A2 機型，請使用 ACCELERATOR_OPTIMIZED
  • 如為 A3 Edge 和 A3 High 機型，請使用 ACCELERATOR_OPTIMIZED_A3
  • 如為 A3 Mega 機型，請使用 ACCELERATOR_OPTIMIZED_A3_MEGA
    注意：如為 A4X、A4 或 A3 Ultra 機型，請務必使用 AI Hypercomputer 的未來預留項目消費選項購買承諾。詳情請參閱「 透過帳戶團隊預留容量」。
  • 如為 G2 機型，請使用 GRAPHICS_OPTIMIZED
  • 如為 G4 機型，請使用 GRAPHICS_OPTIMIZED_G4
  • 如為 C2 機型，請使用 COMPUTE_OPTIMIZED
  • 如為 C2D 機型，請使用 COMPUTE_OPTIMIZED_C2D
  • 如為 C3 機型，請使用 COMPUTE_OPTIMIZED_C3
  • 如果是 C3D 機型，請使用 COMPUTE_OPTIMIZED_C3D
    注意：如果是 C3 和 C3D 承諾類型，承諾類型指定的機器系列會因介面而異：

    • 在 gcloud CLI 和 REST 中，承諾類型值會使用「運算最佳化」做為機器系列，即使 C3 和 C3D 屬於一般用途機器系列也是如此。
    • 在 Google Cloud 控制台中，承諾類型值會使用正確的機器系列：一般用途。

    請務必選取與所用介面相應的正確承諾類型值。
  • 如為 H3 機型，請使用 COMPUTE_OPTIMIZED_H3
  • 如為 H4D 機型，請使用 COMPUTE_OPTIMIZED_H4D
  • 若為 N1 機器類型，請使用 GENERAL_PURPOSE
  • 如為 C4 機型，請使用 GENERAL_PURPOSE_C4
  • 如為 C4A 機型，請使用 GENERAL_PURPOSE_C4A
  • 如為 C4D 機型，請使用 GENERAL_PURPOSE_C4D
  • 若為 E2 機器類型，請使用 GENERAL_PURPOSE_E2
  • 如果是 N2 機器類型，請使用 GENERAL_PURPOSE_N2
  • 如果是 N2D 機器類型，請使用 GENERAL_PURPOSE_N2D
  • 如為 N4 機型，請使用 GENERAL_PURPOSE_N4
  • 如為 N4D 機器類型，請使用 GENERAL_PURPOSE_N4D
  • 如為 N4A 機器類型，請使用 GENERAL_PURPOSE_N4A (預先發布版；CUD 將於正式發布時推出)
  • 如為 Tau T2D 機型，請使用 GENERAL_PURPOSE_T2D
  • 如果是 M1 或 M2 機型，請使用 MEMORY_OPTIMIZED
  • 如為 M3 機型，請使用 MEMORY_OPTIMIZED_M3
  • 如為 M4 機型，請使用 MEMORY_OPTIMIZED_M4
  • 如要使用搭載 6 TB 記憶體的 M4 機器類型，請使用 MEMORY_OPTIMIZED_M4_6TB
  • 如要使用搭載 6 TB 記憶體的 X4 機器類型，請使用 MEMORY_OPTIMIZED_X4_480_6T
  • 如要使用 8 TB 記憶體的 X4 機器類型，請使用 MEMORY_OPTIMIZED_X4_480_8T
  • 如為搭載 12 TB 記憶體的 X4 機器類型，請使用 MEMORY_OPTIMIZED_X4_960_12T
  • 如要使用記憶體為 16 TB 的 X4 機器類型，請使用 MEMORY_OPTIMIZED_X4_960_16T
  • 如要使用搭載 24 TB 記憶體的 X4 機器類型，請使用 MEMORY_OPTIMIZED_X4_1440_24T
  • 如要使用搭載 32 TB 記憶體的 X4 機器類型，請使用 MEMORY_OPTIMIZED_X4_1920_32T
  • 如為 Z3 機型，請使用 STORAGE_OPTIMIZED_Z3

• NUMBER_VCPUS：您要承諾購買的 vCPU 數量。

• MEMORY：您要購買的記憶體量 (以 MB 為單位)，例如 10240MB。

• 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

如要瞭解購買 GPU 和/或本機 SSD 磁碟承諾時，如何延長期限的詳細語法，請參閱購買附加保留項目的承諾。

舉例來說，假設您在 us-central1 地區建立名為 example-commitment 的 1 年期承諾，其中包含 4 個 N1 vCPU 和 9 GB 記憶體。假設您想在 2024 年 1 月 1 日購買這項約定，並希望自訂期限在 2025 年 6 月 30 日結束。如要購買這項約期，請提出下列要求：

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments
{
    "name": "example-commitment",
    "plan": "TWELVE_MONTH",
    "type": "GENERAL_PURPOSE",
    "resources":
    [
        {
            "amount": "4",
            "type": "VCPU"
        },
        {
            "amount": "9216",
            "type": "MEMORY"
        },
    ],
    "customEndTimestamp": "2025-07-01T07:00:00Z",
}

延長現有承諾使用合約的約期

如要延長現有有效約期的期限，請更新約期屬性，指定或更新自訂結束日期。

這項工作需要的權限

如要執行這項工作，您必須具備以下權限：

• 專案或機構的 compute.commitments.update 權限。

如要延長現有約期的期限，請使用下列其中一個選項：

控制台

發起延長期限作業前，請先在 Google Cloud 控制台選取要延長承諾期限的專案。

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

   前往「承諾使用折扣」

   「Commitment list」(承諾清單) 頁面隨即開啟，並顯示「Hardware commitments」(硬體承諾) 分頁。

2. 如要啟動承諾使用合約的延長期限作業，請在「硬體承諾」分頁中選取有效承諾使用合約，然後按一下「延長」。

   您還可以透過以下方法設定提醒：

   1. 在「Commitment list」(承諾清單) 頁面的「Hardware commitments」(硬體承諾) 分頁中，按一下要延長的有效承諾名稱。
   2. 在所選方案的「硬體承諾詳細資料」頁面中，按一下「延長」。

   系統會顯示所選約期的「延長」窗格。

3. 如要完成延長期限作業，請在承諾的「延長」窗格中執行下列操作：

   1. 查看「承諾詳細資料」。
   2. 在「選取結束日期」欄位中，指定承諾的自訂結束日期。
   3. 在「承諾時間表」部分，查看「新結束日期」欄位。
   4. 如要確認延長期限要求，請按一下「延長」。

gcloud

如要延長現有有效承諾方案的期限，請執行 gcloud compute commitments update 指令，並加入 --custom-end-time 旗標。

gcloud compute commitments update COMMITMENT_NAME \
    --region=REGION \
    --project=PROJECT_ID \
    --custom-end-time=CUSTOM_END_DATE

更改下列內容：

• COMMITMENT_NAME：承諾名稱
• PROJECT_ID：專案 ID
• REGION：承諾的區域，以及您要承諾購買 Compute Engine 資源的區域。
• CUSTOM_END_DATE：您希望的自訂學期結束日期，格式為 YYYY-MM-DD，其中 YYYY 是年份、MM 是月份，而 DD 是日期。舉例來說，如要指定 2024 年 4 月 20 日為自訂結束日期，請將格式設為 2024-04-20。

舉例來說，假設您在 us-central1 區域購買了 4 個 N1 vCPU 和 9 GB 記憶體的 1 年期自訂期限承諾 example-commitment。這項約定於 2024 年 1 月 1 日購買，並於 2025 年 6 月 30 日到期。如要將期限延長至 2026 年 6 月 30 日，請執行下列指令：

gcloud compute commitments update example-commitment \
    --region=us-central1 \
    --project=my-project \
    --custom-end-time=2026-07-01

REST

如要延長現有有效合約的期限，請對 regionCommitments.update 方法發出 PATCH 要求。在要求主體中，請納入 customEndTimestamp 欄位。

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments/COMMITMENT_NAME
{
    "name": "COMMITMENT_NAME",
    "customEndTimestamp": "CUSTOM_END_DATETEND_TIMEZ",
}

更改下列內容：

• COMMITMENT_NAME：承諾名稱
• REGION：承諾的區域，以及您要承諾購買 Compute Engine 資源的區域。
• PROJECT_ID：專案 ID
• CUSTOM_END_DATE：您希望的自訂學期結束日期，格式為 YYYY-MM-DD，其中 YYYY 是年份、MM 是月份，而 DD 是日期。舉例來說，如要指定 2024 年 4 月 20 日為自訂結束日期，請將格式設為 2024-04-20。

• END_TIME：美國和加拿大太平洋時間凌晨 12 點 (UTC-8 或 UTC-7)，即世界標準時間 (UTC) 的偏移量。請指定下列其中一個值：

  • 日光節約時間：07:00:00
  • 其他時間：08:00:00

舉例來說，假設您在 us-central1 區域購買了 4 個 N1 vCPU 和 9 GB 記憶體的 1 年期自訂期限承諾 example-commitment。這項承諾於 2024 年 1 月 1 日購買，並於 2025 年 6 月 30 日到期。如要將期限延長至 2026 年 6 月 30 日，請提出下列要求：

PATCH https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments/example-commitment
{
    "name": "example-commitment",
    "customEndTimestamp": "2026-07-01T07:00:00Z",
}

後續步驟

• 瞭解如何自動續約依資源計算的承諾使用合約。
• 瞭解如何升級依資源計算的承諾使用合約。
• 瞭解如何分析 CUD 的成效。