Reservierungen ansehen

In diesem Dokument wird erläutert, wie Sie Reservierungen aufrufen.

Sie können sich Reservierungen ansehen, um eine Übersicht über alle Reservierungen in Ihrem Projekt zu erhalten oder die Konfigurationsdetails einer Reservierung zu prüfen. Wenn Sie eine freigegebene Reservierung aufrufen möchten, können Sie sie nur mit dem Inhaberprojekt aufrufen.

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 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

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

      Verwenden Sie die von der gcloud CLI bereitgestellten Anmeldedaten, um die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung zu verwenden.

        Install the Google Cloud CLI, then initialize it by running the following command: 

        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

Wählen Sie eine der folgenden Methoden aus, um die Details einer Reservierung aufzurufen:

Liste Ihrer Reservierungen ansehen

Wählen Sie eine der folgenden Optionen aus, um eine Liste Ihrer Reservierungen anzusehen:

Console

Öffnen Sie in der Google Cloud Console die Seite Reservierungen.

Zu „Reservierungen“

Auf dem Tab On-Demand-Reservierungen (Standardeinstellung) wird in der Tabelle 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

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 die Liste der Reservierungen mithilfe eines Filterausdrucks eingrenzen. Fügen Sie dazu das Flag --filter hinzu.

gcloud compute reservations list \
    --filter="FILTER_EXPRESSION"

Ersetzen Sie FILTER_EXPRESSION durch einen Filterausdruck.

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"

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"
}

Wenn Sie eine Liste der Reservierungen mithilfe eines Filterausdrucks eingrenzen möchten, fügen Sie optional den Abfrageparameter filter so ein:

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

Wählen Sie eine der folgenden Optionen aus, um die Details einer Reservierung aufzurufen:

Console

  1. Öffnen Sie in der Google Cloud Console die Seite Reservierungen.

    Zu „Reservierungen“

  2. Klicken Sie auf dem Tab On-Demand-Reservierungen (Standardeinstellung) in der Spalte Name auf den Namen der Reservierung, deren Details Sie aufrufen möchten.

    Die Seite mit den Details der ausgewählten Reservierung wird geöffnet. 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 \
    --zone=ZONE

Ersetzen Sie Folgendes:

  • RESERVATION_NAME: der Name einer vorhandenen Reservierung.

  • ZONE: die Zone, in der sich die Reservierung befindet.

Die Ausgabe sieht in etwa so aus:

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 sieht in etwa so aus:

{
  "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