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 ottenere una panoramica di tutte le richieste di prenotazione future nel tuo progetto e per rivedere la configurazione i dettagli 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 di cui è stato eseguito il provisioning per una prenotazione futura, consulta Visualizza 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 come segue.

    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 ulteriori informazioni, vedi Esegui 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 vedere le autorizzazioni esatte obbligatorie, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

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

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

Potresti anche riuscire a ottenere queste autorizzazioni con ruoli personalizzati altri ruoli predefiniti.

Visualizza le tue 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 l'interfaccia a riga di comando gcloud o REST.

Per visualizzare un elenco delle richieste di prenotazione future nel tuo progetto, seleziona una delle le 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 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 filtro inserisci espressione di filtro:

      Ad esempio, per visualizzare solo le richieste di prenotazione future che sono state creato nella zona us-central1-a o che ne ha prenotati 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, specificare un tipo di macchina n2-standard-4 e avere un totale di maggiore di 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 delle richieste di prenotazione future, invia una richiesta GET a 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 viene effettuata una o più prenotazioni future in cui vengono trovate le richieste.

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 quanto segue: espressione 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 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.

    La pagina Prenotazioni future con i dettagli relativi al futuro si apre la richiesta di prenotazione.

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 un elemento esistente richiesta di prenotazione futura.

  • 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 a il 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 un elemento esistente 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": {
    "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 un progetto che in futuro richiesta di prenotazione condivisa con, in base al Proprietà VM specificato nella richiesta. Sottraendo questo numero dal conteggio totale specificato nella richiesta, puoi determinare il numero di VM eseguirà il provisioning dopo l'approvazione della richiesta e dopo che avrà raggiunto l'ora di inizio.

determinare il numero di VM di cui è stato eseguito il provisioning per più prenotazioni future. richieste in contemporanea, usa la console Google Cloud. Altrimenti, per determinare il numero di VM di cui è stato eseguito il provisioning per una singola richiesta, seleziona una delle seguenti opzioni 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, indica il numero di VM in esecuzione e e le prenotazioni delle proprietà VM corrispondenti alla richiesta.

    Sottraendo il valore della colonna Conteggio corrispondenza dal valore nella colonna Conteggio totale, puoi determinare il numero di VM Compute Engine eseguirà il provisioning di una prenotazione futura richiesta 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 o prenotazioni in esecuzione corrispondenti.

    • Il valore di Conteggio corrispondenza è uguale a Conteggio totale. In questo Compute Engine non esegue il provisioning di nessuna VM prenotata la richiesta di prenotazione futura .

    Se modifichi la richiesta di prenotazione futura o crei nuove VM oppure con proprietà VM corrispondenti alla richiesta, Compute Engine aggiorna il valore nel Conteggio corrispondenze colonna entro 30 minuti. Per verificare quando è stato effettuato l'ultimo aggiornamento della 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 oppure con proprietà VM corrispondenti alla richiesta, Compute Engine aggiornerà il campo existingMatchingUsageInfo entro 30 minuti. Per verificare la data dell'ultimo aggiornamento del campo, controlla la 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 la data dell'ultimo aggiornamento del campo, controlla la 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