カレンダー モードで将来の予約リクエストを作成する

コンソール

カレンダー モードで将来の予約リクエストを作成するときに、リージョン内の GPU VM または TPU の将来の可用性を確認できます。詳細については、このドキュメントの GPU VM または TPU の予約リクエストを作成するをご覧ください。

gcloud

リージョンでの GPU VM または TPU の今後の可用性を表示するには、次のいずれかの gcloud beta compute advice calendar-mode コマンドを使用します。表示するリソースに基づいて、次のフラグを含めます。

• GPU VM の可用性を表示するには、--vm-count フラグと --machine-type フラグを指定します。

  gcloud beta compute advice calendar-mode \
      --vm-count=NUMBER_OF_VMS \
      --machine-type=MACHINE_TYPE \
      --region=REGION \
      --start-time-range=from=FROM_START_TIME,to=TO_START_TIME \
      --end-time-range=from=FROM_END_TIME,to=TO_END_TIME
  

• TPU の可用性を表示するには、--chip-count フラグと --tpu-version フラグを含めます。

  gcloud beta compute advice calendar-mode \
      --chip-count=NUMBER_OF_CHIPS \
      --tpu-version=TPU_VERSION \
      --region=REGION \
      --start-time-range=from=FROM_START_TIME,to=TO_START_TIME \
      --end-time-range=from=FROM_END_TIME,to=TO_END_TIME
  

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

• NUMBER_OF_VMS: 予約する GPU VM の数。

• MACHINE_TYPE: 予約する GPU マシンタイプ。

• NUMBER_OF_CHIPS: 予約する TPU チップの数。

• TPU_VERSION: 予約する TPU バージョン。次のいずれかの値を指定します。

  • TPU v6e の場合: V6E

  • TPU v5p の場合: V5P

  • TPU v5e の場合: V5E

  TPU v5e を指定する場合は、--workload-type フラグを含める必要があります。このフラグを、TPU で実行するワークロードのタイプに設定します。

  • 単一または複数のオペレーションで大量のデータを処理するワークロード（機械学習（ML）トレーニング ワークロードなど）の場合は、BATCH を指定します。

  • 同時リクエストを処理し、ネットワーク レイテンシを最小限に抑える必要があるワークロード（ML 推論ワークロードなど）の場合は、SERVING を指定します。

• REGION: GPU VM または TPU を予約するリージョン。サポートされているリージョンとゾーンを確認するには、このドキュメントの制限事項をご覧ください。

• FROM_START_TIME、TO_START_TIME: 容量を予約する最も早い日付と最も遅い日付。これらの日付を RFC 3339 タイムスタンプの形式で指定します。

  YYYY-MM-DDTHH:MM:SSOFFSET
  

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

  • YYYY-MM-DD: 4 桁の年、2 桁の月、2 桁の日をハイフン（-）で区切った形式の日付。

  • HH:MM:SS: 24 時間制の 2 桁の時間、2 桁の分、2 桁の秒をコロン（:）で区切った形式の時刻。

  • OFFSET: 協定世界時（UTC）のオフセット形式で示されるタイムゾーン。たとえば、太平洋標準時（PST）を使用する場合は -08:00 を指定します。オフセットを使用しない場合は、Z を指定します。

• FROM_END_TIME と TO_END_TIME: 容量予約を終了する最早日と最遅日。これらの日付は RFC 3339 タイムスタンプとしてフォーマットします。終了時間ではなく予約期間の範囲を指定する場合は、--end-time-range フラグを --duration-range フラグに置き換えます。

出力は次のようになります。

- recommendationsPerSpec:
    spec:
      endTime: '2025-09-07T00:00:00Z'
      location: zones/us-east5-a
      otherLocations:
        zones/us-east5-b:
          details: this machine family is not supported in this zone
          status: NOT_SUPPORTED
        zones/us-east5-c:
          details: this machine family is not supported in this zone
          status: NOT_SUPPORTED
      recommendationId: 0d3f005d-f952-4fce-96f2-6af25e1591eb
      recommendationType: FUTURE_RESERVATION
      startTime: '2025-06-09T00:00:00Z'

