合併和拆分承諾使用合約

為協助您管理專案的資源需求，Compute Engine 可讓您合併或分割現有的承諾，並重新分配資源，以符合專案所需的精細程度。

本文說明合併和分割提交內容的優點和程序，以及適用的限制和規定。

事前準備

  • 如果尚未設定，請先設定驗證機制。驗證是指驗證身分，以便存取 Google Cloud 服務和 API 的程序。如要在本機開發環境中執行程式碼或範例，您可以選取下列任一選項，向 Compute Engine 進行驗證：

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. After installing the Google Cloud CLI, initialize it by running the following command: 

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    2. Set a default region and zone.

    REST

    To use the REST API samples on this page in a local development environment, you use the credentials you provide to the gcloud CLI.

      After installing the Google Cloud CLI, initialize it by running the following command: 

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    For more information, see Authenticate for using REST in the Google Cloud authentication documentation.

合併承諾使用合約

您可以合併多個相容的承諾，建立新的較大承諾。您可以將承諾合併在一起，以單一實體的形式進行追蹤及管理。合併承諾可讓個別承諾同時到期，避免承諾到期日錯開。合併後，您也可以逐步增加工作負載。舉例來說，您可以在需要時購買較新的小型承諾使用合約，並選擇將這些承諾使用合約合併，或與現有承諾使用合約合併。

合併的運作方式

合併個別承諾 (來源承諾) 時，您會使用所有來源承諾的合併資源建立新承諾 (合併承諾)。在隔天凌晨 12 點 (美國和加拿大太平洋時間，即 UTC-8，或日光節約時間實行期間則為 UTC-7)，合併的承諾使用量會開始生效，來源承諾使用量則會取消。這項啟用日期會成為合併承諾的開始日期，並結束合併作業。

此外，無論來源承諾是否設有預設期限或自訂期限，新建立的合併承諾都會繼承下列屬性：

  • 來源承諾中，最晚的結束日期。
  • 在來源承諾中，最早結束的期限延長資格時間範圍。

舉例來說，假設有兩個來源承諾，分別從 2020 年 1 月 1 日和 2020 年 12 月 1 日開始。這兩項承諾的截止日期分別為 2023 年 1 月 1 日和 2023 年 12 月 1 日。第一筆承諾的期限延長資格申請期間為 2020 年 5 月 1 日，第二筆承諾的期限延長資格申請期間為 2021 年 4 月 1 日。如果您在 2022 年 3 月 1 日合併這些承諾使用合約，合併後的承諾使用合約會繼承 2023 年 12 月 1 日的結束日期。合併承諾的期限延長資格期限已於 2020 年 5 月 1 日結束。

如果任何來源承諾都附有保留項目，則系統會在合併期間保留這些保留項目，並在建立合併後的承諾時附加這些保留項目。如要進一步瞭解附加預留項目的承諾使用合約，請參閱「將預留項目附加至依資源計算的承諾使用合約」。

合併承諾的範例

下表顯示在 March 1, 2022 上，兩個承諾 (source-commitment-1 和 source-commitment-2) 合併為單一承諾 (merged-commitment) 的情況下，來源和合併承諾的屬性：

第一個來源承諾
(在合併前)		 第二個來源承諾
(在合併前)		 合併承諾
名稱 source-commitment-1 source-commitment-2 merged-commitment
類型 N2 N2 N2
區域 us-central-1 us-central-1 us-central-1
資源
  • vCPU：100
  • 記憶體：100 GB
  • vCPU：200
  • 記憶體：300 GB
  • vCPU：300
  • 記憶體：400 GB
期限 3 年 3 年 3 年
開始日期* 2020 年 1 月 1 日 2020 年 12 月 1 日 2022 年 3 月 2 日
(合併後隔天)
結束日期† 2023 年 1 月 1 日 2023 年 12 月 1 日 2023 年 12 月 1 日
延長期限資格申請期間截止時間 2020 年 5 月 1 日 2021 年 4 月 1 日 2020 年 5 月 1 日

*所有承諾都會在指定的開始日期美國和加拿大太平洋時間 (UTC-8 或 UTC-7) 凌晨 12 點開始。
†所有承諾會在指定結束日期的美國和加拿大太平洋時間 (UTC-8 或 UTC-7) 凌晨 12 點到期。

定價影響

