延長承諾使用合約的約期

本文說明如何延長 Compute Engine 硬體資源承諾使用合約的期限,超過預設的 1 年和 3 年選項。

您可以彈性延長承諾使用合約,超過預設的 1 年或 3 年,並指定自訂約期,例如 2 年、3.5 年或 5.5 年。延長承諾使用合約期限,即可根據資源使用需求調整合約期限,並在更長的自訂期限內持續享有承諾使用折扣 (CUD)。您可以延長 1 年和 3 年承諾使用合約的期限,如下所示:

  • 1 年承諾使用合約:您可以指定超過 1 年且少於 3 年的自訂約期。
  • 3 年承諾使用合約:您可以指定 3 年以上、6 年以下的自訂約期。

如要瞭解其他延長承諾使用合約效期的方法,請參閱下列替代方案:

延長期限的運作方式

承諾使用合約在特定期間內有效,由開始和結束日期定義,稱為「約期」。如果承諾使用合約已啟用自動續約功能,每次續約時都會開始新的約期。執行合約展延時,您只會修改合約「進行中合約」的結束日期,也就是您要求展延時有效的合約。

您可以延長承諾使用合約的現有約期,並指定未來的結束日期,設定自訂約期。合約會轉為自訂合約。如果是 1 年約期,自目前約期開始日期起算,自訂結束日期可介於 1 到 3 年之間 (但不能剛好是 3 年)。如果是 3 年承諾使用合約,自訂結束日期可以設在現行合約開始日期後的 3 到 6 年內 (但不能剛好是 6 年)。

您可以為新的和現有的承諾使用合約延長期限,方法如下:

提出承諾使用合約展延要求後,變更會在美國和加拿大太平洋時間 (UTC-8,日光節約時間實行期間則為 UTC-7) 隔天凌晨 12 點生效。在新的自訂結束日期前,合約仍有效,約期也會相應調整。延長承諾使用合約期限不會影響合約的其他屬性:

  • 名稱
  • 開始日期
  • 區域
  • 專案
  • 承諾使用合約類型
  • 承諾使用方案
  • 自動續約設定
  • 承諾資源

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

除非您手動更換,否則與承諾使用合約連結的任何預留項目,在延長期限內都會繼續存在。

延長期限資格窗口

承諾使用合約生效後,您可以在限定時間範圍內要求延長合約期限。這段時間稱為約期延長資格期限。

無論承諾使用合約是預設或自訂效期,延長效期的資格期限都取決於您最近對承諾使用合約執行的操作。視作業而定,約期延長資格期限的適用方式如下:

  • 新購買的承諾使用合約:1 年期合約的資格期限為啟用後最多四個月。如果是 3 年承諾使用合約,則在合約生效後一年內,仍可享有這項優惠。

  • 自動續約的承諾使用合約:如果承諾使用合約自動續約,則資格期限會在續約期開始時重新計算。如果是 1 年期合約,則在續約期開始後的四個月內,仍可享有這項權益。如果是 3 年承諾使用合約,則在續約期開始後最多一年內,仍可享有這項優惠。

  • 合併承諾使用合約:如果合併的承諾使用合約有不同的資格期限,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 建議您盡量減少在同一天對單一承諾提出的展延要求數量。

特定結束日期的合約展延生效後,合約就會有新的自訂結束日期,您無法復原合約展延或縮短合約期限。只有在結束日期晚於最近指定的結束日期時,才能執行後續的延期作業。

待處理承諾使用合約更新要求的影響

如果現有有效承諾使用合約已有待處理的更新要求,只有在待處理要求也是延長合約期限時,才能提出新的延長合約期限要求。如果承諾使用合約有任何待處理的更新要求 (例如合併、分割、升級或自動續約設定更新),則必須等待待處理作業完成且更新生效,才能要求延長合約期限。在美國和加拿大太平洋時間 (UTC-8 或 UTC-7) 隔天凌晨 12 點後,更新生效時,您就可以要求延長該承諾使用合約的效期。

