Reservierte Kapazität ansehen

In diesem Dokument wird beschrieben, wie Sie Ihre Anfragen für reservierte Kapazität und Ihre reservierte Kapazität für HPC-Cluster mit H4D-VMs und erweiterten Verwaltungsfunktionen ansehen. Wenn Sie sich die Verfügbarkeit, Eigenschaften und Topologie Ihrer reservierten Kapazität und Anfragen ansehen, können Sie die reservierte Kapazität für Ihre Arbeitslasten planen.

Der Umfang dieses Dokuments beschränkt sich auf Arbeitslasten, für die eine Kapazitätsoption verwendet wird, in der zukünftige Reservierungen erwähnt werden. Weitere Informationen zu den Kapazitätsoptionen für HPC-Cluster mit H4D-VMs und erweiterten Verwaltungsfunktionen finden Sie unter Nutzungsoption auswählen und Kapazität erhalten.

Nachdem Google Cloud eine Anfrage für eine zukünftige Reservierung genehmigt hat, erstellt Compute Engine automatisch (automatisch erstellt) eine leere Reservierung für die angeforderten Ressourcen. Anschließend können Sie sich die Reservierung ansehen, um Ihre Arbeitslast zu planen. Später, zur angeforderten Startzeit, fügt Compute Engine die reservierten VM-Instanzen der Reservierung hinzu. Sie können die Reservierung dann verwenden, indem Sie VMs erstellen, die der Reservierung entsprechen.

Hinweise

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Compute Future Reservation User (roles/compute.futureReservationUser) für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aufrufen von Reservierungen benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Aufrufen von Reservierungen erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um Reservierungen anzusehen:

  • So zeigen Sie die Details einer vorausschauenden Reservierungsanfrage an: compute.futureReservations.get im Projekt
  • So zeigen Sie die Details einer Reservierung an: compute.reservations.get im Projekt

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Beschränkungen

Sie können eine freigegebene Reservierung oder eine freigegebene vorausschauende Reservierungsanfrage nur in dem Projekt ansehen, in dem sie von Google erstellt wurde.

Anfragen für reservierte Kapazität ansehen

Verwenden Sie eine oder mehrere der folgenden Methoden, um Ihre zukünftigen Reservierungsanfragen aufzurufen:

Liste Ihrer vorausschauenden Reservierungsanfragen ansehen

Sie können eine Liste Ihrer zukünftigen Reservierungsanfragen aufrufen, um den Reservierungszeitraum, den Status und die Zone Ihrer Anfragen zu sehen.

Wählen Sie eine der folgenden Optionen aus, um eine Liste Ihrer vorausschauenden Reservierungsanfragen aufzurufen:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Reservierungen auf.

    Zu „Reservierungen“

  2. Klicken Sie auf den Tab Vorausschauende Reservierungen. In der Tabelle ist jede zukünftige Reservierungsanfrage aufgeführt. Jede Tabellenspalte beschreibt eine Eigenschaft.
  3. Optional: Wenn Sie die Liste der Anfragen eingrenzen möchten, wählen Sie im Feld Filter die Attribute aus, nach denen die Anfragen gefiltert werden sollen.

gcloud

Verwenden Sie den Befehl gcloud compute future-reservations list, um eine Liste Ihrer zukünftigen Reservierungsanfragen aufzurufen: 

gcloud compute future-reservations list

Die Ausgabe sieht etwa so aus wie im folgenden Beispiel.

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

Wenn Sie die Liste der vorausschauenden Reservierungsanfragen eingrenzen möchten, verwenden Sie denselben Befehl mit dem --filter-Flag.

REST

Wenn Sie eine Liste Ihrer zukünftigen Reservierungsanfragen aufrufen möchten, stellen Sie eine GET-Anfrage an eine der folgenden Methoden:

Wenn Sie beispielsweise eine Liste der Anfragen in allen Zonen aufrufen möchten, stellen Sie eine GET-Anfrage:

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

Ersetzen Sie PROJECT_ID durch die ID des Projekts, in dem sich die Anfragen befinden.

Die Ausgabe für eine Liste von vorausschauenden Reservierungsanfragen in einer einzelnen Zone sieht in etwa so aus:

{
  "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"
}

Wenn Sie die Liste der Anfragen für vorausschauende Reservierungen eingrenzen möchten, stellen Sie dieselbe Anfrage und fügen Sie in die Anfrage-URL den filter Abfrageparameter ein.

Details einer vorausschauenden Reservierungsanfrage ansehen

