Diese Seite wurde von der Cloud Translation API übersetzt.

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 sich eine freigegebene Reservierung ansehen möchten, können Sie dies nur über das Inhaberprojekt tun.

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 bei Compute Engine authentifizieren. Wählen Sie dazu eine der folgenden Optionen aus:

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
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

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 auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Anzeigen von Reservierungen erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um Reservierungen aufzurufen:

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.

Reservierungen ansehen

Verwenden Sie eine der folgenden Methoden, um Informationen zu einer Reservierung in Ihrem Projekt aufzurufen:

Eine Übersicht aller Reservierungen in Ihrem Projekt finden Sie hier.
Die vollständigen Details einer bestimmten Reservierung finden Sie hier.

Liste Ihrer Reservierungen ansehen

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

Console

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

Zu „Reservierungen“
Auf dem Tab On-Demand-Reservierungen (Standard) wird in der Tabelle in jeder Zeile eine Reservierung und in jeder Spalte eine Unterkunft beschrieben.
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"

Go

import (
	"context"
	"fmt"
	"io"

	compute "cloud.google.com/go/compute/apiv1"
	computepb "cloud.google.com/go/compute/apiv1/computepb"
	"google.golang.org/api/iterator"
)

// Get list of reservations for given project in particular zone
func listReservations(w io.Writer, projectID, zone string) error {
	// projectID := "your_project_id"
	// zone := "us-west3-a"

	ctx := context.Background()
	reservationsClient, err := compute.NewReservationsRESTClient(ctx)
	if err != nil {
		return err
	}
	defer reservationsClient.Close()

	req := &computepb.ListReservationsRequest{
		Project: projectID,
		Zone:    zone,
	}

	it := reservationsClient.List(ctx, req)
	fmt.Fprintf(w, "Instances found in zone %s:\n", zone)
	for {
		instance, err := it.Next()
		if err == iterator.Done {
			break
		}
		if err != nil {
			return err
		}
		fmt.Fprintf(w, "- %s %d\n", instance.GetName(), instance.GetSpecificReservation().GetCount())
	}

	return nil
}

Java

import com.google.cloud.compute.v1.Reservation;
import com.google.cloud.compute.v1.ReservationsClient;
import java.io.IOException;
import java.util.ArrayList;
import java.util.List;

public class ListReservations {

  public static void main(String[] args) throws IOException {
    // TODO(developer): Replace these variables before running the sample.
    // Project ID or project number of the Cloud project you want to use.
    String project = "YOUR_PROJECT_ID";
    // Zone in which reservations are located.
    String zone = "us-central1-a";

    listReservations(project, zone);
  }

  // List all reservations in the given project and zone.
  public static List<Reservation> listReservations(String project, String zone) throws IOException {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests.
    List<Reservation> listOfReservations = new ArrayList<>();

    try (ReservationsClient reservationsClient = ReservationsClient.create()) {
      for (Reservation reservation : reservationsClient.list(project, zone).iterateAll()) {
        listOfReservations.add(reservation);
        System.out.println("Reservation: " + reservation.getName());
      }
    }
    return listOfReservations;
  }
}

Node.js

// Import the Compute library
const computeLib = require('@google-cloud/compute');

// Instantiate a reservationsClient
const reservationsClient = new computeLib.ReservationsClient();

/**
 * TODO(developer): Update these variables before running the sample.
 */
// The ID of the project where your reservations are located.
const projectId = await reservationsClient.getProjectId();
// The zone where your reservations are located.
const zone = 'us-central1-a';

async function callGetReservations() {
  const reservations = (
    await reservationsClient.list({
      project: projectId,
      zone,
    })
  )[0];

  console.log(JSON.stringify(reservations));
}

await callGetReservations();

Python

from google.cloud import compute_v1
from google.cloud.compute_v1.services.reservations.pagers import ListPager


def list_compute_reservation(project_id: str, zone: str = "us-central1-a") -> ListPager:
    """
    Lists all compute reservations in a specified Google Cloud project and zone.
    Args:
        project_id (str): The ID of the Google Cloud project.
        zone (str): The zone of the reservations.
    Returns:
        ListPager: A pager object containing the list of reservations.
    """

    client = compute_v1.ReservationsClient()

    reservations_list = client.list(
        project=project_id,
        zone=zone,
    )

    for reservation in reservations_list:
        print("Name: ", reservation.name)
        print(
            "Machine type: ",
            reservation.specific_reservation.instance_properties.machine_type,
        )
    # Example response:
    # Name:  my-reservation_1
    # Machine type:  n1-standard-1
    # Name:  my-reservation_2
    # Machine type:  n1-standard-1

    return reservations_list

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.

