Visualizzare le richieste di prenotazione futura

Questo documento spiega come visualizzare le richieste di prenotazione future.

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

Per visualizzare le prenotazioni create automaticamente per una prenotazione futura, consulta Visualizzare le prenotazioni.

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
    2. Set a default region and zone.

      3. REST

      Per utilizzare gli esempi dell'API REST in questa pagina in un ambiente di sviluppo locale, utilizza le credenziali fornite a gcloud CLI.

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

        gcloud init

      Per saperne di più, consulta Eseguire l'autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per visualizzare le richieste di prenotazione futura, chiedi all'amministratore di concederti il ruolo IAM Visualizzatore prenotazioni future di Compute (roles/compute.futureReservationViewer) 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 richieste di prenotazione future. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

Per visualizzare le richieste di prenotazione future sono necessarie le seguenti autorizzazioni:

  • Per visualizzare un elenco di prenotazioni future: compute.futureReservations.list nel progetto
  • Per visualizzare i dettagli di una prenotazione futura: compute.futureReservations.get nel progetto

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

Visualizzare le richieste di prenotazione future

In base ai dettagli che vuoi visualizzare in una richiesta di prenotazione futura, utilizza uno dei seguenti metodi:

Visualizzare un elenco di richieste di prenotazione futura

Quando visualizzi un elenco delle tue richieste di prenotazione futura, puoi utilizzare espressioni di filtro per restringere i risultati. Per espressioni di filtro più avanzate, utilizza gcloud CLI o REST.

Per visualizzare un elenco di richieste di prenotazione future nel tuo progetto, seleziona una delle seguenti opzioni:

Console

  1. Nella console Google Cloud, vai alla pagina Prenotazioni.

    Vai a Prenotazioni

  2. Fai clic sulla scheda Prenotazioni future.

    Nella tabella, ogni riga descrive una richiesta di prenotazione futura e ogni colonna descrive una proprietà. Ad esempio, la colonna Conteggio totale descrive la capacità prenotata di ogni richiesta di prenotazione futura.

  3. (Facoltativo) Per filtrare le richieste di prenotazione futura visualizzate nella tabella, esegui una o entrambe le seguenti operazioni:

    • Nel campo Filtro, inserisci un'espressione di filtro.

      Ad esempio, per visualizzare solo le richieste di prenotazione futura che sono state create nella zona us-central1-a o che hanno prenotato più di 10 risorse, specifica la seguente espressione:

      Zone:us-central1-a OR Total Count>10

    • Fai clic su Opzioni di visualizzazione delle colonne e poi seleziona i valori in base ai quali filtrare la tabella.

gcloud

Per visualizzare un elenco di richieste di prenotazione future, utilizza il comando gcloud beta compute future-reservations list.

gcloud beta compute future-reservations list

L'output è simile al seguente:

NAME: fr-04
TOTAL_COUNT: 100
START_TIME: 2025-07-20T07:00:00Z
END_TIME: 2025-08-05T07:00:00Z
PROCUREMENT_STATUS: FULFILLED
ZONE: us-east1-a

NAME: fr-05
TOTAL_COUNT: 10
START_TIME: 2025-07-20T07:00:00Z
END_TIME: 2025-12-01T00:00:00Z
PROCUREMENT_STATUS: PENDING_APPROVAL
ZONE: us-west1-c

Se vuoi, per filtrare le richieste di prenotazione future in base a un'espressione di filtro, includi il flag --filter.

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

Sostituisci FILTER_EXPRESSION con un'espressione di filtro.

Ad esempio, per visualizzare solo le prenotazioni future create nella zona us-central1-a, specifica un tipo di macchina n2-standard-4 e un conteggio totale superiore a 10, specifica la seguente espressione di filtro:

zone=us-central1-a AND specificSkuProperties.instanceProperties.machineType=n2-standard-4 AND specificSkuProperties.totalCount>10

REST

Per visualizzare un elenco di richieste di prenotazione future, invia una richiesta GET al metodo beta.futureResevations.list.

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui si trovano una o più richieste di prenotazione future.

  • ZONE: la zona in cui si trovano una o più richieste di prenotazione future.

L'output è simile al seguente:

{
  "id": "projects/my-project/zones/us-east1-a/futureReservations",
  "items": [
    {
      "id": "743865190848184978",
      "creationTimestamp": "2025-03-23T18:16:45.274-07:00",
      "selfLink": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a/futureReservations/fr-base",
      "selfLinkWithId": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a/futureReservations/743865190848184978",
      "zone": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a",
      "name": "fr-base",
      "specificSkuProperties": {
        "instanceProperties": {
          "machineType": "n1-standard-1"
        },
        "totalCount": "100"
      },
      "planningStatus": "SUBMITTED",
      "timeWindow": {
        "endTime": "2025-05-02T01:00:00Z",
        "startTime": "2025-04-30T17:30:00Z"
      },
      "status": {
        "procurementStatus": "FULFILLED",
        "lockTime": "2025-03-30T07:00:00Z",
        "existingMatchingUsageInfo": {
          "count": "3",
          "timestamp": "2025-03-30T01:00:00Z"
        }
      },
      "kind": "compute#futureReservation"
    },
    ...
  ],
  "selfLink": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a/futureReservations",
  "etag": "AnzKY34l-cvvV-JnniESJ0dtQvQ=/hvc4jaHpxFAZmOt1FVtKNgzZu-M=",
  "kind": "compute#futureReservationsListResponse"
}

Se vuoi, per filtrare le richieste di prenotazione future in base a un'espressione di filtro, includi il parametro di query filter.

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/aggregated/futureReservations?filter=FILTER_EXPRESSION

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui si trovano una o più richieste di prenotazione future.

  • FILTER_EXPRESSION: un'espressione di filtro che utilizza la codifica dell'URL.

    Ad esempio, per visualizzare solo le prenotazioni future create nella zona us-central1-a, che hanno riservato un tipo di macchina n2-standard-4 e hanno un conteggio totale superiore a dieci, specifica la seguente espressione di filtro:

    zone=us-central1-a%20AND%20specificSkuProperties.instanceProperties.machineType=n2-standard-4%20AND%20specificSkuProperties.totalCount%3E10

    Tieni presente che l'espressione di filtro con codifica URL rappresenta la seguente expression di filtro decodificata:

    zone=us-central1-a AND specificSkuProperties.instanceProperties.machineType=n2-standard-4 AND specificSkuProperties.totalCount>10

Visualizzare i dettagli di una richiesta di prenotazione futura

Per visualizzare i dettagli di una richiesta di prenotazione futura, seleziona una delle seguenti opzioni:

Console

  1. Nella console Google Cloud, vai alla pagina Prenotazioni.

    Vai a Prenotazioni

  2. Fai clic sulla scheda Prenotazioni future.

  3. Nella colonna Nome, fai clic sul nome della richiesta di prenotazione futura di cui vuoi visualizzare i dettagli.

    Viene visualizzata la pagina Prenotazioni future con i dettagli della richiesta di prenotazione futura.

gcloud

Per visualizzare i dettagli di una richiesta di prenotazione futura, utilizza il comando gcloud beta compute future-reservations describe.

gcloud beta compute future-reservations describe FUTURE_RESERVATION_NAME \
    --zone=ZONE

Sostituisci quanto segue:

  • FUTURE_RESERVATION_NAME: il nome di una richiesta di prenotazione futura esistente.

  • ZONE: la zona in cui si trova la richiesta di prenotazione futura.

L'output è simile al seguente:

autoCreatedReservationsDeleteTime: '2025-05-02T01:00:00Z'
creationTimestamp: '2025-03-23T10:08:31.613-07:00'
id: '5212276518668495076'
kind: compute#futureReservation
name: fr-01
planningStatus: SUBMITTED
selfLink: https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-01
selfLinkWithId: https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/5212276518668495076
shareSettings:
  shareType: LOCAL
specificSkuProperties:
  instanceProperties:
    machineType: n1-standard-64
  totalCount: '800'
status:
  existingMatchingUsageInfo:
    count: '3'
    timestamp: '2025-03-30T01:00:00Z'
  lockTime: '2025-03-30T17:09:59.297799Z'
  procurementStatus: APPROVED
timeWindow:
  endTime: '2025-05-02T01:00:00Z'
  startTime: '2025-04-30T17:30:00Z'
zone: https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a

REST

Per visualizzare i dettagli di una richiesta di prenotazione futura, effettua una richiesta GET al metodo beta.futureReservations.get.

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui si trova la futura richiesta di prenotazione.

  • ZONE: la zona in cui si trova la richiesta di prenotazione futura.

  • FUTURE_RESERVATION_NAME: il nome di una richiesta di prenotazione futura esistente.

L'output è simile al seguente:

{
  "autoCreatedReservationsDeleteTime": "2025-05-02T01:00:00Z",
  "creationTimestamp": "2025-03-23T10:08:31.613-07:00",
  "id": "5212276518668495076",
  "kind": "compute#futureReservation",
  "name": "fr-01",
  "planningStatus": "SUBMITTED",
  "selfLink": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-01",
  "selfLinkWithId": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/5212276518668495076",
  "shareSettings": {
    "shareType": "LOCAL"
  },
  "specificSkuProperties": {
    "instanceProperties": {
      "machineType": "n1-standard-64"
    },
    "totalCount": "800"
  },
  "status": {
    "lockTime": "2025-03-30T17:09:59.297799Z",
    "procurementStatus": "APPROVED",
    "existingMatchingUsageInfo": {
      "count": "3",
      "timestamp": "2025-03-30T01:00:00Z"
    }
  },
  "timeWindow": {
    "endTime": "2025-05-02T01:00:00Z",
    "startTime": "2025-04-30T17:30:00Z"
  },
  "zone": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a"
}

