コミットメントの統合と分割

プロジェクトのリソース要件を管理しやすくするために、Compute Engine では、既存のコミットメントを統合または分割し、プロジェクトに必要な粒度に合わせてリソースを再分配できます。

このドキュメントでは、コミットメントの統合と分割の利点とプロセス、制限事項と要件について説明します。

始める前に

まだ設定していない場合は、認証を設定します。認証とは、Google Cloud サービスと API にアクセスするために ID を確認するプロセスです。ローカル開発環境からコードまたはサンプルを実行するには、次のように Compute Engine に対する認証を行います。

このページのサンプルをどのように使うかに応じて、タブを選択してください。
コンソール

Google Cloud コンソールを使用して Google Cloud サービスと API にアクセスする場合、認証を設定する必要はありません。
gcloud
1. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. デフォルトのリージョンとゾーンを設定します。
REST

このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。

コミットメントの統合

複数の互換性のあるコミットメントを統合し、新しい大きなコミットメントを作成できます。コミットメントを統合することで、単一のエンティティとして追跡および管理できます。コミットメントを統合すると、個々のコミットメントが同時に期限切れになるように調整することで、コミットメントの有効期限がずれることを回避できます。統合すると、ワークロードを徐々に増やすこともできます。たとえば、必要に応じて新しい小規模なコミットメントを購入し、それらのコミットメントを統合するか、既存のコミットメントと統合するかを選択できます。

統合の仕組み

個々のコミットメント（ソースコミットメント）を統合すると、すべてのソースコミットメントを結合したリソースを使用して新しいコミットメント（統合コミットメント）が作成されます。米国とカナダの太平洋時間（UTC-8、夏時間期間中は UTC-7）の翌日の午前 12 時に、統合コミットメントが有効になり、ソースコミットメントがキャンセルされます。この有効化日が、統合コミットメントの開始日になり、統合オペレーションが終了します。

Compute Engine により、統合コミットメントの有効期限が、ソースコミットメントのうち最も遅い有効期限に設定されます。たとえば、2 つのソースコミットメントがあり、それぞれが 2023 年 1 月 1 日と 2023 年 12 月 1 日に期限切れになる場合、統合コミットメントは 2023 年 12 月 1 日に期限切れになります。

いずれかのソースコミットメントに予約が関連付けられている場合、予約は統合中に保持され、作成後に統合コミットメントに関連付けられます。予約が関連付けられたコミットメントについての詳細は、予約をリソースベースのコミットメントに関連付けるをご覧ください。

統合コミットメントの例

次の表は、2 つのコミットメント（source-commitment-1、source-commitment-2）が March 1, 2022 で 1 つのコミットメント（merged-commitment）に統合されるというシナリオでの、ソースコミットメントと統合コミットメントのプロパティを示しています。

	最初のソースコミットメント（統合前）	2 番目のソースコミットメント（統合前）	統合コミットメント
名前	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 日

^* すべてのコミットメントは、指定された開始日の米国およびカナダの太平洋標準時（UTC-8 または UTC-7）の午前 12 時に開始します。
^†すべてのコミットメントは、指定された終了日の米国およびカナダの太平洋標準時（UTC-8 または UTC-7）の午前 12 時に終了します。

料金への影響

コミットメント料金は、すべての確約済みリソースの割引価格の合計です。コミットメントを統合すると、統合コミットメントのリソースの割引料金は、統合コミットメントが有効になった日に変更される可能性があります。オンデマンド料金が変更されても、統合コミットメントの期間が終了するまで、リソースごとにこの新しい割引料金が適用されます。ただし、将来、このコミットメントを再度統合または分割すると、リソースの割引料金が再び変更される可能性があります。

制限事項

ライセンスコミットメントは統合できません。
統合コミットメントの作成時に、新しい予約を作成してこれらのコミットメントに関連付けることはできません。
期限切れのコミットメントやキャンセルされたコミットメントは統合できません。
デフォルトでは、統合コミットメントを作成すると、すべてのソースコミットメントが自動更新されるように設定されていても、新しいコミットメントに対する自動更新の設定が無効になります。統合コミットメントを自動的に更新する場合は、それらのコミットメントで自動更新の設定を手動で有効にする必要があります。これは、作成時または作成後に行うことができます。