您的承諾使用費用是所有承諾資源折扣價格的總和。合併承諾使用合約後，合併後的承諾使用合約生效當天，合併後承諾資源的折扣價格可能會變更。即使以量計價價格有所變動，每項資源的新折扣價格仍會維持不變，直到合併承諾使用合約到期為止。不過，如果日後再次合併或分割此承諾使用合約，資源的折扣價格可能會再次變更。

限制

  • 您無法合併授權使用承諾。
  • 在建立合併承諾產品時，您無法建立任何新的保留項目，並將其附加至這些承諾產品。
  • 您無法合併已過期或取消的承諾使用合約。
  • 根據預設，建立合併的承諾後，即使所有來源承諾都已設為自動續約，新承諾的自動續約設定仍會停用。如果想讓合併的承諾自動續約，您必須手動為這些承諾啟用自動續約設定。您可以在建立時或建立後執行這項操作。

需求條件

當您合併個別來源承諾以建立新的合併承諾時，來源和合併承諾必須符合下列規定：

  • 來源承諾必須使用相同的專案、區域、時間長度 (或期限)、承諾類型和承諾類別。
  • 新的合併承諾必須與來源承諾使用相同的專案、區域、期限 (或期限)、承諾類型和承諾類別。不過，您可以為合併的承諾選擇新名稱。
  • 您為合併承諾指定的資源類型，必須與來源承諾中的資源類型完全相同。此外，新合併承諾使用合約中每種資源類型的資源數量，必須等於所有來源承諾使用合約中該資源類型的資源數量總和。舉例來說，如果第一個來源承諾有 100 個 vCPU 和 100 GB 記憶體，而第二個來源承諾有 200 個 vCPU 和 300 GB 記憶體，則您必須建立具有 300 個 vCPU 和 400 GB 記憶體的合併承諾。
  • 來源和合併的承諾必須是硬體資源 (vCPU、記憶體、GPU 和本機 SSD 磁碟)。

建立合併的承諾

使用 gcloud CLI 或 Compute Engine API 建立合併承諾。合併承諾之前，請先詳閱合併限制。

控制台

  1. 在 Google Cloud 控制台中，選取要合併承諾的專案，然後前往「Committed use discounts」(承諾使用折扣) 頁面。

    前往「承諾使用折扣」

  2. 如要針對一組承諾啟動合併作業，請在「承諾清單」頁面的「硬體承諾」分頁標籤中，按一下「合併」。

    或者，您也可以從清單中選取要合併的承諾，然後按一下「合併」。

  3. 在隨即開啟的「合併」頁面的「選擇承諾」分頁中，執行下列操作：

    1. 在「選擇要合併的承諾使用合約」下方，從清單中選取要合併的承諾使用合約。如果您已在「承諾清單」頁面中選取這些承諾，請在這裡確認所選承諾。

      選用：您也可以先指定要合併的承諾合約的方案、區域和承諾類型值，再選取要合併的個別承諾合約。這樣做可篩選承諾清單，只顯示您可以針對指定屬性合併的承諾。

    2. 點選「下一步」。系統會開啟「Review」分頁。

  4. 在「合併」頁面的「查看」分頁中，執行下列操作：

    1. 查看並確認合併承諾使用合約的詳細資料。如要修改要合併的個別承諾清單，請選取視窗左側的「選擇承諾」分頁，然後重複步驟 3。
    2. 在「New commitment name」欄位中，輸入合併的承諾名稱。
    3. 選用：如要為合併的承諾使用合約啟用自動續約功能，請選取「Enable auto renew」核取方塊。
    4. 詳閱條款及細則。
    5. 如要完成合併承諾書的建立作業，並返回「承諾書清單」頁面，請按一下「合併」。

gcloud

如要將現有承諾合併為單一承諾，請使用 gcloud compute commitments create 指令，並加上 --merge-source-commitment 標記。

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

更改下列內容：

  • COMMITMENT_NAME：新合併提交版本的名稱。
  • NUMBER_VCPUS：來源承諾中 vCPU 數量的總和。

  • 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-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-x4-16tb：X4 機器類型資源，適用於記憶體為 16 TB 的執行個體
    • memory-optimized-x4-24tb：X4 機器類型資源，適用於記憶體為 24 TB 的執行個體
    • memory-optimized-x4-32tb：適用於 X4 機器類型的資源，適用於記憶體為 32 TB 的執行個體
    • storage-optimized-z3：適用於 Z3 機器類型資源

  • REGION：與來源版本相同的區域。

  • PROJECT_ID：要合併承諾項目的專案 ID。

  • DURATION：與來源承諾相同的時間長度 (或期限)，可為 12-month 或 36-month。

  • MEMORY：來源承諾中記憶體的總量 (以 MB 或 GB 為單位)。例如 1000 MB。如未指定單位，系統預設使用的單位為 GB。

  • SOURCE_COMMITMENT_URLS：指定一組不同的來源承諾網址，並以半形逗號分隔各個網址。請勿在網址之間加入空白字元。在清單中，您必須指定至少兩個來源承諾網址。

