確約利用期間を延長する

---

このドキュメントでは、Compute Engine ハードウェア リソースベースのコミットメントの期間を、事前設定の 1 年間または 3 年間のオプションを超えて延長する方法について説明します。

期間の延長を使用すると、事前設定の 1 年または 3 年を超えてコミットメントの期間を延長し、任意のカスタム期間（2 年、3.5 年、5.5 年など）を指定できます。コミットメントの期間を延長すると、リソース使用のニーズに合わせてコミットメントの長さを調整し、その長いカスタム期間に確約使用割引（CUD）を引き続き受け取ることができます。1 年間と 3 年間のコミットメントの期間は、次のように延長できます。

• 1 年間のコミットメント: 1 年より長く 3 年未満のカスタム期間を指定できます。
• 3 年間のコミットメント: 3 年より長く 6 年未満のカスタム期間を指定できます。

コミットメントを長期間有効に保つ方法については、次の代替方法をご覧ください。

• 1 年間のコミットメントがあり、期間を延長するだけでなく、割引率を変更する場合は、コミットメント期間をアップグレードします。
• コミットメントの期間を 1 つ以上の完全な期間延長する場合は、コミットメントで自動更新を有効にする。

期間の延長の仕組み

コミットメントの期間を延長し、カスタムの期間を設定するには、コミットメントの期間に任意の終了日を指定します。コミットメントはカスタム期間コミットメントになります。1 年間のコミットメントの場合、カスタムの終了日は、進行中の期間の開始日から 1 ～ 3 年（ただし 3 年ぴったりは不可）の範囲で指定できます。3 年間のコミットメントの場合、カスタムの終了日は、現在の期間の開始日から 3 ～ 6 年（ただし 6 年と指定することはできません）の範囲で指定できます。

新規コミットメントと既存コミットメントの両方で、次のように期間の延長を行うことができます。

• 新しいコミットメント: コミットメントの購入時にカスタムの終了日を指定できます。
• 既存のコミットメント: コミットメントが有効になったら、コミットメントのプロパティを更新してカスタムの終了日を指定または更新できます。

コミットメントの期間延長リクエストを送信すると、変更は米国とカナダの太平洋時間（UTC-8、夏時間中は UTC-7）の翌日の午前 0 時に有効になります。コミットメントは、新しいカスタム終了日まで有効なままとなり、その期間はそれに応じて調整されます。コミットメントの期間を延長しても、コミットメントの他のプロパティには影響しません。

• 名前
• 開始日
• リージョン
• プロジェクト
• コミットメント タイプ
• コミットメント プラン
• 自動更新のステータス
• 確約したリソース

コミットメントの期間を延長しても、そのコミットメントに対して受け取る CUD の割合は変わりません。

コミットメントに関連付けられている予約は、手動で置き換えない限り、延長された全期間にわたって存在し続けます。

期間延長の利用資格期間

コミットメントの期間が開始された後、期間の延長をリクエストできる期間は限られています。この期間は、学期延長の資格要件期間と呼ばれます。

プリセットとカスタムの両方の期間のコミットメントの場合、期間延長の利用資格期間は、コミットメントに対して最後に行ったオペレーションによって異なり、次のように動作します。

• 新しく購入したコミットメント: 1 年間のコミットメントの場合、コミットメントの有効化後 4 か月間、利用資格の取得期間が開いています。3 年間のコミットメントの場合、資格要件の適用期間はコミットメントの有効化から 1 年間です。

• 自動更新されるコミットメント: コミットメントが新しい期間に自動更新される場合、対象期間は更新された期間の開始時に更新されます。1 年間のコミットメントの場合、利用資格の取得期間は更新された期間の開始から最大 4 か月間続きます。3 年間のコミットメントの場合、資格要件の適用期間は、更新された期間の開始日から 1 年間まで続きます。

• 統合されたコミットメント: 利用資格期間が異なるコミットメントを統合する場合、統合されたコミットメントでは、最も早く終了する利用資格期間が使用されます。

