予約と確約利用割引を組み合わせる

コンソール

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

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

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

2. [add_boxコミットメントを購入] をクリックして、新しいコミットメントを購入します。[確約利用割引の購入] ページが開き、[ハードウェア] タブが表示されます。

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

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

5. [コミットメント タイプ] フィールドで、確約されたリソースのマシン ファミリー シリーズを選択します。 次のコミットメントのタイプでは、GPU、ローカル SSD ディスク、またはその両方を使用できます。

   • アクセラレータ最適化 A2: A2 マシンタイプのリソース
   • アクセラレータ最適化 A3: A3 Edge マシンタイプと A3 High マシンタイプのリソース
   • アクセラレータ最適化 A3 Mega: A3 Mega マシンタイプのリソース
   • コンピューティング最適化 C2: C2 マシンタイプのリソース
   • コンピューティング最適化 C2D: C2D マシンタイプのリソース
   • 汎用 C3: C3 マシンタイプのリソース
   • 汎用 C3D: C3D マシンタイプのリソース
   • 汎用 N1: N1 マシンタイプのリソース
   • 汎用 N2: N2 マシンタイプのリソース
   • 汎用 N2D: N2D マシンリソース
   • グラフィック最適化 G2: G2 マシンタイプのリソース
   • メモリ最適化 M3: M3 マシンタイプのリソース
   • ストレージ最適化 Z3: Z3 マシンタイプのリソース

6. [期間] で、次の操作を行います。

   1. コミットメントのプランを指定するには、[1 年] または [3 年] を選択します。この設定により、コミットメントの既定期間が決まります。

   2. 省略可。コミットメントのカスタムの期間を指定するには、[終了日を延長] 切り替えボタンをクリックし、[日付] フィールドでカスタムの終了日を指定します。詳細については、コミットメントの期間を延長するをご覧ください。

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

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

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

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

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

11. 1 つ以上の既存の予約をコミットメントに関連付けるには、[予約] フィールドで [既存の予約を関連付ける] を選択します。

    Google Cloud コンソールに、プロジェクト内でリージョン、マシンタイプ、GPU タイプがコミットメントと一致する予約のリストが表示されます。次に、以下の操作を行います。

    1. 省略可。特定のプロパティの予約を表示するには、[フィルタ] メニューで、目的のプロパティのフィルタを追加または削除します。
    2. コミットメントに関連付ける予約をすべて選択します。

12. 予約を関連付けてコミットメントの購入を完了するには、次の操作を行います。

    1. [購入] をクリックします。
    2. [確約利用割引の購入] ダイアログで、サービス固有の利用規約に同意する場合は、もう一度 [購入] をクリックします。

gcloud

既存の予約を関連付けてコミットメントを購入するには、gcloud compute commitments create コマンドを実行します。コマンドに --existing-reservation フラグを指定して、コミットメントに関連付ける既存の予約を指定します。関連付ける予約ごとに、このフラグの新しいインスタンスを追加します。コミットメントには任意の数の既存の予約を関連付けることができます。

たとえば、2 つの予約をコミットメントに関連付けるには、次のコマンドを実行します。

gcloud compute commitments create COMMITMENT_NAME \
    --region=REGION \
    --project=PROJECT_ID \
    --resources=vcpu=COMMITTED_VCPUS,memory=COMMITTED_MEMORY,local-ssd=COMMITTED_LOCAL_SSD \
    --resources-accelerator=count=COMMITTED_ACCELERATOR_COUNT,type=COMMITTED_ACCELERATOR_TYPE \
    --plan=DURATION \
    --type=COMMITMENT_TYPE \
    --custom-end-time=CUSTOM_END_DATE \
    --existing-reservation=name='RESERVATION_NAME_1',zone='RESERVATION_ZONE_1' \
    --existing-reservation=name='RESERVATION_NAME_2',zone='RESERVATION_ZONE_2'

次のように置き換えます。

• COMMITMENT_NAME: コミットメントの名前。
• REGION: コミットメントのリージョン。
• PROJECT_ID: 予約が関連付けられているコミットメントを購入するプロジェクトの ID。
• DURATION: コミットメントの期間（12-month または 36-month）。
• CUSTOM_END_DATE: 省略可。期間のカスタム終了日。形式は YYYY-MM-DD にする必要があります。たとえば、2024 年 4 月 20 日をカスタム終了日として指定するには、2024-04-20 という形式で指定します。

• COMMITMENT_TYPE: コミットメントのタイプ。次のコミットメントのタイプでは、GPU、ローカル SSD ディスク、またはその両方を使用できます。

  • 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 マシンタイプのリソース
  • general-purpose: N1 マシンタイプのリソース
  • general-purpose-n2: N2 マシンタイプのリソース
  • general-purpose-n2d: N2D マシンリソース
  • graphics-optimized: G2 マシンタイプ リソース
  • memory-optimized-m3: M3 マシンタイプのリソース
  • storage-optimized-z3: Z3 マシンタイプのリソース

• COMMITTED_VCPUS: コミットメントに必要な vCPU の数。数値には任意の正の整数を指定できます。

• COMMITTED_MEMORY: コミットメントに必要なメモリの量（MB または GB）。たとえば、10240MB や、10GB などです。単位を指定しない場合、Compute Engine は単位として GB を使用します。メモリは 0.25 GB 単位で購入できます。

• COMMITTED_LOCAL_SSD: コミットメントに必要なローカル SSD 容量の容量（GB）。各ローカル SSD ディスクは 375 GB です。

• COMMITTED_ACCELERATOR_COUNT: コミットメントで必要な GPU の数。

• COMMITTED_ACCELERATOR_TYPE: コミットメントに必要な GPU タイプ。

• RESERVATION_NAME_1、RESERVATION_NAME_2: コミットメントに関連付ける既存の予約の名前。

• RESERVATION_ZONE_1、RESERVATION_ZONE_2: コミットメントに関連付ける既存の予約のゾーン。

例: 既存の予約を関連付けてコミットメントを購入する

プロジェクト myproject の us-central1-a ゾーンと us-central1-b ゾーンに、res-01 と res-02 の 2 つの予約があるとします。これらの予約で 4 個の NVIDIA P100 GPU と 4 個のローカル SSD ディスクの合計容量が指定されているとします。このプロジェクトの us-central1 リージョンでこれらの GPU とローカル SSD ディスクの新しいコミットメントを購入し、これらの既存の予約を関連付けられた予約として使用するには、次のコマンドを実行します。サンプルのコミットメントには vCPU とメモリも含まれます。