舉例來說，請考慮 us-east1 地區中的兩個來源承諾，其資源分別為 (4 個 N2 vCPU 和 2048 MB) 和 (3 個 N2 vCPU 和 2048 MB)。每個來源承諾的期限為 12 個月。下列 gcloud CLI 指令會合併兩個承諾，並建立名為 merged-commitment 的新承諾，其資源為 7 個 N2 虛擬 CPU 和 4096 MB，期限為 12 個月：

gcloud compute commitments create merged-commitment \
    --plan=12-month \
    --project=myproject \
    --region=us-east1 \
    --type=general-purpose-n2 \
    --resources=vcpu=7,memory=4096MB \
     --merge-source-commitments=projects/myproject/regions/us-central1/commitments/source-commitment-1,projects/myproject/regions/us-central1/commitments/source-commitment-2

API

如要將現有承諾合併為單一承諾，請使用 regionCommitments.insert 方法。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments
{
  "name": COMMITMENT_NAME,
  "plan": DURATION,
  "type": COMMITMENT_TYPE,
  "region": REGION,
  "resources": [
    {
      "type": "vCPUs",
      "amount": NUMBER_VCPUS
    }
    {
      "type": "MEMORY",
      "amount": MEMORY
    }
  ],
  "mergeSourceCommitments": [SOURCE_COMMITMENT_URL ...]
}

更改下列內容：

  • PROJECT_ID：要合併承諾項目的專案 ID。
  • REGION：與來源版本相同的區域。

  • 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_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_X4_16TB：針對記憶體為 16 TB 的執行個體，提供 X4 機器類型資源
    • MEMORY_OPTIMIZED_X4_24TB：針對記憶體為 24 TB 的執行個體，提供 X4 機器類型資源
    • MEMORY_OPTIMIZED_X4_32TB：針對記憶體為 32 TB 的執行個體，提供 X4 機器類型資源
    • STORAGE_OPTIMIZED_Z3：適用於 Z3 機器類型資源

  • DURATION：與來源承諾相同的時間長度 (或期限)，可為 TWELVE_MONTH 或 THIRTY_SIX_MONTH。

  • COMMITMENT_NAME：新合併提交版本的名稱。

  • NUMBER_VCPUS：來源承諾中 vCPU 數量的總和。

  • MEMORY：來源承諾中記憶體的總量，以 MB 為單位。例如 1000 MB。如未指定單位，系統預設使用的單位為 MB。

  • SOURCE_COMMITMENT_URL：您要合併的來源版本網址。您必須指定以半形逗號分隔的清單，其中包含不同的來源承諾網址。

舉例來說，請考慮 us-east1 地區中的兩個來源承諾 (source-commitment-1 和 source-commitment-2)，其資源分別為 (4 個 N2 vCPU 和 2048 MB) 和 (3 個 N2 vCPU 和 2048 MB)。以下 POST 要求會將 source-commitment-1 和 source-commitment-2 合併為名為 merged-commitment 的單一承諾：

POST https://compute.googleapis.com/compute/v1/projects/myproject/regions/us-central1/commitments
{
  "name": "merged-commitment",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE_N2",
  "region": "us-east1",
   "resources": [
    {
      "type": "VCPU",
      "amount": "7"
    }
    {
      "type": "MEMORY",
      "amount": "4096"
    }
  ],
  "mergeSourceCommitments": [
         "projects/myproject/regions/us-central1/commitments/source-commitment-1",
         "projects/myproject/regions/us-central1/commitments/source-commitment-2",
         ...
    ]
}

拆分承諾使用合約

您可以將資源從現有承諾中轉移，並將承諾分割為較小的承諾。分割功能可讓您密切監控並管理單一大型承諾的部分，以較小的個別承諾形式呈現。舉例來說，您可以將承諾分割成幾部分，然後只為其中一個子承諾啟用自動續約功能，讓該部分自動續約。透過分割功能，您也可以針對分割的承諾使用優先歸因，以更精細的方式分配承諾使用折扣。

