In diesem Dokument wird erläutert, wie Sie zukünftige Reservierungsanfragen anzeigen.
Informationen zu anderen Reservierungen, einschließlich der automatisch für eine zukünftige Reservierung erstellten Reservierungen, 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 so bei Compute Engine authentifizieren.
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
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
-
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 Liste zukünftiger Reservierungsanfragen anzeigen
In diesem Abschnitt wird erläutert, wie Sie eine Liste aller Entwurfs- oder eingereichten Reservierungsanfragen in einem bestimmten Projekt anzeigen. Sie können auch Filter verwenden, um die Ergebnisse anhand eines oder mehrerer Attribute einzugrenzen.
Details einer zukünftigen Reservierungsanfrage anzeigen
In diesem Abschnitt wird erläutert, wie Sie die Details einer zukünftigen Reservierungsanfrage anzeigen, z. B. die Projekte, für die eine freigegebene zukünftige Reservierung freigegeben wird, oder die Startzeit des Reservierungszeitraums.
Öffnen Sie in der Google Cloud Console die Seite Reservierungen.
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.
Optional: Sie können die in der Tabelle angezeigten zukünftigen Reservierungsanfragen filtern. Gehen Sie dazu so vor:
Geben Sie im Feld Filterausdruck ein.
Filter einenWenn 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.
FILTER_EXPRESSION
durch einen Filterausdruck.Wenn Sie beispielsweise nur zukünftige Reservierungen aufrufen möchten, die in der Zone
us-central1-a
erstellt wurden, einenn2-standard-4
-Maschinentyp angeben und eine Gesamtzahl von mehr als 10 haben, geben Sie folgenden Filterausdruck an:specificSkuProperties.instanceProperties.machineType=n2-standard-4 AND specificSkuProperties.totalCount>10 AND zone=us-central1-a
PROJECT_ID
: Optional. Die ID des Projekts, in dem sich eine oder mehrere zukünftige Reservierungsanfragen befinden. Wenn Sie das--project
-Flag weglassen, wird die ID des aktuellen Projekts verwendet.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.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, einenn2-standard-4
-Maschinentyp reservieren und eine Gesamtzahl von mehr als 10 haben, geben Sie folgenden Filterausdruck an:specificSkuProperties.instanceProperties.machineType=n2-standard-4%20AND%20specificSkuProperties.totalCount%3E10%20AND%20zone=us-central1-a
Beachten Sie, dass der URL-codierte Filterausdruck für folgenden decodierten Filterausdruck steht:
specificSkuProperties.instanceProperties.machineType=n2-standard-4 AND specificSkuProperties.totalCount>10 AND zone=us-central1-a
Öffnen Sie in der Google Cloud Console die Seite Reservierungen.
Klicken Sie auf den Tab Zukünftige Reservierungen.
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.
FUTURE_RESERVATION_NAME
: Den Name einer vorhandenen zukünftigen Reservierungsanfrage.PROJECT_ID
: Optional. Die ID des Projekts, in dem sich die zukünftige Reservierungsanfrage befindet. Wenn Sie das--project
-Flag weglassen, wird die ID des aktuellen Projekts verwendet.ZONE
: Die Zone, in der sich die zukünftige Reservierungsanfrage befindet.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.Weitere Informationen zum Ändern, Abbrechen oder Löschen zukünftiger Reservierungsanfragen.
Nachdem Sie die Startzeit Ihres Reservierungszeitraums erreicht haben, lesen Sie die Informationen zum Verwenden der automatisch erstellten Reservierungen.
Nach Ablauf des Reservierungszeitraums lernen Sie Folgendes:
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:
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Zukünftige Reservierungsanfragen anzeigen
Wählen Sie eine der folgenden Methoden, um die zukünftigen Reservierungsanfragen in einem bestimmten Projekt anzuzeigen:
Liste der zukünftigen Reservierungsanfragen anzeigen
Sie können eine Liste zukünftiger Reservierungsanfragen in einem bestimmten Projekt mit der Google Cloud Console, der gcloud CLI und REST anzeigen.
Console
So zeigen Sie eine Liste zukünftiger Reservierungsanfragen an:
gcloud
Verwenden Sie den
gcloud beta compute future-reservations list
-Befehl, um eine Liste zukünftiger Reservierungsanfragen anzuzeigen.gcloud beta compute future-reservations list \ --project=PROJECT_ID
Ersetzen Sie
PROJECT_ID
durch die ID des Projekts, in dem sich eine oder mehrere zukünftige Reservierungsanfragen befinden. Wenn Sie das--project
-Flag weglassen, wird die ID des aktuellen Projekts verwendet.Die Ausgabe sieht in etwa so aus:
NAME TOTAL_COUNT START_TIME END_TIME PROCUREMENT_STATUS ZONE fr-04 100 2025-07-20T07:00:00Z 2025-08-05T07:00:00Z FULFILLED us-east1-a fr-05 10 2025-11-15T00:00:00Z 2025-12-01T00:00:00Z PENDING_APPROVAL us-west1-c
Optional können Sie das
--filter
-Flag angeben, um eine gefilterte Liste zukünftiger Reservierungen basierend auf einem Filterausdruck aufzurufen.gcloud beta compute future-reservations list \ --filter="FILTER_EXPRESSION" \ --project=PROJECT_ID
Ersetzen Sie Folgendes:
REST
Wenn Sie eine Liste zukünftiger Reservierungsanfragen anzeigen möchten, stellen Sie eine
GET
-Anfrage an diebeta.futureResevations.list
-Methode.GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations
Ersetzen Sie Folgendes:
Die Ausgabe sieht in etwa so aus:
{ "id": "projects/my-project/zones/us-east1-a/futureReservations", "items": [ { "id": "743865190848184978", "creationTimestamp": "2025-04-11T18: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": { "startTime": "2025-07-20T07:00:00Z", "endTime": "2025-08-05T07:00:00Z" }, "status": { "procurementStatus": "FULFILLED", "lockTime": "2025-05-04T07:00:00Z", "fulfilledCount": "100" }, "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 das
filter
-Abfrageparameter angeben, um eine gefilterte Liste zukünftiger Reservierungen basierend auf einem Filterausdruck aufzurufen.GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/aggregated/futureReservations?filter=FILTER_EXPRESSION
Ersetzen Sie Folgendes:
Details einer zukünftigen Reservierungsanfrage anzeigen
Sie können die Details einer zukünftigen Reservierungsanfrage über die Cloud Console, die gcloud CLI und REST anzeigen.
Console
So zeigen Sie die Details einer zukünftigen Reservierungsanfrage an:
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 \ --project=PROJECT_ID \ --zone=ZONE
Ersetzen Sie Folgendes:
Die Ausgabe sieht in etwa so aus:
creationTimestamp: '2025-07-19T12:44:11.855-07:00' id: '5212276518668495076' kind: compute#futureReservation name: fr-01 namePrefix: test-fr selfLink: https://www.googleapis.com/compute/beta/projects/project-01/zones/us-central1-a/futureReservations/future-reservation-test-1 selfLinkWithId: https://www.googleapis.com/compute/beta/projects/project-01/zones/us-central1-a/futureReservations/5212276518668495076 shareSettings: projects: - 'project-02' shareType: SPECIFIC_PROJECTS specificSkuProperties: instanceProperties: localSsds: - diskSizeGb: '375' interface: SCSI machineType: n1-standard-64 minCpuPlatform: Intel Skylake totalCount: '800' planningStatus: SUBMITTED status: lockTime: '2025-08-25T00:00:00Z' procurementStatus: APPROVED timeWindow: endTime: '2025-12-10T00:00:00Z' startTime: '2025-11-10T00:00:00Z' zone: https://www.googleapis.com/compute/beta/projects/project-01/zones/us-central1-a
REST
Stellen Sie eine
GET
-Anfrage an diebeta.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:
Die Ausgabe sieht in etwa so aus:
{ "creationTimestamp": "2025-04-11T18:16:45.274-07:00", "id": "743865190848184978", "name": "fr-01", "namePrefix": "test-fr", "kind": "compute#futureReservation", "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", "specificSkuProperties": { "instanceProperties": { "machineType": "n1-standard-1" }, "totalCount": "100" }, "planningStatus": "SUBMITTED", "timeWindow": { "endTime": "2025-08-05T07:00:00Z", "startTime": "2025-07-20T07:00:00Z" }, "status": { "fulfilledCount": "100" "lockTime": "2025-05-04T07:00:00Z", "procurementStatus": "FULFILLED", }, "zone": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a" }
Nächste Schritte
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2024-12-03 (UTC).
-