gcloud compute commitments create commitment-01 \
    --region=us-central1 \
    --project=myproject \
    --resources=vcpu=96,memory=624GB,local-ssd=1500 \
    --resources-accelerator=type=nvidia-tesla-p100,count=4 \
    --plan 12-month \
    --existing-reservation=name=res-01,zone=us-central1-a \
    --existing-reservation=name=res-02,zone=us-central1-b
    

REST

既存の予約を関連付けてコミットメントを購入するには、regionCommitments.insert メソッドに POST リクエストを送信します。リクエストに existingReservations フィールドを含めて、コミットメントに関連付ける既存の予約をカンマ区切りのリストで指定します。コミットメントには任意の数の既存の予約を関連付けることができます。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments

{
  "name": "COMMITMENT_NAME",
  "plan": "DURATION",
  "type": COMMITMENT_TYPE,
  "resources":
  [
    {
      "amount": "COMMITTED_VCPUS",
      "type": "VCPU"
    },
    {
      "amount": "COMMITTED_MEMORY",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "COMMITTED_ACCELERATOR_TYPE",
      "amount": "COMMITTED_ACCELERATOR_COUNT",
      "type": "ACCELERATOR"
    }
    {
      "amount": "COMMITTED_LOCAL_SSD",
      "type": "LOCAL_SSD"
    }
  ],
  "customEndTimestamp": "CUSTOM_END_DATETEND_TIMEZ",
  "existingReservations": "RESERVATION_URLs"
}

次のように置き換えます。

• COMMITMENT_NAME: コミットメントの名前。
• REGION: コミットメントのリージョン。
• PROJECT_ID: 予約が関連付けられているコミットメントを購入するプロジェクトの ID。
• DURATION: コミットメントの期間（TWELVE_MONTH または THIRTY_SIX_MONTH）。

• COMMITMENT_TYPE: コミットメントのタイプ。次のコミットメントのタイプでは、GPU、ローカル SSD ディスク、またはその両方を使用できます。

  • 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 マシンタイプのリソース
  • GENERAL_PURPOSE: N1 マシンタイプのリソース
  • GENERAL_PURPOSE_N2: N2 マシンタイプのリソース
  • GENERAL_PURPOSE_N2D: N2D マシンリソース
  • GRAPHICS_OPTIMIZED: G2 マシンタイプ リソース
  • MEMORY_OPTIMIZED_M3: M3 マシンタイプのリソース
  • STORAGE_OPTIMIZED_Z3: Z3 マシンタイプのリソース

• COMMITTED_VCPUS: コミットメントに必要な vCPU の数。数値には任意の正の整数を指定できます。

• COMMITTED_MEMORY: コミットメントに必要なメモリ量（MB）。たとえば、10240MB のようにします。メモリは 256 MB 単位で購入できます。

• COMMITTED_LOCAL_SSD: コミットメントに必要なローカル SSD ストレージの量（GB）。各ローカル SSD ディスクは 375 GB です。

• COMMITTED_ACCELERATOR_COUNT: コミットメントで必要な GPU の数。

• COMMITTED_ACCELERATOR_TYPE: コミットメントに必要な GPU タイプ。

• 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

• RESERVATION_URLs: コミットメントに関連付ける既存の予約の URL のカンマ区切りリスト。たとえば、res-1 と res-2 の 2 つの予約を関連付けるには、次のように指定します。

  "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/example-res-1",
  "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-c/reservations/example-res-2"
  

例: 既存の予約を関連付けてコミットメントを購入する

プロジェクト myproject の us-central1-a ゾーンと us-central1-b ゾーンに、res-01 と res-02 の 2 つの予約があるとします。これらの予約で 4 個の NVIDIA P100 GPU と 4 個のローカル SSD ディスクの合計容量が指定されているとします。このプロジェクトの us-central1 リージョンでこれらの GPU とローカル SSD ディスクの新しいコミットメントを購入し、これらの既存の予約を関連付けられた予約として使用するには、次の POST リクエストを送信します。サンプルのコミットメントには vCPU とメモリも含まれます。

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments

{
  "name": "commitment-01",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE"
  "resources":
  [
    {
      "amount": "96",
      "type": "VCPU"
    },
    {
      "amount": "638976",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "nvidia-tesla-p100",
      "amount": "4",
      "type": "ACCELERATOR"
    },
    {
      "amount": "1536000",
      "type": "LOCAL_SSD"
    }
  ],
  "existingReservations":
  [
    "https://www.googleapis.com/compute/v1/projects/my-project/zone/us-central1-a/reservations/res-01",
    "https://www.googleapis.com/compute/v1/projects/my-project/zone/us-central1-b/reservations/res-02"
  ]
}

コンソール

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

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

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

2. [add_boxコミットメントを購入] をクリックして、新しいコミットメントを購入します。[確約利用割引の購入] ページが開き、[ハードウェア] タブが表示されます。

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

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

5. [コミットメント タイプ] フィールドで、確約されたリソースのマシン ファミリー シリーズを選択します。 次のコミットメントのタイプでは、GPU、ローカル SSD ディスク、またはその両方を使用できます。

   • アクセラレータ最適化 A2: A2 マシンタイプのリソース
   • アクセラレータ最適化 A3: A3 Edge マシンタイプと A3 High マシンタイプのリソース
   • アクセラレータ最適化 A3 Mega: A3 Mega マシンタイプのリソース
   • コンピューティング最適化 C2: C2 マシンタイプのリソース
   • コンピューティング最適化 C2D: C2D マシンタイプのリソース
   • 汎用 C3: C3 マシンタイプのリソース
   • 汎用 C3D: C3D マシンタイプのリソース
   • 汎用 N1: N1 マシンタイプのリソース
   • 汎用 N2: N2 マシンタイプのリソース
   • 汎用 N2D: N2D マシンリソース
   • グラフィック最適化 G2: G2 マシンタイプのリソース
   • メモリ最適化 M3: M3 マシンタイプのリソース
   • ストレージ最適化 Z3: Z3 マシンタイプのリソース

6. [期間] で、コミットメントの期間として [1 年] または [3 年] を選択します。

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

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

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

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

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

