このページは Cloud Translation API によって翻訳されました。

予約済み容量を表示する

このドキュメントでは、H4D VM と強化された管理機能を備えた HPC クラスタの予約済み容量のリクエストと予約済み容量を表示する方法について説明します。予約済み容量とリクエストの可用性、プロパティ、トポロジを確認することで、ワークロードの予約済み容量を計画できます。

このドキュメントの対象範囲は、将来の予約について言及している容量オプションを使用するワークロードに限定されます。H4D VM と拡張管理機能を備えた HPC クラスタの容量オプションの詳細については、消費オプションを選択して容量を取得するをご覧ください。

Google Cloud が将来の予約リクエストを承認すると、Compute Engine はリクエストされたリソースの空の予約を自動的に作成します。予約を表示して、ワークロードを計画できます。後で、リクエストされた開始時刻に、Compute Engine は予約済み仮想マシン（VM）インスタンスを予約に追加します。その後、予約と一致する VM を作成して、予約の使用を開始できます。

始める前に

容量を予約する: プロジェクトでまだ容量を予約していない場合は、次のいずれかのオプションを使用して H4D インスタンスの容量を予約します。
- アカウントチームを通じて容量を予約する
- カレンダーモードで将来の予約リクエストを作成する
まだ設定していない場合は、認証を設定します。認証では、 Google Cloud サービスと API にアクセスするための ID が確認されます。ローカル開発環境からコードまたはサンプルを実行するには、次のいずれかのオプションを選択して Compute Engine に対する認証を行います。
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
1. Google Cloud CLI をインストールします。インストール後、次のコマンドを実行して Google Cloud CLI を初期化します。
  gcloud init
  外部 ID プロバイダ（IdP）を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。
  
  注: すでに gcloud CLI をインストールしている場合は、gcloud components update を実行して、最新バージョンがインストールされていることを確認してください。
2. Set a default region and zone.
REST

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

必要なロール

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

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

必要な権限

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

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

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

制限事項

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

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

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

プロジェクト内のすべての将来の予約リクエストの概要を確認するには、将来の予約リクエストのリストを表示します。
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": "h4d-standard-192-lssd",
          "localSsds": [
            {
              "diskSizeGb": "375",
              "interface": "NVME"
            },
            ...
          ]
        },
        "totalCount": "8"
      },
      "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/us-central1-a/futureReservations/example-draft-request",
      "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/futureReservations/7979651787097007552",
      "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
      "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": "h4d-standard-192"
    },
    "totalCount": "8"
  },
  "kind": "compute#futureReservation",
  "id": "7201773389437194422",
  "creationTimestamp": "2025-11-27T11:14:58.305-08:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/futureReservations/example-draft-request",
  "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/futureReservations/7201773389437194422",
  "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
  "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": "GROUPED",
  "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-west4-b/futureReservations",
  "items": [
    {
      "specificSkuProperties": {
        "instanceProperties": {
          "machineType": "h4d-highmem-192-lssd",
          "localSsds": [
            {
              "diskSizeGb": "375",
              "interface": "NVME"
            }
          ]
        },
        "totalCount": "8"
      },
      "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-west4-b/futureReservations/example-draft-request",
      "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west4-b/futureReservations/7979651787097007552",
      "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west4-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": "GROUPED",
      "autoCreatedReservationsDeleteTime": "2026-02-10T19:20:00Z"
    }
    ...
  ],
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west4-b/futureReservations",
  "etag": "AnzKY34l-cvvV-JnniESJ0dtQvQ=/hvc4jaHpxFAZmOt1FVtKNgzZu-M=",
  "kind": "compute#futureReservationsListResponse"
}

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

予約の詳細を表示する

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

予約に含まれる VM のタイプ。
予約で予約済みで使用可能な VM の数。

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

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

コンソール

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

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

gcloud

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

gcloud compute reservations describe RESERVATION_NAME \
    --zone=ZONE

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

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

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