Sie können die Details einer vorausschauenden Reservierungsanfrage aufrufen, um die Eigenschaften und den Reservierungszeitraum Ihrer reservierten Ressourcen zu prüfen.

Wählen Sie eine der folgenden Optionen aus, um die Details einer zukünftigen Reservierungsanfrage aufzurufen:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Reservierungen auf.

    Zu „Reservierungen“

  2. Klicken Sie auf den Tab Vorausschauende Reservierungen. In der Tabelle ist jede zukünftige Reservierungsanfrage aufgeführt. Jede Tabellenspalte beschreibt eine Eigenschaft.
  3. Wenn Sie die Details einer Anfrage aufrufen möchten, klicken Sie in der Spalte Name auf den Namen der Anfrage. Eine Seite mit den Details der vorausschauenden Reservierungsanfrage wird geöffnet.

gcloud

Verwenden Sie den gcloud compute future-reservations describe-Befehl, um die Details einer zukünftigen Reservierungsanfrage aufzurufen:

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

Ersetzen Sie Folgendes:

  • FUTURE_RESERVATION_NAME: der Name der zukünftigen Reservierungsanfrage.
  • ZONE: die Zone, in der die zukünftige Reservierungsanfrage vorhanden ist.

Die Ausgabe sieht etwa so aus wie im folgenden Beispiel.

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

Wenn Sie die Details einer zukünftigen Reservierungsanfrage aufrufen möchten, stellen Sie eine GET-Anfrage an die futureReservations.get-Methode:

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID des Projekts, in dem die zukünftige Reservierungsanfrage vorhanden ist.
  • ZONE: die Zone, in der die zukünftige Reservierungsanfrage vorhanden ist.
  • FUTURE_RESERVATION_NAME: der Name der zukünftigen Reservierungsanfrage.

Die Ausgabe sieht etwa so aus:

{
  "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"
}

Reservierte Kapazität ansehen

Sie können Ihre reservierte Kapazität ansehen, wenn Sie Folgendes tun möchten:

  • Suchen Sie eine Reservierung, einen Block und einen Unterblock, die Sie zum Bereitstellen einer Arbeitslast verwenden möchten.
  • Eigenschaften, Nutzung und Topologie Ihrer reservierten Kapazität

Sie haben folgende Möglichkeiten, um Ihre reservierte Kapazität aufzurufen:

Liste Ihrer Reservierungen ansehen

Sie können sich eine Liste Ihrer Reservierungen in Ihrem Projekt ansehen, um die gesamte reservierte Kapazität in Ihrem Projekt zu sehen und nach einer Reservierung zu suchen, die Sie zum Bereitstellen Ihrer Arbeitslast verwenden können.

Wählen Sie eine der folgenden Optionen aus, um eine Liste Ihrer Reservierungen aufzurufen:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Reservierungen auf.

    Zu „Reservierungen“

    Auf dem Tab On-Demand-Reservierungen (Standard) wird in der Tabelle jede Reservierung aufgeführt und in jeder Spalte ein Attribut beschrieben.

  2. Optional: Wenn Sie die Liste der Reservierungen eingrenzen möchten, wählen Sie im Feld Filter die Attribute aus, nach denen die Reservierungen gefiltert werden sollen.

gcloud

Verwenden Sie den Befehl gcloud compute reservations list, um eine Liste Ihrer Reservierungen aufzurufen: 

gcloud compute reservations list

Die Ausgabe sieht etwa so aus:

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

Wenn Sie die Liste der Reservierungen eingrenzen möchten, verwenden Sie denselben Befehl mit dem Flag --filter.

REST

Stellen Sie eine GET-Anfrage an eine der folgenden Methoden, um eine Liste Ihrer Reservierungen aufzurufen:

Wenn Sie beispielsweise eine Liste Ihrer Reservierungen in allen Zonen aufrufen möchten, stellen Sie eine GET-Anfrage wie die folgende:

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

Ersetzen Sie PROJECT_ID durch die ID des Projekts, in dem die Reservierungen vorhanden sind.

Die Ausgabe für eine Liste von Reservierungen in einer einzelnen Zone sieht in etwa so aus:

{
  "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"
}

Wenn Sie die Liste der Reservierungen eingrenzen möchten, stellen Sie dieselbe Anfrage und fügen Sie in der Anfrage-URL den Abfrageparameter filter ein.

Details einer Reservierung ansehen