リクエストされたリソースが使用可能な場合、出力には startTime、endTime、location の各フィールドが含まれます。これらのフィールドには、リソースが利用可能な最も早い開始時刻、最も遅い終了時刻、ゾーンを指定します。

REST

リージョンで GPU VM または TPU の将来の可用性を表示するには、ベータ版の advice.calendarMode メソッドに GET リクエストを送信します。表示するリソースに基づいて、リクエスト本文に次のフィールドを含めます。

• GPU VM の可用性を表示するには、instanceCount フィールドと machineType フィールドを指定します。

  POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/advice/calendarMode
  
  {
    "futureResourcesSpecs": {
      "spec": {
        "targetResources": {
          "specificSkuResources": {
            "instanceCount": "NUMBER_OF_VMS",
            "machineType": "MACHINE_TYPE"
          }
        },
        "timeRangeSpec": {
          "startTimeNotEarlierThan": "FROM_START_TIME",
          "startTimeNotLaterThan": "TO_START_TIME",
          "endTimeNotEarlierThan": "FROM_END_TIME",
          "endTimeNotLaterThan": "TO_END_TIME"
        }
      }
    }
  }
  

• TPU の可用性を表示するには、acceleratorCount フィールドと vmFamily フィールドを含めます。

  POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/advice/calendarMode
  
  {
    "futureResourcesSpecs": {
      "spec": {
        "targetResources": {
          "aggregateResources": {
            "acceleratorCount": "NUMBER_OF_CHIPS",
            "vmFamily": "TPU_VERSION"
          }
        },
        "timeRangeSpec": {
          "startTimeNotEarlierThan": "FROM_START_TIME",
          "startTimeNotLaterThan": "TO_START_TIME",
          "endTimeNotEarlierThan": "FROM_END_TIME",
          "endTimeNotLaterThan": "TO_END_TIME"
        }
      }
    }
  }
  

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

• PROJECT_ID: リソースを予約するプロジェクトの ID。

• REGION: GPU VM または TPU を予約するリージョン。サポートされているリージョンとゾーンを確認するには、このドキュメントの制限事項をご覧ください。

• NUMBER_OF_VMS: 予約する GPU VM の数。

• MACHINE_TYPE: 予約する GPU マシンタイプ。

• NUMBER_OF_CHIPS: 予約する TPU チップの数。

• TPU_VERSION: 予約する TPU バージョン。次のいずれかの値を指定します。

  • TPU v6e の場合: VM_FAMILY_CLOUD_TPU_LITE_POD_SLICE_CT6E

  • TPU v5p の場合: VM_FAMILY_CLOUD_TPU_POD_SLICE_CT5P

  • TPU v5e の場合: VM_FAMILY_CLOUD_TPU_LITE_POD_SLICE_CT5LP

  TPU v5e を指定する場合は、aggregateResources フィールドに workloadType フィールドを含める必要があります。このフィールドには、TPU で実行するワークロードのタイプを設定します。

  • 単一または複数のオペレーションで大量のデータを処理するワークロード（機械学習（ML）トレーニング ワークロードなど）の場合は、BATCH を指定します。

  • 同時リクエストを処理し、ネットワーク レイテンシを最小限に抑える必要があるワークロード（ML 推論ワークロードなど）の場合は、SERVING を指定します。

• FROM_START_TIME、TO_START_TIME: 容量を予約する最も早い日付と最も遅い日付。これらの日付を RFC 3339 タイムスタンプの形式で指定します。

  YYYY-MM-DDTHH:MM:SSOFFSET
  

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

  • YYYY-MM-DD: 4 桁の年、2 桁の月、2 桁の日をハイフン（-）で区切った形式の日付。

  • HH:MM:SS: 24 時間制の 2 桁の時間、2 桁の分、2 桁の秒をコロン（:）で区切った形式の時刻。

  • OFFSET: 協定世界時（UTC）のオフセット形式で示されるタイムゾーン。たとえば、太平洋標準時（PST）を使用する場合は -08:00 を指定します。オフセットを使用しない場合は、Z を指定します。