11. 新しい予約を作成してコミットメントに関連付けるには、[予約] フィールドで [予約を作成する] を選択し、次の操作を行います。作成して関連付ける新しい予約ごとに、この手順を繰り返します。

    1. [予約を追加] をクリックします。[新規予約] セクションが表示されます。
    2. [名前] フィールドに、関連付ける予約の名前を入力します。
    3. [リージョン] フィールドで、コミットメントと同じリージョンを選択します。
    4. [ゾーン] フィールドで、リソースを予約するゾーンを選択します。

    5. [共有タイプ] セクションで、次のいずれかの方法でこの予約を共有する方法を指定します。

       • 単一プロジェクトの予約を作成するには、[ローカル] を選択します。
       • 複数のプロジェクトで共有される予約を作成するには、[共有] を選択します。次に、この予約を共有するプロジェクトを指定するには、[add プロジェクトを追加] をクリックし、現在のプロジェクトの組織から必要なプロジェクトを選択します。

    6. [VM インスタンスでの使用] フィールドで、VM が予約を消費する方法を選択します（次のいずれかの方法を選択します）。

       • 一致するプロパティを持つ VM がこの予約を自動的に使用できるようにするには、[予約を自動的に使用する] をクリックします（デフォルト）。
       • この予約の名前と一致するプロパティを持つ VM を作成する場合にのみ、この予約のリソースを使用するには、[特定の予約を選択する] を選択します。

    7. [リソースの詳細] セクションで、次の操作を行います。

       1. [VM インスタンスの数] フィールドに、予約する VM インスタンスの数を入力します。

       2. [マシンの構成] セクションで、次のいずれかの方法で予約 VM のプロパティを指定します。

          1. 既存のインスタンス テンプレートを使用して VM のプロパティを指定するには、[インスタンス テンプレートを使用] を選択します。

             [インスタンス テンプレート] フィールドで、コミットメントと同じマシン ファミリー シリーズのインスタンス テンプレートを選択します。リージョン インスタンス テンプレートを選択する場合は、そのインスタンス テンプレートのリージョンも、コミットメントで指定されたリージョンと一致する必要があります。

          2. VM のプロパティを手動で指定するには、[Select machine type] を選択して、次の操作を行います。

             1. コミットメントに指定したマシンシリーズに適用されるマシン ファミリーを選択します。

                • 汎用: 汎用マシンシリーズ
                • コンピューティング最適化: コンピューティング最適化マシンシリーズ
                • メモリ最適化: メモリ最適化マシンシリーズ
                • GPU: アクセラレータ最適化マシンシリーズ

             2. [シリーズ] 列があるテーブルで、コミットメントに指定したマシンシリーズを選択します。

             3. [マシンタイプ] フィールドで、次のいずれかの方法で事前定義またはカスタムのマシンタイプを指定します。

                1. 事前定義されたマシンタイプを選択するには、[プリセット] を選択してから、必要なマシンタイプを選択します。
                2. カスタム マシンタイプを選択するには、[カスタム] を選択し、必要なコア数とメモリを指定します。

             4. 最小 CPU プラットフォーム、GPU、またはその両方を指定するには、[expand_more CPU プラットフォームと GPU] メニューを開いて、次の操作を行います。

                1. 省略可: 最小 CPU プラットフォームを指定するには、[CPU プラットフォーム] リストでオプションを選択します。

                2. 省略可: GPU を予約するには、add [GPU を追加する] をクリックします。次に、[GPU タイプ] フィールドと [GPU の数] フィールドで、各 VM の GPU のタイプと数を選択します。

             5. ローカル SSD ディスクを予約する手順は次のとおりです。

                1. [ディスクの数] フィールドで、各 VM に必要なローカル SSD ディスクの数を選択します。
                2. [インターフェース タイプ] フィールドで、ローカル SSD ディスクのインターフェースを選択します。

    8. この予約のプロパティの指定を完了するには、[完了] をクリックします。

12. 予約を関連付けてコミットメントの購入を完了するには、次の操作を行います。

    1. [購入] をクリックします。
    2. [確約利用割引の購入] ダイアログで、サービス固有の利用規約に同意する場合は、もう一度 [購入] をクリックします。

gcloud

コミットメントの購入時に関連付ける予約を作成するには、gcloud compute commitments create コマンドを実行します。

単一の予約を関連付けるか複数の予約を関連付けるかに応じて、次のいずれかの方法でコマンドを実行します。

• 単一の予約を作成してコミットメントに関連付けるには、次のコマンドを実行して、関連付ける予約のプロパティを定義します。

  gcloud compute commitments create COMMITMENT_NAME \
      --region=REGION \
      --project=PROJECT_ID \
      --plan DURATION \
      --type COMMITMENT_TYPE
      --resources=vcpu=COMMITTED_VCPUS,memory=COMMITTED_MEMORY,local-ssd=COMMITTED_LOCAL_SSD \
      --resources-accelerator=count=COMMITTED_ACCELERATOR_COUNT,type=COMMITTED_ACCELERATOR_TYPE \
      --custom-end-time=CUSTOM_END_DATE \
      --reservation=RESERVATION_NAME \
      --reservation-zone=RESERVATION_ZONE \
      --machine-type=RESERVED_MACHINE_TYPE \
      --require-specific-reservation=REQUIRE_SPECIFIC_RESERVATION_VALUE \
      --vm-count=NUMBER_OF_RESERVED_VMs \
      --accelerator=type=RESERVED_ACCELERATOR_TYPE,count=RESERVED_ACCELERATOR_COUNT \
      --local-ssd=interface=INTERFACE_1,size=375 \
      --local-ssd=interface=INTERFACE_2,size=375 \
      --minimum-cpu-platform=MINIMUM_CPU_PLATFORM \
      --share-setting=SHARE_SETTING \
      --share-with=CONSUMER_PROJECT_ID_1,CONSUMER_PROJECT_ID_2
  

• 複数の予約を作成してコミットメントに関連付けるには、YAML ファイルを使用して予約のプロパティを定義し、コミットメントの購入に使用するコマンドでその YAML ファイルを指定します。必要に応じて、この YAML ファイルを使用して単一の予約を作成し、コミットメントに関連付けることもできます。関連付けられる予約をこの方法で作成する手順は次のとおりです。

  1. 現在のディレクトリに YAML ファイルを作成し、関連付ける予約ごとに必要な構成を指定します。たとえば、GPU、2 つのローカル SSD ディスク、最小 CPU プラットフォームを指定する 2 つのプロジェクトと共有される共有予約の構成を指定するには、YAML ファイルに次のテキストを追加します。

     - reservation: RESERVATION_NAME
       reservation_zone: RESERVATION_ZONE
       require_specific_reservation: REQUIRE_SPECIFIC_RESERVATION_VALUE
       vm_count: NUMBER_OF_RESERVED_VMs
       machine_type: RESERVED_MACHINE_TYPE
       accelerator:
       - count: RESERVED_ACCELERATOR_COUNT
         type: RESERVED_ACCELERATOR_TYPE
       localssd:
       - interface: INTERFACE_1
         size: 375
       - interface: INTERFACE_2
         size: 375
       project: OWNER_PROJECT_ID
       minimum-cpu-platform: MINIMUM_CPU_PLATFORM
       share-setting: SHARE_SETTING
       share-with:
       - CONSUMER_PROJECT_ID_1
       - CONSUMER_PROJECT_ID_2
     
     

     複数の予約の構成を指定するには、作成する予約ごとにこれらのプロパティを繰り返します。コミットメントには、任意の数の既存の予約を追加できます。

  2. --reservation-from-file フラグを指定して gcloud compute commitments create コマンドを実行します。

     gcloud compute commitments create COMMITMENT_NAME \
         --region REGION \
         --project PROJECT_ID \
         --plan DURATION \
         --type COMMITMENT_TYPE \
         --resources=vcpu=COMMITTED_VCPUS,memory=COMMITTED_MEMORY,local-ssd=COMMITTED_LOCAL_SSD \
         --resources-accelerator=count=COMMITTED_ACCELERATOR_COUNT,type=COMMITTED_ACCELERATOR_TYPE \
         --reservations-from-file=YAML_FILE
     

