In diesem Dokument wird erläutert, wie Sie Reservierungen aufrufen.
Hinweise
- Informationen zu den Anforderungen und Einschränkungen für Reservierungen
-
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
-
Installieren Sie die Google Cloud CLI und initialisieren Sie sie mit folgendem Befehl:
gcloud init
- Set a default region and zone.
-
So zeigen Sie eine Liste der Reservierungen an:
compute.reservations.list
im Projekt -
So zeigen Sie die Details einer Reservierung an:
compute.reservations.get
im Projekt FILTER_EXPRESSION
: ein Filterausdruck.PROJECT_ID
: die ID des Projekts, in dem sich Ihre Reservierungen befinden.PROJECT_ID
: die ID des Projekts, in dem sich Ihre Reservierungen befinden.ZONE
: die Zone, in der sich Ihre Ressourcen befinden.PROJECT_ID
: die ID des Projekts, in dem sich Ihre Reservierungen befinden.ZONE
: die Zone, in der sich Ihre Ressourcen befinden.FILTER_EXPRESSION
: ein Filterausdruck.Öffnen Sie in der Google Cloud Console die Seite Reservierungen.
Die Seite Reservierungen wird angezeigt.
Klicken Sie in der Spalte Name auf den Namen der Reservierung, die Sie beschreiben möchten.
Die Detailseite für die Reservierung wird angezeigt. Die Auslastung einer Reservierung können Sie anhand der Felder Reservierte Maschinen insgesamt und Verwendete Maschinen bestimmen.
RESERVATION_NAME
: der Name einer vorhandenen Reservierung.PROJECT_ID
: die ID des Projekts, in dem sich die Reservierung befindet.ZONE
: die Zone, in der sich die Reservierung befindet.PROJECT_ID
: die ID des Projekts, in dem sich die Reservierung befindet.ZONE
: die Zone, in der sich die Reservierung befindet.RESERVATION_NAME
: der Name einer vorhandenen Reservierung.- Reservierungen an Zusicherungen anhängen
- Reservierungen verwenden
- Reservierungen ändern
- Reservierungen löschen
REST
Verwenden Sie die von der gcloud CLI bereitgestellten Anmeldedaten, um die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung zu verwenden.
Installieren Sie die Google Cloud CLI und initialisieren Sie sie mit folgendem Befehl:
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-Administrator (
roles/compute.admin
) 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 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 zum Aufrufen von Reservierungen erforderlich:
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Ihre Reservierungen aufrufen
Sie können nur die Reservierungen aufrufen, die in Ihrem aktuellen Projekt erstellt wurden.
Nur das Inhaberprojekt kann eine freigegebene Reservierung ansehen. Wenn Sie die Projekte, für die eine gemeinsame Reservierung freigegeben ist, ansehen möchten, rufen Sie die Details der Reservierung auf.
Liste Ihrer Reservierungen ansehen
Verwenden Sie die Google Cloud Console, die gcloud CLI oder REST, um eine Liste Ihrer Reservierungen aufzurufen.
Console
Öffnen Sie in der Google Cloud Console die Seite Reservierungen.
Die Seite Reservierungen wird angezeigt.
In der Tabelle wird in jeder Zeile eine Reservierung und in jeder Spalte ein Attribut beschrieben. In der Spalte Verwendete Maschinen werden z. B. die Auslastung und Gesamtkapazität jeder Reservierung beschrieben: Der Wert
25 (50)
stellt eine Reservierung für 50 VMs dar, wobei 25 dieser VMs verbraucht wurden.Optional: Wenn Sie ändern möchten, welche Reservierungen und Attribute angezeigt werden, verwenden Sie den Filter
und die Spaltenanzeigeoptionen .gcloud
Verwenden Sie den Befehl
gcloud compute reservations list
, um eine Liste Ihrer Reservierungen aufzurufen.gcloud compute reservations list \ --project=PROJECT_ID
Ersetzen Sie
PROJECT_ID
durch die ID des Projekts, in dem sich Ihre Reservierungen befinden.Die Ausgabe sollte in etwa so aussehen:
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 das Flag
--filter
angeben, um eine Liste der Reservierungen mithilfe eines Filterausdrucks einzugrenzen.gcloud compute reservations list \ --filter="FILTER_EXPRESSION" \ --project=PROJECT_ID
Ersetzen Sie Folgendes:
Führen Sie beispielsweise den folgenden Befehl aus, um nur Reservierungen anzuzeigen, deren Name mit
prefix
beginnt und die sich in der Zoneus-central1-a
befinden:gcloud compute reservations list \ --filter="name~prefix AND zone=us-central1-a" \ --project=example-project
REST
Stellen Sie eine
GET
-Anfrage an die Methodereservations.list
, um eine Liste Ihrer Reservierungen anzusehen.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations
Ersetzen Sie Folgendes:
Die Ausgabe sieht etwa so aus wie im folgenden Beispiel.
{ "id": "4100668622331754141", "creationTimestamp": "2019-09-27T08:21:14.707-07:00", "selfLink": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/reservation-05", "zone": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a", "name": "reservation-05", "specificReservation": { "instanceProperties": { "machineType": "n1-standard-2", "minCpuPlatform": "Any CPU Platform", }, "count": "100", "inUseCount": "0" }, "specificReservationRequired": false, "status": "READY", "kind": "compute#reservation" }, { "id": "2533514314332214789", "creationTimestamp": "2019-09-27T08:21:14.707-07:00", "selfLink": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/reservation-04", "zone": "https://www.googleapis.com/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 } ], "minCpuPlatform": "Any CPU Platform", "localSsds": [ { "diskSizeGb": "375", "interface": "SCSI" } ] }, "count": "50", "inUseCount": "25" }, "specificReservationRequired": false, "status": "READY", "kind": "compute#reservation" }
Optional können Sie die Liste der Reservierungen mithilfe eines Filterausdrucks durch die folgende
GET
-Anfrage eingrenzen:GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations?filter=FILTER_EXPRESSION
Ersetzen Sie Folgendes:
Beispiel: Um nur Reservierungen anzuzeigen, deren Name mit
prefix
beginnt und sich in der Zoneus-central1-a
befinden, stellen Sie die folgendeGET
-Anfrage mit URL-codierten Werten:GET https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations?filter=name%7Eprefix%20AND%20zone=us-central1-a
Details einer Reservierung aufrufen
Verwenden Sie die Google Cloud Console, die gcloud CLI oder REST, um die Details einer Reservierung aufzurufen.
Console
So rufen Sie die Details einer VM auf:
gcloud
Wenn Sie die Details einer VM aufrufen möchten, verwenden Sie den Befehl
gcloud compute reservations describe
.gcloud compute reservations describe RESERVATION_NAME \ --project=PROJECT_ID \ --zone=ZONE
Ersetzen Sie Folgendes:
Die Ausgabe sollte in etwa so aussehen:
kind: compute#reservation name: reservation-04 selfLink: https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/reservation-04 specificReservation: count: '50' inUseCount: '25' instanceProperties: guestAccelerators: - acceleratorCount: 1 acceleratorType: nvidia-tesla-t4 localSsds: - diskSizeGb: '375' interface: SCSI machineType: n1-standard-2 minCpuPlatform: Any CPU Platform specificReservationRequired: false status: READY zone: https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a
Die Auslastung einer Reservierung können Sie anhand der Felder
count
undinUseCount
bestimmen. In diesem Beispiel sind 50 VMs reserviert und 25 VMs wurden verbraucht.REST
Stellen Sie eine
GET
-Anfrage an die Methodereservations.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:
Die Ausgabe sollte in etwa so aussehen:
{ "id": "2533514314332214789", "creationTimestamp": "2019-09-27T08:21:14.707-07:00", "selfLink": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/reservation-04", "zone": "https://www.googleapis.com/compute/v1/projects/my-project/zones/us-centra1-a", "name": "reservation-04", "specificReservationRequired": false, "status": "READY", "kind": "compute#reservation", "specificReservation": { "instanceProperties": { "machineType": "n1-standard-2", "guestAccelerators": [ { "acceleratorType": "nvidia-tesla-t4", "acceleratorCount": 1 } ], "minCpuPlatform": "Any CPU Platform", "localSsds": [ { "diskSizeGb": "375", "interface": "SCSI" } ] }, "count": "50", "inUseCount": "25" } }
Die Auslastung einer Reservierung können Sie anhand der Felder
count
undinUseCount
bestimmen. In diesem Beispiel sind 50 VMs reserviert und 25 VMs wurden verbraucht.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-07-24 (UTC).
[{ "type": "thumb-down", "id": "hardToUnderstand", "label":"Hard to understand" },{ "type": "thumb-down", "id": "incorrectInformationOrSampleCode", "label":"Incorrect information or sample code" },{ "type": "thumb-down", "id": "missingTheInformationSamplesINeed", "label":"Missing the information/samples I need" },{ "type": "thumb-down", "id": "translationIssue", "label":"Problem mit der Übersetzung" },{ "type": "thumb-down", "id": "otherDown", "label":"Sonstiges" }] [{ "type": "thumb-up", "id": "easyToUnderstand", "label":"Leicht verständlich" },{ "type": "thumb-up", "id": "solvedMyProblem", "label":"Mein Problem wurde gelöst" },{ "type": "thumb-up", "id": "otherUp", "label":"Sonstiges" }] -