{
  "kind": "compute#reservation",
  "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"
    },
    "count": "100",
    "inUseCount": "0",
    "assuredCount": "100"
  },
  "specificReservationRequired": false,
  "status": "READY",
  "shareSettings": {
    "shareType": "LOCAL"
  }
},
{
  "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
        }
      ],
      "localSsds": [
        {
          "diskSizeGb": "375",
          "interface": "SCSI"
        }
      ]
    },
    "count": "50",
    "inUseCount": "25",
    "assuredCount": "50"
  },
  "specificReservationRequired": false,
  "status": "READY",
  "shareSettings": {
    "shareType": "LOCAL"
  }
}

Optional können Sie die Liste der Reservierungen mithilfe eines Filterausdrucks eingrenzen. Fügen Sie dazu den Abfrageparameter filter wie unten gezeigt 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 ansehen

In der Google Cloud Console können Sie sich ansehen, wie viele VMs jedes unterstützte Google Cloud-Produkt in einer Reservierung belegt. Wählen Sie andernfalls eine der folgenden Optionen aus:

Console

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

Zu „Reservierungen“
Klicken Sie auf dem Tab On-Demand-Reservierungen (Standard) 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. Wenn Sie das Feld Gesicherte Anzahl sehen möchten, müssen Sie eine Liste Ihrer Reservierungen aufrufen.

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:

creationTimestamp: '2024-10-11T03:25:23.192-07:00'
id: '4488228526648280060'
kind: compute#reservation
name: r-01
selfLink: https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations/r-01
shareSettings:
  shareType: LOCAL
specificReservation:
  assuredCount: '50'
  count: '50'
  inUseCount: '25'
  instanceProperties:
    machineType: n2-standard-2
specificReservationRequired: false
status: READY
zone: https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a

Go

import (
	"context"
	"fmt"
	"io"

	compute "cloud.google.com/go/compute/apiv1"
	computepb "cloud.google.com/go/compute/apiv1/computepb"
)

// Get certain reservation for given project and zone
func getReservation(w io.Writer, projectID, zone, reservationName string) (*computepb.Reservation, error) {
	// projectID := "your_project_id"
	// zone := "us-west3-a"
	// reservationName := "your_reservation_name"

	ctx := context.Background()
	reservationsClient, err := compute.NewReservationsRESTClient(ctx)
	if err != nil {
		return nil, err
	}
	defer reservationsClient.Close()

	req := &computepb.GetReservationRequest{
		Project:     projectID,
		Reservation: reservationName,
		Zone:        zone,
	}

	reservation, err := reservationsClient.Get(ctx, req)
	if err != nil {
		return nil, fmt.Errorf("unable to delete reservation: %w", err)
	}

	fmt.Fprintf(w, "Reservation: %s\n", reservation.GetName())

	return reservation, nil
}

Java

import com.google.cloud.compute.v1.Reservation;
import com.google.cloud.compute.v1.ReservationsClient;
import java.io.IOException;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.TimeoutException;

public class GetReservation {

  public static void main(String[] args)
      throws IOException, ExecutionException, InterruptedException, TimeoutException {
    // TODO(developer): Replace these variables before running the sample.
    // Project ID or project number of the Cloud project you want to use.
    String projectId = "YOUR_PROJECT_ID";
    // Name of the zone in which you want to create the reservation.
    String zone = "us-central1-a";
    // Name of the reservation you want to create.
    String reservationName = "test-reservation-name";

    getReservation(projectId, reservationName, zone);
  }

  // Retrieve a reservation with the given name in the given zone.
  public static Reservation getReservation(
      String projectId, String reservationName, String zone)
      throws IOException {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests.
    try (ReservationsClient reservationsClient = ReservationsClient.create()) {

      // Get the reservation.
      Reservation reservation = reservationsClient.get(projectId, zone, reservationName);

      System.out.println("Reservation: " + reservation.getName());
      return reservation;
    }
  }
}

Node.js

// Import the Compute library
const computeLib = require('@google-cloud/compute');

// Instantiate a reservationsClient
const reservationsClient = new computeLib.ReservationsClient();