advancedDeploymentControl:
  reservationOperationalMode: HIGHLY_AVAILABLE_CAPACITY
creationTimestamp: '2025-11-20T15:49:02.541-07:00'
deleteAtTime: '2026-01-31T07:00:00Z'
deploymentType: DENSE
id: '5555834036379788721'
kind: compute#reservation
name: example-res1
reservationSharingPolicy:
  serviceShareType: DISALLOW_ALL
resourceStatus:
  reservationBlockCount: 1
  reservationMaintenance:
    schedulingType: GROUPED
schedulingType: GROUPED
selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations/example-res1
shareSettings:
  shareType: LOCAL
specificReservation:
  assuredCount: '8'
  count: '8'
  inUseCount: '0'
  instanceProperties:
    machineType: h4d-highmem-192
    minCpuPlatform: Any CPU Platform
specificReservationRequired: true
status: READY
zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a

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

name: 予約の名前。
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": "h4d-highmem-192-lssd",
      "minCpuPlatform": "Any CPU Platform",
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        },
        {
          "diskSizeGb": "375",
          "interface": "NVME"
        }
      ]
    },
    "count": "8",
    "inUseCount": "0",
    "assuredCount": "8"
  },
  "kind": "compute#reservation",
  "id": "5555834036379788721",
  "creationTimestamp": "2025-11-20T15:49:02.541-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": "LOCAL"
  },
  "resourceStatus": {
    "reservationMaintenance": {
      "schedulingType": "INDEPENDENT"
    },
    "reservationBlockCount": 1
  },
  "reservationSharingPolicy": {
    "serviceShareType": "DISALLOW_ALL"
  },
  "deploymentType": "DENSE",
  "advancedDeploymentControl": {
    "reservationOperationalMode": "HIGHLY_AVAILABLE_CAPACITY"
  },
  "schedulingType": "INDEPENDENT",
  "deleteAtTime": "2026-01-31T07:00:00Z"
}

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

instanceProperties: 予約をデプロイできる VM のプロパティ。
inUseCount: 予約にすでにデプロイされている VM の数。
assuredCount: 予約を使用してデプロイできる VM の合計数。この値が count より小さい場合は、使用可能な VM が少ない場合のトラブルシューティング方法をご覧ください。
name: 予約の名前。

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

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

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

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

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

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

コンソール

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

[予約] に移動
[オンデマンド予約] テーブルの [名前] 列で、詳細を表示する予約の名前をクリックします。予約の詳細ページが開きます。
[リソーストポロジ] セクションで、予約済みブロックに関する情報を確認できます。この情報には、各ブロックについて次の情報が含まれます。
- ブロック 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'
  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 の合計数。
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
  }
}

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

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

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

予約のブロックで使用可能なサブブロックを一覧表示して説明するには、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'
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 の合計数。
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"
    }
  }
}

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

name: サブブロックの名前。
count: サブブロックにデプロイできる VM の合計数。
inUseCount: サブブロックにすでにデプロイされている VM の数。
physicalTopology: サブブロックの物理的な場所。 VM トポロジにも次のように表示されます。
- cluster: クラスタのグローバル名。
- block: ブロックの組織固有の ID。
- subblock: サブブロックの組織固有の ID。

次のステップ

利用可能なすべての使用オプションについては、HPC クラスタの作成の概要をご覧ください。
Cloud RDMA を使用する HPC 最適化インスタンスを一括作成する
H4D インスタンスを使用して RDMA 対応の HPC Slurm クラスタを作成する
予約で制限された使用量で HPC ワークロードの MIG を作成する

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

始める前に

Console

gcloud

REST

必要なロール

必要な権限

制限事項

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

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

コンソール

gcloud

REST

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

コンソール

gcloud

REST

予約済み容量を表示する

予約のリストを表示する

コンソール

gcloud

REST

予約の詳細を表示する

コンソール

gcloud

REST

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

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

コンソール

gcloud

REST

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

gcloud

REST

次のステップ

予約済み容量を表示する