• コミットメントの分割: コミットメントを分割しても、サイズ変更されたソース コミットメントと新しい分割コミットメントの両方で利用資格期間は変わりません。

• アップグレードされたコミットメント: 1 年間のコミットメントを 3 年間のコミットメントにアップグレードすると、Compute Engine はコミットメントの利用資格期間も更新します。更新された期間は、進行中の期間の開始日から最大 1 年間開いています。

  たとえば、1 年間のコミットメントの開始日が 2024 年 1 月 1 日の場合、最初の 1 年間の資格要件期間は 2024 年 5 月 1 日まで開いています。2024 年 4 月 1 日にこのコミットメントを 3 年間のコミットメントにアップグレードしたとします。期間の延長後、コミットメントの更新された利用資格期間は 2025 年 1 月 1 日まで開いています。

複数の期間延長を実行する

コミットメントの期間は、期間延長の対象期間内であれば何度でも延長できます。1 日に複数のアクティブなコミットメントに対して、翌日の米国およびカナダの太平洋時間（UTC-8 または UTC-7）の午前 0 時まで、期間延長リクエストを複数回行うことができます。ただし、毎回終了日を後日に指定する必要があります。ただし、1 日に 1 件のコミットメントに対して行う期間延長リクエストの数は最小限に抑えることをおすすめします。

特定の終了日までの期間の延長が有効になり、コミットメントに新しいカスタム終了日が設定された後、期間の延長を取り消したり、コミットメントの期間を短縮したりすることはできません。その後の延長オペレーションは、最後に指定した終了日より後の終了日に対してのみ実行できます。

保留中のコミットメント更新リクエストの影響

更新リクエストが保留中の既存の有効なコミットメントについては、保留中のリクエストが期間延長のリクエストである場合にのみ、新しい期間延長リクエストを送信できます。コミットメントに保留中の更新リクエスト（統合、分割、期間のアップグレード、自動更新設定の更新など）がある場合は、期間の延長をリクエストする前に、保留中のオペレーションが完了して更新が有効になるまで待つ必要があります。翌日の深夜 0 時に更新が有効になったら、そのコミットメントの期間延長をリクエストできます。

料金への影響

コミットメント料金は、すべての確約済みリソースの割引価格の合計です。コミットメントの期間を延長しても、オンデマンド料金が変更されても、リソースの割引料金はカスタム期間全体で変わりません。リソースの料金の詳細については、Compute Engine の料金をご覧ください。

注: コミットメントを統合または分割すると、コミットされたリソースまたは分割されたコミットメントが有効になった日に、コミットされたリソースの割引料金が変更されることがあります。

割り当てに関する考慮事項

コミットメントの購入時にカスタムの終了日を指定するには、コミットメントと commit 済みリソースの両方で使用可能な十分な割り当てが必要です。通常、既存のコミットメントにカスタムの終了日を指定するために、追加の割り当てをリクエストする必要はありません。

期間の延長が今後のコミットメント オペレーションに与える影響

コミットメントにカスタムの期間が設定されている場合、カスタムの期間のコミットメントに対してその後のコミットメント管理オペレーションを実行すると、カスタムの終了日と利用可能期間に影響する可能性があります。以降のセクションでは、他のコミットメント オペレーション中にカスタム期間コミットメントがどのように動作するかについて説明します。

カスタム期間のコミットメントの自動更新

自動更新コミットメントの更新期間は、コミットメントのプランで定義された事前設定の期間（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 日まで開いています。

コミットメントの自動更新の詳細については、コミットメントを自動的に更新するをご覧ください。

カスタム期間コミットメントの統合

カスタムの契約期間を持つコミットメントを統合する方法は、事前設定された契約期間を持つコミットメントを統合する場合と同じです。統合されたコミットメントは、次のプロパティを継承します。

