予約済みの容量を表示する

このドキュメントでは、AI Hypercomputer の予約済み容量のリクエストと予約済み容量を表示する方法について説明します。予約済み容量とリクエストの可用性、プロパティ、トポロジを確認することで、ワークロードの予約済み容量を計画できます。

このドキュメントの対象範囲は、将来の予約について言及している容量オプションを使用するワークロードに限定されます。AI Hypercomputer の容量オプションの詳細については、容量の概要をご覧ください。

Google Cloud が将来の予約リクエストを承認すると、Compute Engine はリクエストされたリソースの空の予約を自動的に作成します。予約を表示して、ワークロードを計画できます。後で、リクエストされた開始時刻になると、次の処理が行われます。

• Compute Engine は、予約済み仮想マシン（VM）インスタンスを予約に追加します。その後、予約と一致する VM を作成して、予約の使用を開始できます。
• 予約を変更して、Vertex AI トレーニング ジョブまたは予測ジョブが予約を使用できるようにすることができます。手順については、 予約の共有ポリシーを変更するをご覧ください。

制限事項

共有予約または共有の将来の予約リクエストを表示できるのは、Google が作成したプロジェクトでのみです。

始める前に

1. 容量を予約する: プロジェクトでまだ容量を予約していない場合は、次のいずれかのオプションを使用して AI Hypercomputer の容量を予約します。
   • アカウント チームを通じて容量を予約する
   • カレンダー モードで将来の予約リクエストを作成する