• FROM_END_TIME と TO_END_TIME: 容量予約を終了する最早日と最遅日。これらの日付は RFC 3339 タイムスタンプとしてフォーマットします。終了時刻ではなく予約期間の範囲を指定する場合は、endTimeNotEarlierThan フィールドと endTimeNotLaterThan フィールドを minDuration フィールドと maxDuration フィールドに置き換えます。

出力は次のようになります。

{
  "recommendations": [
    {
      "recommendationsPerSpec": {
        "spec": {
          "recommendationId": "a21a2fa0-72c7-4105-8179-88de5409890b",
          "recommendationType": "FUTURE_RESERVATION",
          "startTime": "2025-06-09T00:00:00Z",
          "endTime": "2025-09-07T00:00:00Z",
          "otherLocations": {
            "zones/us-east5-b": {
              "status": "NOT_SUPPORTED",
              "details": "this machine family is not supported in this zone"
            },
            "zones/us-east5-c": {
              "status": "NOT_SUPPORTED",
              "details": "this machine family is not supported in this zone"
            }
          },
          "location": "zones/us-east5-a"
        }
      }
    }
  ]
}

リクエストされたリソースが使用可能な場合、出力には startTime、endTime、location の各フィールドが含まれます。これらのフィールドには、リソースが利用可能な最も早い開始時刻、最も遅い終了時刻、ゾーンを指定します。

コンソール

1. Google Cloud コンソールで、[予約] ページに移動します。

   [予約] に移動

2. [将来の予約] タブをクリックします。

3. [add_box将来の予約を作成] をクリックします。[将来の予約を作成] ページが表示され、[ハードウェア構成] ペインが選択されています。

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

   • GPU VM または TPU のプロパティを直接指定する手順は次のとおりです。

     1. [マシンタイプを指定] を選択します。

     2. [GPU] タブまたは [TPU] タブをクリックし、予約する GPU マシンタイプまたは TPU バージョンを選択します。

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

   • 既存の VM を参照として使用して GPU VM のプロパティを指定するには、[既存の VM を使用] を選択し、VM を選択します。

5. 前の手順で TPU v5e（CT5LP）を指定した場合は、[TPU v5 ワークロード タイプ] リストで次のいずれかのオプションを選択します。

   • 単一または複数のオペレーションで大量のデータを処理するワークロード（ML トレーニング ワークロードなど）を TPU で実行するには、[バッチ] を選択します。

   • 同時リクエストを処理し、ネットワーク レイテンシを最小限に抑える必要があるワークロード（ML 推論ワークロードなど）を TPU で実行するには、[サービス提供中] を選択します。

6. [容量を検索] セクションで、次の操作を行います。

   1. [リージョン] リストと [ゾーン] リストで、リソースを予約するリージョンとゾーンを指定します。サポートされているリージョンとゾーンを確認するには、このドキュメントの制限事項をご覧ください。

   2. [必要な合計容量] フィールド（GPU VM を予約する場合）または [チップの数] リスト（TPU を予約する場合）で、予約する GPU VM または TPU チップの数を指定します。

   3. [開始時間] リストで、リクエストの開始時間を選択します。

   4. 省略可: [開始日の柔軟性を選択] リストで、開始日の正確さを選択します。

   5. [予約期間] フィールドで、リソースを予約する期間を指定します。

   6. [容量を検索] をクリックします。次に、[使用可能な容量] テーブルで、予約する GPU VM または TPU のタイプ、数、予約期間を含む使用可能なオプションのいずれかを選択します。

7. [次へ] をクリックします。

8. [共有タイプ] セクションで、リクエストした容量を共有するプロジェクトを選択します。

   • 予約済み容量をプロジェクト内でのみ使用するには、[ローカル] を選択します。

   • 予約済み容量を他のプロジェクトと共有するには、[共有] を選択し、add [プロジェクトを追加] をクリックして、プロンプトに沿ってプロジェクトを選択します。

9. [次へ] をクリックします。

10. [将来の予約の名前] フィールドに、リクエストの名前を入力します。

11. [予約名] フィールドに、リクエストした容量をプロビジョニングするために Compute Engine が自動的に作成する予約の名前を入力します。

12. [作成] をクリックします。

gcloud

カレンダー モードで将来の予約リクエストを作成して審査のために送信するには、次のいずれかの gcloud beta compute future-reservations create コマンドを使用します。予約するリソースに基づいて、次のフラグを含めます。