• ソース コミットメントのうち、最も遅い終了日（カスタム終了日かどうかに関係なく）。
• ソース コミットメントのうち、最も早く終了する利用資格期間。

たとえば、2 つのカスタム期間 1 年のコミットメントを統合するとします。最初のコミットメントの開始日は 2024 年 1 月 1 日で、カスタムの終了日は 2025 年 6 月 30 日です。最初のコミットメントの利用期間は 2024 年 5 月 1 日までです。2 つ目のコミットメントの開始日は 2024 年 2 月 1 日、カスタムの終了日は 2025 年 7 月 30 日です。2 回目のコミットメントの対象期間は 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 日に、このコミットメントを 2 つの個別のコミットメントに分割したとします。新しく分割されたコミットメントは、2025 年 6 月 30 日のカスタム終了日を継承し、利用可能期間は 2024 年 5 月 1 日までとなります。

コミットメントの分割の詳細については、コミットメントの分割をご覧ください。

カスタム期間コミットメントのアップグレード

カスタムの期間の 1 年コミットメントのアップグレードは、事前設定された期間のコミットメントと同じように機能します。アップグレード後、Compute Engine はコミットメントの進行中の期間の終了日を 2 年間延長します。

たとえば、1 年間のコミットメントの開始日が 2024 年 1 月 1 日で、カスタムの終了日が 2025 年 6 月 30 日の場合、最初の 1 年間の資格要件期間は 2024 年 5 月 1 日まで開いています。2024 年 4 月 1 日にこのコミットメントを 3 年間のコミットメントにアップグレードしたとします。期間のアップグレード後、コミットメントは 3 年間のコミットメントになり、終了日は 2027 年 6 月 30 日になります。コミットメントの更新された利用資格期間は 2025 年 1 月 1 日まで開いています。また、3 年間のコミットメントに適用される CUD の割合も適用されます。

コミットメントのアップグレードの詳細については、コミットメント期間をアップグレードするをご覧ください。

制限事項

リソースベースのコミットメントの期間延長には、次の制限が適用されます。

• 延長できるのは、ハードウェア リソースのコミットメントの期間のみです。
• 無効なコミットメントや期限切れのコミットメントの期間を延長することはできません。
• 3 年間のコミットメントの期間を 3 年間延長することはできません。代わりに、コミットメントの自動更新を有効にすることを検討してください。
• カスタム期間のコミットメントは、コミットメント プランで定義されている事前設定の期間（1 年または 3 年）でのみ更新できます。
• 保留中のコミットメント更新リクエストがすでにある既存のアクティブなコミットメントについては、保留中のリクエストが期間延長のリクエストである場合にのみ、新しい期間延長リクエストを送信できます。コミットメントに他の保留中の更新リクエスト（統合、分割、期間のアップグレード、自動更新設定の更新など）がある場合は、期間の延長をリクエストするには、保留中のオペレーションが完了して更新が有効になるまで、翌日の深夜 0 時以降まで待つ必要があります。

要件

コミットメントの期間を延長するには、次の要件を満たす必要があります。

• 期間延長リクエストは、コミットメントの期間延長の対象期間中に行う必要があります。
• 1 年間のコミットメントの場合、カスタムの終了日は、現在の期間の開始日から 1 ～ 3 年後（ただし 3 年ちょうどは指定できません）にする必要があります。
• 3 年間のコミットメントの場合、カスタムの終了日は、現在の期間の開始日から 3 ～ 6 年後（ただし 6 年ちょうどは指定できません）にする必要があります。
• そのコミットメントに対して、他の進行中または保留中の統合、分割、アップグレード、更新オペレーションがないこと。

ベスト プラクティス

コミットメントの期間を延長する際は、次のベスト プラクティスに従うことをおすすめします。

• 期間延長リクエストを行う前に、保留中の他のすべてのコミットメント オペレーションが完了し、更新が有効になるまで待機します。
• 1 つのコミットメントに対して 1 日に行う期間延長リクエストの数を最小限に抑えます。

