Visualizza le richieste di prenotazione future

Questo documento spiega come visualizzare le richieste di prenotazione future.

Per visualizzare altre prenotazioni, incluse quelle create automaticamente per una prenotazione futura al fine di eseguire il provisioning delle risorse prenotate, vedi Visualizzare le prenotazioni.

Prima di iniziare

  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale viene verificata l'identità per l'accesso ai servizi e alle API Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti in Compute Engine nel seguente modo.

    Select the tab for how you plan to use the samples on this page:

    Consolegcloud

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    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, consulta Eseguire l'autenticazione per l'utilizzo di REST nella documentazione Google Cloud sull'autenticazione.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per visualizzare le richieste di prenotazione future, chiedi all'amministratore di concederti il ruolo IAM Visualizzatore prenotazione futuro Compute (roles/compute.futureReservationViewer) per il progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

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

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

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

Potresti anche essere in grado di ottenere queste autorizzazioni con i ruoli personalizzati o altri ruoli predefiniti.

Visualizza le tue richieste di prenotazione future

Per visualizzare le richieste di prenotazione future in un progetto specificato, seleziona uno dei seguenti metodi:

Visualizzare un elenco delle richieste di prenotazione future

Puoi visualizzare un elenco di richieste di prenotazione future in un progetto specificato utilizzando la console Google Cloud, gcloud CLI e REST.

Console gcloud REST

Per visualizzare un elenco di richieste di prenotazione future:

  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, mentre 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 future 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 future 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, poi seleziona i valori in base ai quali filtrare la tabella.

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

gcloud beta compute future-reservations list \
    --project=PROJECT_ID

Sostituisci PROJECT_ID con l'ID del progetto in cui si trovano una o più richieste di prenotazione future. Se ometti il flag --project, viene utilizzato l'ID del progetto corrente.

L'output è simile al seguente:

NAME          TOTAL_COUNT    START_TIME             END_TIME               PROCUREMENT_STATUS   ZONE
fr-04         100            2025-07-20T07:00:00Z   2025-08-05T07:00:00Z   FULFILLED            us-east1-a
fr-05         10             2025-11-15T00:00:00Z   2025-12-01T00:00:00Z   PENDING_APPROVAL     us-west1-c

Se vuoi, puoi specificare il flag --filter per visualizzare un elenco filtrato di prenotazioni future in base a un'espressione di filtro.

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

Sostituisci quanto segue:

  • 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 conteggio totale maggiore di 10, specifica la seguente espressione di filtro:

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

  • PROJECT_ID: facoltativo. L'ID del progetto in cui si trovano una o più richieste di prenotazione future. Se ometti il flag --project, viene utilizzato l'ID del progetto attuale.

Per visualizzare un elenco delle richieste di prenotazione future, effettua una richiesta GET utilizzando il 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-04-11T18: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": {
        "startTime": "2025-07-20T07:00:00Z",
        "endTime": "2025-08-05T07:00:00Z"
      },
      "status": {
        "procurementStatus": "FULFILLED",
        "lockTime": "2025-05-04T07:00:00Z",
        "fulfilledCount": "100"
      },
      "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, puoi specificare il parametro di query filter per visualizzare un elenco filtrato di prenotazioni future in base a un'espressione di filtro.

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 degli URL.

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

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

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

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

Visualizzare i dettagli di una richiesta di prenotazione futura

Puoi visualizzare i dettagli di una richiesta di prenotazione futura utilizzando la console Google Cloud, gcloud CLI e REST.

Console gcloud REST

Per visualizzare i dettagli di una richiesta di prenotazione futura:

  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.

    Si apre la pagina Prenotazioni future con i dettagli della richiesta di prenotazione futura.

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 \
    --project=PROJECT_ID \
    --zone=ZONE

Sostituisci quanto segue:

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

  • PROJECT_ID: facoltativo. L'ID del progetto in cui si trova la richiesta di prenotazione futura. Se ometti il flag --project, viene utilizzato l'ID del progetto corrente.

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

L'output è simile al seguente:

creationTimestamp: '2025-07-19T12:44:11.855-07:00'
id: '5212276518668495076'
kind: compute#futureReservation
name: fr-01
namePrefix: test-fr
selfLink: https://www.googleapis.com/compute/beta/projects/project-01/zones/us-central1-a/futureReservations/future-reservation-test-1
selfLinkWithId: https://www.googleapis.com/compute/beta/projects/project-01/zones/us-central1-a/futureReservations/5212276518668495076
shareSettings:
  projects:
  - 'project-02'
  shareType: SPECIFIC_PROJECTS
specificSkuProperties:
  instanceProperties:
    localSsds:
    - diskSizeGb: '375'
      interface: SCSI
    machineType: n1-standard-64
    minCpuPlatform: Intel Skylake
  totalCount: '800'
planningStatus: SUBMITTED
status:
  lockTime: '2025-08-25T00:00:00Z'
  procurementStatus: APPROVED
timeWindow:
  endTime: '2025-12-10T00:00:00Z'
  startTime: '2025-11-10T00:00:00Z'
zone: https://www.googleapis.com/compute/beta/projects/project-01/zones/us-central1-a

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

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

Sostituisci quanto segue:

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

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

{
  "creationTimestamp": "2025-04-11T18:16:45.274-07:00",
  "id": "743865190848184978",
  "name": "fr-01",
  "namePrefix": "test-fr",
  "kind": "compute#futureReservation",
  "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",
  "specificSkuProperties": {
    "instanceProperties": {
      "machineType": "n1-standard-1"
    },
    "totalCount": "100"
  },
  "planningStatus": "SUBMITTED",
  "timeWindow": {
    "endTime": "2025-08-05T07:00:00Z",
    "startTime": "2025-07-20T07:00:00Z"
  },
  "status": {
    "fulfilledCount": "100"
    "lockTime": "2025-05-04T07:00:00Z",
    "procurementStatus": "FULFILLED",
  },
  "zone": "https://www.googleapis.com/compute/beta/projects/my-project/zones/us-east1-a"
}

Passaggi successivi