定價影響

承諾使用費用是所有承諾資源折扣價格的總和。延長承諾使用合約期限後,即使隨選價格有所變動,資源的折扣價格在整個自訂期限內仍會維持不變。如要進一步瞭解資源價格,請參閱「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 日續約 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 費率。

如要進一步瞭解如何升級承諾使用合約,請參閱「升級承諾使用合約」。

限制

資源型承諾使用合約的展期限制如下:

  • 您只能延長硬體資源承諾使用合約的期限。
  • 您無法延長未啟用或已到期承諾使用合約的期限。
  • 您無法延長透過 AI Hypercomputer 未來預留項目或 Cloud TPU 未來預留項目購買的使用承諾期限。
  • 如果是 1 年承諾使用合約,您無法指定自訂結束日期,導致總承諾使用合約期限為 3 年以上。建議您改為升級承諾使用合約,將合約方案從 1 年變更為 3 年。
  • 如果是 3 年承諾使用合約,您無法指定自訂結束日期,導致總承諾使用合約期限為 6 年以上。建議您啟用承諾使用合約自動續約功能。自動續約功能可讓您續約 3 年。
  • 自訂合約續約時,新合約的效期會是合約方案定義的 1 年或 3 年,而非自訂效期。
  • 如果現有的有效承諾使用合約已有待處理的更新要求,只有在該要求也是延長合約期限時,您才能提出新的延長合約期限要求。如果承諾使用合約有任何其他待處理的更新要求 (例如合併、分割、升級或自動續約設定更新),您必須等到美國和加拿大太平洋時間 (UTC-8 或 UTC-7) 隔天凌晨 12 點之後,待處理作業完成且更新生效後,才能要求延長合約效期。

需求條件

您必須符合下列規定,才能成功延長承諾使用合約期限:

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

最佳做法

延長承諾使用合約期限時,Google 建議您遵循下列最佳做法:

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

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

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

如要購買延長合約期限的使用承諾,請按照下列步驟操作:

控制台