要件

個々のソースコミットメントを統合して、新しい統合コミットメントを作成する場合、ソースコミットメントと統合コミットメントは次の要件を満たす必要があります。

ソースコミットメントのプロジェクト、リージョン、期間、コミットメントタイプ、コミットメントカテゴリは同じである必要があります。
新しい統合コミットメントには、ソースのコミットメントと同じプロジェクト、リージョン、期間、コミットメントタイプ、コミットメントカテゴリが必要です。ただし、統合コミットメントに新しい名前を付けることはできます。
統合コミットメントに指定するリソースタイプは、ソースコミットメントとまったく同じリソースタイプである必要があります。また、新しい統合コミットメントの各リソースタイプのリソース量は、すべてのソースコミットメントのそのリソースタイプのリソース量の合計と同じにする必要があります。たとえば、最初のソースコミットメントに 100 個の vCPU と 100 GB のメモリがあり、2 番目のソースコミットメントに 200 個の vCPU と 300 GB のメモリがある場合、300 個の vCPU と 400 GB のメモリがある統合コミットメントを作成する必要があります。
ソースコミットメントと統合コミットメントは、ハードウェアリソース（vCPU、メモリ、GPU、ローカル SSD ディスク）に関するものである必要があります。

統合コミットメントの作成

gcloud CLI または Compute Engine API を使用して、統合コミットメントを作成します。コミットメントを統合する前に、統合に関する制限事項を確認してください。

このタスクに必要な権限

このタスクを行うには、次の権限が必要です。

プロジェクトまたは組織に対する compute.commitments.create。

コンソール

Google Cloud コンソールで、コミットメントを統合するプロジェクトを選択し、[確約利用割引] ページに移動します。

[確約利用割引] ページに移動
一連のコミットメントの統合オペレーションを開始するには、[コミットメントリスト] ページの [ハードウェアのコミットメント] タブで、[統合] をクリックします。

または、統合するコミットメントをリストから選択し、[統合] をクリックします。
[統合] ページの [コミットメントを選択] タブで、次の操作を行います。
1. [統合するコミットメントの選択] で、リストから統合するコミットメントを選択します。[コミットメントリスト] ページでこれらのコミットメントをすでに選択している場合は、このタブで選択したコミットメントを確認します。
  
  省略可: 統合する個別のコミットメントを選択する前に、統合コミットメントに必要な [プラン]、[リージョン]、[コミットメントタイプ] の値を指定することもできます。これにより、コミットメントリストがフィルタリングされ、指定した属性に対して統合できるコミットメントのみが表示されます。
2. [次へ] をクリックします。[確認] タブが開きます。
[統合] ページの [確認] タブで、次の操作を行います。
1. 統合コミットメントの詳細を確認します。統合する個々のコミットメントのリストを変更するには、ウィンドウの左側にある [コミットメントを選択] タブを選択して、ステップ 3 を繰り返します。
2. [新しいコミットメント名] フィールドに、統合コミットメントの名前を入力します。
3. 省略可: 統合コミットメントで自動更新を有効にするには、[自動更新を有効にする] チェックボックスをオンにします。
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 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-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 マシンタイプのリソース
- storage-optimized-z3: Z3 マシンタイプのリソース
REGION: ソースコミットメントと同じリージョン。
PROJECT_ID: コミットメントを統合するプロジェクトのプロジェクト ID。
DURATION: ソースコミットメントと同じ期間（12-month または 36-month）。
MEMORY: ソースコミットメントのメモリ量の合計（MB または GB）。例: 1,000 MB。単位を指定しないと、デフォルトで GB が使用されます。
SOURCE_COMMITMENT_URLS: 個別のソースコミットメント URL のリストを指定します。各 URL はカンマで区切ります。URL の間に空白を追加しないでください。このリストには、ソースコミットメントの URL を 2 つ以上指定する必要があります。

たとえば、リージョン us-east1 に 2 つのソースコミットメントがあり、それぞれ（4 個の N2 vCPU と 2,048 MB）のリソースと、（3 個の N2 vCPU と 2,048 MB）のリソースがあるとします。ソースコミットメントの期間は 12 か月です。次の gcloud CLI コマンドは、2 つのコミットメントを結合し、7 個の N2 vCPU と 4,096 MB のリソース、期間を 12 か月として、merged-commitment という新しい統合コミットメントを作成します。

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