以下は、コミットメントと関連付けられている予約の対応するプロパティに置き換えます。

Compute Engine は、ターゲット ゾーンで指定されたマシンタイプに十分なリソースがあり、リクエスト時に十分な割り当てがある場合にのみ、コミットメントとそれに関連する予約を作成します。購入が成功すると、次のような成功メッセージが表示されます。

Created[https://www.googleapis.com/compute/v1/projects/your-project/regions/your-region/commitments/your-commitment-name]

関連付ける新しい予約を作成してコミットメントを購入する例

次のシナリオとコマンドの例は、コミットメントに関連付ける新しい予約を作成して、GPU、ローカル SSD ディスク、またはその両方のコミットメントを購入する方法を示しています。

例 1: 新しい予約を 1 つだけ関連付けて GPU のコミットメントを購入する

4 個の NVIDIA V100 GPU を含む us-central1 リージョンでコミットメント commitment-01 を購入するとします。これらの GPU の関連付けられた予約として、新しい予約 reservation-01 を作成します。us-central1-a ゾーンの 2 台の n1-standard-32 VM でこれらの予約済み GPU を使用するように Compute Engine を指定するとします。予約が関連付けられているこのサンプルのコミットメントを購入するには、次のコマンドを実行します。

gcloud compute commitments create commitment-01 \
    --region=us-central1 \
    --project=myproject \
    --resources=vcpu=96,memory=624GB \
    --resources-accelerator=type=nvidia-tesla-v100,count=4 \
    --plan 12-month \
    --reservation=reservation-01 \
    --reservation-zone=us-central1-a \
    --machine-type=n1-standard-32 \
    --accelerator=type=nvidia-tesla-v100,count=2 \
    --vm-count=2

例 2: vCPU やメモリを確約せずに GPU のコミットメントを購入する

vCPU またはメモリを確約せずに GPU とローカル SSD ディスクを確約して予約するには、vCPU とメモリ量の値として 0 を指定します。たとえば、us-west2 リージョンで単一の NVIDIA P4 GPU のコミットメント commitment-02 を購入するとします。また、関連付ける予約を新たに作成し、us-west2-b ゾーンの n1-standard-2 VM で予約済みの GPU を使用するように Compute Engine を指定します。予約が関連付けられているこのサンプルのコミットメントを購入するには、次のコマンドを実行します。

gcloud compute commitments create commitment-02 \
    --region=us-west2 \
    --project=myproject \
    --resources=vcpu=0,memory=0 \
    --resources-accelerator=type=nvidia-tesla-p4,count=1 \
    --plan 12-month \
    --reservation=reservation-01 \
    --reservation-zone=us-west2-b \
    --machine-type=n1-standard-2 \
    --accelerator=type=nvidia-tesla-p4,count=1 \
    --vm-count=1

例 3: 複数の新しい予約を関連付けて GPU とローカル SSD ディスクのコミットメントを購入する

us-central1 リージョンで 1 個の NVIDIA V100 GPU と 2 個のローカル SSD ディスクのコミットメント commitment-03 を購入するとします。また、us-central1-a ゾーンに 2 個の予約を作成して関連付けます。最初の予約 res-01 では、1 個の GPU を使用する 1 台の n1-standard-2 VM を予約します。res-01 をターゲット予約にする場合に、予約済みの VM を使用するには、その予約を名前で明示的に指定する必要があります。2 番目の予約 res-02 では、2 種類のローカル SSD ディスクがアタッチされた 1 つの n1-standard-8 VM を予約します。

予約が関連付けられたこのコミットメントの例を購入するには、まず両方の予約のプロパティを含む YAML ファイルを作成します。

- reservation: res-01
  reservation_zone: us-central1-a
  require_specific_reservation: true
  vm_count: 1
  machine_type: n1-standard-2
  accelerator:
  - count: 1
    type: nvidia-tesla-v100
- reservation: res-02
  reservation_zone: us-central1-a
  vm_count: 1
  machine_type: n1-standard-8
  local_ssd:
  - interface: scsi
    size: 375
  - interface: nvme
    size: 375

YAML ファイルを作成したら、次のコマンドを実行して、予約を追加したコミットメントの購入を完了します。この例のコミットメントには vCPU とメモリリソースも含まれています。

gcloud compute commitments create commitment-03 \
    --region=us-central1 \
    --project=myproject \
    --resources=vcpu=96,memory=624,local-ssd=750 \
    --resources-accelerator=type=nvidia-tesla-v100,count=1 \
    --plan 12-month \
    --reservations-from-file=YAML_FILE

REST

コミットメントの購入時に関連付ける予約を作成するには、regionCommitments.insert メソッドに POST リクエストを送信します。リクエストに reservations フィールドを含めて、作成して関連付ける新しい予約のリストを定義します。コミットメントには、任意の数の既存の予約を追加できます。

• すべての VM プロパティを手動で指定して新しい予約を作成するには、instanceProperties フィールドを含め、sourceInstanceTemplate フィールドを除外します。

  たとえば、GPU、2 個のローカル SSD ディスク、最小 CPU プラットフォームの 2 つのプロジェクトと共有される共有予約の構成を手動で指定するには、次のリクエストを行います。

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments
  
  {
  "name": "COMMITMENT_NAME",
  "plan": "DURATION",
  "type": COMMITMENT_TYPE,
  "resources":
  [
    {
      "amount": "COMMITTED_VCPUS",
      "type": "VCPU"
    },
    {
      "amount": "COMMITTED_MEMORY",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "COMMITTED_ACCELERATOR_TYPE",
      "amount": "COMMITTED_ACCELERATOR_COUNT",
      "type": "ACCELERATOR"
    }
    {
      "amount": "COMMITTED_LOCAL_SSD",
      "type": "LOCAL_SSD"
    }
  ],
  "customEndTimestamp": "CUSTOM_END_DATETEND_TIMEZ",
  "reservations":
  [
    {
      "name": "RESERVATION_NAME",
      "specificReservation":
      {
        "count": "NUMBER_OF_RESERVED_VMS",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": "RESERVED_ACCELERATOR_COUNT",
              "acceleratorType": "RESERVED_ACCELERATOR_TYPE"
            }
          ],
          "localSsds":
          [
            {
              "diskSizeGb": "375",
              "interface": "RESERVED_INTERFACE_1"
            },
            {
              "diskSizeGb": "375",
              "interface": "RESERVED_INTERFACE_2"
            }
          ],
          "machineType": "RESERVED_MACHINE_TYPE",
          "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
        }
      },
      "specificReservationRequired": REQUIRE_SPECIFIC_RESERVATION_VALUE",
      "zone": "RESERVED_ZONE",
      "shareSettings":
      {
        "shareType": "SPECIFIC_PROJECTS",
        "projectMap":
        {
          "CONSUMER_PROJECT_ID_1":
          {
            "projectId": "CONSUMER_PROJECT_ID_1"
          },
          "CONSUMER_PROJECT_ID_2":
          {
            "projectId": "CONSUMER_PROJECT_ID_2"
          }
        }
      }
    }
  ]
  }
  
  