分割的運作方式

分割現有承諾 (來源承諾) 時，您會將資源從來源承諾中轉移，建立一或多個新承諾 (分割承諾)，然後在新的分割承諾中重新分配轉移的資源。新的分割承諾啟用作業和來源承諾調整作業，都會在隔天凌晨 12 點 (美國和加拿大太平洋時間，即 UTC-8，或日光節約時間實行期間則為 UTC-7) 執行。Compute Engine 會將這天設為分割承諾的開始日期。分割作業完成後，您必須遵守下列承諾：

  • 已調整大小的來源承諾，以及分割後剩餘的資源。
  • 新建立的分割承諾使用合約，以及重新分配的資源。

來源承諾雖然會調整大小，但會保留所有其他屬性 (包括開始和結束日期)，並繼續正常運作。分割的承諾使用合約會保留與來源承諾使用合約相同的結束日期和期限延長資格時間窗口。

使用 Compute Engine API 和 gcloud CLI 時，一次只能建立一個新的分割承諾。您可以使用 Google Cloud 控制台在單一作業中建立多個新的分割承諾。

您無法將附加保留項目的承諾分割。如要進一步瞭解附加保留項目的承諾，請參閱合併使用保留項目與承諾使用折扣。

分割承諾範例

下表列出當現有承諾 (source-commitment) 在 2022 年 3 月 1 日分割為兩個不同的承諾 (調整大小的 source-commitment 和 split-commitment) 時，承諾的屬性：

來源承諾
(拆分前)		 拆分承諾使用合約 來源承諾
(分割後)
名稱 source-commitment split-commitment source-commitment
類型 N2 N2 N2
區域 us-central-1 us-central-1 us-central-1
資源
  • vCPU：200
  • 記憶體：200 GB
  • vCPU：50
  • 記憶體：100 GB
  • vCPU：150
  • 記憶體：100 GB
期限 3 年 3 年 3 年
開始日期* 2020 年 1 月 1 日 2022 年 3 月 2 日
(分割後的隔天)		 2020 年 1 月 1 日
結束日期† 2023 年 1 月 1 日 2023 年 1 月 1 日 2023 年 1 月 1 日
延長期限資格申請期間截止時間 2021 年 1 月 1 日 2021 年 1 月 1 日 2021 年 1 月 1 日

*所有承諾都會在指定的開始日期美國和加拿大太平洋時間 (UTC-8 或 UTC-7) 凌晨 12 點開始。
†所有承諾會在指定結束日期的美國和加拿大太平洋時間 (UTC-8 或 UTC-7) 凌晨 12 點到期。

定價影響

您的承諾使用費用是所有承諾資源折扣價格的總和。將承諾使用量拆分後，資源費用會受到以下影響：

  • 已調整大小的來源承諾使用合約：從已調整大小的來源承諾使用合約取得的資源折扣價格維持不變。
  • 分割承諾：新分割承諾的資源折扣價格，可能會在分割承諾生效當天變更。即使以量計價價格有所變動，每項資源的新折扣價格仍會維持不變，直到新的分割承諾合約到期為止。

不過，如果日後再次合併或分割這兩種承諾使用合約，折扣價格可能又會變更。

限制

  • 您無法分割授權使用承諾。
  • 您無法分割附加保留項目的承諾使用合約。因此，您無法分割含有 GPU、本機 SSD 磁碟或兩者的承諾，因為含有這些資源的承諾總是會附加保留項目。
  • 建立分割承諾產品時，您無法建立任何新預訂並附加至這些承諾。
  • 您無法分割已過期或取消的承諾使用合約。
  • 根據預設，建立分割承諾時，即使所有來源承諾都已設為自動續約，新承諾的自動續約設定仍會停用。如果您希望分割承諾自動續約，請務必手動啟用這些承諾的自動續約設定。您可以在建立時或建立後執行這項操作。
  • 您一次只能使用 Compute Engine API 或 gcloud CLI 建立一個新的分割承諾。

需求條件