Determina il numero di VM di cui è stato eseguito il provisioning

Dopo aver creato una richiesta di prenotazione futura, puoi vedere quante VM in esecuzione e prenotazioni inutilizzate nel tuo progetto o in un progetto con cui la richiesta di prenotazione futura è condivisa corrispondono alle proprietà VM specificate nella richiesta. Sottraendo questo numero dal conteggio totale specificato nella richiesta, puoi determinare quante VM Compute Engine eseguirà il provisioning dopo l'approvazione della richiesta e il raggiungimento della relativa ora di inizio.

Per determinare contemporaneamente il numero di VM di cui è stato eseguito il provisioning per più richieste di prenotazione futura, utilizza la console Google Cloud. In caso contrario, per determinare il numero di VM di cui è stato eseguito il provisioning per una singola richiesta, seleziona una delle seguenti opzioni:

Console

  1. Nella console Google Cloud, vai alla pagina Prenotazioni.

    Vai a Prenotazioni

  2. Fai clic sulla scheda Prenotazioni future.

  3. Per ogni richiesta di prenotazione futura, puoi determinare quanto segue:

    • Nella colonna Conteggio totale, il conteggio totale della richiesta.

    • Nella colonna Conteggio corrispondenze, il numero di VM e prenotazioni in esecuzione le cui proprietà VM corrispondono alla richiesta.

    Sottraendo il valore nella colonna Conteggio corrispondenze dal valore nella colonna Conteggio totale, puoi determinare il numero di VM che Compute Engine eseguirà il provisioning per una richiesta di prenotazione futura all'ora di inizio. Se nella colonna Conteggio corrispondenze viene visualizzato un avviso, il motivo è uno dei seguenti:

    • Il valore di Conteggio corrispondenze è zero. In questo caso, nel progetto non sono presenti VM in esecuzione o prenotazioni corrispondenti.

    • Il valore di Conteggio corrispondente è uguale a Conteggio totale. In questo caso, Compute Engine non eseguirà il provisioning di VM riservate per la richiesta di prenotazione futura .

    Se modifichi la richiesta di prenotazione futura o crei nuove VM o prenotazioni con proprietà VM corrispondenti alla richiesta, Compute Engine aggiornerà il valore nella colonna Conteggio corrispondenze entro 30 minuti. Per verificare quando è stata aggiornata l'ultima volta la colonna Conteggio corrispondenze, visualizza i dettagli della richiesta e poi controlla il valore nella riga Ora ultima valutazione dell'utilizzo corrispondente.

  4. (Facoltativo) Per modificare il numero di VM riservate in una richiesta di prenotazione futura, modifica la richiesta di prenotazione futura.

gcloud

  1. Visualizza i dettagli della richiesta di prenotazione futura.

  2. Nell'output, sottrai il valore del campo existingMatchingUsageInfo dal campo totalCount. Se il valore di existingMatchingUsageInfo.count è uguale a totalCount, Compute Engine non eseguirà il provisioning di VM riservate per le future richieste di prenotazione.

    Se modifichi la richiesta di prenotazione futura o crei nuove VM o prenotazioni con proprietà VM corrispondenti alla richiesta, Compute Engine aggiornerà il campo existingMatchingUsageInfo entro 30 minuti. Per verificare quando è stato aggiornato l'ultimo campo, controlla il valore del campo existingMatchingUsageInfo.timestamp.

  3. (Facoltativo) Per modificare il numero di VM riservate nella richiesta di prenotazione futura, modifica la richiesta di prenotazione futura.

REST

  1. Visualizza i dettagli della richiesta di prenotazione futura.

  2. Nell'output, sottrai il valore del campo existingMatchingUsageInfo dal campo totalCount. Se il valore di existingMatchingUsageInfo.count è uguale a totalCount, Compute Engine non eseguirà il provisioning di VM riservate per le future richieste di prenotazione.

    Se modifichi la richiesta di prenotazione futura o crei nuove VM o prenotazioni con proprietà VM corrispondenti alla richiesta, Compute Engine aggiornerà il campo existingMatchingUsageInfo entro 30 minuti. Per verificare quando è stato aggiornato l'ultimo campo, controlla il valore del campo existingMatchingUsageInfo.timestamp.

  3. (Facoltativo) Per modificare il numero di VM riservate nella richiesta di prenotazione futura, modifica la richiesta di prenotazione futura.

Passaggi successivi