Reservierungen ansehen

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
1. Installieren Sie die Google Cloud CLI und initialisieren Sie sie mit folgendem Befehl:
```
gcloud init
```
  Hinweis: Wenn Sie die gcloud CLI zuvor installiert haben, prüfen Sie, ob Sie die neueste Version haben, indem Sie gcloud components update ausführen.
2. 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.

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.

Zu „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.

Zu „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.

Reservierungen ansehen

Hinweise

Console

gcloud

REST

Erforderliche Rollen

Erforderliche Berechtigungen

Ihre Reservierungen aufrufen

Liste Ihrer Reservierungen ansehen

Console

gcloud

REST

Details einer Reservierung aufrufen

Console

gcloud

REST

Nächste Schritte