Zukünftige Reservierungsanfragen anzeigen

In diesem Dokument wird erläutert, wie Sie vorausschauende Reservierungsanfragen anzeigen.

Sie sehen sich vorausschauende Reservierungsanfragen an, um sich einen Überblick über diesen Anfragetyp in Ihrem Projekt zu verschaffen und die Konfigurationsdetails einer vorausschauenden Reservierungsanfrage zu überprüfen. Freigegebene vorausschauende Reservierungsanfragen lassen sich nur über das Inhaberprojekt anzeigen.

Informationen zu automatisch erstellten Reservierungen, die für eine vorausschauende Reservierung bereitgestellt wurden, finden Sie unter Reservierungen anzeigen.

Hinweise

  • Richten Sie die Authentifizierung ein, falls Sie dies noch nicht getan haben. Bei der Authentifizierung wird Ihre Identität für den Zugriff auf Google Cloud -Dienste und ‑APIs überprüft. Zur Ausführung von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich bei Compute Engine authentifizieren. Wählen Sie dazu eine der folgenden Optionen aus:

    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. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

      Verwenden Sie die von der gcloud CLI bereitgestellten Anmeldedaten, um die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung zu verwenden.

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

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

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Compute-Betrachter zukünftiger Reservierungsanfragen (roles/compute.futureReservationViewer) für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zur Anzeige zukünftiger Reservierungsanfragen 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 Anzeigen zukünftiger Reservierungsanfragen erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um zukünftige Reservierungsanfragen anzuzeigen:

  • So zeigen Sie eine Liste der zukünftigen Reservierungen an: compute.futureReservations.list im Projekt
  • So zeigen Sie die Details einer vorausschauenden Reservierung an: compute.futureReservations.get im Projekt

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

Vorausschauende Reservierungsanfragen anzeigen

Verwenden Sie basierend auf den Details, die Sie in einer vorausschauenden Reservierungsanfrage anzeigen möchten, eine der folgenden Methoden:

Liste der vorausschauenden Reservierungsanfragen anzeigen

Wenn Sie sich eine Liste Ihrer vorausschauenden Reservierungsanfragen ansehen, können Sie mithilfe von Filterausdrücken die Ergebnisse eingrenzen. Für erweiterte Filterausdrücke verwenden Sie die gcloud CLI oder REST.

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

Console

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

    Zu „Reservierungen“

  2. Klicken Sie auf den Tab Vorausschauende Reservierungen.

    In der Tabelle steht jede Zeile für eine zukünftige Reservierungsanfrage und jede Spalte für eine Eigenschaft. Beispiel: In der Spalte Gesamtzahl wird die reservierte Kapazität jeder zukünftigen Reservierungsanfrage beschrieben.

  3. Optional: Sie können die in der Tabelle angezeigten zukünftigen Reservierungsanfragen filtern. Gehen Sie dazu so vor:

    • Geben Sie im Feld Filter einen Filterausdruck ein.

      Wenn Sie beispielsweise nur die vorausschauenden Reservierungsanfragen anzeigen möchten, die in der Zone us-central1-a erstellt wurden, oder die mehr als zehn Ressourcen reserviert haben, geben Sie folgenden Ausdruck an:

      Zone:us-central1-a OR Total Count>10

    • Klicken Sie auf Spaltenanzeigeoptionen und wählen Sie die Werte aus, nach denen Sie die Tabelle filtern möchten.

gcloud

Verwenden Sie den gcloud beta compute future-reservations list-Befehl, um eine Liste der vorausschauenden Reservierungsanfragen anzuzeigen.

gcloud beta compute future-reservations list

Die Ausgabe sieht in etwa so aus:

NAME: fr-04
TOTAL_COUNT: 100
START_TIME: 2025-07-20T07:00:00Z
END_TIME: 2025-08-05T07:00:00Z
PROCUREMENT_STATUS: FULFILLED
ZONE: us-east1-a

NAME: fr-05
TOTAL_COUNT: 10
START_TIME: 2025-07-20T07:00:00Z
END_TIME: 2025-12-01T00:00:00Z
PROCUREMENT_STATUS: PENDING_APPROVAL
ZONE: us-west1-c