既存のコミットメントを 1 つのコミットメントに統合するには、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 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_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 マシンタイプのリソース
- STORAGE_OPTIMIZED_Z3: Z3 マシンタイプのリソース
DURATION: ソースコミットメントと同じ期間（TWELVE_MONTH または THIRTY_SIX_MONTH）。
COMMITMENT_NAME: 新しい統合コミットメントの名前。
NUMBER_VCPUS: ソースコミットメントの vCPU の数の合計。
MEMORY: ソースコミットメントのメモリ量の合計（MB）。例: 1,000 MB。単位を指定しないと、デフォルトで MB が使用されます。
SOURCE_COMMITMENT_URL: 統合するソースコミットメントの URL。個別のソースコミットメント URL のカンマ区切りリストを指定する必要があります。

たとえば、リージョン us-east1 に 2 つのソースコミットメント（source-commitment-1 と source-commitment-2）があり、それぞれ（4 個の N2 vCPU と 2,048 MB）のリソースと、（3 個の N2 vCPU と 2,048 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",
         ...
    ]
}

コミットメントを分割する

既存のコミットメントからリソースを転送し、小さなコミットメントに分割できます。分割すると、1 つの大きなコミットメントの一部を、小さな個々のコミットメントの形式で綿密にモニタリングおよび管理できます。たとえば、コミットメントを分割し、子コミットメントの 1 つのみに対して自動更新を有効にすることで、コミットメントの一部だけを自動的に更新するよう設定できます。分割では、分割コミットメントに優先アトリビューションを使用することで、より詳細に確約利用割引を分配することもできます。

分割の仕組み

既存のコミットメントを分割する（ソースコミットメント）場合、リソースをソースコミットメントから転送し、1 つ以上の新しいコミットメント（分割コミットメント）を作成して、移行したリソースを新しい分割されたコミットメント間で再分配します。新しい分割コミットメントの有効化とソースコミットメントのサイズ変更は、どちらも米国とカナダの太平洋時間（UTC-8、夏時間期間中は UTC-7）の翌日午前 12 時に行われます。 Compute Engine は、この有効化日を分割コミットメントの開始日として設定します。分割オペレーションが完了すると、次のコミットメントが作成されます。

分割後に残ったリソースを含むサイズ変更されたソースコミットメント。
新しく作成された分割コミットメントと再配布されたリソース。

ソースコミットメントはサイズが変更されますが、開始日や有効期限など、他のすべての属性が保持され、引き続き正常に動作します。分割コミットメントの有効期限は引き続きソースコミットメントと同じです。

Compute Engine API と gcloud CLI を使用して、新しい分割コミットメントを一度に 1 つだけ作成できます。Google Cloud コンソールを使用すると、1 回のオペレーションで複数の新しい分割コミットメントを作成できます。

予約が関連付けられているコミットメントは分割できません。予約が関連付けられたコミットメントについての詳細は、予約と確約利用割引の併用をご覧ください。

分割コミットメントの例

次の表は、既存のコミットメント（source-commitment）が 2022 年 3 月 1 日に 2 つの異なるコミットメント（サイズ変更された 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 日

料金への影響

コミットメント料金は、すべての確約済みリソースの割引価格の合計です。コミットメントを分割すると、リソースの費用に次のような影響があります。

サイズ変更されたソースコミットメント: サイズ変更されたソースコミットメントからリソースの割引料金は変わりません。
分割コミットメント: 新しい分割コミットメントのリソースの割引料金は、分割コミットメントが有効になった日に変わる場合があります。オンデマンド料金が変更されても、新しい分割コミットメントの期間が終了するまで、リソースごとにこの新しい割引料金が適用されます。

ただし、将来これらのコミットメントのいずれかを統合または分割すると、割引価格が再び変更される可能性があります。

制限事項

