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.
Wählen Sie den Tab für die Verwendung der Beispiele auf dieser Seite aus:
Console
Wenn Sie über die Google Cloud Console auf Google Cloud-Dienste und -APIs zugreifen, müssen Sie die Authentifizierung nicht einrichten.
gcloud
-
Installieren Sie die Google Cloud CLI und initialisieren Sie sie mit folgendem Befehl:
gcloud init
- Legen Sie eine Standardregion und -zone fest.
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
-
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
Zum Aufrufen von Reservierungen sind die folgenden Berechtigungen 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 sehen, die in Ihrem aktuellen Projekt erstellt wurden.
Nur das Inhaberprojekt kann eine freigegebene Reservierung sehen. Wenn Sie die Projekte sehen möchten, für die eine freigegebene Reservierung freigegeben ist, 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 dabei 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
Wenn Sie eine Liste von Reservierungen mit einem Filterausdruck eingrenzen möchten, geben Sie das Flag --filter
an.
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-k80",
"acceleratorCount": 1
}
],
"minCpuPlatform": "Any CPU Platform",
"localSsds": [
{
"diskSizeGb": "375",
"interface": "SCSI"
}
]
},
"count": "50",
"inUseCount": "25"
},
"specificReservationRequired": false,
"status": "READY",
"kind": "compute#reservation"
}
Wenn Sie eine Liste von Reservierungen mit einem Filterausdruck eingrenzen möchten, können Sie die folgende GET
-Anfrage stellen:
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.
Wenn Sie beispielsweise nur Reservierungen mit einem Namen anzeigen möchten, der mit prefix
beginnt und sich in der Zone us-central1-a
befindet, stellen Sie 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-k80
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-k80",
"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