Optional können Sie das Flag --filter angeben, um Ihre vorausschauenden Reservierungsanfragen basierend auf einem Filterausdruck zu filtern.

gcloud beta compute future-reservations list \
    --filter="FILTER_EXPRESSION"

Ersetzen Sie FILTER_EXPRESSION durch einen Filterausdruck.

Wenn Sie beispielsweise nur vorausschauende Reservierungen aufrufen möchten, die in der Zone us-central1-a erstellt wurden, einen n2-standard-4-Maschinentyp angeben und eine Gesamtzahl von mehr als 10 haben, geben Sie folgenden Filterausdruck an:

zone=us-central1-a AND specificSkuProperties.instanceProperties.machineType=n2-standard-4 AND specificSkuProperties.totalCount>10

REST

Wenn Sie eine Liste zukünftiger Reservierungsanfragen anzeigen möchten, stellen Sie eine GET-Anfrage an die beta.futureResevations.list-Methode.

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

Dabei gilt:

  • PROJECT_ID: die ID des Projekts, in dem sich eine oder mehrere vorausschauende Reservierungsanfragen befinden.

  • ZONE: Die Zone, in der sich eine oder mehrere zukünftige Reservierungsanfragen befinden.

Die Ausgabe sieht in etwa so aus:

{
  "id": "projects/my-project/zones/us-east1-a/futureReservations",
  "items": [
    {
      "id": "743865190848184978",
      "creationTimestamp": "2025-03-23T18:16:45.274-07:00",
      "selfLink": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a/futureReservations/fr-base",
      "selfLinkWithId": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a/futureReservations/743865190848184978",
      "zone": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a",
      "name": "fr-base",
      "specificSkuProperties": {
        "instanceProperties": {
          "machineType": "n1-standard-1"
        },
        "totalCount": "100"
      },
      "planningStatus": "SUBMITTED",
      "timeWindow": {
        "endTime": "2025-05-02T01:00:00Z",
        "startTime": "2025-04-30T17:30:00Z"
      },
      "status": {
        "procurementStatus": "FULFILLED",
        "lockTime": "2025-03-30T07:00:00Z",
        "existingMatchingUsageInfo": {
          "count": "3",
          "timestamp": "2025-03-30T01:00:00Z"
        }
      },
      "kind": "compute#futureReservation"
    },
    ...
  ],
  "selfLink": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a/futureReservations",
  "etag": "AnzKY34l-cvvV-JnniESJ0dtQvQ=/hvc4jaHpxFAZmOt1FVtKNgzZu-M=",
  "kind": "compute#futureReservationsListResponse"
}

Optional können Sie den Abfrageparameter filter angeben, um Ihre vorausschauenden Reservierungsanfragen basierend auf einem Filterausdruck zu filtern.

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/aggregated/futureReservations?filter=FILTER_EXPRESSION

Dabei gilt:

  • PROJECT_ID: die ID des Projekts, in dem sich eine oder mehrere vorausschauende Reservierungsanfragen befinden.

  • FILTER_EXPRESSION: ein Filterausdruck, der die URL-Codierung verwendet.

    Wenn Sie beispielsweise nur vorausschauende Reservierungen aufrufen möchten, die in der Zone us-central1-a erstellt wurden, einen n2-standard-4-Maschinentyp reservieren und eine Gesamtzahl von mehr als 10 haben, geben Sie folgenden Filterausdruck an:

    zone=us-central1-a%20AND%20specificSkuProperties.instanceProperties.machineType=n2-standard-4%20AND%20specificSkuProperties.totalCount%3E10

    Beachten Sie, dass der URL-codierte Filterausdruck für folgenden decodierten Filterausdruck steht:

    zone=us-central1-a AND specificSkuProperties.instanceProperties.machineType=n2-standard-4 AND specificSkuProperties.totalCount>10

Details einer vorausschauenden Reservierungsanfrage anzeigen

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