• インスタンス テンプレートを指定して新しい予約を作成するには、sourceInstanceTemplate フィールドを追加し、instanceProperties フィールドを除外します。

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments
  
  {
  "name": "COMMITMENT_NAME",
  "plan": "DURATION",
  "type": COMMITMENT_TYPE,
  "resources":
  [
    {
      "amount": "COMMITTED_VCPUS",
      "type": "VCPU"
    },
    {
      "amount": "COMMITTED_MEMORY",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "COMMITTED_ACCELERATOR_TYPE",
      "amount": "COMMITTED_ACCELERATOR_COUNT",
      "type": "ACCELERATOR"
    }
    {
      "amount": "COMMITTED_LOCAL_SSD",
      "type": "LOCAL_SSD"
    }
  ],
  "customEndTimestamp": "CUSTOM_END_DATETEND_TIMEZ",
  "reservations":
  [
    {
      "name": "RESERVATION_NAME",
      "specificReservation":
      {
        "count": "NUMBER_OF_RESERVED_VMS",
        "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME"
      },
      "specificReservationRequired": REQUIRE_SPECIFIC_RESERVATION_VALUE",
      "zone": "RESERVED_ZONE",
      "shareSettings":
      {
        "shareType": "SPECIFIC_PROJECTS",
        "projectMap":
        {
          "CONSUMER_PROJECT_ID_1":
          {
            "projectId": "CONSUMER_PROJECT_ID_1"
          },
          "CONSUMER_PROJECT_ID_2":
          {
            "projectId": "CONSUMER_PROJECT_ID_2"
          }
        }
      }
    }
  ]
  }
  
  

以下は、コミットメントと関連付けられている予約の対応するプロパティに置き換えます。

Compute Engine は、ターゲット ゾーンで指定されたマシンタイプに十分なリソースがあり、リクエスト時に十分な割り当てがある場合にのみ、コミットメントとそれに関連する予約を作成します。購入が正常に完了すると、Compute Engine は REST API リクエストに対して 200 ステータスを返します。

新しい予約を作成してコミットメントを購入する例

次のシナリオとコマンドの例は、コミットメントに関連付ける新しい予約を作成して、GPU、ローカル SSD ディスク、またはその両方のコミットメントを購入する方法を示しています。

例 1: 新しい予約を 1 つだけ関連付けて GPU のコミットメントを購入する

4 個の NVIDIA V100 GPU を含む us-central1 リージョンでコミットメント commitment-01 を購入するとします。これらの GPU に関連付けられた予約として、新しい予約 reservation-01 を作成します。us-central1-a ゾーンの 2 台の n1-standard-8 VM でこれらの予約済み GPU を使用するように Compute Engine を指定するとします。この例のコミットメントとそれに関連付けられた予約を購入するには、次の POST リクエストを行います。

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments

{
  "name": "commitment-01",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE"
  "resources":
  [
    {
      "amount": "96",
      "type": "VCPU"
    },
    {
      "amount": "638976",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "nvidia-tesla-v100",
      "amount": "4",
      "type": "ACCELERATOR"
    }
  ],
  "reservations":
  [
    {
      "name": "reservation-01",
      "specificReservation":
      {
        "count": "2",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": 2,
              "acceleratorType": "nvidia-tesla-v100"
            }
          ],
          "machineType": "n1-standard-8"
        }
      },
      "specificReservationRequired": false,
      "zone": "us-central1-a"
    }
  ]
}

例 2: vCPU やメモリを確約せずに GPU のコミットメントを購入する

vCPU またはメモリを確約せずに GPU とローカル SSD ディスクを確約して予約するには、vCPU とメモリ量の値として 0 を指定します。たとえば、us-west2 リージョンで単一の NVIDIA P4 GPU のコミットメント commitment-02 を購入するとします。また、関連付ける予約を新たに作成し、us-west2-b ゾーンの n1-standard-2 VM で予約済みの GPU を使用するように Compute Engine を指定します。この例のコミットメントとそれに関連付けられた予約を購入するには、次の POST リクエストを行います。

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-west2/commitments

{
  "name": "commitment-02",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE",
  "resources":
  [
    {
      "amount": "0",
      "type": "VCPU"
    },
    {
      "amount": "0",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "nvidia-tesla-p4",
      "amount": "4",
      "type": "ACCELERATOR"
    }
  ],
  "reservations":
  [
    {
      "name": "reservation-01",
      "specificReservation":
      {
        "count": "1",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": 4,
              "acceleratorType": "nvidia-tesla-p4"
            }
          ],
          "machineType": "n1-standard-2"
        }
      },
      "specificReservationRequired": false,
      "zone": "us-west2-b"
    }
  ]
}

例 3: 複数の新しい予約を関連付けて GPU とローカル SSD ディスクのコミットメントを購入する

us-central1 リージョンで 1 個の NVIDIA V100 GPU と 2 個のローカル SSD ディスクのコミットメント commitment-03 を購入するとします。また、us-central1-a ゾーンに 2 個の予約を作成して関連付けます。最初の予約 res-01 では、1 個の GPU を使用する 1 台の n1-standard-2 VM を予約します。res-01 をターゲット予約にする場合に、予約済みの VM を使用するには、その予約を名前で明示的に指定する必要があります。2 番目の予約 res-02 では、2 種類のローカル SSD ディスクがアタッチされた 1 つの n1-standard-8 VM を予約します。関連付ける予約とこのコミットメントの例を購入するには、次の POST リクエストを行います。この例のコミットメントには、vCPU とメモリリソースも含まれています。