當您分割來源承諾並建立一或多個分割承諾時，來源和分割承諾必須符合下列規定：

  • 新的分割承諾使用合約必須與來源承諾使用合約具有相同的專案、承諾類型、區域和時間長度 (或期限)。不過，您必須為分割承諾選擇新名稱。
  • 您為新分割承諾指定的資源類型，必須與來源承諾中的部分或所有資源類型相符。此外，您為新分割承諾指定的資源總量，必須是來源承諾中資源的一部分。您必須保留部分來源承諾中的資源。舉例來說，假設您原先的承諾資源為 200 個 vCPU 和 300 GB 記憶體，則下列調整大小和重新分配情境適用：
    • 您可以在新的分割承諾中重新分配部分 200 個 vCPU 和 300 GB 記憶體。
    • 您可以重新分配所有 200 個 vCPU，但必須保留來源承諾中的部分記憶體。
    • 您可以重新分配所有 300 GB 記憶體，但必須保留部分來源承諾中的 vCPU。
    • 您無法將所有 200 個 vCPU 和 300 GB 記憶體重新分配至新的分割承諾
  • 來源和分割承諾必須是 vCPU、記憶體或兩者組合的硬體資源。

此外，如要使用 Google Cloud CLI 分割來源承諾，請將 Google Cloud CLI 更新至 423.0.0 以上版本。如果您嘗試使用舊版 gcloud CLI 分割來源承諾，分割作業會失敗，且 Compute Engine 會擲回錯誤。

建立分割承諾

使用 gcloud CLI 或 Compute Engine API 一次建立一個新的分割承諾。您可以使用 Google Cloud 控制台一次建立多個新的分割承諾。在分割承諾前，請先詳閱分割限制。

控制台

  1. 在 Google Cloud 控制台中，選取要分割承諾的專案，然後前往「Committed use discounts」(承諾使用折扣) 頁面。

    前往「承諾使用折扣」

  2. 如要啟動分割承諾作業，請在「承諾清單」頁面的「硬體承諾」分頁中執行下列任一操作：

    • 從清單中選取要分割的承諾，然後按一下「分割」。
    • 在「名稱」欄中，按一下要分割的承諾名稱。在隨即開啟的「硬體承諾詳細資料」頁面中，按一下「分割」。

  3. 在隨即開啟的「Split commitment」頁面中，點選「Resize」分頁，然後執行下列操作：

    1. 在「vCPU」和「記憶體」欄位中，指定您要在原始承諾中保留的 vCPU 數量和記憶體。剩餘的資源可重新分配給分割承諾。調整大小後，來源承諾不得為空白。
    2. 點選「下一步」。系統會開啟「重新發布」分頁。

  4. 在「Split commitment」頁面的「Redistribute」分頁中，執行下列操作：

    1. 在「名稱」欄位中，指定分割承諾的名稱。
    2. 在「vCPU」和「記憶體」欄位中，指定您在分割承諾中想要的 vCPU 數量和記憶體。
      • 如要建立多個分割承諾，請只指定部分重新分配的資源。
      • 否則，請指定所有重新散發的資源。
    3. 選用：如要為分割承諾使用合約啟用自動續約功能，請勾選「Enable auto renew」(啟用自動續約) 核取方塊。
    4. 按一下 [完成]。
    5. 選用步驟：如要建立其他分割承諾，請按一下「Add an item」(新增項目)，然後重複上述步驟。
    6. 點選「下一步」。系統會開啟「Review」分頁。

  5. 在「Split commitment」頁面的「Review」分頁中，執行下列操作：

    1. 請詳閱並確認調整後的承諾使用合約和拆分承諾使用合約的詳細資料。
      • 如要修改原始承諾的資源分配，請選取視窗左側的「Resize」分頁，然後重複步驟 3。
      • 如要修改分割承諾中的資源重新分配，請選取視窗左側的「Redistribute」分頁標籤，然後重複步驟 4。
    2. 詳閱條款及細則。
    3. 如要完成建立分割承諾並返回「承諾清單」頁面，請按一下「提交」。

gcloud

如要將現有承諾分割為兩個承諾，請使用 gcloud compute commitments create 指令，並加上 --split-source-commitment 標記。

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