Sie können die Details einer Reservierung in Ihrem Projekt aufrufen, um Informationen wie die folgenden zu sehen:

  • Welche Arten von VMs in der Reservierung enthalten sind.
  • Anzahl der reservierten und in der Reservierung verfügbaren VMs.

Wenn Sie die Blöcke und Unterblöcke einer Reservierung sehen möchten, lesen Sie stattdessen Topologie einer Reservierung ansehen.

Wählen Sie eine der folgenden Optionen aus, um die Details einer Reservierung aufzurufen:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Reservierungen auf.

    Zu „Reservierungen“

  2. Klicken Sie in der Tabelle On-demand reservations (On-Demand-Reservierungen) in der Spalte Name auf den Namen der Reservierung, deren Details Sie aufrufen möchten. Eine Seite mit den Details der Reservierung wird angezeigt.

gcloud

Wenn Sie die Details einer Reservierung aufrufen möchten, verwenden Sie den gcloud compute reservations describe-Befehl:

gcloud compute reservations describe RESERVATION_NAME \
    --zone=ZONE

Ersetzen Sie Folgendes:

  • RESERVATION_NAME: der Name der Reservierung.
  • ZONE: die Zone, in der die Reservierung vorhanden ist.

Die Ausgabe sieht etwa so aus wie im folgenden Beispiel.

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

Die Ausgabe enthält die folgenden Felder für die Reservierung:

  • name: der Name der Reservierung.
  • reservationBlockCount: die Gesamtzahl der Blöcke in der Reservierung.
  • assuredCount: die Gesamtzahl der VMs, die mit der Reservierung bereitgestellt werden können. Wenn dieser Wert kleiner als count ist, finden Sie Informationen zur Fehlerbehebung bei weniger verfügbaren VMs.
  • inUseCount: die Anzahl der VMs, die bereits in der Reservierung bereitgestellt wurden.
  • instanceProperties: die Eigenschaften der VMs, die mit der Reservierung bereitgestellt werden können.

REST

Stellen Sie eine GET-Anfrage an die Methode reservations.get, um die Details einer Reservierung aufzurufen:

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID des Projekts, in dem die Reservierung vorhanden ist.
  • ZONE: die Zone, in der die Reservierung vorhanden ist.
  • RESERVATION_NAME: der Name der Reservierung.

Die Ausgabe sieht etwa so aus:

{
  "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"
}

Die Ausgabe enthält die folgenden Felder für die Reservierung:

  • instanceProperties: die Eigenschaften der VMs, die mit der Reservierung bereitgestellt werden können.
  • inUseCount: die Anzahl der VMs, die bereits in der Reservierung bereitgestellt wurden.
  • assuredCount: die Gesamtzahl der VMs, die mit der Reservierung bereitgestellt werden können. Wenn dieser Wert kleiner als count ist, finden Sie Informationen zur Fehlerbehebung bei weniger verfügbaren VMs.
  • name: der Name der Reservierung.

Topologie einer Reservierung ansehen

Sie können sich die detaillierten Topologieinformationen einer Reservierung ansehen, um zu entscheiden, wo Sie VMs innerhalb der reservierten Blöcke und Unterblöcke erstellen. Informationen zur Platzierung von reservierten VMs, die bereits bereitgestellt wurden, finden Sie unter H4D-Clustertopologie ansehen.

Wenn Sie andere Details zu einer Reservierung aufrufen möchten, lesen Sie stattdessen den Abschnitt Details einer Reservierung aufrufen.

Reservierte Blöcke ansehen

Verwenden Sie eine der folgenden Methoden, um die verfügbaren Blöcke in einer Reservierung aufzulisten und zu beschreiben. Mit dieser Aufgabe können Sie Folgendes ermitteln:

  • Welche Kapazitätsblöcke in der Reservierung enthalten sind.
  • Wie viel Kapazität in jedem Block verfügbar ist.
  • Der Name, Block und Unterblock aller VMs, die im Block bereitgestellt werden. (Nur verfügbar, wenn Sie einen bestimmten Block mit der gcloud CLI oder REST aufrufen.)

Console

  1. Rufen Sie in der Google Cloud Console die Seite Reservierungen auf.

    Zu „Reservierungen“

  2. Klicken Sie in der Tabelle On-demand reservations (On-Demand-Reservierungen) in der Spalte Name auf den Namen der Reservierung, deren Details Sie aufrufen möchten. Die Seite mit den Details der ausgewählten Reservierung wird geöffnet.
  3. Im Abschnitt Ressourcentopologie finden Sie Informationen zu Ihren reservierten Blöcken. Diese Informationen umfassen für jeden Block Folgendes:
    • Block-ID: Der Name des Blocks.
    • Anzahl: Die Gesamtzahl der VMs, die im Block bereitgestellt werden können.
    • Wird verwendet: Die Anzahl der VMs, die bereits im Block bereitgestellt wurden.