購買承諾使用合約前,請在 Cloud de Confiance 控制台選取要用於購買合約的專案。如果 Cloud Billing 帳戶已啟用承諾使用折扣共用功能,您可以使用該 Cloud Billing 帳戶中的任何專案購買承諾使用合約。

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

    前往「Committed use discounts」(承諾使用折扣) 頁面

  2. 按一下「 購買承諾」。「Purchase a commitment」(購買承諾使用合約) 頁面隨即顯示。

  3. 在「Purchase a commitment」(購買承諾使用合約) 頁面中,指定承諾使用合約的屬性,如下所示:

    1. 如要為承諾使用合約設定展期,請在「Term」(合約期) 區段中執行下列操作:

      1. 選取「1 year」(1 年) 或「3 years」(3 年),指定承諾使用合約的方案。方案會決定承諾使用合約的 CUD 費率和預設約期。

      2. 查看「Start date」(開始日期) 欄位,其中會顯示承諾使用合約生效的日期和時間。系統會自動將這個欄位設為目前日期隔天的美國和加拿大太平洋時間凌晨 12 點。

      3. 如要指定承諾使用合約的自訂結束日期,請在「End date」(結束日期) 欄位中指定所需日期。

    2. 如要瞭解如何設定承諾使用合約的其他屬性,請根據您的用途參閱下列其中一個頁面:

      您至少必須指定名稱、區域、資源、承諾使用類型和承諾使用方案。

  4. 在右側的「Summary」(摘要) 窗格中,查看承諾使用合約詳細資料和任何潛在的配額限制。

  5. 如要完成購買承諾使用合約,請按照下列步驟操作:

    1. 移至頁面最下方。

    2. 查看「揭露事項」部分,其中包含費用、折扣資格和條款及細則等資訊。

    3. 如要確認接受承諾使用合約價格和服務專屬條款,請勾選核取方塊。

    4. 按一下「購買」。

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
    • 如果是 G2 機型,請使用 graphics-optimized
    • 如果是 G4 機型,請使用 graphics-optimized-g4
    • 如果是 C2 機型,請使用 compute-optimized
    • 如果是 C2D 機型,請使用 compute-optimized-c2d
    • 如果是 C3 機型,請使用 compute-optimized-c3
    • 如果是 C3D 機型,請使用 compute-optimized-c3d
    • 如果是 H3 機型,請使用 compute-optimized-h3
    • 如果是 H4D 機型,請使用 compute-optimized-h4d
    • 如果是 N1 機型,請使用 general-purpose
    • 如果是 C4 機型,請使用 general-purpose-c4
    • 如果是 C4A 機型,請使用 general-purpose-c4a
    • 如果是 C4D 機型,請使用 general-purpose-c4d
    • 如果是 C4N 機型,請使用 network-optimized-c4n
    • 如果是 E2 機型,請使用 general-purpose-e2
    • 如果是 N2 機型,請使用 general-purpose-n2
    • 如果是 N2D 機型,請使用 general-purpose-n2d
    • 如果是 N4 機型,請使用 general-purpose-n4
    • 如果是 N4D 機型,請使用 general-purpose-n4d
    • 如果是 N4A 機型,請使用 general-purpose-n4a
    • 如果是 Tau T2D 機型,請使用 general-purpose-t2d
    • 如果是 M1 或 M2 機型,請使用 memory-optimized
    • 如果是 M3 機型,請使用 memory-optimized-m3
    • 如果是記憶體為 6 TB 的 M4 機型,請使用 memory-optimized-m4-6tb
    • 如為其他 M4 機型,請使用 memory-optimized-m4
    • 如果是記憶體為 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
    • 如果是 Z4D 機型,請使用 storage-optimized-z4d
    • 如果是 Z4M 機型,請使用 storage-optimized-z4m

    如未指定 --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 區域中的承諾使用合約 (example-commitment) 指定的資源為四個 N1 vCPU 和 9 GB 記憶體。承諾使用合約的承諾使用方案為 12-month。假設您想在 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
    • 如果是 G2 機型,請使用 GRAPHICS_OPTIMIZED
    • 如果是 G4 機型,請使用 GRAPHICS_OPTIMIZED_G4
    • 如果是 C2 機型,請使用 COMPUTE_OPTIMIZED
    • 如果是 C2D 機型,請使用 COMPUTE_OPTIMIZED_C2D
    • 如果是 C3 機型,請使用 COMPUTE_OPTIMIZED_C3
    • 如果是 C3D 機型,請使用 COMPUTE_OPTIMIZED_C3D
    • 如果是 H3 機型,請使用 COMPUTE_OPTIMIZED_H3
    • 如果是 H4D 機型,請使用 COMPUTE_OPTIMIZED_H4D
    • 如果是 N1 機型,請使用 GENERAL_PURPOSE
    • 如果是 C4 機型,請使用 GENERAL_PURPOSE_C4
    • 如果是 C4A 機型,請使用 GENERAL_PURPOSE_C4A
    • 如果是 C4D 機型,請使用 GENERAL_PURPOSE_C4D
    • 如果是 C4N 機型,請使用 NETWORK_OPTIMIZED_C4N
    • 如果是 E2 機型,請使用 GENERAL_PURPOSE_E2
    • 如果是 N2 機型,請使用 GENERAL_PURPOSE_N2
    • 如果是 N2D 機型,請使用 GENERAL_PURPOSE_N2D
    • 如果是 N4 機型,請使用 GENERAL_PURPOSE_N4
    • 如果是 N4D 機型,請使用 GENERAL_PURPOSE_N4D
    • 如果是 N4A 機型,請使用 GENERAL_PURPOSE_N4A
    • 如果是 Tau T2D 機型,請使用 GENERAL_PURPOSE_T2D
    • 如果是 M1 或 M2 機型,請使用 MEMORY_OPTIMIZED
    • 如果是 M3 機型,請使用 MEMORY_OPTIMIZED_M3
    • 如果是記憶體為 6 TB 的 M4 機型,請使用 MEMORY_OPTIMIZED_M4_6TB
    • 如為其他 M4 機型,請使用 MEMORY_OPTIMIZED_M4
    • 如果是記憶體為 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
    • 如果是 Z4D 機型,請使用 STORAGE_OPTIMIZED_Z4D
    • 如果是 Z4M 機型,請使用 STORAGE_OPTIMIZED_Z4M

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

  • MEMORY:您要承諾購買的記憶體容量 (以 MB 為單位),例如 10240MB。

  • CUSTOM_END_DATE:合約的自訂結束日期,格式必須為 YYYY-MM-DD。舉例來說,如要指定 2024 年 4 月 20 日為自訂結束日期,請將格式設為 2024-04-20。

  • END_TIME:美國和加拿大太平洋時間 (UTC-8 或 UTC-7) 凌晨 12 點,以世界標準時間 (UTC) 為基準。指定下列其中一個值:

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