• GPU VM を予約するには、--total-count フラグと --machine-type フラグを指定します。

  gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
      --auto-delete-auto-created-reservations \
      --total-count=NUMBER_OF_VMS \
      --machine-type=MACHINE_TYPE \
      --deployment-type=DENSE \
      --planning-status=SUBMITTED \
      --require-specific-reservation \
      --reservation-mode=CALENDAR \
      --reservation-name=RESERVATION_NAME \
      --share-setting=SHARE_TYPE \
      --start-time=START_TIME \
      --end-time=END_TIME \
      --zone=ZONE
  

• TPU を予約するには、--chip-count フラグと --tpu-version フラグを指定します。

  gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
      --auto-delete-auto-created-reservations \
      --chip-count=NUMBER_OF_CHIPS \
      --tpu-version=TPU_VERSION \
      --deployment-type=DENSE \
      --planning-status=SUBMITTED \
      --require-specific-reservation \
      --reservation-mode=CALENDAR \
      --reservation-name=RESERVATION_NAME \
      --share-setting=SHARE_TYPE \
      --start-time=START_TIME \
      --end-time=END_TIME \
      --zone=ZONE
  

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

• FUTURE_RESERVATION_NAME: リクエストの名前。

• NUMBER_OF_VMS: 予約する GPU VM の数。

• MACHINE_TYPE: 予約する GPU マシンタイプ。

• NUMBER_OF_CHIPS: 予約する TPU チップの数。

• TPU_VERSION: 予約する TPU バージョン。次のいずれかの値を指定します。

  • TPU v6e の場合: V6E

  • TPU v5p の場合: V5P

  • TPU v5e の場合: V5E

  TPU v5e を指定する場合は、--workload-type フラグを含める必要があります。フラグを、TPU で実行するワークロードのタイプに設定します。

  • 単一または複数のオペレーションで大量のデータを処理するワークロード（機械学習（ML）トレーニング ワークロードなど）の場合は、BATCH を指定します。

  • 同時リクエストを処理し、ネットワーク レイテンシを最小限に抑える必要があるワークロード（ML 推論ワークロードなど）の場合は、SERVING を指定します。

• RESERVATION_NAME: リクエストした容量をプロビジョニングするために Compute Engine が自動的に作成する予約の名前。

• SHARE_TYPE: 組織内の他のプロジェクトが予約済み容量を使用できるかどうか。次のいずれかの値を指定します。

  • プロジェクト内でのみ容量を使用する場合: local

  • 他のプロジェクトと容量を共有する場合: projects

  projects を指定する場合は、プロジェクト ID のカンマ区切りリスト（例: project-1,project-2）に設定された --share-with フラグを含める必要があります。組織内で最大 100 個のプロジェクトを指定できます。このリストにプロジェクト ID を含めないでください。予約済みの容量はデフォルトで使用できます。

• START_TIME: リクエストの開始時間（RFC 3339 タイムスタンプの形式）。

• END_TIME: 予約期間の終了日時（RFC 3339 タイムスタンプの形式）。終了時間ではなく、予約期間の長さ（秒単位）を指定する場合は、--end-time フラグを --duration フラグに置き換えます。

• ZONE: リソースを予約するゾーン。

REST

カレンダー モードで将来の予約リクエストを作成し、審査を受けるために送信するには、ベータ版の futureReservations.insert メソッドに次の POST リクエストを送信します。予約するリソースに基づいて、リクエスト本文に次のフィールドを含めます。

• GPU VM を予約するには、totalCount フィールドと machineType フィールドを指定します。

  POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations
  
  {
    "name": "FUTURE_RESERVATION_NAME",
    "autoDeleteAutoCreatedReservations": true,
    "deploymentType": "DENSE",
    "planningStatus": "SUBMITTED",
    "reservationMode": "CALENDAR",
    "reservationName": "RESERVATION_NAME",
    "shareSettings": {
      "shareType": "SHARE_TYPE"
    },
    "specificReservationRequired": true,
    "specificSkuProperties": {
      "totalCount": NUMBER_OF_VMS,
      "instanceProperties": {
        "machineType": "MACHINE_TYPE"
      }
    },
    "timeWindow": {
      "startTime": "START_TIME",
      "endTime": "END_TIME"
    }
  }
  