確約購入中に利用期間を延長する

コミットメントを購入するときに、カスタムの終了日を指定して、事前設定された 1 年または 3 年の期間を延長できます。

このタスクに必要な権限

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

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

購入時にコミットメントの期間を延長するには、次のいずれかのオプションを使用します。

コンソール

コミットメントを購入する前に、Google Cloud コンソールで、コミットメントの購入に使用するプロジェクトを選択します。Cloud 請求先アカウントで CUD の共有が有効になっている場合、その Cloud 請求先アカウントの任意のプロジェクトを使用してコミットメントを購入できます。

1. Google Cloud コンソールで [確約利用割引] ページに移動します。

   [確約利用割引] ページに移動

   [コミットメント リスト] ページが開き、[ハードウェア コミットメント] タブが表示されます。

2. [コミットメントを購入] をクリックします。

   [確約利用割引の購入] ページが開き、[ハードウェア] タブが表示されます。

3. [名前] フィールドに、コミットメントの名前を入力します。

4. [リージョン] フィールドで、Compute Engine リソースの購入を確約するリージョンを選択します。

5. [コミットメント タイプ] フィールドで、確約されたリソースのマシン ファミリー シリーズを選択します。 使用できるコミットメント タイプは次のとおりです。

   • アクセラレータ最適化 A2: A2 マシンタイプのリソース
   • アクセラレータ最適化 A3: A3 Edge マシンタイプと A3 High マシンタイプのリソース
   • アクセラレータ最適化 A3 Mega: A3 Mega マシンタイプのリソース
   • コンピューティング最適化 C2: C2 マシンタイプのリソース
   • コンピューティング最適化 C2D: C2D マシンタイプのリソース
   • コンピューティング最適化 H3: H3 マシンタイプのリソース
   • 汎用 C3: C3 マシンタイプのリソース
   • 汎用 C3D: C3D マシンタイプのリソース
   • 汎用 C4: C4 マシンタイプのリソース
   • 汎用 C4A: C4A マシンタイプのリソース
   • 汎用 E2: E2 マシンタイプのリソース
   • 汎用 N1: N1 マシンタイプのリソース
   • 汎用 N2: N2 マシンタイプのリソース
   • 汎用 N2D: N2D マシンリソース
   • 汎用 N4: N4 マシンタイプのリソース
   • 汎用 T2D: Tau T2D マシンタイプのリソース
   • グラフィック最適化 G2: G2 マシンタイプのリソース
   • メモリ最適化 M1 / M2: M1 マシンタイプまたは M2 マシンタイプのリソース
   • メモリ最適化 M3: M3 マシンタイプのリソース
   • ストレージ最適化 Z3: Z3 マシンタイプのリソース

6. [期間] セクションで、次の操作を行います。

   1. コミットメントの事前設定期間を指定するには、[1 年] または [3 年] を選択します。
   2. コミットメントのカスタム終了日を指定するには、[終了日を延長] 切り替えボタンをクリックし、[日付] フィールドにカスタム終了日を指定します。

7. [コア数] フィールドに、購入を確約する vCPU の数を入力します。

8. [メモリ] フィールドに、購入に確約するメモリ容量（GB）を入力します。

9. GPU の購入を確約するには、[GPU] セクションで [GPU を追加] をクリックし、次の操作を行います。

   1. [GPU のタイプ] フィールドで、GPU のタイプを選択します。
   2. [GPU の数] フィールドに、GPU の数を入力します。
   3. 省略可: GPU モデルがグラフィック ワークロード用の NVIDIA RTX 仮想ワークステーション（vWS）をサポートし、グラフィックを多用するワークロードを実行する予定がある場合は、[仮想ワークステーション（NVIDIA GRID）を有効にする] チェックボックスを選択します。

10. ローカル SSD ディスクの購入を確約するには、[ローカル SSD] セクションで [SSD を追加] をクリックし、[SSD の数] フィールドにディスクの数を指定します。

