Zukünftige Reservierungsanfragen anzeigen

In diesem Dokument wird erläutert, wie Sie zukünftige Reservierungsanfragen anzeigen.

Wenn Sie sich Anfragen für zukünftige Reservierungen ansehen, erhalten Sie einen Überblick über alle Anfragen für zukünftige Reservierungen in Ihrem Projekt und können die Konfigurationsdetails einer Anfrage für eine zukünftige Reservierung prüfen. Wenn Sie sich eine Anfrage für eine freigegebene zukünftige Reservierung ansehen möchten, können Sie dies nur über das Inhaberprojekt tun.

Informationen zu den automatisch erstellten Reservierungen, die für eine zukünftige Reservierung bereitgestellt werden, 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 zukünftigen Reservierung an: compute.futureReservations.get im Projekt

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

Zukünftige Reservierungsanfragen anzeigen

Verwenden Sie basierend auf den Details, die Sie in einer Anfrage für eine zukünftige Reservierung anzeigen möchten, eine der folgenden Methoden:

Liste der zukünftigen Reservierungsanfragen anzeigen

Wenn Sie sich eine Liste Ihrer zukünftigen 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 zukünftigen Reservierungsanfragen in Ihrem Projekt aufzurufen:

Console

  1. Öffnen Sie in der Google Cloud Console die Seite Reservierungen.

    Zu „Reservierungen“

  2. Klicken Sie auf den Tab Zukünftige 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 zukünftigen 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 zukünftiger 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 zukünftigen 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 zukünftige 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

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID des Projekts, in dem sich eine oder mehrere zukünftige 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 die zukünftigen Reservierungsanfragen basierend auf einem Filterausdruck filtern. Fügen Sie dazu den Abfrageparameter filter ein.

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

Ersetzen Sie Folgendes:

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

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

    Wenn Sie beispielsweise nur zukünftige 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 zukünftigen Reservierungsanfrage anzeigen

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

Console

  1. Öffnen Sie in der Google Cloud Console die Seite Reservierungen.

    Zu „Reservierungen“

  2. Klicken Sie auf den Tab Zukünftige 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

Ersetzen Sie Folgendes:

  • FUTURE_RESERVATION_NAME: Den Name einer vorhandenen zukünftigen Reservierungsanfrage.

  • ZONE: Die Zone, in der sich die zukünftige 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

Ersetzen Sie Folgendes:

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

  • ZONE: Die Zone, in der sich die zukünftige Reservierungsanfrage befindet.

  • FUTURE_RESERVATION_NAME: Den Name einer vorhandenen zukünftigen 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 Anfrage für eine zukünftige Reservierung erstellt haben, sehen Sie, wie viele laufende VMs und nicht verwendete Reservierungen in Ihrem Projekt oder in einem Projekt, mit dem die Anfrage für eine zukünftige Reservierung 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 Anfragen für zukünftige Reservierungen 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. Öffnen Sie in der Google Cloud Console die Seite Reservierungen.

    Zu „Reservierungen“

  2. Klicken Sie auf den Tab Zukünftige Reservierungen.

  3. Für jede Anfrage für eine zukünftige Reservierung können Sie Folgendes festlegen:

    • In der Spalte Anzahl insgesamt die Gesamtzahl der Anfragen.

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

    Wenn Sie den Wert in der Spalte Übereinstimmende Anzahl vom Wert in der Spalte Gesamtzahl abziehen, können Sie die Anzahl der VMs ermitteln, die die Compute Engine zum Zeitpunkt des Beginns für eine zukünftige Reservierungsanfrage bereitstellen wird. Wenn in der Spalte Übereinstimmende Anzahl eine Warnung angezeigt wird, kann das folgende Ursachen haben:

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

    • Der Wert für Passende Anzahl entspricht Gesamtzahl. In diesem Fall stellt Compute Engine keine reservierten VMs für die zukünftige Reservierungsanfrage bereit .

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

  4. Optional: Wenn Sie die Anzahl der reservierten VMs in einer zukünftigen Reservierungsanfrage ändern möchten, ändern Sie die zukünftige Reservierungsanfrage.

gcloud

  1. Details der zukünftigen Reservierungsanfrage ansehen

  2. In der Ausgabe wird der Wert des Felds existingMatchingUsageInfo vom Feld totalCount abgezogen. Wenn der Wert von existingMatchingUsageInfo.count totalCount entspricht, stellt Compute Engine keine reservierten VMs für die Anfrage für eine zukünftige Reservierung bereit.

    Wenn Sie die Anfrage für eine zukünftige Reservierung ändern oder neue VMs oder Reservierungen mit VM-Attributen erstellen, die mit der Anfrage übereinstimmen, 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 Ihrer zukünftigen Reservierungsanfrage ändern möchten, ändern Sie die zukünftige Reservierungsanfrage.

REST

  1. Details der zukünftigen Reservierungsanfrage ansehen

  2. In der Ausgabe wird der Wert des Felds existingMatchingUsageInfo vom Feld totalCount abgezogen. Wenn der Wert von existingMatchingUsageInfo.count totalCount entspricht, stellt Compute Engine keine reservierten VMs für die Anfrage für eine zukünftige Reservierung bereit.

    Wenn Sie die Anfrage für eine zukünftige Reservierung ändern oder neue VMs oder Reservierungen mit VM-Attributen erstellen, die mit der Anfrage übereinstimmen, 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 Ihrer zukünftigen Reservierungsanfrage ändern möchten, ändern Sie die zukünftige Reservierungsanfrage.

Nächste Schritte