/**
 * TODO(developer): Update/uncomment these variables before running the sample.
 */
// The ID of the project where your reservation is located.
const projectId = await reservationsClient.getProjectId();
// The zone where your reservation is located.
const zone = 'us-central1-a';
// The name of the reservation to return.
// reservationName = 'reservation-01';

async function callGetReservation() {
  const requestedReservation = (
    await reservationsClient.get({
      project: projectId,
      zone,
      reservation: reservationName,
    })
  )[0];

  console.log(JSON.stringify(requestedReservation));
}

await callGetReservation();

Python

from google.cloud import compute_v1
from google.cloud.compute_v1.types import compute


def get_compute_reservation(
    project_id: str,
    zone: str = "us-central1-a",
    reservation_name="your-reservation-name",
) -> compute.Reservation:
    """
    Retrieves a compute reservation from GCP.
    Args:
        project_id (str): The ID of the Google Cloud project.
        zone (str): The zone of the reservation.
        reservation_name (str): The name of the reservation to retrieve.
    Returns:
        compute.Reservation: The reservation object retrieved from Google Cloud.
    """

    client = compute_v1.ReservationsClient()

    reservation = client.get(
        project=project_id,
        zone=zone,
        reservation=reservation_name,
    )

    print("Name: ", reservation.name)
    print("STATUS: ", reservation.status)
    print(reservation.specific_reservation)
    # Example response:
    # Name:  your-reservation-name
    # STATUS:  READY
    # count: 3
    # instance_properties {
    #   machine_type: "n1-standard-1"
    #   local_ssds {
    #     disk_size_gb: 375
    #     interface: "NVME"
    #   }
    # ...

    return reservation

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:

{
  "kind": "compute#reservation",
  "id": "4488228526648280060",
  "creationTimestamp": "2024-10-11T03:25:23.192-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/davide-experimental/zones/us-central1-a/reservations/r-01",
  "zone": "https://www.googleapis.com/compute/v1/projects/davide-experimental/zones/us-central1-a",
  "name": "r-01",
  "specificReservation": {
    "instanceProperties": {
      "machineType": "n2-standard-2"
    },
    "count": "50",
    "inUseCount": "25",
    "assuredCount": "50"
  },
  "specificReservationRequired": false,
  "status": "READY",
  "shareSettings": {
    "shareType": "LOCAL"
  }
}

Anzahl der nutzbaren VMs ermitteln

In den folgenden Feldern können Sie sehen, wie viele VMs die Reservierung nutzen und wie viele weitere VMs sie nutzen können:

Gesicherte Anzahl (assuredCount): Die Anzahl der VMs, die in der Zone der Reservierung für Ihr Projekt und für alle Projekte reserviert sind, für die eine freigegebene Reservierung freigegeben ist.
Gesamtzahl (count): Die in der Reservierung angegebene Anzahl der reservierten VMs. Diese Zahl sollte mit der Anzahl der garantierten Instanzen übereinstimmen.

Achtung :Wenn die garantierte Anzahl einer Reservierung niedriger als die Gesamtzahl ist, werden weniger VMs als erwartet reserviert. Informationen zur Behebung dieses Problems finden Sie unter Weniger VMs für die Nutzung verfügbar.
In Verwendung befindliche Maschinen (inUseCount): Die Anzahl der laufenden VMs in Ihrem Projekt oder in einem Projekt, für das eine freigegebene Reservierung freigegeben wurde, die die Reservierung belegen.

Wenn beispielsweise die garantierte Anzahl (assuredCount) und die Gesamtzahl (count) jeweils 50 beträgt und die Anzahl der VMs, die die Reservierung nutzen (inUseCount), 25 ist, werden 25 VMs durch die Reservierung belegt und Sie können weitere 25 VMs erstellen und ausführen, bevor die Reservierung vollständig aufgebraucht ist.

Reservierungen ansehen

Hinweise

Console

gcloud

Terraform

Go

Java

Node.js

Python

REST

Erforderliche Rollen

Erforderliche Berechtigungen

Reservierungen ansehen

Liste Ihrer Reservierungen ansehen

Console

gcloud

Go

Java

Node.js

Python

REST

Details einer Reservierung ansehen

Console

gcloud

Go

Java

Node.js

Python

REST

Anzahl der nutzbaren VMs ermitteln

Nächste Schritte