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.
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:
-
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
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:
FILTER_EXPRESSION
: ein Filterausdruck.PROJECT_ID
: die ID des Projekts, in dem sich Ihre Reservierungen befinden.
Führen Sie beispielsweise den folgenden Befehl aus, um nur Reservierungen anzuzeigen, deren Name mit prefix
beginnt und die sich in der Zone us-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 Methode reservations.list
, um eine Liste Ihrer Reservierungen anzusehen.
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations
Ersetzen Sie Folgendes:
PROJECT_ID
: die ID des Projekts, in dem sich Ihre Reservierungen befinden.ZONE
: die Zone, in der sich Ihre Ressourcen befinden.
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:
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.
Beispiel: Um nur Reservierungen anzuzeigen, deren Name mit prefix
beginnt
und sich in der Zone us-central1-a
befinden, stellen Sie die folgende GET
-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:
Ö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.
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:
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.
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
und inUseCount
bestimmen. In diesem Beispiel sind 50 VMs reserviert und 25 VMs wurden verbraucht.
REST
Stellen Sie eine GET
-Anfrage an die Methode reservations.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:
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.
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
und inUseCount
bestimmen. In diesem Beispiel sind 50 VMs reserviert und 25 VMs wurden verbraucht.
Nächste Schritte
- Reservierungen an Zusicherungen anhängen
- Reservierungen verwenden
- Reservierungen ändern
- Reservierungen löschen