Console

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

    Zu „Reservierungen“

  2. Klicken Sie auf den Tab Vorausschauende Reservierungen.

  3. Klicken Sie in der Spalte Name auf den Namen der zukünftigen Reservierungsanfrage, für die Sie die Details anzeigen lassen möchten.

    Die Seite zukünftige Reservierungen mit den Details der zukünftigen Reservierungsanfrage wird geöffnet.

gcloud

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

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

Dabei gilt:

  • FUTURE_RESERVATION_NAME: der Name einer vorhandenen vorausschauenden Reservierungsanfrage.

  • ZONE: die Zone, in der sich die vorausschauende Reservierungsanfrage befindet.

Die Ausgabe sieht in etwa so aus:

autoCreatedReservationsDeleteTime: '2025-05-02T01:00:00Z'
creationTimestamp: '2025-03-23T10:08:31.613-07:00'
id: '5212276518668495076'
kind: compute#futureReservation
name: fr-01
planningStatus: SUBMITTED
selfLink: https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-01
selfLinkWithId: https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/5212276518668495076
shareSettings:
  shareType: LOCAL
specificSkuProperties:
  instanceProperties:
    machineType: n1-standard-64
  totalCount: '800'
status:
  existingMatchingUsageInfo:
    count: '3'
    timestamp: '2025-03-30T01:00:00Z'
  lockTime: '2025-03-30T17:09:59.297799Z'
  procurementStatus: APPROVED
timeWindow:
  endTime: '2025-05-02T01:00:00Z'
  startTime: '2025-04-30T17:30:00Z'
zone: https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a

REST

Stellen Sie eine GET-Anfrage an die beta.futureReservations.get-Methode, um die Details einer zukünftigen Reservierungsanfrage anzuzeigen.

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

Dabei gilt:

  • PROJECT_ID: die ID des Projekts, in dem sich die zukünftige Reservierungsanfrage befindet.

  • ZONE: die Zone, in der sich die vorausschauende Reservierungsanfrage befindet.

  • FUTURE_RESERVATION_NAME: der Name einer vorhandenen vorausschauenden Reservierungsanfrage.

Die Ausgabe sieht in etwa so aus:

{
  "autoCreatedReservationsDeleteTime": "2025-05-02T01:00:00Z",
  "creationTimestamp": "2025-03-23T10:08:31.613-07:00",
  "id": "5212276518668495076",
  "kind": "compute#futureReservation",
  "name": "fr-01",
  "planningStatus": "SUBMITTED",
  "selfLink": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-01",
  "selfLinkWithId": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/5212276518668495076",
  "shareSettings": {
    "shareType": "LOCAL"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "machineType": "n1-standard-64"
    },
    "totalCount": "800"
  },
  "status": {
    "lockTime": "2025-03-30T17:09:59.297799Z",
    "procurementStatus": "APPROVED",
    "existingMatchingUsageInfo": {
      "count": "3",
      "timestamp": "2025-03-30T01:00:00Z"
    }
  },
  "timeWindow": {
    "endTime": "2025-05-02T01:00:00Z",
    "startTime": "2025-04-30T17:30:00Z"
  },
  "zone": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a"
}

Anzahl der bereitgestellten VMs ermitteln

Nachdem Sie eine vorausschauende Reservierungsanfrage erstellt haben, sehen Sie, wie viele laufende VMs und nicht verwendete Reservierungen in Ihrem Projekt oder in einem Projekt, mit dem die vorausschauende Reservierungsanfrage geteilt wird, den in Ihrer Anfrage angegebenen VM-Attributen entsprechen. Wenn Sie diese Zahl von der in Ihrer Anfrage angegebenen Gesamtzahl abziehen, können Sie ermitteln, wie viele VMs die Compute Engine bereitstellen wird, nachdem Ihre Anfrage genehmigt wurde und die Startzeit erreicht hat.

Verwenden Sie die Google Cloud Console, um die Anzahl der bereitgestellten VMs für mehrere vorausschauende Reservierungsanfragen gleichzeitig zu ermitteln. Andernfalls können Sie eine der folgenden Optionen auswählen, um die Anzahl der bereitgestellten VMs für eine einzelne Anfrage zu ermitteln:

Console

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

    Zu „Reservierungen“

  2. Klicken Sie auf den Tab Vorausschauende Reservierungen.

  3. Für jede vorausschauende Reservierungsanfrage können Sie Folgendes festlegen:

    • In der Spalte Gesamtanzahl die Gesamtzahl der Anfragen.

    • In der Spalte Passende Anzahl sehen Sie die Anzahl der laufenden VMs und Reservierungen, deren VM-Eigenschaften mit der Anfrage übereinstimmen.

    Wenn Sie den Wert in der Spalte Passende Anzahl vom Wert in der Spalte Gesamtanzahl abziehen, können Sie die Anzahl der VMs ermitteln, die die Compute Engine zum Startzeitpunkt für eine vorausschauende Reservierungsanfrage bereitstellen wird. Wenn in der Spalte Passende Anzahl eine Warnung angezeigt wird, kann das folgende Ursachen haben:

    • Der Wert für Passende Anzahl ist null. In diesem Fall gibt es in Ihrem Projekt keine übereinstimmenden laufenden VMs oder Reservierungen.

    • Der Wert für Passende Anzahl entspricht der Gesamtanzahl. In diesem Fall stellt Compute Engine keine reservierten VMs für die vorausschauende Reservierungsanfrage bereit.

    Wenn Sie die vorausschauende Reservierungsanfrage ändern oder neue VMs oder Reservierungen mit VM-Attributen erstellen, die der Anfrage entsprechen, aktualisiert Compute Engine den Wert in der Spalte Passende Anzahl innerhalb von 30 Minuten. Wenn Sie prüfen möchten, wann die Spalte Passende Anzahl zuletzt aktualisiert wurde, rufen Sie die Details der Anfrage auf und sehen Sie sich dann den Wert in der Zeile Letzte Auswertungszeit der übereinstimmenden Nutzung an.

  4. Optional: Wenn Sie die Anzahl der reservierten VMs in einer vorausschauenden Reservierungsanfrage ändern möchten, ändern Sie die vorausschauende Reservierungsanfrage.

gcloud

  1. Details einer vorausschauenden Reservierungsanfrage ansehen

  2. In der Ausgabe wird der Wert des Felds existingMatchingUsageInfo vom Feld totalCount abgezogen. Wenn existingMatchingUsageInfo.count und totalCount den gleichen Wert haben, stellt Compute Engine keine reservierten VMs für die vorausschauende Reservierungsanfrage bereit.

    Wenn Sie die vorausschauende Reservierungsanfrage ändern oder neue VMs oder Reservierungen mit VM-Attributen erstellen, die der Anfrage entsprechen, aktualisiert Compute Engine das Feld existingMatchingUsageInfo innerhalb von 30 Minuten. Den Zeitpunkt der letzten Aktualisierung des Felds sehen Sie im Wert des Felds existingMatchingUsageInfo.timestamp.

  3. Optional: Wenn Sie die Anzahl der reservierten VMs in einer vorausschauenden Reservierungsanfrage ändern möchten, ändern Sie die vorausschauende Reservierungsanfrage.

REST

  1. Details einer vorausschauenden Reservierungsanfrage ansehen

  2. In der Ausgabe wird der Wert des Felds existingMatchingUsageInfo vom Feld totalCount abgezogen. Wenn existingMatchingUsageInfo.count und totalCount den gleichen Wert haben, stellt Compute Engine keine reservierten VMs für die vorausschauende Reservierungsanfrage bereit.

    Wenn Sie die vorausschauende Reservierungsanfrage ändern oder neue VMs oder Reservierungen mit VM-Attributen erstellen, die der Anfrage entsprechen, aktualisiert Compute Engine das Feld existingMatchingUsageInfo innerhalb von 30 Minuten. Den Zeitpunkt der letzten Aktualisierung des Felds sehen Sie im Wert des Felds existingMatchingUsageInfo.timestamp.

  3. Optional: Wenn Sie die Anzahl der reservierten VMs in einer vorausschauenden Reservierungsanfrage ändern möchten, ändern Sie die vorausschauende Reservierungsanfrage.

Nächste Schritte