POST https://compute.googleapis.com/compute/v1/projects/my-project/regions/us-central1/commitments

{
  "name": "commitment-03",
  "plan": "TWELVE_MONTH",
  "type": "GENERAL_PURPOSE",
  "resources":
  [
    {
      "amount": "96",
      "type": "VCPU"
    },
    {
      "amount": "638976",
      "type": "MEMORY"
    },
    {
      "acceleratorType": "nvidia-tesla-v100",
      "amount": "1",
      "type": "ACCELERATOR"
    },
    {
      "amount": "768000",
      "type": "LOCAL_SSD"
    }
  ],
  "reservations":
  [
    {
      "name": "res-01",
      "specificReservation":
      {
        "count": "1",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": 1,
              "acceleratorType": "nvidia-tesla-v100"
            }
          ],
          "machineType": "n1-standard-2"
        }
      },
      "specificReservationRequired": true,
      "zone": "us-central1-a"
    },
    {
      "name": "res-02",
      "specificReservation":
      {
        "count": "1",
        "instanceProperties":
        {
          "localSsds":
          [
            {
              "diskSizeGb": "375",
              "interface": "SCSI"
            },
            {
              "diskSizeGb": "375",
              "interface": "NVME"
            }
          ]
          "machineType": "n1-standard-8"
        }
      },
      "specificReservationRequired": false,
      "zone": "us-central1-a"
    }
  ]
}

gcloud

コミットメントに関連付けられている予約を置き換えるには、次のようにします。

1. 現在のディレクトリに、次の関連付けられた予約の構成を含む YAML ファイルを作成します。

   • 置き換える現在の予約。

     この予約の詳細を取得するには、予約の詳細を表示するをご覧ください。

   • 新しい置き換える予約。

   YAML ファイルの内容は次のようになります。

   - reservation: CURRENT_RESERVATION_NAME
     reservation_zone: CURRENT_RESERVATION_ZONE
     vm_count: 0
     machine_type: CURRENT_RESERVATION_MACHINE_TYPE
     accelerator:
     - count: CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS
       type: CURRENT_RESERVATION_ACCELERATOR_TYPE
     local_ssd:
     - interface: CURRENT_RESERVATION_INTERFACE_1
       size: 375
     - interface: CURRENT_RESERVATION_INTERFACE_2
       size: 375
     project: CURRENT_RESERVATION_PROJECT_ID
     share_setting: CURRENT_RESERVATION_SHARE_SETTING
     share_with:
     - CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1
     - CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2
   - reservation: REPLACEMENT_RESERVATION_NAME
     reservation_zone: REPLACEMENT_RESERVATION_ZONE
     vm_count: REPLACEMENT_RESERVATION_NUMBER_OF_VMs
     machine_type: REPLACEMENT_RESERVATION_MACHINE_TYPE
     accelerator:
     - count: REPLACEMENT_RESERVATION_ACCELERATOR_COUNT
       type: REPLACEMENT_RESERVATION_ACCELERATOR_TYPE
     local_ssd:
     - interface: REPLACEMENT_RESERVATION_INTERFACE_1
       size: 375
     - interface: REPLACEMENT_RESERVATION_INTERFACE_2
       size: 375
     project: REPLACEMENT_RESERVATION_PROJECT_ID
     share_setting: REPLACEMENT_RESERVATION_SHARE_SETTING
     share_with:
     - REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1
     - REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2
   
   

   以下を、現在の予約と置き換える予約の対応するプロパティに置き換えます。

   現在の予約

   現在の予約では、次のすべてのプロパティが予約を表示したときと完全に一致している必要があります。現在の予約にまだ含まれていないプロパティについては、フィールドを省略します。

   • CURRENT_RESERVATION_NAME: 現在関連付けられている予約の名前。
   • CURRENT_RESERVATION_ZONE: 現在関連付けられている予約のゾーン。
   • CURRENT_RESERVATION_MACHINE_TYPE: 現在関連付けられている予約のマシンタイプ。
   • CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS: 現在関連付けられている予約で予約されている GPU の数。
   • CURRENT_RESERVATION_ACCELERATOR_TYPE: 現在の関連付けられた予約で予約されているアクセラレータのタイプ。
   • CURRENT_RESERVATION_INTERFACE_1、CURRENT_RESERVATION_INTERFACE_2: 現在関連付けられている予約で、各予約済み VM のローカル SSD ディスクが使用するインターフェースのタイプ。有効なオプションは scsi と nvme です。各ローカル SSD ディスクは 375 GB です。予約済みのすべてのローカル SSD ディスクに local_ssd パラメータを繰り返します。
   • CURRENT_RESERVATION_PROJECT_ID: コミットメントと予約が関連付けられている現在のプロジェクトのプロジェクト ID。現在関連付けられている予約が複数のコンシューマー プロジェクト間で共有されている場合は、このフィールドを指定します。
   • CURRENT_RESERVATION_SHARE_SETTING: 現在の予約の共有タイプ。現在関連付けられている予約が複数のコンシューマー プロジェクト間で共有されている場合は、このフィールドに projects の値を指定します。
   • CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1、CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2: 現在の予約を共有するプロジェクトのプロジェクト ID（例: project-1 と project-2）です。

   置換予約

   置換予約では、必要に応じて次のプロパティを設定します。これらのプロパティを指定するときは、すべての要件を満たしていることを確認してください。使用しないその他のフィールドは省略します。

   • REPLACEMENT_RESERVATION_NAME: 新しい置換予約の名前。
   • REPLACEMENT_RESERVATION_ZONE: 新しい置換予約のゾーン。
   • REPLACEMENT_RESERVATION_NUMBER_OF_VMS: 新しい置換予約で予約する VM の数。

   • REPLACEMENT_RESERVATION_MACHINE_TYPE: 新しい置換予約の VM に必要なマシンタイプ。

     • マシンタイプが事前定義の場合は、MACHINE_FAMILY-standard-CPUS の形式を使用します（例: n2-standard-4）。
     • マシンタイプがカスタムの場合は、MACHINE_FAMILY-custom-CPUS-MEMORY の形式を使用します（例: n2-custom-4-5120）。詳しい制限事項については、カスタム マシンタイプの仕様をご覧ください。

     次のように置き換えます。

     • MACHINE_FAMILY: マシンタイプのファミリー。たとえば、N2 VM の場合は n2 を指定します。
     • CPUS: vCPU の数。
     • MEMORY: 予約済み VM の合計メモリ。メモリの量には、256 MB の倍数を MB 単位で指定します。たとえば、4 個の vCPU と 5 GB（5,120 MB）のメモリを搭載した N2 VM を作成するには、n2-custom-4-5120 を使用します。

   • REPLACEMENT_RESERVATION_NUMBER_OF_ACCELERATORS: 置換予約で VM ごとに追加する GPU の数。

   • REPLACEMENT_RESERVATION_ACCELERATOR_TYPE: 置換予約に追加するアクセラレータのタイプ。

   • REPLACEMENT_RESERVATION_INTERFACE_1、REPLACEMENT_RESERVATION_INTERFACE_2: 各予約済み VM のローカル SSD ディスクで使用するインターフェースのタイプ。有効なオプションは scsi と nvme です。各ローカル SSD ディスクは 375 GB です。追加するローカル SSD ディスクごとに local_ssd パラメータを繰り返します。ローカル SSD ディスクは 24 個まで指定できます。

   • REPLACEMENT_RESERVATION_PROJECT_ID: コミットメントと予約が関連付けられている現在のプロジェクトのプロジェクト ID。複数のコンシューマー プロジェクトで置換予約を共有する場合は、このフィールドを指定します。

   • REPLACEMENT_RESERVATION_SHARE_SETTING: 置換予約の共有タイプ。複数のコンシューマー プロジェクトで置換予約を共有する場合は、このフィールドに projects の値を指定します。

   • REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1、REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2: この予約を共有できるプロジェクトのプロジェクト ID（例: project-1,project-2）をご覧ください。最大 100 個のコンシューマー プロジェクトを含めることができます。これらのプロジェクトは、オーナー プロジェクトと同じ組織に存在している必要があります。この予約の使用はデフォルトで許可されているため、REPLACEMENT_RESERVATION_PROJECT_ID は使用しないでください。