gcloud

Mit den folgenden Befehlen können Sie die Blöcke in einer Reservierung aufrufen:

  • Wenn Sie alle verfügbaren Blöcke in einer Reservierung aufrufen möchten, verwenden Sie den Befehl gcloud compute reservations blocks list: 
    gcloud compute reservations blocks list RESERVATION_NAME \
    --zone=ZONE
  • Wenn Sie einen bestimmten Block in einer Reservierung aufrufen möchten, verwenden Sie den gcloud compute reservations blocks describe-Befehl. Wenn Sie auch den Namen und die Topologie aller VMs sehen möchten, die im Block bereitgestellt werden, fügen Sie das Flag --full-view=BLOCK_VIEW_FULL hinzu. 
    gcloud compute reservations blocks describe RESERVATION_NAME \
    --zone=ZONE \
    --block-name=BLOCK_NAME \
    --full-view=BLOCK_VIEW_FULL

Ersetzen Sie Folgendes:

  • RESERVATION_NAME: der Name der Reservierung
  • ZONE: die Zone, in der die Reservierung vorhanden ist.
  • BLOCK_NAME: der Name des Blocks.

Die Ausgabe für jeden Block sieht in etwa so aus:

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

Die Ausgabe enthält für jeden Block die folgenden Felder:

  • count: die Gesamtzahl der VMs, die im Block bereitgestellt werden können.
  • inUseCount: Die Anzahl der VMs, die bereits im Block bereitgestellt wurden.
  • name: der Name des Blocks.
  • physicalTopology: Der physische Standort des Blocks, der auch in der VM-Topologie angezeigt wird, wie folgt:
    • block: die organisationsspezifische ID des Blocks.
    • cluster: Der globale Name des Clusters.
    • instances: Eine Liste der Namen und physischen Standorte aller VMs im Block, wie unten beschrieben. Dieses Feld wird nur angezeigt, wenn Sie das Flag --full-view=BLOCK_VIEW_FULL angeben.
      • instanceId: Die ID einer Instanz.
      • subBlock: Die organisationsspezifische ID des Unterblocks, in dem sich diese Instanz befindet.
      • block: Die organisationsspezifische ID des Blocks, in dem sich diese Instanz befindet.
  • reservationSubBlockCount: die Anzahl der Unterblöcke im Block.
  • reservationSubBlockInUseCount: Die Anzahl der Unterblöcke im Block, in dem mindestens eine VM bereitgestellt wurde.

REST

Sie können die Blöcke in einer Reservierung auf folgende Weise aufrufen:

  • Wenn Sie alle verfügbaren Blöcke in einer Reservierung ansehen möchten, stellen Sie eine GET-Anfrage an die Methode reservationBlocks.list: 
    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks
  • Wenn Sie einen bestimmten Block in einer Reservierung aufrufen möchten, senden Sie eine GET-Anfrage an die Methode reservationBlocks.get. Wenn Sie auch den Namen und die Topologie aller VMs sehen möchten, die im Block bereitgestellt werden, fügen Sie den Abfrageparameter ?view=FULL hinzu. 
    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME?view=FULL

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID des Projekts, in dem die Reservierung vorhanden ist.
  • ZONE: die Zone, in der die Reservierung vorhanden ist.
  • RESERVATION_NAME: der Name der Reservierung.
  • BLOCK_NAME: der Name des Blocks.

Die Ausgabe für jeden Block sieht in etwa so aus:

{
  "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
  }
}

Die Ausgabe enthält für jeden Block die folgenden Felder:

  • name: der Name des Blocks.
  • count: die Gesamtzahl der VMs, die im Block bereitgestellt werden können.
  • inUseCount: Die Anzahl der VMs, die bereits im Block bereitgestellt wurden.
  • physicalTopology: Der physische Standort des Blocks, der auch in H4D-Clustertopologie ansehen wie folgt angezeigt wird:
    • cluster: Der globale Name des Clusters.
    • block: die organisationsspezifische ID des Blocks.
    • instances: Eine Liste der Namen und physischen Standorte aller VMs im Block, wie unten beschrieben. Dieses Feld wird nur angezeigt, wenn Sie den Abfrageparameter ?view=FULL angeben.
      • instanceId: Die ID einer Instanz.
      • subBlock: Die organisationsspezifische ID des Unterblocks, in dem sich diese Instanz befindet.
      • block: Die organisationsspezifische ID des Blocks, in dem sich diese Instanz befindet.
  • reservationSubBlockCount: die Anzahl der Unterblöcke im Block.
  • reservationSubBlockInUseCount: Die Anzahl der Unterblöcke im Block, in dem mindestens eine VM bereitgestellt wurde.