• TPU を予約するには、acceleratorCount フィールドと vmFamily フィールドを含めます。

  POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations
  
  {
    "name": "FUTURE_RESERVATION_NAME",
    "autoDeleteAutoCreatedReservations": true,
    "deploymentType": "DENSE",
    "planningStatus": "SUBMITTED",
    "reservationMode": "CALENDAR",
    "reservationName": "RESERVATION_NAME",
    "shareSettings": {
      "shareType": "SHARE_TYPE"
    },
    "specificReservationRequired": true,
    "aggregateReservation": {
      "reservedResources": [
        {
          "accelerator": {
            "acceleratorCount": NUMBER_OF_CHIPS
          }
        }
      ],
      "vmFamily": "TPU_VERSION"
    },
    "timeWindow": {
      "startTime": "START_TIME",
      "endTime": "END_TIME"
    }
  }
  

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

• PROJECT_ID: リクエストを作成するプロジェクトの ID。

• ZONE: リソースを予約するゾーン。

• FUTURE_RESERVATION_NAME: リクエストの名前。

• RESERVATION_NAME: リクエストした容量をプロビジョニングするために Compute Engine が自動的に作成する予約の名前。

• SHARE_TYPE: 組織内の他のプロジェクトが予約済み容量を使用できるかどうか。次のいずれかの値を指定します。

  • プロジェクト内でのみ容量を使用する場合: LOCAL

  • 他のプロジェクトと容量を共有する場合: SPECIFIC_PROJECTS

  SPECIFIC_PROJECTS を指定する場合は、shareSettings フィールドに projectMap フィールドを含めて、容量を共有するプロジェクトを指定する必要があります。組織内で最大 100 個のプロジェクトを指定できます。プロジェクト ID を指定しないでください。予約済みの容量はデフォルトで使用できます。

  たとえば、リクエストした容量を他の 2 つのプロジェクトと共有するには、次のようにします。

  "shareSettings": {
    "shareType": "SPECIFIC_PROJECTS",
    "projectMap": {
      "CONSUMER_PROJECT_ID_1": {
        "projectId": "CONSUMER_PROJECT_ID_1"
      },
      "CONSUMER_PROJECT_ID_2": {
        "projectId": "CONSUMER_PROJECT_ID_2"
      }
    }
  }
  

  CONSUMER_PROJECT_ID_1 と CONSUMER_PROJECT_ID_2 は、リクエストした容量の使用を許可する 2 つのプロジェクトの ID に置き換えます。

• NUMBER_OF_VMS: 予約する GPU VM の数。

• MACHINE_TYPE: 予約する GPU マシンタイプ。

• NUMBER_OF_CHIPS: 予約する TPU チップの数。

• TPU_VERSION: 予約する TPU バージョン。次のいずれかの値を指定します。

  • TPU v6e の場合: VM_FAMILY_CLOUD_TPU_LITE_POD_SLICE_CT6E

  • TPU v5p の場合: VM_FAMILY_CLOUD_TPU_POD_SLICE_CT5P

  • TPU v5e の場合: VM_FAMILY_CLOUD_TPU_LITE_POD_SLICE_CT5LP

  TPU v5e を指定する場合は、aggregateResources フィールドに workloadType フィールドを含める必要があります。このフィールドには、TPU で実行するワークロードのタイプを設定します。

  • 単一または複数のオペレーションで大量のデータを処理するワークロード（機械学習（ML）トレーニング ワークロードなど）の場合は、BATCH を指定します。

  • 同時リクエストを処理し、ネットワーク レイテンシを最小限に抑える必要があるワークロード（ML 推論ワークロードなど）の場合は、SERVING を指定します。

• START_TIME: リクエストの開始時間（RFC 3339 タイムスタンプの形式）。

• END_TIME: 予約期間の終了日時（RFC 3339 タイムスタンプの形式）。終了時間ではなく予約期間の長さ（秒単位）を指定する場合は、endTime フィールドを duration フィールドに置き換えます。