2. 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

   In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

   REST

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

   Google Cloud CLI をインストールします。 インストール後、次のコマンドを実行して Google Cloud CLI を初期化します。

   gcloud init

   外部 ID プロバイダ（IdP）を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。

   詳細については、 Google Cloud 認証ドキュメントの REST を使用して認証するをご覧ください。

   必要なロール

   予約を表示するために必要な権限を取得するには、プロジェクトに対する Compute の将来の予約ユーザー （roles/compute.futureReservationUser）IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。

   この事前定義ロールには、予約の表示に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

   必要な権限

   予約を表示するには、次の権限が必要です。

   • 将来の予約リクエストの詳細を表示する: プロジェクトに対する compute.futureReservations.get
   • 予約の詳細を表示する: プロジェクトに対する compute.reservations.get

   カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

   予約済み容量のリクエストを表示する

   将来の予約リクエストを表示するには、次のいずれかの方法を使用します。

   • プロジェクト内のすべての将来の予約リクエストの概要を確認するには、将来の予約リクエストの一覧を表示します。
   • 1 つの将来の予約リクエストの詳細をすべて表示するには、将来の予約リクエストの詳細を表示します。

   将来の予約リクエストの一覧を表示する

   将来の予約リクエストの一覧を表示して、リクエストの予約期間、ステータス、ゾーンを確認できます。

   将来の予約リクエストの一覧を表示するには、次のいずれかのオプションを選択します。

   コンソール

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

      [予約] に移動

   2. [将来の予約] タブをクリックします。この表には、将来の予約リクエストがそれぞれ一覧表示されます。表の各列はプロパティを表します。
   3. 省略可: リクエストのリストを絞り込むには、[ フィルタ] フィールドで、リクエストをフィルタするプロパティを選択します。

   gcloud

   将来の予約リクエストのリストを表示するには、gcloud compute future-reservations list コマンドを使用します。

   gcloud compute future-reservations list
   

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

   NAME: fr-01
   TOTAL_COUNT: 100
   START_TIME: 2026-07-20T07:00:00Z
   END_TIME: 2026-08-05T07:00:00Z
   PROCUREMENT_STATUS: FULFILLED
   ZONE: us-west4-b
   
   NAME: fr-02
   TOTAL_COUNT: 10
   START_TIME: 2026-07-20T07:00:00Z
   END_TIME: 2026-12-01T00:00:00Z
   PROCUREMENT_STATUS: PENDING_APPROVAL
   ZONE: us-west4-b
   

   将来の予約リクエストのリストを絞り込む場合は、--filter フラグを指定して同じコマンドを使用します。

   REST

   将来の予約リクエストの一覧を表示するには、次のいずれかのメソッドに GET リクエストを送信します。

   • すべてのゾーンのリクエストのリストを表示するには: futureReservations.aggregatedList メソッド
   • 特定のゾーンのリクエストのリストを表示するには: futureReservations.list メソッド

   たとえば、すべてのゾーンのリクエストの一覧を表示するには、次のように GET リクエストを作成します。

   GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/futureReservations
   

   PROJECT_ID は、リクエストが存在するプロジェクトの ID に置き換えます。

   単一ゾーンの将来の予約リクエストの一覧の出力は次のようになります。

   {
     "id": "projects/example-project/aggregated/futureReservations",
     "items": [
       {
         "specificSkuProperties": {
           "instanceProperties": {
             "machineType": "a3-ultragpu-8g",
             "guestAccelerators": [
               {
                 "acceleratorType": "nvidia-h200-141gb",
                 "acceleratorCount": 8
               }
             ],
             "localSsds": [
               {
                 "diskSizeGb": "375",
                 "interface": "NVME"
               },
               ...
             ]
           },
           "totalCount": "2"
         },
         "kind": "compute#futureReservation",
         "id": "7979651787097007552",
         "creationTimestamp": "2025-11-27T11:14:58.305-08:00",
         "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/example-draft-request",
         "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/7979651787097007552",
         "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b",
         "name": "example-draft-request",
         "timeWindow": {
           "startTime": "2026-01-27T19:20:00Z",
           "endTime": "2026-02-10T19:20:00Z"
         },
         "status": {
           "procurementStatus": "DRAFTING",
           "lockTime": "2026-01-27T19:15:00Z"
         },
         "planningStatus": "DRAFT",
         "specificReservationRequired": true,
         "reservationName": "example-reservation",
         "deploymentType": "DENSE",
         "schedulingType": "INDEPENDENT",
         "autoCreatedReservationsDeleteTime": "2026-02-10T19:20:00Z"
       },
       ...
     ],
     "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/aggregated/futureReservations",
     "etag": "AnzKY34l-cvvV-JnniESJ0dtQvQ=/hvc4jaHpxFAZmOt1FVtKNgzZu-M=",
     "kind": "compute#futureReservationsListResponse"
   }
   

   将来の予約リクエストのリストを絞り込む場合は、同じリクエストを作成し、リクエスト URL に filter クエリ パラメータを含めます。

   将来の予約リクエストの詳細を表示する

   将来の予約リクエストの詳細を表示して、予約済みリソースのプロパティと予約期間を確認できます。

   将来の予約リクエストの詳細を表示するには、次のいずれかのオプションを選択します。

   コンソール

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

      [予約] に移動

   2. [将来の予約] タブをクリックします。この表には、将来の予約リクエストがそれぞれ一覧表示されます。表の各列はプロパティを表します。
   3. リクエストの詳細を表示するには、[名前] 列でリクエストの名前をクリックします。将来の予約リクエストの詳細が表示されたページが開きます。

   gcloud

   将来の予約リクエストの詳細を表示するには、gcloud compute future-reservations describe コマンドを使用します。

   gcloud compute future-reservations describe FUTURE_RESERVATION_NAME \
       --zone=ZONE
   

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

   • FUTURE_RESERVATION_NAME: 将来の予約リクエストの名前。
   • ZONE: 将来の予約リクエストが存在するゾーン。

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

   autoCreatedReservationsDeleteTime: '2026-02-10T19:20:00Z'
   creationTimestamp: '2025-11-27T11:14:58.305-08:00'
   deploymentType: DENSE
   id: '7979651787097007552'
   kind: compute#futureReservation
   name: example-draft-request
   planningStatus: DRAFT
   reservationName: example-reservation
   schedulingType: INDEPENDENT
   selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/example-draft-request
   selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/7979651787097007552
   specificReservationRequired: true
   specificSkuProperties:
     instanceProperties:
       guestAccelerators:
       -   acceleratorCount: 8
         acceleratorType: nvidia-h200-141gb
       localSsds:
       -   diskSizeGb: '375'
         interface: NVME
       ...
     machineType: a3-ultragpu-8g
   totalCount: '2'
   status:
     autoCreatedReservations:
     -   https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/reservations/example-reservation
     fulfilledCount: '2'
     lockTime: '2026-01-27T19:15:00Z'
     procurementStatus: DRAFTING
   timeWindow:
     endTime: '2026-02-10T19:20:00Z'
     startTime: '2026-01-27T19:20:00Z'
   zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b
   

   REST

   将来の予約リクエストの詳細を表示するには、futureReservations.get メソッドに対して GET リクエストを実行します。

   GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME
   

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

   • PROJECT_ID: 将来の予約リクエストが存在するプロジェクトの ID。
   • ZONE: 将来の予約リクエストが存在するゾーン。
   • FUTURE_RESERVATION_NAME: 将来の予約リクエストの名前。

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

   {
     "specificSkuProperties": {
       "instanceProperties": {
         "machineType": "a3-ultragpu-8g",
         "guestAccelerators": [
           {
             "acceleratorType": "nvidia-h200-141gb",
             "acceleratorCount": 8
           }
         ],
         "localSsds": [
           {
             "diskSizeGb": "375",
             "interface": "NVME"
           },
           ...
         ]
       },
       "totalCount": "2"
     },
     "kind": "compute#futureReservation",
     "id": "7979651787097007552",
     "creationTimestamp": "2025-11-27T11:14:58.305-08:00",
     "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/example-draft-request",
     "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/7979651787097007552",
     "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b",
     "name": "example-draft-request",
     "timeWindow": {
       "startTime": "2026-01-27T19:20:00Z",
       "endTime": "2026-02-10T19:20:00Z"
     },
     "status": {
       "procurementStatus": "DRAFTING",
       "lockTime": "2026-01-27T19:15:00Z"
     },
     "planningStatus": "DRAFT",
     "specificReservationRequired": true,
     "reservationName": "example-reservation",
     "deploymentType": "DENSE",
     "schedulingType": "INDEPENDENT",
     "autoCreatedReservationsDeleteTime": "2026-02-10T19:20:00Z"
   }
   

   予約済み容量を表示する

   次のいずれかを行う場合は、予約済み容量を確認します。

   • ワークロードのデプロイに使用する予約、ブロック、サブブロックを特定する。
   • 予約済み容量のプロパティ、使用状況、トポロジを把握する。

   予約済み容量を表示するには、次のいずれかの方法を使用します。

   • プロジェクト内のすべての予約済み容量の概要を確認し、未使用の予約済み容量を確認するには、予約のリストを表示します。
   • 予約のすべての予約済み VM のプロパティと可用性を確認するには、予約の詳細を表示します。
   • スケジューラやプランニング ツールとの統合など、予約の容量のブロックとサブブロックがどのように編成されているかを確認するには、予約のトポロジを表示します。

   予約のリストを表示する

   プロジェクト内の予約の一覧を表示して、プロジェクト内のすべての予約済み容量を確認し、ワークロードのデプロイに使用する予約を検索できます。

   予約のリストを表示するには、次のいずれかのオプションを選択します。

   コンソール

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

      [予約] に移動

      [オンデマンド予約] タブ（デフォルト）の表に、各予約が表示されます。各表の列はプロパティを表します。

   2. 省略可: 予約のリストを絞り込むには、 [フィルタ] フィールドで、予約のフィルタ条件として使用するプロパティを選択します。

   gcloud

   予約のリストを表示するには、gcloud compute reservations list コマンドを使用します。

   gcloud compute reservations list
   

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

   NAME: r-01
   IN_USE_COUNT: 0
   COUNT: 5
   ZONE: europe-west4-b
   SHARE_TYPE: LOCAL
   
   NAME: r-02
   IN_USE_COUNT: 3
   COUNT: 10
   ZONE: europe-west4-b
   SHARE_TYPE: LOCAL
   

   予約のリストを絞り込む場合は、--filter フラグを指定して同じコマンドを使用します。

   REST

   予約のリストを表示するには、次のいずれかのメソッドに GET リクエストを送信します。

   • すべてのゾーンの予約の一覧を表示するには: reservations.aggregatedList メソッド
   • 単一ゾーンの予約の一覧を表示するには: reservations.list メソッド

   たとえば、すべてのゾーンの予約の一覧を表示するには、次のように GET リクエストを送信します。

   GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/reservations
   

   PROJECT_ID は、予約が存在するプロジェクトの ID に置き換えます。

   単一ゾーンの予約リストの出力は次のようになります。

   {
     "id": "projects/example-project/zones/europe-west1-b/futureReservations",
     "items": [
       {
         "specificSkuProperties": {
           "instanceProperties": {
             "machineType": "a3-ultragpu-8g",
             "guestAccelerators": [
               {
                 "acceleratorType": "nvidia-h200-141gb",
                 "acceleratorCount": 8
               }
             ],
             "localSsds": [
               {
                 "diskSizeGb": "375",
                 "interface": "NVME"
               },
               ...
             ]
           },
           "totalCount": "2"
         },
         "kind": "compute#futureReservation",
         "id": "7979651787097007552",
         "creationTimestamp": "2025-11-27T11:14:58.305-08:00",
         "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/example-draft-request",
         "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations/7979651787097007552",
         "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b",
         "name": "example-draft-request",
         "timeWindow": {
           "startTime": "2026-01-27T19:20:00Z",
           "endTime": "2026-02-10T19:20:00Z"
         },
         "status": {
           "procurementStatus": "DRAFTING",
           "lockTime": "2026-01-27T19:15:00Z"
         },
         "planningStatus": "DRAFT",
         "specificReservationRequired": true,
         "reservationName": "example-reservation",
         "deploymentType": "DENSE",
         "schedulingType": "INDEPENDENT",
         "autoCreatedReservationsDeleteTime": "2026-02-10T19:20:00Z"
       }
       ...
     ],
     "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/futureReservations",
     "etag": "AnzKY34l-cvvV-JnniESJ0dtQvQ=/hvc4jaHpxFAZmOt1FVtKNgzZu-M=",
     "kind": "compute#futureReservationsListResponse"
   }
   

   予約のリストを絞り込む場合は、同じリクエストを作成し、リクエスト URL に filter クエリ パラメータを含めます。

   予約の詳細を表示する

   プロジェクト内の予約の詳細を表示して、次のような詳細を確認できます。

   • 予約に含まれる VM のタイプ。
   • 予約済みで使用可能な VM の数。
   • 予約の健全性（正常なブロックの数など）。（gcloud CLI または REST を使用する場合にのみ使用できます）。

   予約のブロックとサブブロックについて確認する場合は、代わりに予約のトポロジを表示するをご覧ください。

   予約の詳細を表示するには、次のいずれかのオプションを選択します。

   コンソール

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

      [予約] に移動

   2. [オンデマンド予約] テーブルの [名前] 列で、詳細を表示する予約の名前をクリックします。予約の詳細を示すページが表示されます。

   gcloud

   予約の詳細を表示するには、gcloud compute reservations describe コマンドを使用します。

   gcloud compute reservations describe RESERVATION_NAME \
       --zone=ZONE
   

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

   • RESERVATION_NAME: 予約の名前。
   • ZONE: 予約が存在するゾーン。

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

   advancedDeploymentControl:
     reservationOperationalMode: ALL_CAPACITY
   creationTimestamp: '2025-07-18T13:23:22.191-07:00'
   deleteAtTime: '2026-06-19T00:00:00Z'
   deploymentType: DENSE
   enableEmergentMaintenance: false
   id: '4298354039694234582'
   kind: compute#reservation
   name: example-res1
   reservationSharingPolicy:
     serviceShareType: DISALLOW_ALL
   resourceStatus:
     healthInfo:
       degradedBlockCount: 0
       healthStatus: HEALTHY
       healthyBlockCount: 1
     reservationBlockCount: 1
     reservationMaintenance:
       schedulingType: GROUPED
   schedulingType: GROUPED
   selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1
   selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/4298354039694234582
   shareSettings:
     shareType: LOCAL
   specificReservation:
     assuredCount: '18'
     count: '18'
     inUseCount: '2'
     instanceProperties:
       guestAccelerators:
       -   acceleratorCount: 4
         acceleratorType: nvidia-gb200
       localSsds:
       -   diskSizeGb: '3000'
         interface: NVME
       -   diskSizeGb: '3000'
         interface: NVME
       -   diskSizeGb: '3000'
         interface: NVME
       -   diskSizeGb: '3000'
         interface: NVME
       machineType: a4x-highgpu-4g
   specificReservationRequired: true
   status: READY
   zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a
   

   出力には、予約に関する次のフィールドが含まれます。

   • name: 予約の名前。
   • healthInfo: 予約の健康情報。次のとおりです。
     • degradedBlockCount: 予約内の劣化ブロックの数。
     • healthStatus: 予約の全体的な健全性ステータス。
     • healthyBlockCount: 予約内の正常なブロックの数。
   • reservationBlockCount: 予約内のブロックの合計数。
   • assuredCount: 予約を使用してデプロイできる VM の合計数。この値が count より小さい場合は、使用可能な VM が少ない場合のトラブルシューティング方法をご覧ください。
   • inUseCount: 予約にすでにデプロイされている VM の数。
   • instanceProperties: 予約をデプロイできる VM のプロパティ。

   REST

   予約の詳細を表示するには、reservations.get メソッドに GET リクエストを送信します。

   GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME
   

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

   • PROJECT_ID: 予約が存在するプロジェクトの ID。
   • ZONE: 予約が存在するゾーン。
   • RESERVATION_NAME: 予約の名前。

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

   {
     "specificReservation": {
       "instanceProperties": {
         "machineType": "a4x-highgpu-4g",
         "guestAccelerators": [
           {
             "acceleratorType": "nvidia-gb200",
             "acceleratorCount": 4
           }
         ],
         "localSsds": [
           {
             "diskSizeGb": "3000",
             "interface": "NVME"
           },
           {
             "diskSizeGb": "3000",
             "interface": "NVME"
           },
           {
             "diskSizeGb": "3000",
             "interface": "NVME"
           },
           {
             "diskSizeGb": "3000",
             "interface": "NVME"
           }
         ]
       },
       "count": "36",
       "inUseCount": "35",
       "assuredCount": "33"
     },
     "kind": "compute#reservation",
     "id": "6823689647457870910",
     "creationTimestamp": "2025-08-04T13:40:50.496-07:00",
     "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1",
     "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
     "name": "example-res1",
     "specificReservationRequired": true,
     "status": "READY",
     "shareSettings": {
       "shareType": "SPECIFIC_PROJECTS"
     },
     "resourceStatus": {
       "reservationMaintenance": {
         "upcomingGroupMaintenance": {
           "type": "SCHEDULED",
           "canReschedule": false,
           "maintenanceStatus": "ONGOING"
         },
         "maintenanceOngoingCount": 2,
         "maintenancePendingCount": 34,
         "schedulingType": "GROUPED",
         "subblockInfraMaintenanceOngoingCount": 0,
         "subblockInfraMaintenancePendingCount": 0,
         "instanceMaintenanceOngoingCount": 3,
         "instanceMaintenancePendingCount": 32
       },
       "reservationBlockCount": 1,
       "healthInfo": {
         "healthStatus": "DEGRADED",
         "healthyBlockCount": 0,
         "degradedBlockCount": 1
       }
     },
     "reservationSharingPolicy": {
       "serviceShareType": "DISALLOW_ALL"
     },
     "deploymentType": "DENSE",
     "advancedDeploymentControl": {
       "reservationOperationalMode": "ALL_CAPACITY"
     },
     "enableEmergentMaintenance": false,
     "schedulingType": "GROUPED",
     "deleteAtTime": "2025-10-01T00:00:00Z"
   }
   

   出力には、予約に関する次のフィールドが含まれます。

   • instanceProperties: 予約をデプロイできる VM のプロパティ。
   • inUseCount: 予約にすでにデプロイされている VM の数。
   • assuredCount: 予約を使用してデプロイできる VM の合計数。この値が count より小さい場合は、使用可能な VM が少ない場合のトラブルシューティング方法をご覧ください。
   • name: 予約の名前。
   • healthInfo: 予約の健康情報。次のとおりです。
     • healthStatus: 予約の全体的な健全性ステータス。
     • healthyBlockCount: 予約内の正常なブロックの数。
     • degradedBlockCount: 予約内の劣化ブロックの数。

   予約のトポロジを表示する

   予約の詳細なトポロジ情報を表示して、予約済みブロックとサブブロック内に VM を作成する場所を決定できます。すでにデプロイされている予約済み VM の配置については、コンピューティング インスタンスのトポロジを表示するをご覧ください。

   予約に関するその他の詳細を表示する場合は、予約の詳細を表示するをご覧ください。

   予約済みのブロックを表示する

   予約で使用可能なブロックを一覧表示して説明を取得するには、次のいずれかの方法を使用します。このタスクにより、以下のことを確認できます。

   • 予約に含まれる容量ブロック。
   • 各ブロックで使用可能な容量。
   • 各ブロックの健全性（正常なサブブロックの数を含む）。（gcloud CLI または REST を使用する場合にのみ使用できます）。
   • ブロックにデプロイされているすべての VM の名前、ブロック、サブブロック（gcloud CLI または REST を使用して特定のブロックを表示する場合にのみ使用できます）。

   コンソール

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

      [予約] に移動

   2. [オンデマンド予約] テーブルの [名前] 列で、詳細を表示する予約の名前をクリックします。予約の詳細ページが開きます。
   3. [リソースのトポロジ] セクションで、予約済みブロックに関する情報を確認できます。この情報には、各ブロックの次の情報が含まれます。
      • ブロック ID: ブロックの名前。
      • 数: ブロックにデプロイできる VM の合計数。
      • 使用中: ブロックにすでにデプロイされている VM の数。

   gcloud

   予約内のブロックを表示するには、次のコマンドを使用します。

   • 予約で使用可能なすべてのブロックを表示するには、gcloud compute reservations blocks list コマンドを使用します。

     gcloud compute reservations blocks list RESERVATION_NAME \
         --zone=ZONE
     

   • 予約内の特定のブロックを表示するには、gcloud compute reservations blocks describe コマンドを使用します。ブロックにデプロイされているすべての VM の名前とトポロジを表示するには、--full-view=BLOCK_VIEW_FULL フラグを追加します。

     gcloud compute reservations blocks describe RESERVATION_NAME \
         --zone=ZONE \
         --block-name=BLOCK_NAME \
         --full-view=BLOCK_VIEW_FULL
     

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

   • RESERVATION_NAME: 予約の名前。
   • ZONE: 予約が存在するゾーン。
   • BLOCK_NAME: ブロックの名前。

   各ブロックの出力は次のようになります。

   resource:
     count: 36
     creationTimestamp: '2025-08-04T15:15:07.074-07:00'
     healthInfo:
       degradedSubBlockCount: 2
       healthStatus: DEGRADED
       healthySubBlockCount: 0
     id: '4360924059555106309'
     inUseCount: 35
     kind: compute#reservationBlock
     name: example-res1-block-0001
     physicalTopology:
       block: 1acd074d42cd3be9e4486b524db2e9ab
       cluster: us-central1-cluster-dnkc
       instances:
       -   instanceId: '5815586279631866288'
         physicalHostTopology:
           host: c229b308380a83e0ca345d4a0de05aa7
           subBlock: c02af6bdaeccacef571e0adbe79e8c28
         projectId: 'PROJECT_NUMBER'
       ...
       -   instanceId: '8389759878923049076'
         physicalHostTopology:
           host: '3ac534f00c20e6e0c87c3aaff2705be6'
           subBlock: 'c081876ba0aa2857d608eb30a5b2fa40'
         projectId: 'PROJECT_NUMBER'
     reservationMaintenance:
       instanceMaintenanceOngoingCount: 3
       instanceMaintenancePendingCount: 32
       maintenanceOngoingCount: 2
       maintenancePendingCount: 34
       schedulingType: GROUPED
       subblockInfraMaintenanceOngoingCount: 0
       subblockInfraMaintenancePendingCount: 0
       upcomingGroupMaintenance:
         canReschedule: false
         maintenanceReasons:
         -   PLANNED_UPDATE
         maintenanceStatus: ONGOING
         type: SCHEDULED
         windowEndTime: '2025-09-08T17:00:00.000-07:00'
         windowStartTime: '2025-09-08T13:00:00.000-07:00'
     reservationSubBlockCount: 2
     reservationSubBlockInUseCount: 2
     selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001
     selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/4360924059555106309
     status: READY
     zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a
   

   出力には、各ブロックの次のフィールドが含まれます。

   • count: ブロックにデプロイできる VM の合計数。
   • healthInfo: ブロックのヘルス情報。次のようになります。
     • degradedSubBlockCount: ブロック内の劣化サブブロックの数。
     • healthStatus: ブロックの全体的な健全性ステータス。
     • healthySubBlockCount: ブロック内の正常なサブブロックの数。
   • inUseCount: ブロックにすでにデプロイされている VM の数。
   • name: ブロックの名前。
   • physicalTopology: 次のようなブロックの物理的な場所。これは、VM トポロジにも表示されます。
     • block: ブロックの組織固有の ID。
     • cluster: クラスタのグローバル名。
     • instances: ブロック内のすべての VM の名前と物理的な場所のリスト（このフィールドは、--full-view=BLOCK_VIEW_FULL フラグを含めた場合にのみ表示されます）。
       • instanceId: インスタンスの ID。
       • subBlock: このインスタンスが配置されているサブブロックの組織固有の ID。
       • block: このインスタンスが配置されているブロックの組織固有の ID。
   • reservationSubBlockCount: ブロック内のサブブロックの数。
   • reservationSubBlockInUseCount: 少なくとも 1 つの VM がすでにデプロイされているブロック内のサブブロックの数。

   REST

   予約内のブロックは、次の方法で確認できます。

   • 予約で使用可能なすべてのブロックを表示するには、reservationBlocks.list メソッドに GET リクエストを送信します。

     GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks
     

   • 予約内の特定のブロックを表示するには、reservationBlocks.get メソッドに GET リクエストを送信します。ブロックにデプロイされているすべての VM の名前とトポロジも表示するには、?view=FULL クエリ パラメータを追加します。

     GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME?view=FULL
     

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

   • PROJECT_ID: 予約が存在するプロジェクトの ID。
   • ZONE: 予約が存在するゾーン。
   • RESERVATION_NAME: 予約の名前。
   • BLOCK_NAME: ブロックの名前。

   各ブロックの出力は次のようになります。

   {
     "resource": {
       "kind": "compute#reservationBlock",
       "id": "4360924059555106309",
       "creationTimestamp": "2025-08-04T15:15:07.074-07:00",
       "name": "example-res1-block-0001",
       "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
       "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001",
       "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/4360924059555106309",
       "count": 36,
       "inUseCount": 35,
       "reservationMaintenance": {
         "upcomingGroupMaintenance": {
           "type": "SCHEDULED",
           "canReschedule": false,
           "windowStartTime": "2025-09-08T13:00:00.000-07:00",
           "windowEndTime": "2025-09-08T17:00:00.000-07:00",
           "maintenanceStatus": "ONGOING",
           "maintenanceReasons": [
             "PLANNED_UPDATE"
           ]
         },
         "maintenanceOngoingCount": 2,
         "maintenancePendingCount": 34,
         "schedulingType": "GROUPED",
         "subblockInfraMaintenanceOngoingCount": 0,
         "subblockInfraMaintenancePendingCount": 0,
         "instanceMaintenanceOngoingCount": 3,
         "instanceMaintenancePendingCount": 32
       },
       "status": "READY",
       "physicalTopology": {
         "cluster": "us-central1-cluster-dnkc",
         "block": "1acd074d42cd3be9e4486b524db2e9ab",
         "instances": [
           {
             "instanceId": "5815586279631866288",
             "projectId": "PROJECT_NUMBER",
             "physicalHostTopology": {
               "subBlock": "c02af6bdaeccacef571e0adbe79e8c28",
               "host": "c229b308380a83e0ca345d4a0de05aa7"
             }
           },
           ...
           {
             "instanceId": "8389759878923049076",
             "projectId": "PROJECT_NUMBER",
             "physicalHostTopology": {
               "subBlock": "c081876ba0aa2857d608eb30a5b2fa40",
               "host": "3ac534f00c20e6e0c87c3aaff2705be6"
             }
           }
         ]
       },
       "reservationSubBlockCount": 2,
       "reservationSubBlockInUseCount": 2,
       "healthInfo": {
         "healthStatus": "DEGRADED",
         "healthySubBlockCount": 0,
         "degradedSubBlockCount": 2
       }
     }
   }
   

   出力には、各ブロックの次のフィールドが含まれます。

   • name: ブロックの名前。
   • count: ブロックにデプロイできる VM の合計数。
   • inUseCount: ブロックにすでにデプロイされている VM の数。
   • physicalTopology: 次のようなブロックの物理的な場所。これは、VM トポロジにも表示されます。
     • cluster: クラスタのグローバル名。
     • block: ブロックの組織固有の ID。
     • instances: ブロック内のすべての VM の名前と物理的な場所のリスト（このフィールドは、?view=FULL クエリ パラメータを含める場合にのみ表示されます）。
       • instanceId: インスタンスの ID。
       • subBlock: このインスタンスが配置されているサブブロックの組織固有の ID。
       • block: このインスタンスが配置されているブロックの組織固有の ID。
   • reservationSubBlockCount: ブロック内のサブブロックの数。
   • reservationSubBlockInUseCount: 少なくとも 1 つの VM がすでにデプロイされているブロック内のサブブロックの数。
   • healthInfo: ブロックのヘルス情報。次のようになります。
     • healthStatus: ブロックの全体的な健全性ステータス。
     • healthySubBlockCount: ブロック内の正常なサブブロックの数。
     • degradedSubBlockCount: ブロック内の劣化サブブロックの数。

   予約済みのサブブロックを表示する

   予約のブロックで使用可能なサブブロックを一覧表示して説明を取得するには、Google Cloud CLI または REST API を使用します。このタスクにより、以下のことを確認できます。

   • 予約済みブロックに含まれる容量のサブブロック。
   • 各サブブロックで使用可能な容量。
   • 正常なホストマシン数と正常なアクセラレータ インターコネクト数など、各サブブロックの健全性。

   gcloud

   予約内のサブブロックを表示するには、次のコマンドを使用します。

   • 予約のブロックで使用可能なすべてのサブブロックを表示するには、gcloud compute reservations sub-blocks list コマンドを使用します。

     gcloud compute reservations sub-blocks list RESERVATION_NAME \
         --zone=ZONE \
         --block-name=BLOCK_NAME
     

   • 予約のブロック内の特定のサブブロックを表示するには、gcloud compute reservations sub-blocks describe コマンドを使用します。

     gcloud compute reservations sub-blocks describe RESERVATION_NAME \
         --zone=ZONE \
         --block-name=BLOCK_NAME \
         --sub-block-name=SUB-BLOCK_NAME
     

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

   • RESERVATION_NAME: 予約の名前。
   • ZONE: 予約が存在するゾーン。
   • BLOCK_NAME: ブロックの名前。
   • SUB-BLOCK_NAME: サブブロックの名前。

   各サブブロックの出力は次のようになります。

   count: 18
   creationTimestamp: '2025-07-18T14:50:01.652-07:00'
   healthInfo:
     degradedHostCount: 0
     degradedInfraCount: 0
     healthStatus: HEALTHY
     healthyHostCount: 18
     healthyInfraCount: 1
   id: '6848013619223297894'
   inUseCount: 2
   kind: compute#reservationSubBlock
   name: example-res1-block-0001-subblock-0001
   physicalTopology:
     block: 2b6aa63faa2b60b7ecd3b87ec337f270
     cluster: us-central1-cluster-xvhj
     subBlock: 556a310b49a0b247bc109cc7f997cea2
   reservationSubBlockMaintenance:
     schedulingType: GROUPED
   selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001/reservationSubBlocks/example-res1-block-0001-subblock-0001
   selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001/reservationSubBlocks/6848013619223297894
   status: READY
   zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a
   

   出力には、各サブブロックの次のフィールドが含まれます。

   • count: サブブロックにデプロイできる VM の合計数。
   • healthInfo: サブブロックのヘルス情報。次のようになります。
     • degradedHostCount: サブブロック内の障害が発生したホストマシンの数。
     • degradedInfraCount: サブブロック内のパフォーマンスが低下したアクセラレータ インターコネクトの数。
     • healthStatus: サブブロックの全体的な健全性ステータス。
     • healthyHostCount: サブブロック内の正常なホストマシンの数。
     • healthyInfraCount: サブブロック内の正常なアクセラレータ インターコネクトの数。
   • inUseCount: サブブロックにすでにデプロイされている VM の数。
   • name: サブブロックの名前。
   • physicalTopology: 次のようなサブブロックの物理的な場所。これは VM トポロジにも表示されます。
     • block: ブロックの組織固有の ID。
     • cluster: クラスタのグローバル名。
     • subblock: サブブロックの組織固有の ID。

   REST

   予約のサブブロックは、次の方法で確認できます。

   • 予約のブロックで使用可能なすべてのサブブロックを表示するには、reservationSubBlocks.list メソッドに GET リクエストを送信します。

     GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME/reservationSubBlocks
     

   • 予約のブロック内の特定のサブブロックを表示するには、reservationSubBlocks.get メソッドに GET リクエストを送信します。

     GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME/reservationSubBlocks/SUB-BLOCK_NAME
     

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

   • PROJECT_ID: 予約が存在するプロジェクトの ID。
   • ZONE: 予約が存在するゾーン。
   • RESERVATION_NAME: 予約の名前。
   • BLOCK_NAME: ブロックの名前。
   • SUB-BLOCK_NAME: サブブロックの名前。

   各サブブロックの出力は次のようになります。

   {
     "resource": {
       "kind": "compute#reservationSubBlock",
       "id": "5679680646666817028",
       "creationTimestamp": "2025-08-04T15:15:07.625-07:00",
       "name": "example-res1-block-0001-subblock-0001",
       "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
       "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001/reservationSubBlocks/example-res1-block-0001-subblock-0001",
       "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1/reservationBlocks/example-res1-block-0001/reservationSubBlocks/5679680646666817028",
       "count": 18,
       "inUseCount": 18,
       "reservationSubBlockMaintenance": {
         "upcomingGroupMaintenance": {
           "type": "SCHEDULED",
           "canReschedule": false,
           "windowStartTime": "2025-09-08T13:00:00.000-07:00",
           "windowEndTime": "2025-09-08T17:00:00.000-07:00",
           "maintenanceStatus": "ONGOING",
           "maintenanceReasons": [
             "PLANNED_UPDATE"
           ]
         },
         "maintenanceOngoingCount": 2,
         "maintenancePendingCount": 16,
         "schedulingType": "GROUPED",
         "subblockInfraMaintenanceOngoingCount": 0,
         "subblockInfraMaintenancePendingCount": 0,
         "instanceMaintenanceOngoingCount": 3,
         "instanceMaintenancePendingCount": 15
       },
       "status": "READY",
       "physicalTopology": {
         "cluster": "us-central1-cluster-dnkc",
         "block": "1acd074d42cd3be9e4486b524db2e9ab",
         "subBlock": "c081876ba0aa2857d608eb30a5b2fa40"
       },
       "healthInfo": {
         "healthStatus": "DEGRADED",
         "healthyHostCount": 16,
         "degradedHostCount": 2,
         "healthyInfraCount": 1,
         "degradedInfraCount": 0
       }
     }
   }
   

   出力には、各サブブロックの次のフィールドが含まれます。

   • name: サブブロックの名前。
   • count: サブブロックにデプロイできる VM の合計数。
   • inUseCount: サブブロックにすでにデプロイされている VM の数。
   • physicalTopology: 次のようなサブブロックの物理的な場所。これは VM トポロジにも表示されます。
     • cluster: クラスタのグローバル名。
     • block: ブロックの組織固有の ID。
     • subblock: サブブロックの組織固有の ID。
   • healthInfo: サブブロックのヘルス情報。次のようになります。
     • healthStatus: サブブロックの全体的な健全性ステータス。
     • healthyHostCount: サブブロック内の正常なホストマシンの数。
     • degradedHostCount: サブブロック内の障害が発生したホストマシンの数。
     • healthyInfraCount: サブブロック内の正常なアクセラレータ インターコネクトの数。
     • degradedInfraCount: サブブロック内のパフォーマンスが低下したアクセラレータ インターコネクトの数。

   次のステップ

   • VM とクラスタの作成の概要
   • 予約の使用状況を表示する
   フィードバックを送信