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 AI Hypercomputer 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 AI Hypercomputer finden Sie unter Kapazitätsübersicht.

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. Sie können sich dann die Reservierung ansehen, um Ihre Arbeitslast zu planen. Später, zur angeforderten Startzeit, passiert Folgendes:

  • Compute Engine fügt die reservierten VM-Instanzen der Reservierung hinzu. Anschließend können Sie die Reservierung nutzen, indem Sie VMs erstellen, die der Reservierung entsprechen.
  • Sie können die Reservierung so ändern, dass sie von Vertex AI-Trainings- oder Vorhersagejobs verwendet werden kann. Eine Anleitung finden Sie unter Freigaberichtlinie einer Reservierung ändern.

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.

Hinweise

  1. Kapazität reservieren:Wenn noch nicht geschehen, reservieren Sie Kapazität für AI Hypercomputer mit einer der folgenden Optionen:

  2. Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

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

    REST

    Wenn Sie die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, verwenden Sie die Anmeldedaten, die Sie der gcloud CLI bereitstellen.

      Installieren Sie die Google Cloud CLI. Initialisieren Sie die Google Cloud CLI nach der Installation mit dem folgenden Befehl: 

      gcloud init

      Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

    Weitere Informationen finden Sie in der Dokumentation zur Google Cloud -Authentifizierung unter Für die Verwendung von REST authentifizieren.

    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.

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

    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 zukünftigen 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": "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"
}

    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

    Wenn Sie eine Liste Ihrer Reservierungen aufrufen möchten, stellen Sie eine GET-Anfrage an eine der folgenden Methoden:

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

    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.
    • Der Zustand der Reservierung, einschließlich der Anzahl der fehlerfreien Blöcke. (Nur über die gcloud CLI oder REST verfügbar)

    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: 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

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

    • name: der Name der Reservierung.
    • healthInfo: die Informationen zum Status der Reservierung:
      • degradedBlockCount: die Anzahl der beeinträchtigten Blöcke in der Reservierung.
      • healthStatus: der allgemeine Status der Reservierung.
      • healthyBlockCount: Die Anzahl der fehlerfreien Blöcke in 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.
    • 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": "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"
}

    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.
    • name: der Name der Reservierung.
    • healthInfo: die Informationen zum Status der Reservierung:
      • healthStatus: der allgemeine Status der Reservierung.
      • healthyBlockCount: Die Anzahl der fehlerfreien Blöcke in der Reservierung.
      • degradedBlockCount: die Anzahl der beeinträchtigten Blöcke in der Reservierung.

    Topologie einer Reservierung ansehen

    Sie können sich die detaillierten Topologieinformationen einer Reservierung ansehen, um zu entscheiden, wo Sie VMs in den reservierten Blöcken und Unterblöcken erstellen. Informationen zur Platzierung von reservierten VMs, die bereits bereitgestellt wurden, finden Sie unter Topologie einer Compute-Instanz ansehen.

    Wenn Sie andere Details zu einer Reservierung aufrufen möchten, lesen Sie stattdessen 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 Zustand der einzelnen Blöcke, einschließlich der Anzahl der fehlerfreien Unterblöcke. (Nur über die gcloud CLI oder REST verfügbar)
    • 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'
  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

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

    • count: die Gesamtzahl der VMs, die im Block bereitgestellt werden können.
    • healthInfo: Die Informationen zum Zustand des Blocks:
      • degradedSubBlockCount: Die Anzahl der beeinträchtigten Unterblöcke im Block.
      • healthStatus: Der allgemeine Status des Blocks.
      • healthySubBlockCount: Die Anzahl der fehlerfreien Unterblöcke im Block.
    • 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 aufrufen möchten, senden 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,
    "healthInfo": {
      "healthStatus": "DEGRADED",
      "healthySubBlockCount": 0,
      "degradedSubBlockCount": 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 der VM-Topologie angezeigt wird, wie folgt:
      • 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 einfügen.
        • 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.
    • healthInfo: Die Informationen zum Zustand des Blocks:
      • healthStatus: Der allgemeine Status des Blocks.
      • healthySubBlockCount: Die Anzahl der fehlerfreien Unterblöcke im Block.
      • degradedSubBlockCount: Die Anzahl der beeinträchtigten Unterblöcke im Block.

    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.
    • Der Zustand jedes Subblocks, einschließlich der Anzahl der fehlerfreien Hostmaschinen und der Anzahl der fehlerfreien Accelerator-Verbindungen.

    gcloud

    Mit den folgenden Befehlen können Sie die untergeordneten Blö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'
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

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

    • count: die Gesamtzahl der VMs, die im Unterblock bereitgestellt werden können.
    • healthInfo: Die Informationen zum Zustand des Unterblocks:
      • degradedHostCount: die Anzahl der beeinträchtigten Hostcomputer im Unterblock.
      • degradedInfraCount: Die Anzahl der beeinträchtigten Beschleunigerverbindungen im Subblock.
      • healthStatus: Der allgemeine Status des Unterblocks.
      • healthyHostCount: die Anzahl der fehlerfreien Hostcomputer im Unterblock.
      • healthyInfraCount: Die Anzahl der fehlerfreien Beschleunigerverbindungen im Subblock.
    • 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"
    },
    "healthInfo": {
      "healthStatus": "DEGRADED",
      "healthyHostCount": 16,
      "degradedHostCount": 2,
      "healthyInfraCount": 1,
      "degradedInfraCount": 0
    }
  }
}

    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.
    • healthInfo: Die Informationen zum Zustand des Unterblocks:
      • healthStatus: Der allgemeine Status des Unterblocks.
      • healthyHostCount: die Anzahl der fehlerfreien Hostcomputer im Unterblock.
      • degradedHostCount: die Anzahl der beeinträchtigten Hostcomputer im Unterblock.
      • healthyInfraCount: Die Anzahl der fehlerfreien Beschleunigerverbindungen im Subblock.
      • degradedInfraCount: Die Anzahl der beeinträchtigten Beschleunigerverbindungen im Subblock.

    Nächste Schritte