2. gcloud beta compute commitments update-reservations コマンドを実行し、--reservations-from-file フラグを使用して YAML ファイルのパスを指定します。

   gcloud beta compute commitments update-reservations COMMITMENT_NAME \
       --project= PROJECT_ID \
       --region= REGION \
       --reservations-from-file= YAML_FILE
   

   次のように置き換えます。

   • COMMITMENT_NAME: 予約が関連付けられたコミットメントの名前。
   • PROJECT_ID: 予約が関連付けられたコミットメントのプロジェクト ID。
   • REGION: コミットメントのリージョン。
   • YAML_FILE: 現在の予約と置換予約の構成を含む YAML ファイルのパス。

コミットメントに関連付けられている予約を置き換える例

これを説明するために、このセクションでは、予約が関連付けられたコミットメントの例と、関連付けられた予約の例を置き換える方法について説明します。

予約が関連付けられたコミットメントの例

たとえば、次のコマンドを使用して購入した my-commitment-with-reservations コミットメントに関連付けられた予約を更新するとします。

  gcloud beta compute commitments create my-commitment-with-reservations \
      --region=asia-east1 \
      --resources=vcpu=16,memory=60GB,local-ssd=3000 \
      --resources-accelerator=type=nvidia-tesla-p100,count=4 \
      --plan=12-month \
      --type=general-purpose \
      --reservations-from-file=one-reservation.yaml

この例では、このコマンドの実行時に one-reservation.yaml が現在のディレクトリにある次の内容のファイルで、res-1 という名前の関連付けられた予約が定義されているとします。

  - reservation: res-1
    reservation_zone: asia-east1-a
    vm_count: 4
    machine_type: n1-standard-4
    accelerator:
    - count: 1
      type: nvidia-tesla-p100
    local_ssd:
    - interface: scsi
      size: 375
    - interface: scsi
      size: 375

この my-commitment-with-reservations コミットメントと関連付けられた予約 res-1 により、次の確約リソースと予約済みリソースが作成されました。

^*具体的には、関連付けられた予約の例（res-1）では、それぞれ scsi インターフェースの 1 個の P100 GPU と 2 個のローカル SSD ディスクを使用する 4 個の n1-standard-4 VM を予約します。n1-standard-4 マシンタイプでは、各 VM に 4 個の vCPU と 15 GB が使用されます。

関連付けられた予約の例を置き換える

関連付けられた予約 res-1 を新しい予約 res-2 に置き換え、予約済みリソースを次のように変更するとします。

^*具体的には、関連付けられた予約の例（res-1）では、それぞれ scsi インターフェースの 1 個の P100 GPU と 2 個のローカル SSD ディスクを使用する 4 個の n1-standard-4 VM を予約します。n1-standard-4 マシンタイプでは、各 VM に 4 個の vCPU と 15 GB が使用されます。

^†置換の関連付けられた予約では、それぞれ scsi インターフェース タイプの 1 個の P100 GPU と 4 個のローカル SSD ディスクを使用する 2 個の n1-standard-8 VM を予約する res-2 を定義します。また、res-2 は他の 2 つのプロジェクト project-1 と project-2 と共有され、現在のプロジェクト my-project によって所有されます。n1-standard-8 マシンタイプでは、各 VM に 8 個の vCPU と 30 GB が使用されます。

my-commitment-with-reservations コミットメントに関連付けられた予約 res-1 を res-2 に置き換えるには、次の操作を行います。

1. 現在のディレクトリに、次の内容を含む two-reservations.yaml という名前のファイルを作成します。

   - reservation: res-1
     reservation_zone: asia-east1-a
     vm_count: 0
     machine_type: n1-standard-4
     accelerator:
     - count: 1
       type: nvidia-tesla-p100
     local_ssd:
     - interface: scsi
       size: 375
     - interface: scsi
       size: 375
   - reservation: res-2
     reservation_zone: asia-east1-a
     vm_count: 2
     machine_type: n1-standard-8
     accelerator:
     - count: 2
       type: nvidia-tesla-p100
     project: my-project
     share_setting: projects
     share_with:
     - project-1
     - project-2
     local_ssd:
     - interface: scsi
       size: 375
     - interface: scsi
       size: 375
     - interface: scsi
       size: 375
     - interface: scsi
       size: 375
   

2. 次のコマンドを実行します。

   gcloud beta compute commitments update-reservations my-commitment-with-reservations \
       --region=asia-east1 \
       --reservations-from-file=two-reservations.yaml
   

REST

コミットメントに関連付けられている予約を置き換えるには、regionCommitments.updateReservations メソッドを使用して POST リクエストを行います。

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/COMMITMENT_ZONE/commitments/COMMITMENT_NAME/updateReservations

