Questa pagina è stata tradotta dall'API Cloud Translation.

Visualizza prenotazioni

Questo documento spiega come visualizzare le prenotazioni.

La visualizzazione delle prenotazioni è utile per avere una panoramica di tutte le prenotazioni nel tuo progetto o per esaminare i dettagli di configurazione di una prenotazione. Se vuoi visualizzare una prenotazione condivisa, puoi farlo solo utilizzando il progetto del proprietario.

Prima di iniziare

Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è la procedura mediante la quale la tua identità viene verificata per l'accesso alle API e ai servizi Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:

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.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per visualizzare le prenotazioni, chiedi all'amministratore di concederti il ruolo IAM Amministratore di Compute (roles/compute.admin) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per visualizzare le prenotazioni. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

Per visualizzare le prenotazioni sono necessarie le seguenti autorizzazioni:

Per visualizzare un elenco di prenotazioni: compute.reservations.list nel progetto
Per visualizzare i dettagli di una prenotazione: compute.reservations.get nel progetto

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Visualizza prenotazioni

Per visualizzare le informazioni su una prenotazione nel tuo progetto, utilizza uno dei seguenti metodi:

Per una panoramica di tutte le prenotazioni nel tuo progetto, visualizza un elenco delle prenotazioni.
Per i dettagli completi di una prenotazione specifica, visualizza i dettagli di una prenotazione.

Visualizzare un elenco delle prenotazioni

Per visualizzare un elenco delle tue prenotazioni, seleziona una delle seguenti opzioni:

Console

Nella console Google Cloud, vai alla pagina Prenotazioni.

Vai a Prenotazioni
Nella scheda Prenotazioni on demand (predefinita), nella tabella ogni riga descrive una prenotazione e ogni colonna una proprietà.
(Facoltativo) Per modificare le prenotazioni e le proprietà visualizzate, utilizza rispettivamente Filtro e Opzioni di visualizzazione delle colonne.

gcloud

Per visualizzare un elenco delle tue prenotazioni, usa il comando gcloud compute reservations list.

gcloud compute reservations list

L'output dovrebbe essere simile al seguente esempio:

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

Facoltativamente, per restringere un elenco di prenotazioni utilizzando un'espressione di filtro, includere il flag --filter.

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

Sostituisci FILTER_EXPRESSION con un'espressione di filtro.

Ad esempio, per visualizzare solo le prenotazioni con un nome che inizia con prefix e si trovano nella zona us-central1-a, esegui il seguente comando:

gcloud compute reservations list \
    --filter="name~prefix AND zone=us-central1-a"

Vai

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

Per visualizzare un elenco delle tue prenotazioni, invia una richiesta GET al metodo reservations.list.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations

Sostituisci quanto segue:

PROJECT_ID: l'ID del progetto in cui si trovano le tue prenotazioni.
ZONE: la zona in cui si trovano le prenotazioni.

L'output è simile al seguente esempio:

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

Facoltativamente, per restringere un elenco di prenotazioni utilizzando un'espressione di filtro, includi il parametro di query filter come segue:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations?filter=FILTER_EXPRESSION

Sostituisci quanto segue:

PROJECT_ID: l'ID del progetto in cui si trovano le tue prenotazioni.
ZONE: la zona in cui si trovano le prenotazioni.
FILTER_EXPRESSION: un'espressione di filtro.

Ad esempio, per visualizzare solo le prenotazioni con un nome che inizia con prefix e si trovano nella zona us-central1-a, effettua la seguente richiesta GET utilizzando valori con codifica URL:

GET https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations?filter=name%7Eprefix%20AND%20zone=us-central1-a

Visualizzare i dettagli di una prenotazione

Per sapere quante VM vengono utilizzate da ciascun prodotto Google Cloud supportato in una prenotazione, visualizza i dettagli della prenotazione utilizzando la console Google Cloud. In caso contrario, seleziona una delle seguenti opzioni:

Console

Nella console Google Cloud, vai alla pagina Prenotazioni.

Vai a Prenotazioni
Nella scheda Prenotazioni on demand (predefinita), nella colonna Nome, fai clic sul nome della prenotazione di cui vuoi visualizzare i dettagli.

Si apre la pagina dei dettagli della prenotazione. Se vuoi visualizzare il campo Conteggio garantito, devi visualizzare un elenco delle tue prenotazioni.

gcloud

Per visualizzare i dettagli di una prenotazione, utilizza il comando gcloud compute reservations describe.

gcloud compute reservations describe RESERVATION_NAME \
    --zone=ZONE

Sostituisci quanto segue:

RESERVATION_NAME: il nome di una prenotazione esistente.
ZONE: la zona in cui si trova la prenotazione.

L'output è simile al seguente:

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

Vai

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

Per visualizzare i dettagli di una prenotazione, effettua una richiesta GET al metodo reservations.get.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME

Sostituisci quanto segue:

PROJECT_ID: l'ID del progetto in cui si trova la prenotazione.
ZONE: la zona in cui si trova la prenotazione.
RESERVATION_NAME: il nome di una prenotazione esistente.

L'output è simile al seguente:

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

Determina il numero di VM consumabili

Quando visualizzi una prenotazione, puoi determinare quante VM la stanno utilizzando e quante altre possono farlo controllando i seguenti campi:

Conteggio garantito (assuredCount): il numero di VM fisicamente riservate nella zona della prenotazione per il tuo progetto e per qualsiasi progetto con cui è condivisa una prenotazione condivisa.
Conteggio totale (count): il numero di VM riservate specificato nella prenotazione. Questo numero deve corrispondere al conteggio garantito.

Attenzione: se il numero garantito di una prenotazione è inferiore al numero totale, vengono riservate meno VM del previsto. Per risolvere il problema, consulta Meno VM disponibili per l'utilizzo.
Macchine in uso (inUseCount): il numero di VM in esecuzione nel progetto o in un progetto con cui è condivisa una prenotazione che stanno utilizzando la prenotazione.

Ad esempio, se il conteggio garantito (assuredCount) e il conteggio totale (count) sono entrambi pari a 50 e il numero di VM che utilizzano la prenotazione (inUseCount) è 25, significa che 25 VM stanno utilizzando la prenotazione e puoi creare ed eseguire altre 25 VM prima che la prenotazione venga utilizzata completamente.

Passaggi successivi

Scopri come collegare le prenotazioni agli impegni.
Scopri come utilizzare le prenotazioni.
Scopri come modificare le prenotazioni.
Scopri come eliminare le prenotazioni.

Visualizza prenotazioni

Prima di iniziare

Console

gcloud

Terraform

Vai

Java

Node.js

Python

REST

Ruoli obbligatori

Autorizzazioni obbligatorie

Visualizza prenotazioni

Visualizzare un elenco delle prenotazioni

Console

gcloud

Vai

Java

Node.js

Python

REST

Visualizzare i dettagli di una prenotazione

Console

gcloud

Vai

Java

Node.js

Python

REST

Determina il numero di VM consumabili

Passaggi successivi