更改下列內容：

  • COMMITMENT_NAME：新分割承諾的名稱。

  • 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-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-x4-16tb：X4 機器類型資源，適用於記憶體為 16 TB 的執行個體
    • memory-optimized-x4-24tb：X4 機器類型資源，適用於記憶體為 24 TB 的執行個體
    • memory-optimized-x4-32tb：適用於 X4 機器類型的資源，適用於記憶體為 32 TB 的執行個體
    • storage-optimized-z3：適用於 Z3 機器類型資源

  • REGION：與來源承諾相同的區域。

  • PROJECT_ID：您要分割來源承諾的專案 ID。

  • DURATION：與來源承諾相同的時間長度 (或期限)，可為 12-month 或 36-month。

  • NUMBER_VCPUS：您要從來源承諾中轉移的 vCPU 數量，以建立新的分割承諾。這個數字必須是整數，且小於來源承諾中的 vCPU 數量。

  • MEMORY：您要從來源承諾中轉移的記憶體量，以建立新的分割承諾，單位為 MB 或 GB。該值必須小於來源承諾中的記憶體量。例如 1000 MB。如未指定單位，系統預設使用的單位為 GB。記憶體的購買單位為 0.25 GB。

  • SOURCE_COMMITMENT_URL：您要從中劃分資源的來源承諾網址。

舉例來說，假設在 us-east1 地區中，有個來源承諾 (source-commitment) 包含 3 個 N2 vCPU 和 2048 MB 記憶體。下列 gcloud CLI 指令會透過以下方式分割承諾：

  • 從 source-commitment 取得資源，並建立新的承諾 split-commitment，其中包含 1 個 N2 vCPU 和 1024 MB 記憶體。
  • 將 source-commitment 的大小調整為其餘資源。
gcloud compute commitments create split-commitment \
    --plan=12-month \
    --type=general-purpose-n2 \
    --region=us-east1 \
    --project=myproject \
    --resources vcpu=1,memory=1024MB \
    --split-source-commitment=projects/myproject/regions/us-central1/commitments/source-commitment

API

如要將現有承諾分割為兩個承諾，請使用 regionCommitments.insert 方法。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments
{
  "name": COMMITMENT_NAME,
  "plan": DURATION,
  "type": COMMITMENT_TYPE,
  "region": REGION,
  "resources": [
    {
      "type": "vCPUs",
      "amount": NUMBER_VCPUS
    }
    {
      "type": "MEMORY",
      "amount": MEMORY
    }
  ],
  "splitSourceCommitment": SOURCE_COMMITMENT_URL
}

更改下列內容：

  • PROJECT_ID：您要分割來源承諾的專案 ID。
  • REGION：與來源承諾相同的區域。
  • COMMITMENT_NAME：新分割承諾的名稱。

  • 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_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_X4_16TB：針對記憶體為 16 TB 的執行個體，提供 X4 機器類型資源
    • MEMORY_OPTIMIZED_X4_24TB：針對記憶體為 24 TB 的執行個體，提供 X4 機器類型資源
    • MEMORY_OPTIMIZED_X4_32TB：針對記憶體為 32 TB 的執行個體，提供 X4 機器類型資源
    • STORAGE_OPTIMIZED_Z3：適用於 Z3 機器類型資源

  • DURATION：與來源承諾相同的時間長度 (或期限)，可為 TWELVE_MONTH 或 THIRTY_SIX_MONTH。

  • NUMBER_VCPUS：您要從來源承諾中轉移的 vCPU 數量，以建立新的分割承諾。這個數字必須是整數，且小於來源承諾中的 vCPU 數量。

  • MEMORY：您要從來源承諾中轉移的記憶體量，以建立新的分割承諾，單位為 MB。該值必須小於來源承諾中的記憶體量。例如 1000 MB。如未指定單位，系統預設使用的單位為 MB。記憶體的購買單位為 0.25 GB。

  • SOURCE_COMMITMENT_URL：您要從中轉移資源的來源承諾網址。

舉例來說，假設在 us-east1 地區有個來源承諾 (source-commitment)，其中有 3 個 N2 vCPU 和 2048 MB 記憶體。下列 POST 要求會透過以下方式分割承諾：

  • 從 source-commitment 取得資源，並建立新的承諾 split-commitment，其中包含 1 個 N2 vCPU 和 1024 MB 記憶體。
  • 將 source-commitment 的大小調整為其餘資源。
POST https://compute.googleapis.com/compute/v1/projects/myproject/regions/us-central1/commitments
{
  "name": "split-commitment",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE_N2",
  "region": "us-east1",
  "resources": [
    {
      "type": "VCPU",
      "amount": "1"
    }
    {
      "type": "MEMORY",
      "amount": "1024"
    }
  ],
  "splitSourceCommitment": "projects/myproject/regions/us-central1/commitments/source-commitment"
}

後續步驟