{
  "reservations":
  [
    {
      "name": "REPLACEMENT_RESERVATION_NAME",
      "specificReservation":
      {
        "count": "REPLACEMENT_RESERVATION_NUMBER_OF_VMS",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": "REPLACEMENT_RESERVATION_NUMBER_OF_ACCELERATORS",
              "acceleratorType": "REPLACEMENT_RESERVATION_ACCELERATOR_TYPE"
            }
          ],
          "localSsds":
          [
            {
              "diskSizeGb": "375",
              "interface": "REPLACEMENT_RESERVATION_INTERFACE_1"
            },
            {
              "diskSizeGb": "375",
              "interface": "REPLACEMENT_RESERVATION_INTERFACE_2"
            }
          ],
          "machineType": "REPLACEMENT_RESERVATION_MACHINE_TYPE"

        }
      },
      "zone": "REPLACEMENT_RESERVATION_ZONE",
      "shareSettings":
      {
        "shareType": "SPECIFIC_PROJECTS",
        "projectMap":
        {
          "REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1":
          {
            "projectId": "REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_1"
          },
          "REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2":
          {
            "projectId": "REPLACEMENT_RESERVATION_CONSUMER_PROJECT_ID_2"
          }
         }
      }
    },
    {
      "name": "CURRENT_RESERVATION_NAME",
      "specificReservation":
      {
        "count": "0",
        "instanceProperties":
        {
          "guestAccelerators":
          [
            {
              "acceleratorCount": "CURRENT_RESERVATION_NUMBER_OF_ACCELERATORS",
              "acceleratorType": "CURRENT_RESERVATION_ACCELERATOR_TYPE"
            }
          ],
          "localSsds":
          [
            {
              "diskSizeGb": "375",
              "interface": "CURRENT_RESERVATION_INTERFACE_1"
            },
            {
              "diskSizeGb": "375",
              "interface": "CURRENT_RESERVATION_INTERFACE_2"
            }
          ],
          "machineType": "CURRENT_RESERVATION_MACHINE_TYPE"

        }
      },
      "zone": "CURRENT_RESERVATION_ZONE",
      "shareSettings":
      {
        "shareType": "SPECIFIC_PROJECTS",
        "projectMap":
        {
          "CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1":
          {
            "projectId": "CURRENT_RESERVATION_CONSUMER_PROJECT_ID_1"
          },
          "CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2":
          {
            "projectId": "CURRENT_RESERVATION_CONSUMER_PROJECT_ID_2"
          }
         }
      }
    }
  ]
}

以下を、コミットメント、現在の予約、置換予約の対応するプロパティに置き換えます。

コミットメントに関連付けられている予約を置き換える例

これを説明するために、このセクションでは、予約が関連付けられたコミットメントの例と、関連付けられた予約の例を置き換える方法について説明します。

予約が関連付けられたコミットメントの例

たとえば、次の POST リクエストによって購入された my-commitment-with-reservations コミットメントに関連付けられている予約 res-1 を置き換えるとします。

  POST https://compute.googleapis.com/compute/beta/projects/my-project/regions/asia-east1/commitments

  {
    "name": "my-commitment-with-reservations",
    "plan": "TWELVE_MONTH",
    "reservations":
    [
      {
        "name": "res-1",
        "specificReservation":
        {
          "count": "4",
          "instanceProperties":
          {
            "guestAccelerators":
            [
              {
                "acceleratorCount": "1",
                "acceleratorType": "nvidia-tesla-p100"
              }
            ],
            "localSsds":
            [
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              }
            ],
            "machineType": "n1-standard-4"
          }
        },
        "zone": "asia-east1-a"
      }
    ],
    "resources":
    [
      {
        "amount": "16",
        "type": "VCPU"
      },
      {
        "amount": "61440",
        "type": "MEMORY"
      },
      {
        "acceleratorType": "nvidia-tesla-p100",
        "amount": "4",
        "type": "ACCELERATOR"
      }
      {
        "amount": "3072000",
        "type": "LOCAL_SSD"
      }
    ],
    "type": "GENERAL_PURPOSE"
  }

この my-commitment-with-reservations コミットメントと関連付けられた予約 res-1 により、次の確約リソースと予約済みリソースが作成されました。

^*具体的には、関連付けられた予約の例（res-1）では、それぞれ scsi インターフェースの 1 個の P100 GPU と 2 個のローカル SSD ディスクを使用する 4 個の n1-standard-4 VM を予約します。n1-standard-4 マシンタイプでは、各 VM に 4 個の vCPU と 15 GB が使用されます。

関連付けられた予約の例を置き換える

関連付けられた予約 res-1 を新しい予約 res-2 に置き換え、予約済みリソースを次のように変更するとします。

^*具体的には、関連付けられた予約の例（res-1）では、それぞれ scsi インターフェースの 1 個の P100 GPU と 2 個のローカル SSD ディスクを使用する 4 個の n1-standard-4 VM を予約します。n1-standard-4 マシンタイプでは、各 VM に 4 個の vCPU と 15 GB が使用されます。

^†置換の関連付けられた予約では、それぞれ scsi インターフェース タイプの 1 個の P100 GPU と 4 個のローカル SSD ディスクを使用する 2 個の n1-standard-8 VM を予約する res-2 を定義します。また、res-2 は他の 2 つのプロジェクト project-1 と project-2 と共有され、現在のプロジェクト my-project によって所有されます。n1-standard-8 マシンタイプでは、各 VM に 8 個の vCPU と 30 GB が使用されます。

my-commitment-with-reservations コミットメントの関連付けられた予約 res-1 を res-2 に置き換えるには、regionCommitments.updateReservations メソッドを使用して次の POST リクエストを行います。

  POST https://compute.googleapis.com/compute/beta/projects/my-project/regions/asia-east1/commitments/my-commitment-with-reservations/updateReservations

  {
    "reservations":
    [
      {
        "name": "res-2",
        "specificReservation":
        {
          "count": "2",
          "instanceProperties":
          {
            "guestAccelerators":
            [
              {
                "acceleratorCount": 2,
                "acceleratorType": "nvidia-tesla-p100"
              }
            ],
            "localSsds":
            [
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              }
            ],
            "machineType": "n1-standard-8"
          }
        },
        "zone": "asia-east1-a"
      },
      {
        "name": "res-1",
        "specificReservation":
        {
          "count": "0",
          "instanceProperties":
          {
            "guestAccelerators":
            [
              {
                "acceleratorCount": 1,
                "acceleratorType": "nvidia-tesla-p100"
              }
            ],
            "localSsds":
            [
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              },
              {
                "diskSizeGb": "375",
                "interface": "scsi"
              }
            ],
            "machineType": "n1-standard-4"
          }
        },
        "zone": "asia-east1-a"
      }
    ]
  }