11. コミットメントで GPU またはローカル SSD ディスクを指定した場合は、次のいずれかの方法で、それらのリソースに一致する予約を関連付けます。アタッチする新しい予約ごとに、この手順を繰り返します。

    1. 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: リソースの購入にコミットするマシンシリーズ。次のオプションを使用できます。

  • accelerator-optimized: A2 マシンタイプのリソース
  • accelerator-optimized-a3: A3 Edge および 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 マシンタイプのリソース
  • storage-optimized-z3: Z3 マシンタイプのリソース

  --type フラグを指定しない場合、Compute Engine はデフォルト値として general-purpose を使用します。

• NUMBER_VCPUS: 購入にコミットする vCPU の数。

• MEMORY: 購入にコミットするメモリの量（MB または GB）。例: 1000MB または 100GB。単位を指定しない場合、Compute Engine はデフォルトの単位として GB を使用します。この値は 0.25 GB 単位で指定できます。

• CUSTOM_END_DATE: 任意の期間の終了日。YYYY-MM-DD の形式にする必要があります。たとえば、2024 年 4 月 20 日をカスタム終了日として指定するには、2024-04-20 という形式で指定します。

GPU、ローカル SSD ディスク、またはその両方のコミットメントを購入する際に有効期間を延長する方法の詳細な構文については、予約が関連付けられているコミットメントを購入するをご覧ください。

たとえば、us-central1 リージョンの 4 個の N1 vCPU と 9 GB のメモリに対する example-commitment という 1 年間のコミットメントについて考えてみましょう。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: リソースの購入にコミットするマシンシリーズ。次のオプションを使用できます。

  • ACCELERATOR_OPTIMIZED: A2 マシンタイプのリソース
  • ACCELERATOR_OPTIMIZED_A3: A3 Edge および 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 マシンタイプのリソース
  • STORAGE_OPTIMIZED_Z3: Z3 マシンタイプのリソース

• NUMBER_VCPUS: 購入にコミットする vCPU の数。

• MEMORY: 購入にコミットするメモリの量（MB）。例: 10240MB。この値は 256 MB 単位で指定できます。

• CUSTOM_END_DATE: 任意の期間の終了日。YYYY-MM-DD の形式にする必要があります。たとえば、2024 年 4 月 20 日をカスタム終了日として指定するには、2024-04-20 という形式で指定します。

• END_TIME: 米国およびカナダ太平洋標準時（UTC-8 または UTC-7）の午前 0 時（協定世界時（UTC）のオフセット）。次のいずれかの値を指定します。

  • 夏時間: 07:00:00
  • それ以外の時間: 08:00:00

GPU、ローカル SSD ディスク、またはその両方のコミットメントを購入する際に有効期間を延長する方法の詳細な構文については、予約が関連付けられているコミットメントを購入するをご覧ください。

たとえば、us-central1 リージョンの 4 個の N1 vCPU と 9 GB のメモリに対する example-commitment という 1 年間のコミットメントについて考えてみましょう。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 コンソールで [確約利用割引] ページに移動します。

   [確約利用割引] ページに移動

   [コミットメント リスト] ページが開き、[ハードウェア コミットメント] タブが表示されます。

2. コミットメントの期間延長オペレーションを開始するには、[ハードウェアのコミットメント] タブでアクティブなコミットメントを選択し、[延長] をクリックします。

   または、次の方法も可能です。

   1. [コミットメント リスト] ページの [ハードウェアのコミットメント] タブで、延長するアクティブなコミットメントの名前をクリックします。
   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: 米国およびカナダ太平洋標準時（UTC-8 または UTC-7）の午前 0 時（協定世界時（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",
}

次のステップ

• リソースベースのコミットメントを自動更新する方法を学習する。
• リソースベースのコミットメント期間をアップグレードする方法を学習する。
• リソースベースの確約利用割引の効果を分析する方法を学習する。