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

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

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

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

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

制限事項

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

始める前に

容量を予約する: プロジェクトでまだ容量を予約していない場合は、次のいずれかのオプションを使用して AI Hypercomputer の容量を予約します。
- Google のアカウント担当者を通じて容量を予約する
- カレンダーモードで将来の予約リクエストを作成する
このページのサンプルをどのように使うかに応じて、タブを選択してください。
コンソール

Google Cloud コンソールを使用して Google Cloud サービスと API にアクセスする場合、認証を設定する必要はありません。

gcloud

Google Cloud コンソールで Cloud Shell をアクティブにします。

Cloud Shell をアクティブにする

Google Cloud コンソールの下部にある Cloud Shell セッションが開始し、コマンドラインプロンプトが表示されます。Cloud Shell はシェル環境です。Google Cloud CLI がすでにインストールされており、現在のプロジェクトの値もすでに設定されています。セッションが初期化されるまで数秒かかることがあります。
REST

このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。
詳細については、 Google Cloud 認証ドキュメントの REST を使用して認証するをご覧ください。

必要なロール

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

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

必要な権限

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

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

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

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

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

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

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

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

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

コンソール

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

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 クエリパラメータを含めます。

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

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

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

コンソール

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

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

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 のプロパティと可用性を確認するには、予約の詳細を表示します。
スケジューラやプランニングツールとの統合など、予約の容量のブロックとサブブロックがどのように編成されているかを確認するには、予約のトポロジを表示します。

予約のリストを表示する

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

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

コンソール

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

[オンデマンド予約] タブ（デフォルト）の表に、各予約が表示されます。各表の列はプロパティを表します。
省略可: 予約のリストを絞り込むには、 [フィルタ] フィールドで、予約のフィルタ条件として使用するプロパティを選択します。

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 クエリパラメータを含めます。

予約の詳細を表示する

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

予約に含まれるコンピューティングインスタンスのタイプ。
予約済みで使用可能なコンピューティングインスタンスの数。
予約の健全性（正常なブロックの数など）。（gcloud CLI または REST を使用する場合にのみ使用できます）。

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

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

コンソール

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

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

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

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

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

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

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

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

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

コンソール

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

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

gcloud

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

予約で使用可能なすべてのブロックを表示するには、 gcloud compute reservations blocks list コマンドを使用します。
```
gcloud compute reservations blocks list RESERVATION_NAME \
    --zone=ZONE
```
予約内の特定のブロックを表示するには、 gcloud compute reservations blocks describe コマンドを使用します。ブロックにデプロイされているすべてのコンピューティングインスタンスの名前とトポロジを表示するには、--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: ブロックにデプロイできるコンピューティングインスタンスの合計数。
healthInfo: ブロックのヘルス情報。次のようになります。
- degradedSubBlockCount: ブロック内の障害が発生したサブブロックの数。
- healthStatus: ブロックの全体的な健全性ステータス。
- healthySubBlockCount: ブロック内の正常なサブブロックの数。
inUseCount: ブロックにすでにデプロイされているコンピューティングインスタンスの数。
name: ブロックの名前。
physicalTopology: 次のようなブロックの物理的な場所。これは、コンピューティングインスタンストポロジにも表示されます。
- block: ブロックの組織固有の ID。
- cluster: クラスタのグローバル名。
- instances: ブロック内のすべてのコンピューティングインスタンスの名前と物理的な場所のリスト（このフィールドは、--full-view=BLOCK_VIEW_FULL フラグを含めた場合にのみ表示されます）。
  - instanceId: インスタンスの ID。
  - subBlock: このインスタンスが配置されているサブブロックの組織固有の ID。
  - block: このインスタンスが配置されているブロックの組織固有の ID。
reservationSubBlockCount: ブロック内のサブブロックの数。
reservationSubBlockInUseCount: 少なくとも 1 つのコンピューティングインスタンスがすでにデプロイされているブロック内のサブブロックの数。

REST

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

予約で使用可能なすべてのブロックを表示するには、reservationBlocks.list メソッドに GET リクエストを送信します。
```
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks
```
予約内の特定のブロックを表示するには、reservationBlocks.get メソッドに GET リクエストを送信します。ブロックにデプロイされているすべてのコンピューティングインスタンスの名前とトポロジも表示するには、?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: ブロックにデプロイできるコンピューティングインスタンスの合計数。
inUseCount: ブロックにすでにデプロイされているコンピューティングインスタンスの数。
physicalTopology: 次のようなブロックの物理的な場所。これは、コンピューティングインスタンストポロジにも表示されます。
- cluster: クラスタのグローバル名。
- block: ブロックの組織固有の ID。
- instances: ブロック内のすべてのコンピューティングインスタンスの名前と物理的な場所のリスト（このフィールドは、?view=FULL クエリパラメータを含める場合にのみ表示されます）。
  - instanceId: インスタンスの ID。
  - subBlock: このコンピューティングインスタンスが配置されているサブブロックの組織固有の ID。
  - block: このコンピューティングインスタンスが配置されているブロックの組織固有の ID。
reservationSubBlockCount: ブロック内のサブブロックの数。
reservationSubBlockInUseCount: 少なくとも 1 つのコンピューティングインスタンスがすでにデプロイされているブロック内のサブブロックの数。
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: サブブロックにデプロイできるコンピューティングインスタンスの合計数。
healthInfo: サブブロックのヘルス情報。次のようになります。
- degradedHostCount: サブブロック内の障害が発生したホストマシンの数。
- degradedInfraCount: サブブロック内のパフォーマンスが低下したアクセラレータインターコネクトの数。
- healthStatus: サブブロックの全体的な健全性ステータス。
- healthyHostCount: サブブロック内の正常なホストマシンの数。
- healthyInfraCount: サブブロック内の正常なアクセラレータインターコネクトの数。
inUseCount: サブブロックにすでにデプロイされているコンピューティングインスタンスの数。
name: サブブロックの名前。
physicalTopology: 次のようなサブブロックの物理的な場所。これは、コンピューティングインスタンストポロジにも表示されます。
- 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: サブブロックにデプロイできるコンピューティングインスタンスの合計数。
inUseCount: サブブロックにすでにデプロイされているコンピューティングインスタンスの数。
physicalTopology: 次のようなサブブロックの物理的な場所。これは、コンピューティングインスタンストポロジにも表示されます。
- cluster: クラスタのグローバル名。
- block: ブロックの組織固有の ID。
- subblock: サブブロックの組織固有の ID。
healthInfo: サブブロックのヘルス情報。次のようになります。
- healthStatus: サブブロックの全体的な健全性ステータス。
- healthyHostCount: サブブロック内の正常なホストマシンの数。
- degradedHostCount: サブブロック内の障害が発生したホストマシンの数。
- healthyInfraCount: サブブロック内の正常なアクセラレータインターコネクトの数。
- degradedInfraCount: サブブロック内のパフォーマンスが低下したアクセラレータインターコネクトの数。

予約済みの容量を表示する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

制限事項

始める前に

コンソール

gcloud

REST

必要なロール

必要な権限

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

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

コンソール

gcloud

REST

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

コンソール

gcloud

REST

予約済み容量を表示する

予約のリストを表示する

コンソール

gcloud

REST

予約の詳細を表示する

コンソール

gcloud

REST

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

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

コンソール

gcloud

REST

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

gcloud

REST

次のステップ

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