ライセンスコミットメントは分割できません。
予約が関連付けられているコミットメントは分割できません。そのため、GPU、ローカル SSD ディスク、またはこの両方を含むコミットメントは分割できません。これは、これらのリソースに対するコミットメントには常に予約が関連付けられているためです。
分割コミットメントの作成時に、新しい予約を作成してこれらのコミットメントに関連付けることはできません。
期限切れのコミットメントやキャンセルされたコミットメントは分割できません。
デフォルトでは、分割コミットメントを作成すると、すべてのソースコミットメントが自動更新されるように設定されていても、新しいコミットメントに対する自動更新の設定が無効になります。分割コミットメントを自動的に更新する場合は、それらのコミットメントで自動更新の設定を手動で有効にする必要があります。これは、作成時または作成後に行うことができます。
Compute Engine API または gcloud CLI を使用して一度に作成できる新しい分割コミットメントは 1 つだけです。

要件

ソースコミットメントを分割し、1 つ以上の分割されたコミットメントを作成する場合、ソースコミットメントと分割コミットメントは次の要件を満たしている必要があります。

新しい分割コミットメントには、ソースコミットメントと同じプロジェクト、コミットメントタイプ、リージョン、期間が必要です。ただし、分割コミットメントには新しい名前を選択する必要があります。
新しい分割コミットメントに指定するリソースタイプは、ソースコミットメントの一部またはすべてのリソースタイプと一致する必要があります。また、新しい分割コミットメントに指定するリソースの合計量は、ソースコミットメントのリソースの一部である必要があります。ソースコミットメントにはリソースの一部を保持する必要があります。たとえば、ソースコミットメントに 200 個の vCPU と 300 GB のメモリがあるとします。次のようなサイズ変更と再配布のシナリオが適用されます。
- 200 個の vCPU の一部と 300 GB のメモリの一部を、新しい分割コミットメントに再分配できます。
- 200 個の vCPU すべてを再分配できますが、ソースコミットメントにはメモリの一部を残しておく必要があります。
- 300 GB のメモリはすべて再分配できますが、ソースコミットメントには vCPU の一部を残しておく必要があります。
- 新しい分割コミットメントに 200 個の vCPU と 300 GB のメモリをすべて再分配することはできません。
ソースコミットメントと分割コミットメントは、ハードウェアリソース（vCPU、メモリ、GPU、またはこの両方）に関するものである必要があります。

また、Google Cloud CLI を使用してソースコミットメントを分割するには、Google Cloud CLI をバージョン 423.0.0 以降に更新します。以前の gcloud CLI バージョンを使用してソースコミットメントを分割しようとすると、分割オペレーションが失敗し、Compute Engine によってエラーがスローされます。

分割コミットメントの作成

gcloud CLI または Compute Engine API では、新しい分割コミットメントを一度に 1 つずつ作成します。複数の新しい分割コミットメントを一度に作成するには、Google Cloud コンソールを使用します。コミットメントを分割する前に、分割に関する制限事項を確認してください。

このタスクに必要な権限

このタスクを行うには、次の権限が必要です。

プロジェクトまたは組織に対する compute.commitments.create。

コンソール

Google Cloud コンソールで、コミットメントを分割するプロジェクトを選択し、[確約利用割引] ページに移動します。

[確約利用割引] ページに移動
コミットメントの分割オペレーションを開始するには、[コミットメントリスト] ページの [ハードウェアのコミットメント] タブで次のいずれかを行います。
- リストから分割するコミットメントを選択し、[分割] をクリックします。
- [名前] 列で、分割するコミットメントの名前をクリックします。[ハードウェアコミットメントの詳細] ページが表示されたら、[分割] をクリックします。
表示された [分割コミットメント] ページの [サイズ変更] タブで、次の操作を行います。
1. [vCPU] フィールドと [メモリ] フィールドに、元のコミットメントで保持する vCPU とメモリの数を指定します。残りのリソースは、分割コミットメントに再分配できます。サイズを変更したソースコミットメントを空にすることはできません。
2. [次へ] をクリックします。[再分配] タブが開きます。
[分割コミットメント] ページの [再分配] タブで、次の操作を行います。
1. [名前] フィールドに、分割コミットメントの名前を指定します。
2. [vCPU] フィールドと [メモリ] フィールドに、分割コミットメントに必要な vCPU とメモリの数を指定します。
  - 複数の分割コミットメントを作成する場合は、再分散するリソースの一部のみを指定します。
  - それ以外の場合は、再配布するすべてのリソースを指定します。