Reservierte Unterblöcke ansehen

Verwenden Sie die Google Cloud CLI oder die REST API, um die verfügbaren Unterblöcke in einem Block einer Reservierung aufzulisten und zu beschreiben. Mit dieser Aufgabe können Sie Folgendes ermitteln:

  • Welche Unterblöcke der Kapazität im reservierten Block enthalten sind.
  • Wie viel Kapazität in jedem Unterblock verfügbar ist.

gcloud

Mit den folgenden Befehlen können Sie die Unterblöcke in einer Reservierung aufrufen:

  • Wenn Sie alle verfügbaren Unterblöcke in einem Block einer Reservierung aufrufen möchten, verwenden Sie den gcloud compute reservations sub-blocks list-Befehl: 
    gcloud compute reservations sub-blocks list RESERVATION_NAME \
    --zone=ZONE \
    --block-name=BLOCK_NAME
  • Wenn Sie einen bestimmten Unterblock in einem Block einer Reservierung aufrufen möchten, verwenden Sie den gcloud compute reservations sub-blocks describe-Befehl: 
    gcloud compute reservations sub-blocks describe RESERVATION_NAME \
    --zone=ZONE \
    --block-name=BLOCK_NAME \
    --sub-block-name=SUB-BLOCK_NAME

Ersetzen Sie Folgendes:

  • RESERVATION_NAME: der Name der Reservierung
  • ZONE: die Zone, in der die Reservierung vorhanden ist.
  • BLOCK_NAME: der Name des Blocks.
  • SUB-BLOCK_NAME: der Name des Unterblocks.

Die Ausgabe für jeden Unterblock sieht in etwa so aus:

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

Die Ausgabe enthält die folgenden Felder für jeden Unterblock:

  • count: die Gesamtzahl der VMs, die im Unterblock bereitgestellt werden können.
  • inUseCount: Die Anzahl der VMs, die bereits im Unterblock bereitgestellt wurden.
  • name: der Name des Unterblocks.
  • physicalTopology: Der physische Standort des Subblocks, der auch in der VM-Topologie angezeigt wird, wie folgt:
    • block: die organisationsspezifische ID des Blocks.
    • cluster: Der globale Name des Clusters.
    • subblock: die organisationsspezifische ID des Unterblocks.

REST

Sie können die untergeordneten Blöcke in einer Reservierung mit den folgenden Methoden aufrufen:

  • Wenn Sie alle verfügbaren Unterblöcke in einem Block einer Reservierung aufrufen möchten, senden Sie eine GET-Anfrage an die Methode reservationSubBlocks.list: 
    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME/reservationSubBlocks
  • Wenn Sie einen bestimmten Unterblock in einem Block einer Reservierung aufrufen möchten, senden Sie eine GET-Anfrage an die Methode reservationSubBlocks.get: 
    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/reservationBlocks/BLOCK_NAME/reservationSubBlocks/SUB-BLOCK_NAME

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID des Projekts, in dem die Reservierung vorhanden ist.
  • ZONE: die Zone, in der die Reservierung vorhanden ist.
  • RESERVATION_NAME: der Name der Reservierung.
  • BLOCK_NAME: der Name des Blocks.
  • SUB-BLOCK_NAME: der Name des Unterblocks.

Die Ausgabe für jeden Unterblock sieht in etwa so aus:

{
  "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"
    }
  }
}

Die Ausgabe enthält die folgenden Felder für jeden Unterblock:

  • name: der Name des Unterblocks.
  • count: die Gesamtzahl der VMs, die im Unterblock bereitgestellt werden können.
  • inUseCount: Die Anzahl der VMs, die bereits im Unterblock bereitgestellt wurden.
  • physicalTopology: Der physische Standort des Subblocks, der auch in der VM-Topologie angezeigt wird, wie folgt:
    • cluster: Der globale Name des Clusters.
    • block: die organisationsspezifische ID des Blocks.
    • subblock: die organisationsspezifische ID des Unterblocks.

Nächste Schritte