如要瞭解購買 GPU、本機 SSD 磁碟或兩者的承諾使用合約時,如何延長合約期限的詳細語法,請參閱「購買依硬體資源計算的承諾使用合約並附加預留項目」。

舉例來說,假設 us-central1 區域中的承諾使用合約 (example-commitment) 指定的資源為四個 N1 vCPU 和 9 GB 記憶體。承諾使用合約的承諾使用方案為 TWELVE_MONTH。假設您想在 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"
}

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

如要延長現有有效承諾使用合約的期限,請更新合約屬性,指定或更新自訂結束日期。

如要延長現有承諾使用合約的期限,請使用下列其中一種方法:

控制台

在 Cloud de Confiance 控制台選取要延長承諾使用合約期限的專案,然後再啟動期限延長作業。

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

    前往「承諾使用折扣」

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

  2. 如要延長承諾使用合約,請在「Hardware commitments」(硬體承諾使用合約) 分頁中選取有效的承諾使用合約,然後按一下「Extend」(延長)。

    或者,您也可以採取下列做法:

    1. 在「Commitment list」(承諾使用合約清單) 頁面的「Hardware commitments」(硬體承諾使用合約) 分頁中,按一下要延長的有效承諾使用合約名稱。

    2. 在所選承諾使用合約的「Hardware commitment details」(硬體承諾使用合約詳細資料) 頁面中,按一下「Extend」(延長)。

    所選承諾使用合約的「Extend」(延長) 窗格隨即顯示。

  3. 如要完成延長合約期限作業,請在承諾使用合約的「Extend」(延長) 窗格中執行下列操作:

    1. 查看「Commitment details」(承諾使用合約詳細資料)。

    2. 在「Select an end date」(選取結束日期) 欄位中,指定承諾使用合約的自訂結束日期。

    3. 在「Commitment timeline」(承諾使用合約時間軸) 區段中,查看「New end date」(新結束日期) 欄位。

    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 區域中的自訂約期承諾 (example-commitment) 指定了四個 N1 vCPU 和 9 GB 記憶體。承諾使用合約的承諾使用方案為 12-month。這項承諾使用合約於 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:美國和加拿大太平洋時間 (UTC-8 或 UTC-7) 凌晨 12 點,以世界標準時間 (UTC) 為基準。指定下列其中一個值:

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

舉例來說,假設 us-central1 區域中的自訂約期承諾 (example-commitment) 指定了四個 N1 vCPU 和 9 GB 記憶體。承諾使用合約的承諾使用方案為 12-month。這項承諾使用合約於 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"
}

後續步驟