3. 省略可: 分割コミットメントで自動更新を有効にするには、[自動更新を有効にする] チェックボックスをオンにします。
4. [完了] をクリックします。
5. 省略可: 追加の分割コミットメントを作成するには、[項目を追加] をクリックして上記の手順を繰り返します。
6. [次へ] をクリックします。[確認] タブが開きます。
[分割コミットメント] ページの [確認] タブで、次の操作を行います。
1. サイズ変更されたコミットメントと分割コミットメントの詳細を確認します。
  - 元のコミットメントのリソース割り当てを変更するには、ウィンドウの左側にある [サイズ変更] タブを選択し、手順 3 を繰り返します。
  - 分割コミットメント間でリソースの再分配を変更するには、ウィンドウの左側にある [再分配] タブを選択して、手順 4 を繰り返します。
2. 利用規約を読みます。
3. 分割コミットメントの作成を完了して [コミットメントリスト] ページに戻るには、[送信] をクリックします。

gcloud

既存のコミットメントを 2 つのコミットメントに分割するには、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 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-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 マシンタイプのリソース
- storage-optimized-z3: Z3 マシンタイプのリソース
REGION: ソースコミットメントと同じリージョン。
PROJECT_ID: ソースコミットメントを分割するプロジェクトのプロジェクト ID。
DURATION: ソースコミットメントと同じ期間（12-month または 36-month）。
NUMBER_VCPUS: 新しい分割コミットメントを作成するために、ソースコミットメントから転送する vCPU の数。この値は、ソースコミットメントの vCPU の数よりも小さい整数にする必要があります。
MEMORY: 新しい分割コミットメントを作成するためにソースコミットメントから転送するメモリの量（MB または GB）。この量は、ソースコミットメントのメモリ量未満にする必要があります。例: 1,000 MB。単位を指定しないと、デフォルトで GB が使用されます。メモリは 0.25 GB 単位で購入できます。
SOURCE_COMMITMENT_URL: リソースを切り出すソースコミットメントの URL。

たとえば、リージョン us-east1 のソースコミットメント（source-commitment）に 3 個の N2 vCPU と 2,048 MB のメモリがあるとします。次の gcloud CLI コマンドは、次の方法でコミットメントを分割します。

source-commitment からリソースを取得し、1 個の N2 vCPU と 1,024 MB のメモリで新しいコミットメント split-commitment を作成します。
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

既存のコミットメントを 2 つのコミットメントに分割するには、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 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_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 マシンタイプのリソース
- STORAGE_OPTIMIZED_Z3: Z3 マシンタイプのリソース
DURATION: ソースコミットメントと同じ期間（TWELVE_MONTH または THIRTY_SIX_MONTH）。
NUMBER_VCPUS: 新しい分割コミットメントを作成するために、ソースコミットメントから転送する vCPU の数。この値は、ソースコミットメントの vCPU の数よりも小さい整数にする必要があります。
MEMORY: 新しい分割コミットメントを作成するためにソースコミットメントから転送するメモリの量（MB）。この量は、ソースコミットメントのメモリ量未満にする必要があります。例: 1,000 MB。単位を指定しないと、デフォルトで MB が使用されます。メモリは 0.25 GB 単位で購入できます。
SOURCE_COMMITMENT_URL: リソースの転送元となるソースコミットメントの URL。

たとえば、リージョン us-east1 のソースコミットメント（source-commitment）に 3 個の N2 vCPU と 2,048 MB のメモリがあるとします。次の POST リクエストは、次のようにコミットメントを分割します。

source-commitment からリソースを取得し、1 個の N2 vCPU と 1,024 MB のメモリで新しいコミットメント split-commitment を作成します。
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"
}

コミットメントの統合と分割

始める前に

コンソール

gcloud

REST

コミットメントの統合

統合の仕組み

統合コミットメントの例

料金への影響

制限事項

要件

統合コミットメントの作成

このタスクに必要な権限

コンソール

gcloud

API

コミットメントを分割する

分割の仕組み

分割コミットメントの例

料金への影響

制限事項

要件

分割コミットメントの作成

このタスクに必要な権限

コンソール

gcloud

API

次のステップ