In diesem Dokument wird erläutert, wie Sie Ihre Reservierungen oder vorausschauenden Reservierungsanfragen ansehen. Weitere Informationen zu den verschiedenen Reservierungstypen finden Sie unter Reservierungstyp auswählen.
Wenn Sie sich Ihre Reservierungen oder Anfragen für vorausschauende Reservierungen ansehen, haben Sie folgende Möglichkeiten:
Reservierungseinstellungen ansehen So können Sie die Details Ihrer Reservierungen prüfen, sicherstellen, dass sie Ihren Anforderungen entsprechen, und die Kapazität planen.
Anzahl der verbrauchbaren Instanzen ermitteln Mit dieser Prüfung können Sie ermitteln, wie viele Compute Engine-Instanzen Ihre reservierte Kapazität nutzen können.
Beschränkungen
Sie können eine freigegebene Reservierung oder eine freigegebene Anfrage für eine vorausschauende Reservierung nur in dem Projekt ansehen, in dem Sie sie erstellt haben.
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 Trusted Cloud by S3NS -Dienste und APIs überprüft.
Zum Ausführen von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich so bei der Compute Engine authentifizieren:
Select the tab for how you plan to use the samples on this page:
Console
When you use the Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.
gcloud
-
Installieren Sie die Google Cloud CLI und melden Sie sich dann mit Ihrer föderierten Identität in der gcloud CLI an. Nach der Anmeldung initialisieren Sie die Google Cloud CLI mit folgendem Befehl:
gcloud init
- Set a default region and zone.
Go
Wenn Sie die Go -Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, installieren und initialisieren Sie die gcloud CLI und richten Sie dann die Standardanmeldedaten für Anwendungen mit Ihren Nutzeranmeldedaten ein.
Installieren Sie die Google Cloud CLI und melden Sie sich dann mit Ihrer föderierten Identität in der gcloud CLI an.
Create local authentication credentials for your user account:
gcloud auth application-default login
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Weitere Informationen finden Sie unter Set up authentication for a local development environment.
Java
Wenn Sie die Java -Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, installieren und initialisieren Sie die gcloud CLI und richten Sie dann die Standardanmeldedaten für Anwendungen mit Ihren Nutzeranmeldedaten ein.
Installieren Sie die Google Cloud CLI und melden Sie sich dann mit Ihrer föderierten Identität in der gcloud CLI an.
Create local authentication credentials for your user account:
gcloud auth application-default login
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Weitere Informationen finden Sie unter Set up authentication for a local development environment.
Node.js
Wenn Sie die Node.js -Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, installieren und initialisieren Sie die gcloud CLI und richten Sie dann die Standardanmeldedaten für Anwendungen mit Ihren Nutzeranmeldedaten ein.
Installieren Sie die Google Cloud CLI und melden Sie sich dann mit Ihrer föderierten Identität in der gcloud CLI an.
Create local authentication credentials for your user account:
gcloud auth application-default login
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Weitere Informationen finden Sie unter Set up authentication for a local development environment.
Python
Wenn Sie die Python -Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, installieren und initialisieren Sie die gcloud CLI und richten Sie dann die Standardanmeldedaten für Anwendungen mit Ihren Nutzeranmeldedaten ein.
Installieren Sie die Google Cloud CLI und melden Sie sich dann mit Ihrer föderierten Identität in der gcloud CLI an.
Create local authentication credentials for your user account:
gcloud auth application-default login
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
Weitere Informationen finden Sie unter Set up authentication for a local development environment.
REST
Wenn Sie die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, nutzen Sie die Anmeldedaten, die Sie der gcloud CLI bereitstellen.
Installieren Sie die Google Cloud CLI und melden Sie sich dann mit Ihrer föderierten Identität in der gcloud CLI an.
Weitere Informationen finden Sie in der Dokumentation zur Trusted Cloud -Authentifizierung unter Für die Verwendung von REST authentifizieren.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Compute-Administrator (
roles/compute.admin
) für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aufrufen von Reservierungen oder zukünftigen 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 von Reservierungen oder zukünftigen Reservierungsanfragen erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
Die folgenden Berechtigungen sind erforderlich, um Reservierungen oder zukünftige Reservierungsanfragen anzusehen:
-
So zeigen Sie eine Liste der Reservierungen an:
compute.reservations.list
im Projekt -
So zeigen Sie eine Liste der zukünftigen Reservierungsanfragen an:
compute.futureReservations.list
im Projekt -
So zeigen Sie die Details einer Reservierung an:
compute.reservations.get
im Projekt -
So zeigen Sie die Details einer vorausschauenden Reservierungsanfrage an:
compute.futureReservations.get
im Projekt
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Reservierungseinstellungen ansehen
In den folgenden Abschnitten wird beschrieben, wie Sie die Einstellungen Ihrer Reservierungen oder zukünftigen Reservierungsanfragen aufrufen.
Reservierungen ansehen
Verwenden Sie eine der in diesem Abschnitt beschriebenen Methoden, um die Einstellungen einer oder mehrerer Reservierungen aufzurufen:
Wenn Sie sich einen Überblick über alle Reservierungen in Ihrem Projekt verschaffen möchten, rufen Sie eine Liste Ihrer Reservierungen auf.
Wenn Sie die vollständigen Details einer einzelnen Reservierung aufrufen möchten, sehen Sie sich die Details der Reservierung an.
Wenn Sie die Felder
deleteAtTime
undreservationSharingPolicy
(Vorabversion) in einer Reservierung aufrufen möchten, rufen Sie die Details einer Reservierung mit der Google Cloud CLI auf oder rufen Sie Reservierungen mit der REST API auf. Wenn Sie diese Felder nicht benötigen, können Sie Reservierungen mit einer der folgenden Optionen aufrufen:Console
Rufen Sie in der Trusted Cloud Console die Seite IAM auf.
Auf dem Tab On-Demand-Reservierungen (Standard) wird in der Tabelle jede Reservierung aufgeführt und in jeder Spalte ein Attribut beschrieben.
Optional: Führen Sie in der Tabelle On-Demand-Reservierungen einen oder beide der folgenden Schritte aus:
Wenn Sie die garantierte Anzahl Ihrer Reservierungen anzeigen möchten, klicken Sie auf Spaltenanzeigeoptionen..., wählen Sie das Kästchen Garantierte Anzahl aus und klicken Sie auf OK.
Wenn Sie die Liste der Reservierungen eingrenzen möchten, wählen Sie im Feld
Filter die Eigenschaften aus, nach denen Sie die Reservierungen filtern möchten.
Klicken Sie in der Spalte Name auf den Namen der Reservierung, um die Details aufzurufen. Eine Seite mit den Details der Reservierung wird geöffnet.
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 wie im folgenden Beispiel.
NAME: r-01 IN_USE_COUNT: 0 COUNT: 5 ZONE: us-central1-a SHARE_TYPE: LOCAL NAME: r-02 IN_USE_COUNT: 3 COUNT: 10 ZONE: us-central1-f SHARE_TYPE: LOCAL
Optional können Sie die Liste der Reservierungen mithilfe eines Filterausdrucks durch das Flag
--filter
eingrenzen:gcloud compute reservations list \ --filter="FILTER_EXPRESSION"
Ersetzen Sie
FILTER_EXPRESSION
durch einen Filterausdruck.Wenn Sie die Details einer Reservierung aufrufen möchten, verwenden Sie den Befehl
gcloud compute reservations describe
:gcloud compute reservations describe RESERVATION_NAME \ --zone=ZONE
Ersetzen Sie Folgendes:
RESERVATION_NAME
: der Name einer vorhandenen Reservierung.ZONE
: die Zone, in der die Reservierung vorhanden ist.
Die Ausgabe sieht etwa so aus wie im folgenden Beispiel.
creationTimestamp: '2024-10-11T03:25:23.192-07:00' id: '4488228526648280060' kind: compute#reservation name: r-01 selfLink: https://www.s3nsapis.fr/compute/v1/projects/my-project/zones/us-central1-a/reservations/r-01 shareSettings: shareType: LOCAL specificReservation: assuredCount: '50' count: '50' inUseCount: '25' instanceProperties: machineType: n2-standard-2 specificReservationRequired: false status: READY zone: https://www.s3nsapis.fr/compute/v1/projects/my-project/zones/us-central1-a
Go
Verwenden Sie das folgende Codebeispiel, um eine Liste Ihrer Reservierungen aufzurufen:
So rufen Sie die Details einer Reservierung auf:
Java
Verwenden Sie das folgende Codebeispiel, um eine Liste Ihrer Reservierungen aufzurufen:
So rufen Sie die Details einer Reservierung auf:
Node.js
Verwenden Sie das folgende Codebeispiel, um eine Liste Ihrer Reservierungen aufzurufen:
So rufen Sie die Details einer Reservierung auf:
Python
Verwenden Sie das folgende Codebeispiel, um eine Liste Ihrer Reservierungen aufzurufen:
So rufen Sie die Details einer Reservierung auf:
REST
Wenn Sie eine Liste Ihrer Reservierungen aufrufen möchten, stellen Sie eine
GET
-Anfrage an die Methodereservations.list
:GET https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations
Ersetzen Sie Folgendes:
PROJECT_ID
: die ID des Projekts, in dem Sie Ihre Reservierungen erstellt haben.ZONE
: die Zone, in der sich Ihre Reservierungen befinden.
Die Ausgabe sieht etwa so aus wie im folgenden Beispiel.
{ "kind": "compute#reservation", "id": "4100668622331754141", "creationTimestamp": "2019-09-27T08:21:14.707-07:00", "selfLink": "https://www.s3nsapis.fr/compute/v1/projects/my-project/zones/us-central1-a/reservations/reservation-05", "zone": "https://www.s3nsapis.fr/compute/v1/projects/my-project/zones/us-central1-a", "name": "reservation-05", "specificReservation": { "instanceProperties": { "machineType": "n1-standard-2" }, "count": "100", "inUseCount": "0", "assuredCount": "100" }, "specificReservationRequired": false, "status": "READY", "shareSettings": { "shareType": "LOCAL" } }, { "kind": "compute#reservation", "id": "2533514314332214789", "creationTimestamp": "2019-09-27T08:21:14.707-07:00", "selfLink": "https://www.s3nsapis.fr/compute/v1/projects/my-project/zones/us-central1-a/reservations/reservation-04", "zone": "https://www.s3nsapis.fr/compute/v1/projects/my-project/zones/us-central1-a", "name": "reservation-04", "specificReservation": { "instanceProperties": { "machineType": "n1-standard-2", "guestAccelerators": [ { "acceleratorType": "nvidia-tesla-t4", "acceleratorCount": 1 } ], "localSsds": [ { "diskSizeGb": "375", "interface": "SCSI" } ] }, "count": "50", "inUseCount": "25", "assuredCount": "50" }, "specificReservationRequired": false, "status": "READY", "shareSettings": { "shareType": "LOCAL" } }
Optional können Sie die Liste der Reservierungen mithilfe eines Filterausdrucks eingrenzen, indem Sie den Abfrageparameter
filter
einfügen:GET https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations?filter=FILTER_EXPRESSION
Ersetzen Sie
FILTER_EXPRESSION
durch einen Filterausdruck, in dem URL-codierte Werte verwendet werden.Stellen Sie eine
GET
-Anfrage an die Methodereservations.get
, um die Details einer Reservierung aufzurufen.GET https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME
Ersetzen Sie Folgendes:
PROJECT_ID
: die ID des Projekts, in dem Sie die Reservierung erstellt haben.ZONE
: die Zone, in der die Reservierung vorhanden ist.RESERVATION_NAME
: der Name einer vorhandenen Reservierung.
Die Ausgabe sieht etwa so aus wie im folgenden Beispiel.
{ "kind": "compute#reservation", "id": "4488228526648280060", "creationTimestamp": "2024-10-11T03:25:23.192-07:00", "selfLink": "https://www.s3nsapis.fr/compute/v1/projects/davide-experimental/zones/us-central1-a/reservations/r-01", "zone": "https://www.s3nsapis.fr/compute/v1/projects/davide-experimental/zones/us-central1-a", "name": "r-01", "specificReservation": { "instanceProperties": { "machineType": "n2-standard-2" }, "count": "50", "inUseCount": "25", "assuredCount": "50" }, "specificReservationRequired": false, "status": "READY", "shareSettings": { "shareType": "LOCAL" } }
Zukünftige Reservierungsanfragen anzeigen
Verwenden Sie eine der in diesem Abschnitt beschriebenen Methoden, um die Einstellungen einer oder mehrerer vorausschauender Reservierungsanfragen aufzurufen:
Wenn Sie sich einen Überblick über alle vorausschauenden Reservierungsanfragen in Ihrem Projekt verschaffen möchten, rufen Sie eine Liste Ihrer Anfragen auf.
Wenn Sie die vollständigen Details einer einzelnen vorausschauenden Reservierungsanfrage aufrufen möchten, rufen Sie die Details der Anfrage auf.
Wählen Sie eine der folgenden Optionen aus, um zukünftige Reservierungsanfragen aufzurufen:
Console
Rufen Sie in der Trusted Cloud Console die Seite IAM auf.
Klicken Sie auf den Tab Zukünftige Reservierungen.
In der Tabelle wird jede zukünftige Reservierungsanfrage aufgeführt und jede Spalte beschreibt eine Eigenschaft.
Optional: Wenn Sie die Liste der Anfragen filtern möchten, wählen Sie im Feld
Filter die Eigenschaften aus, nach denen Sie die Anfragen filtern möchten.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 Befehl
gcloud beta compute future-reservations list
, um eine Liste Ihrer zukünftigen Reservierungsanfragen aufzurufen:gcloud beta compute future-reservations list
Die Ausgabe sieht etwa so aus wie im folgenden Beispiel.
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 die Liste der vorausschauenden Reservierungsanfragen mithilfe eines Filterausdrucks eingrenzen. Geben Sie dazu das Flag
--filter
an:gcloud beta compute future-reservations list \ --filter="FILTER_EXPRESSION"
Ersetzen Sie
FILTER_EXPRESSION
durch einen Filterausdruck.Verwenden Sie den Befehl
gcloud beta compute future-reservations describe
, 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 die zukünftige Reservierungsanfrage vorhanden ist.
Die Ausgabe sieht etwa so aus wie im folgenden Beispiel.
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.s3nsapis.fr/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-01 selfLinkWithId: https://www.s3nsapis.fr/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.s3nsapis.fr/compute/beta/projects/example-project/zones/us-central1-a
REST
Wenn Sie eine Liste Ihrer zukünftigen Reservierungsanfragen aufrufen möchten, stellen Sie eine
GET
-Anfrage an die Beta-MethodefutureReservations.list
:GET https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations
Ersetzen Sie Folgendes:
PROJECT_ID
: die ID des Projekts, in dem Sie Ihre vorausschauenden Reservierungsanfragen erstellt haben.ZONE
: die Zone, in der sich Ihre zukünftigen Reservierungsanfragen befinden.
Die Ausgabe sieht etwa so aus wie im folgenden Beispiel.
{ "id": "projects/my-project/zones/us-east1-a/futureReservations", "items": [ { "id": "743865190848184978", "creationTimestamp": "2025-03-23T18:16:45.274-07:00", "selfLink": "https://www.s3nsapis.fr/compute/beta/projects/my-project/zones/us-east1-a/futureReservations/fr-base", "selfLinkWithId": "https://www.s3nsapis.fr/compute/beta/projects/my-project/zones/us-east1-a/futureReservations/743865190848184978", "zone": "https://www.s3nsapis.fr/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.s3nsapis.fr/compute/beta/projects/my-project/zones/us-east1-a/futureReservations", "etag": "AnzKY34l-cvvV-JnniESJ0dtQvQ=/hvc4jaHpxFAZmOt1FVtKNgzZu-M=", "kind": "compute#futureReservationsListResponse" }
Optional können Sie die Liste der vorausschauenden Reservierungsanfragen mithilfe eines Filterausdrucks eingrenzen. Fügen Sie dazu den Abfrageparameter
filter
ein:GET https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/aggregated/futureReservations?filter=FILTER_EXPRESSION
Ersetzen Sie
FILTER_EXPRESSION
durch einen Filterausdruck, in dem URL-codierte Werte verwendet werden.Wenn Sie die Details einer zukünftigen Reservierungsanfrage aufrufen möchten, stellen Sie eine
GET
-Anfrage an die Beta-MethodefutureReservations.get
:GET https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME
Ersetzen Sie Folgendes:
PROJECT_ID
: die ID des Projekts, in dem Sie die zukünftige Reservierungsanfrage erstellt haben.ZONE
: die Zone, in der die zukünftige Reservierungsanfrage vorhanden ist.FUTURE_RESERVATION_NAME
: Den Name einer vorhandenen zukünftigen Reservierungsanfrage.
Die Ausgabe sieht 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.s3nsapis.fr/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-01", "selfLinkWithId": "https://www.s3nsapis.fr/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.s3nsapis.fr/compute/beta/projects/example-project/zones/us-central1-a" }
Anzahl der nutzbaren Instanzen ermitteln
Führen Sie einen der folgenden Schritte aus, um die Anzahl der Compute-Instanzen zu ermitteln, die Ihre reservierte Kapazität nutzen können:
Die maximale Anzahl von Instanzen, die eine Reservierung nutzen können, finden Sie unter Nutzbare Instanzen in einer Reservierung.
Die Anzahl der Instanzen, die Compute Engine für eine zukünftige Reservierungsanfrage zum Startzeitpunkt der Anfrage reservieren soll, finden Sie unter Verfügbare Instanzen in einer zukünftigen Reservierungsanfrage.
Informationen dazu, wie viele Instanzen Compute Engine für eine zukünftige Reservierungsanfrage im Kalendermodus zum Startzeitpunkt der Anfrage reservieren soll, finden Sie unter Verfügbare Instanzen in einer zukünftigen Reservierungsanfrage im Kalendermodus.
Nutzbare Instanzen in einer Reservierung
Wenn Sie die Details einer Reservierung aufrufen, können Sie anhand der folgenden Felder sehen, wie viele Compute-Instanzen die Reservierung nutzen und wie viele Instanzen sie nutzen können:
Garantierte Anzahl (
assuredCount
): Die Anzahl der Instanzen, die in der Zone der Reservierung physisch reserviert sind. Diese Zahl umfasst die Instanzen, die für Ihr Projekt und für alle Projekte reserviert sind, für die eine freigegebene Reservierung freigegeben ist.Gesamtzahl (
count
): Die Anzahl der in der Reservierung angegebenen reservierten Instanzen. Diese Zahl sollte mit der garantierten Anzahl übereinstimmen.Verwendete Maschinen (
inUseCount
): Die Anzahl der aktiven Instanzen in Ihrem Projekt oder in einem Projekt, für das eine freigegebene Reservierung freigegeben ist, die die Reservierung nutzen.
Wenn beispielsweise sowohl die garantierte Anzahl (
assuredCount
) als auch die Gesamtzahl (count
) 50 sind und die Anzahl der Instanzen, die die Reservierung nutzen (inUseCount
), 25 beträgt, können 25 weitere Instanzen die Reservierung nutzen, bevor sie vollständig genutzt ist.Verbrauchbare Instanzen in einer Anfrage für vorausschauende Reservierungen
Sie können die Anzahl der Compute-Instanzen ermitteln, für die Compute Engine zum Startzeitpunkt einer Anfrage für eine zukünftige Reservierung eine Reservierung erstellt. Bei einem Entwurf, einer ausstehenden Genehmigung oder einer genehmigten Anfrage können Sie diese Nummer so ermitteln:
Sie können sehen, wie viele laufende Instanzen und nicht verwendete Reservierungen in Ihrem Projekt und in allen Projekten, mit denen die Anfrage geteilt wird, den Anfrageattributen entsprechen.
Ziehen Sie die Anzahl der übereinstimmenden laufenden Instanzen und ungenutzten Reservierungen von der Gesamtzahl in der Anfrage ab.
Sie können die Anzahl der verbrauchbaren Instanzen für einzelne oder mehrere Anfragen gleichzeitig ermitteln. Bei mehreren Anfragen verwenden Sie die Trusted Cloud Konsole oder die REST API. Wählen Sie für einzelne Anfragen eine der folgenden Optionen aus:
Console
Rufen Sie in der Trusted Cloud Console die Seite IAM auf.
Klicken Sie auf den Tab Zukünftige Reservierungen.
In der Tabelle wird jede zukünftige Reservierungsanfrage aufgeführt und jede Spalte beschreibt eine Eigenschaft.
Wenn Sie die Anzahl der Instanzen ermitteln möchten, die Compute Engine zum Startzeitpunkt für eine Anfrage reservieren möchte, ziehen Sie die Spalte Passende Anzahl von der Spalte Gesamtanzahl ab.
In der Spalte Passende Anzahl wird eine der folgenden Warnungen angezeigt:
Anzahl der Übereinstimmungen ist null: Es gibt keine übereinstimmenden laufenden Instanzen oder nicht verwendeten Reservierungen in Ihrem Projekt oder in einem Projekt, mit dem Ihre Anfrage geteilt wird.
Anzahl der Übereinstimmungen entspricht der Gesamtzahl: Compute Engine reserviert zum Startzeitpunkt keine Instanzen für Ihre Anfrage.
Wenn Sie eine Anfrage ändern oder neue Instanzen oder Reservierungen erstellen, die der Anfrage entsprechen, aktualisiert Compute Engine die Spalte Passende Anzahl innerhalb von 30 Minuten.
Optional: So prüfen Sie, wann die Spalte Passende Anzahl in einer Anfrage zuletzt aktualisiert wurde:
Klicken Sie in der Spalte Name auf den Namen der Anfrage. Eine Seite mit den Details der zukünftigen Reservierungsanfrage wird geöffnet.
Sehen Sie sich im Abschnitt Ressourcendetails das Feld Letzte Auswertungszeit der übereinstimmenden Nutzung an.
gcloud
Verwenden Sie den Befehl
gcloud beta compute future-reservations describe
, 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 die zukünftige Reservierungsanfrage vorhanden ist.
Suchen Sie in der Ausgabe nach den Feldern
count
undtotalCount
:... specificSkuProperties: ... totalCount: '100' status: existingMatchingUsageInfo: count: '50' timestamp: '2025-03-30T01:00:00Z' ... procurementStatus: DRAFTING ...
Ziehen Sie den Wert von
count
vontotalCount
ab. Wenncount
beispielsweise 50 undtotalCount
100 ist, erstellt Compute Engine automatisch eine Reservierung für 50 Instanzen zum Startzeitpunkt der Anfrage.Wenn Sie die Anfrage ändern oder neue Instanzen oder Reservierungen erstellen, die der Anfrage entsprechen, aktualisiert Compute Engine das Feld
existingMatchingUsageInfo
innerhalb von 30 Minuten. Den Zeitpunkt der letzten Aktualisierung dieses Felds sehen Sie im Wert vonexistingMatchingUsageInfo.timestamp
.
REST
Wenn Sie eine Liste Ihrer zukünftigen Reservierungsanfragen anzeigen möchten, stellen Sie eine
GET
-Anfrage an die Beta-MethodefutureReservations.list
. Fügen Sie in der Anfrage-URL den Abfrageparameterfilter
ein und geben Sie an, dass nur die Feldername
,specificSkuProperties
undstatus
angezeigt werden sollen:GET https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations?fields=items.name,items.specificSkuProperties,items.status
Ersetzen Sie Folgendes:
PROJECT_ID
: die ID des Projekts, in dem Sie Ihre vorausschauenden Reservierungsanfragen erstellt haben.ZONE
: die Zone, in der die zukünftige Reservierungsanfrage vorhanden ist.
Suchen Sie in der Ausgabe nach den Feldern
count
undtotalCount
für jeden Entwurf, jede ausstehende Genehmigung oder jede genehmigte Anfrage:{ "items": [ { "specificSkuProperties": { ... totalCount: "100" }, "name": "fr-01", "status": { "procurementStatus": "APPROVED", ... existingMatchingUsageInfo: { count: "50", "timestamp": "2025-01-22T07:54:26.295Z" } } }, { "specificSkuProperties": { ... totalCount: "20" }, "name": "fr-02", "status": { "procurementStatus": "DRAFTING", ... existingMatchingUsageInfo: { "count": "2", "timestamp": "2025-01-22T07:54:26.295Z" } } } ] }
Ziehen Sie für jede Anfrage den Wert von
count
vontotalCount
ab. Wenncount
beispielsweise 50 undtotalCount
100 ist, erstellt Compute Engine automatisch eine Reservierung für 50 Instanzen zur Startzeit der Anfrage.Wenn Sie eine Anfrage ändern oder neue Instanzen oder Reservierungen erstellen, die der Anfrage entsprechen, aktualisiert Compute Engine das Feld
existingMatchingUsageInfo
innerhalb von 30 Minuten. Den Zeitpunkt der letzten Aktualisierung dieses Felds sehen Sie im Wert vonexistingMatchingUsageInfo.timestamp
.
Verbrauchbare Instanzen in einer Anfrage für vorausschauende Reservierungen im Kalendermodus
Wenn Sie die Details einer zukünftigen Reservierungsanfrage ansehen, können Sie sehen, wie viele Compute-Instanzen Compute Engine zum Startzeitpunkt der Anfrage bereitstellen möchte. Compute Engine erstellt die im Antrag angegebene Anzahl von Instanzen, unabhängig von der Anzahl der übereinstimmenden Instanzen in Ihrem Projekt oder in einem Projekt, für das der Antrag freigegeben ist.
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: 2025-08-18 (UTC).
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-18 (UTC)."],[[["This document outlines how to view the settings and details of your Compute Engine reservations and future reservation requests, allowing for verification and capacity planning."],["You can determine the number of instances that can consume your reserved capacity by examining the \"Assured count,\" \"Total count,\" and \"Machines in use\" fields for reservations, and by calculating the difference between \"count\" and \"totalCount\" for future requests."],["Viewing reservations and future requests requires specific permissions, primarily through the Compute Admin IAM role, which includes permissions like `compute.reservations.list` and `compute.futureReservations.list`."],["The process for viewing reservations and future reservation requests can be done via the Google Cloud console, `gcloud` CLI, code samples in various languages (Go, Java, Node.js, Python), or through REST API calls."],["Future reservation requests, currently in Preview, allow you to view details such as `procurementStatus`, `existingMatchingUsageInfo` and can be viewed and managed similarly to on-demand reservations."]]],[]] -