Creare richieste di prenotazione futura per un singolo progetto


Questo documento spiega come creare richieste di prenotazione futura per un singolo progetto.

Se Google Cloud approva la tua richiesta di prenotazione futura per un singolo progetto, all'ora di inizio specificata nella richiesta, Compute Engine crea automaticamente prenotazioni che possono essere utilizzate solo dalle istanze di macchine virtuali (VM) create nello stesso progetto.

Prima di iniziare

  • Se non l'hai ancora fatto, consulta come funzionano le prenotazioni future.
  • Per assicurarti di avere una quota sufficiente per le risorse che vuoi prenotare, controlla la quota.
  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale la tua identità viene verificata per l'accesso ai Google Cloud servizi e alle API. 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. After installing the Google Cloud CLI, initialize it by running the following command:

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

      2. Set a default region and zone.
      3. REST

        Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.

          After installing the Google Cloud CLI, initialize it by running the following command:

          gcloud init

          If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare richieste di prenotazione futura per un singolo progetto, chiedi all'amministratore di concederti il ruolo IAM Compute Future Reservation User (roles/compute.futureReservationUser) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per creare richieste di prenotazione futura per un singolo progetto. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per creare richieste di prenotazione futura per un singolo progetto, sono necessarie le seguenti autorizzazioni:

  • Per creare una richiesta di prenotazione futura: compute.futureReservations.create sul progetto
  • Per consentire a Compute Engine di creare in automatico le prenotazioni: compute.reservations.create sul progetto
  • Per specificare un template di istanza: compute.instanceTemplates.useReadOnly sul template di istanza

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

Crea una bozza di richiesta

Quando crei una richiesta di prenotazione futura, puoi salvarla come bozza e inviarla in un secondo momento a Google Cloud per la revisione oppure inviare direttamente la richiesta per la revisione. Google consiglia di creare prima una bozza di richiesta, in quanto consente di determinare il numero di VM di cui Compute Engine eseguirà il provisioning per la richiesta, anziché stimarlo manualmente e, in via facoltativa, di modificare il numero di VM prenotate nella richiesta prima di inviarla per la revisione.

Per utilizzare una prenotazione creata automaticamente per una prenotazione futura, una VM deve avere proprietà che corrispondono esattamente a quelle della prenotazione. Per specificare le proprietà delle VM che vuoi richiedere di prenotare creando una richiesta di prenotazione futura, utilizza uno dei seguenti metodi:

  • Consigliato: specifica un template di istanza

    Puoi utilizzare un template di istanza esistente per definire le proprietà di una richiesta di prenotazione futura. Utilizzando un modello di istanza, puoi definire in un unico posto le proprietà di una prenotazione futura e le VM che possono utilizzare le prenotazioni create automaticamente.

  • Specifica una VM esistente

    Puoi utilizzare una VM esistente per definire le proprietà di una richiesta di prenotazione futura. Con le proprietà di una VM esistente, puoi usare le prenotazioni create automaticamente per la prenotazione futura creando VM con proprietà che corrispondono a quelle della VM di riferimento.

  • Specifica le proprietà direttamente

    Puoi definire direttamente le proprietà di una richiesta di prenotazione futura. Questo metodo richiede di assicurarti manualmente che le proprietà delle VM e le prenotazioni create automaticamente corrispondano esattamente: eventuali proprietà non corrispondenti impediscono l'utilizzo.

Una prenotazione creata automaticamente per una prenotazione futura può essere utilizzata in automatico da qualsiasi VM con le proprietà corrispondenti. Se vuoi impedire a una VM di utilizzare una di queste prenotazioni create automaticamente, scopri come creare VM senza utilizzare le prenotazioni.

Specifica un template di istanza

Quando crei una richiesta di prenotazione futura specificando un modello di istanza, tieni presente quanto segue:

  • Devi creare la richiesta di prenotazione futura nella stessa regione e nella stessa zona delle risorse nel template di istanza. Qualsiasi risorsa regionale o di zona specificata in un template di istanza, ad esempio un tipo di macchina o un Persistent Disk, limita l'utilizzo del template alle posizioni in cui si trovano queste risorse. Ad esempio, se il template di istanza specifica un Persistent Disk esistente nella zona us-central1-a, devi creare la richiesta di prenotazione futura nella stessa zona. In caso contrario, la creazione della richiesta di prenotazione futura non va a buon fine.

    Per verificare se un template esistente specifica risorse che lo legano a una determinata regione o zona, visualizza i dettagli relativi al template di istanza e cerca al suo interno riferimenti a quelle risorse.

  • Se vuoi associare a un impegno le prenotazioni create automaticamente di cui è stato eseguito il provisioning per una prenotazione futura, devi disattivare l'opzione di eliminazione automatica. Per ulteriori informazioni, consulta Restrizioni dopo la creazione.

Dopo aver creato una richiesta di prenotazione futura, non puoi modificarla per eseguire l'override delle proprietà della VM del template o specificare un altro template. Devi invece creare una nuova richiesta di prenotazione futura.

Per creare una prenotazione futura per un singolo progetto specificando un modello di istanza esistente, 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. Fai clic su Crea prenotazione futura.

    Viene visualizzata la pagina Crea una prenotazione futura.

  4. In Nome, inserisci un nome per la richiesta di prenotazione futura.

  5. In Prefisso, inserisci un prefisso per il nome. Il nome di ogni prenotazione creata automaticamente a partire da questa richiesta di prenotazione futura avrà questo prefisso.

  6. Per Regione e Zona, seleziona la regione e la zona in cui prenotare le risorse.

  7. In Data/ora di inizio, inserisci una data/ora di inizio per il periodo di prenotazione. La data/ora di inizio non può essere successiva a un anno dalla data e dall'ora di invio della richiesta di prenotazione futura per la revisione. Per avere tempo sufficiente di eventualmente modificare, annullare o eliminare la prenotazione futura prima che entri nel periodo di blocco, specifica un valore consigliato per la data/ora di inizio.

  8. In Ora di fine, inserisci un'ora di fine per il periodo di prenotazione. Nella sezione Riepilogo durata, puoi vedere la durata del periodo di prenotazione. Per aumentare le probabilità che Google Cloud approvi la tua richiesta di prenotazione futura dopo l'invio per la revisione, specifica un valore consigliato per il periodo di prenotazione.

  9. Nella sezione Tipo di condivisione, seleziona Locale se non è già selezionata.

  10. In Capacità totale necessaria, inserisci il numero totale di VM che vuoi prenotare per il periodo, la configurazione delle VM e i progetti specificati nella richiesta di prenotazione futura.

  11. Nella sezione Configurazione macchina, segui questi passaggi:

    1. Seleziona Utilizza template di istanza.

    2. In Template di istanza, seleziona il template di istanza che preferisci. Se selezioni un template di istanza regionale, puoi prenotare risorse solo nella stessa regione del template.

  12. Nella sezione Eliminazione automatica delle prenotazioni generate automaticamente, svolgi una delle seguenti operazioni:

    • Per consentire a Compute Engine di eliminare in automatico le prenotazioni create automaticamente per la tua richiesta di prenotazione futura, segui questi passaggi:

      1. Se non è già stato fatto, fai clic sul pulsante di attivazione/disattivazione Abilita eliminazione automatica in modo che sia impostato su On.

      2. (Facoltativo) In Data/ora eliminazione automatica, inserisci una data e un'ora in cui eliminare le prenotazioni create automaticamente. La data e l'ora devono essere successive alla data/ora di fine del periodo di prenotazione. Se lasci vuoto questo campo, le prenotazioni create automaticamente vengono eliminate entro due ore dall'ora di fine del periodo di prenotazione.

    • Altrimenti, fai clic sul pulsante di attivazione/disattivazione Abilita eliminazione automatica in modo che sia impostato su Off.

  13. Per completare la creazione della bozza della richiesta di prenotazione futura, fai clic su Salva una bozza.

Viene visualizzata la pagina Prenotazioni. La creazione della richiesta di prenotazione futura può richiedere fino a un minuto.

gcloud

Per creare una richiesta di prenotazione futura per un singolo progetto specificando un modello di istanza, utilizza il comando gcloud beta compute future-reservations create.

Per creare una bozza di richiesta di prenotazione futura specificando un template di istanza senza includere flag facoltativi ed eliminare in automatico la prenotazione creata automaticamente al termine del periodo di prenotazione, esegui il seguente comando:

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Sostituisci quanto segue:

  • FUTURE_RESERVATION_NAME: il nome della richiesta di prenotazione futura.

  • MACHINE_TYPE: il tipo di macchina da utilizzare per ogni VM prenotata.

  • PROJECT_ID: l'ID del progetto in cui vuoi prenotare le risorse e in cui si trova il template di istanza.

  • LOCATION: la posizione del template di istanza. Specifica uno dei seguenti valori:

    • Per un template di istanza regionale: regions/REGION. Sostituisci REGION con la regione in cui si trova il template di istanza. Se specifichi un template di istanza regionale, puoi creare la richiesta di prenotazione futura solo all'interno della stessa regione del template.

    • Per un template di istanza globale: global.

  • INSTANCE_TEMPLATE_NAME: il nome di un template di istanza esistente.

  • START_TIME: la data/ora di inizio del periodo di prenotazione come timestamp RFC 3339, che deve essere formattato come segue:

    YYYY-MM-DDTHH:MM:SSOFFSET
    

    Sostituisci quanto segue:

    • YYYY-MM-DD: una data formattata con l'anno a 4 cifre, il mese a 2 cifre e il giorno del mese a 2 cifre, separati da trattini (-).

    • HH:MM:SS: un orario formattato con l'ora a due cifre utilizzando il sistema a 24 ore, i minuti a due cifre e i secondi a due cifre, separati da due punti (:).

    • OFFSET: il fuso orario formattato come offset rispetto al Tempo Universale Coordinato (UTC). Ad esempio, per utilizzare il fuso orario PST (Pacific Standard Time), specifica -08:00. In alternativa, per non utilizzare alcun offset, specifica Z.

    La data/ora di inizio non può essere successiva a un anno dalla data e dall'ora di invio della richiesta di prenotazione futura per la revisione. Per avere tempo sufficiente per annullare, eliminare o modificare facoltativamente una richiesta di prenotazione futura dopo l'approvazione e prima del periodo di blocco, specifica un valore consigliato per la data/ora di inizio.

  • END_TIME: la data/ora di fine del periodo di prenotazione formattata come timestamp RFC 3339. Per aumentare le probabilità che Google Cloud approvi la tua richiesta dopo l'invio, specifica un periodo di prenotazione minimo. Per specificare una durata anziché una data/ora di fine, sostituisci il flag --end-time con il flag --duration=END_DURATION. Sostituisci END_DURATION con una durata in secondi. Ad esempio, specifica 1209600 per 1.209.600 secondi (14 giorni).

    Per aumentare le probabilità che Google Cloud approvi una richiesta di prenotazione futura dopo averla inviata per la revisione, specifica una durata minima consigliata.

  • TOTAL_COUNT: il numero totale di VM che vuoi prenotare.

  • ZONE: la zona in cui prenotare le risorse.

Ad esempio, supponiamo che tu voglia creare una bozza di richiesta di prenotazione futura chiamata fr-01 nella zona us-central1-a con le seguenti proprietà:

  • Un periodo di prenotazione che inizia a mezzanotte del 10 novembre 2024 UTC e termina a mezzanotte del 10 dicembre 2024 UTC.

  • Un numero totale di 80 VM.

  • Un template di istanza regionale della regione us-central1.
  • L'opzione di eliminazione automatica abilitata. Le prenotazioni create automaticamente vengono eliminate al termine del periodo di prenotazione.

Per creare fr-01, esegui il comando seguente:

gcloud beta compute future-reservations create fr-01 \
    --auto-delete-auto-created-reservations \
    --source-instance-template=projects/example-project/regions/us-central1/instanceTemplates/example-template \
    --start-time=2024-11-10T00:00:00Z \
    --end-time=2024-12-10T00:00:00Z \
    --total-count=80 \
    --zone=us-central1-a

Facoltativamente, puoi eseguire una o più delle seguenti operazioni:

  • Per eliminare le prenotazioni create automaticamente dopo la data/ora di fine del periodo di prenotazione, seleziona uno dei seguenti metodi:

    • Per eliminare le prenotazioni create automaticamente in una data e un'ora specifiche dopo la data/ora di fine del periodo di prenotazione, includi il flag --auto-created-reservations-delete-time.

      gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
          --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
          --auto-delete-auto-created-reservations \
          --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
          --start-time=START_TIME \
          --end-time=END_TIME \
          --total-count=TOTAL_COUNT \
          --zone=ZONE
      

      Sostituisci AUTO_CREATED_RESERVATIONS_DELETE_TIME con una data e un'ora formattate come timestamp RFC 3339.

    • Per eliminare le prenotazioni create automaticamente dopo una durata specifica dalla data/ora di fine del periodo di prenotazione, includi il flag --auto-created-reservations-duration.

      gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
          --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
          --auto-delete-auto-created-reservations \
          --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
          --start-time=START_TIME \
          --end-time=END_TIME \
          --total-count=TOTAL_COUNT \
          --zone=ZONE
      

      Sostituisci DURATION_BEFORE_DELETE con una durata in giorni, ore, minuti o secondi. Ad esempio, specifica 30m per 30 minuti o 1d2h3m4s per un giorno, due ore, tre minuti e quattro secondi.

  • Per disattivare l'opzione di eliminazione automatica per le prenotazioni create automaticamente, sostituisci il flag --auto-delete-auto-created-reservations con il flag --no-auto-delete-auto-created-reservations.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
        --no-auto-delete-auto-created-reservations \
        --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
        --start-time=START_TIME \
        --end-time=END_TIME \
        --total-count=TOTAL_COUNT \
        --zone=ZONE
    
  • Per specificare un prefisso del nome per le prenotazioni create automaticamente, includi il flag --name-prefix.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
        --auto-delete-auto-created-reservations \
        --name-prefix=NAME_PREFIX \
        --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \
        --start-time=START_TIME \
        --end-time=END_TIME \
        --total-count=TOTAL_COUNT \
        --zone=ZONE
    

    Sostituisci NAME_PREFIX con il prefisso del nome di ogni prenotazione creata automaticamente. Per aiutarti a identificare le prenotazioni create automaticamente per questa richiesta di prenotazione futura, Google Cloud consiglia di specificare un prefisso del nome univoco.

REST

Per creare una richiesta di prenotazione futura per un singolo progetto specificando un modello di istanza, invia una richiesta POST al metodo beta.futureReservations.insert.

Per creare una bozza di richiesta di prenotazione futura specificando un template di istanza senza includere campi facoltativi, effettua una richiesta POST come segue:

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

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME",
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui vuoi prenotare le risorse e in cui si trova il template di istanza.

  • ZONE: la zona in cui prenotare le risorse.

  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: se imposti questo campo su true, Compute Engine elimina in automatico le prenotazioni create automaticamente per questa prenotazione futura entro due ore dall'ora di fine del periodo di prenotazione. Se vuoi collegare le prenotazioni create automaticamente a un impegno, imposta questo campo su false.

  • LOCATION: la posizione del template di istanza. Specifica uno dei seguenti valori:

    • Per un template di istanza regionale: regions/REGION. Sostituisci REGION con la regione in cui si trova il template di istanza. Se specifichi un template di istanza regionale, puoi creare la richiesta di prenotazione futura solo all'interno della stessa regione del template.

    • Per un template di istanza globale: global.

  • INSTANCE_TEMPLATE_NAME: il nome di un template di istanza esistente.

  • TOTAL_COUNT: il numero totale di VM che vuoi prenotare.

  • START_TIME: la data/ora di inizio del periodo di prenotazione come timestamp RFC 3339, che deve essere formattato come segue:

    YYYY-MM-DDTHH:MM:SSOFFSET
    

    Sostituisci quanto segue:

    • YYYY-MM-DD: una data formattata con l'anno a 4 cifre, il mese a 2 cifre e il giorno del mese a 2 cifre, separati da trattini (-).

    • HH:MM:SS: un orario formattato con l'ora a due cifre utilizzando il sistema a 24 ore, i minuti a due cifre e i secondi a due cifre, separati da due punti (:).

    • OFFSET: il fuso orario formattato come offset rispetto al Tempo Universale Coordinato (UTC). Ad esempio, per utilizzare il fuso orario PST (Pacific Standard Time), specifica -08:00. In alternativa, per non utilizzare alcun offset, specifica Z.

    La data/ora di inizio non può essere successiva a un anno dalla data e dall'ora di invio della richiesta di prenotazione futura per la revisione. Per avere tempo sufficiente per annullare, eliminare o modificare facoltativamente una richiesta di prenotazione futura dopo l'approvazione e prima del periodo di blocco, specifica un valore consigliato per la data/ora di inizio.

  • END_TIME: la data/ora di fine del periodo di prenotazione formattata come timestamp RFC 3339. Per aumentare le probabilità che Google Cloud approvi la tua richiesta dopo l'invio, specifica un periodo di prenotazione minimo. Per specificare una durata anziché una data e ora di fine, puoi sostituire il campo endTime con il campo duration:

    "duration": {
      "seconds": END_DURATION
    }
    

    Sostituisci END_DURATION con una durata in secondi. Ad esempio, specifica 1209600 per 1.209.600 secondi (14 giorni).

Ad esempio, supponiamo che tu voglia creare una bozza di richiesta di prenotazione futura chiamata fr-01 nella zona us-central1-a con le seguenti proprietà:

  • Un periodo di prenotazione che inizia a mezzanotte del 10 novembre 2024 UTC e termina a mezzanotte del 10 dicembre 2024 UTC.

  • Un numero totale di 80 VM.

  • Un template di istanza regionale della regione us-central1.
  • L'opzione di eliminazione automatica abilitata. Le prenotazioni create automaticamente vengono eliminate al termine del periodo di prenotazione.

Per creare fr-01, invia una richiesta POST come segue:

POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations

{
  "autoDeleteAutoCreatedReservations": true,
  "name": "fr-01",
  "specificSkuProperties": { 
    "sourceInstanceTemplate": "projects/example-project/regions/us-central1/instanceTemplates/example-template",
    "totalCount": 80
  },
  "timeWindow": {
    "startTime": "2024-11-10T00:00:00Z",
    "endTime": "2024-12-10T00:00:00Z"
  }
}

Facoltativamente, puoi eseguire una o più delle seguenti operazioni:

  • Per specificare un prefisso del nome per le prenotazioni create automaticamente, includi il campo namePrefix.

    POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations
    
    {
      "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
      "name": "FUTURE_RESERVATION_NAME",
      "namePrefix": "NAME_PREFIX",
      "specificSkuProperties": { 
        "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME",
        "totalCount": TOTAL_COUNT
      },
      "timeWindow": {
        "startTime": "START_TIME",
        "endTime": "END_TIME"
      }
    }
    

    Sostituisci NAME_PREFIX con il prefisso del nome di ogni prenotazione creata automaticamente. Per aiutarti a identificare le prenotazioni create automaticamente per questa richiesta di prenotazione futura, Google Cloud consiglia di specificare un prefisso del nome univoco.

  • Per eliminare le prenotazioni create automaticamente dopo la data/ora di fine del periodo di prenotazione, seleziona uno dei seguenti metodi:

    • Per eliminare le prenotazioni create automaticamente dopo un'ora specifica successiva al termine del periodo di prenotazione, imposta autoDeleteAutoCreatedReservations su true e includi il campo autoCreatedReservationsDeleteTime.

      POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations
      
      {
        "autoCreatedReservationsDeleteTime": "DELETE_TIME",
        "autoDeleteAutoCreatedReservations": true,
        "name": "FUTURE_RESERVATION_NAME",
        "specificSkuProperties": { 
          "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME",
          "totalCount": TOTAL_COUNT
        },
        "timeWindow": {
          "startTime": "START_TIME",
          "endTime": "END_TIME"
        }
      }
      

      Sostituisci DELETE_TIME con una data e un'ora in cui Compute Engine elimina le prenotazioni create automaticamente. La data e l'ora devono essere formattate come timestamp RFC 3339.

    • Per eliminare le prenotazioni create automaticamente dopo una durata specifica a partire dalla data/ora di inizio del periodo di prenotazione, imposta autoDeleteAutoCreatedReservations su true e includi il campo autoCreatedReservationsDuration.

      POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations
      
      {
        "autoCreatedReservationsDuration": {
          "seconds": "DURATION_BEFORE_DELETE"
        },
        "autoDeleteAutoCreatedReservations": true,
        "name": "FUTURE_RESERVATION_NAME",
        "specificSkuProperties": { 
          "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME",
          "totalCount": TOTAL_COUNT
        },
        "timeWindow": {
          "startTime": "START_TIME",
          "endTime": "END_TIME"
        }
      }
      

      Sostituisci DURATION_BEFORE_DELETE con una durata in secondi. Ad esempio, specifica 604800 per 604.800 secondi (7 giorni).

Dopo aver creato una bozza di richiesta di prenotazione futura, puoi determinare il numero di VM di cui Compute Engine eseguirà il provisioning per la richiesta.

Specifica una VM esistente

Puoi creare una bozza di richiesta di prenotazione futura solo in base a una VM esistente nella stessa zona della VM.

Dopo che la richiesta di prenotazione futura è stata approvata da Google Cloud e inizia il periodo di prenotazione, puoi utilizzare le prenotazioni create automaticamente creando VM con proprietà corrispondenti a quella di riferimento. Puoi farlo eseguendo una di queste operazioni:

Per creare una richiesta di prenotazione futura per un singolo progetto che utilizza le proprietà di una VM esistente, segui questi passaggi:

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

    Vai a Prenotazioni

  2. Fai clic sulla scheda Prenotazioni future.

  3. Fai clic su Crea prenotazione futura.

    Viene visualizzata la pagina Crea una prenotazione futura.

  4. In Nome, inserisci un nome per la richiesta di prenotazione futura.

  5. In Prefisso, inserisci un prefisso per il nome. Il nome di ogni prenotazione creata automaticamente a partire da questa richiesta di prenotazione futura avrà questo prefisso.

  6. Per Regione e Zona, seleziona la regione e la zona in cui prenotare le risorse.

  7. In Data/ora di inizio, inserisci una data/ora di inizio per il periodo di prenotazione. La data/ora di inizio non può essere successiva a un anno dalla data e dall'ora di invio della richiesta di prenotazione futura per la revisione. Per avere tempo sufficiente di eventualmente modificare, annullare o eliminare la prenotazione futura prima che entri nel periodo di blocco, specifica un valore consigliato per la data/ora di inizio.

  8. In Ora di fine, inserisci un'ora di fine per il periodo di prenotazione. Nella sezione Riepilogo durata, puoi vedere la durata del periodo di prenotazione. Per aumentare le probabilità che Google Cloud approvi la tua richiesta di prenotazione futura dopo l'invio per la revisione, specifica un valore consigliato per il periodo di prenotazione.

  9. Nella sezione Tipo di condivisione, seleziona Locale se non è già selezionata.

  10. In Capacità totale necessaria, inserisci il numero totale di VM che vuoi prenotare per il periodo, la configurazione delle VM e i progetti specificati nella richiesta di prenotazione futura.

  11. Nella sezione Configurazione macchina, segui questi passaggi:

    1. Seleziona Usa VM esistente.

    2. Per VM esistente, seleziona la VM le cui proprietà vuoi utilizzare per creare la prenotazione.

  12. Nella sezione Eliminazione automatica delle prenotazioni generate automaticamente, svolgi una delle seguenti operazioni:

    • Per consentire a Compute Engine di eliminare in automatico le prenotazioni create automaticamente per la tua richiesta di prenotazione futura, segui questi passaggi:

      1. Se non è già stato fatto, fai clic sul pulsante di attivazione/disattivazione Abilita eliminazione automatica in modo che sia impostato su On.

      2. (Facoltativo) In Data/ora eliminazione automatica, inserisci una data e un'ora in cui eliminare le prenotazioni create automaticamente. La data e l'ora devono essere successive alla data/ora di fine del periodo di prenotazione. Se lasci vuoto questo campo, le prenotazioni create automaticamente vengono eliminate entro due ore dall'ora di fine del periodo di prenotazione.

    • Altrimenti, fai clic sul pulsante di attivazione/disattivazione Abilita eliminazione automatica in modo che sia impostato su Off.

  13. Per completare la creazione della bozza della richiesta di prenotazione futura, fai clic su Salva una bozza.

Viene visualizzata la pagina Prenotazioni. La creazione della richiesta di prenotazione futura può richiedere fino a un minuto.

Dopo aver creato una bozza di richiesta di prenotazione futura, puoi determinare il numero di VM di cui Compute Engine eseguirà il provisioning per la richiesta.

Specifica le proprietà direttamente

Se vuoi associare a un impegno le prenotazioni create automaticamente di cui è stato eseguito il provisioning per una prenotazione futura, devi disattivare l'opzione di eliminazione automatica. Per saperne di più, consulta Limitazioni dopo la creazione.

Per creare una prenotazione futura per un singolo progetto specificando direttamente le proprietà, 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. Fai clic su Crea prenotazione futura.

    Viene visualizzata la pagina Crea una prenotazione futura.

  4. In Nome, inserisci un nome per la richiesta di prenotazione futura.

  5. In Prefisso, inserisci un prefisso per il nome. Il nome di ogni prenotazione creata automaticamente a partire da questa richiesta di prenotazione futura avrà questo prefisso.

  6. Per Regione e Zona, seleziona la regione e la zona in cui prenotare le risorse.

  7. In Data/ora di inizio, inserisci una data/ora di inizio per il periodo di prenotazione. La data/ora di inizio non può essere successiva a un anno dalla data e dall'ora di invio della richiesta di prenotazione futura per la revisione. Per avere tempo sufficiente di eventualmente modificare, annullare o eliminare la prenotazione futura prima che entri nel periodo di blocco, specifica un valore consigliato per la data/ora di inizio.

  8. In Ora di fine, inserisci un'ora di fine per il periodo di prenotazione. Nella sezione Riepilogo durata, puoi vedere la durata del periodo di prenotazione. Per aumentare le probabilità che Google Cloud approvi la tua richiesta di prenotazione futura dopo l'invio per la revisione, specifica un valore consigliato per il periodo di prenotazione.

  9. Nella sezione Tipo di condivisione, seleziona Locale se non è già selezionata.

  10. In Capacità totale necessaria, inserisci il numero totale di VM che vuoi prenotare per il periodo, la configurazione delle VM e i progetti specificati nella richiesta di prenotazione futura.

  11. Nella sezione Configurazione macchina, segui questi passaggi:

    1. Seleziona Specifica il tipo di macchina, se non è già selezionato.

    2. Specifica il tipo di macchina da utilizzare per le VM prenotate.

  12. Nella sezione Eliminazione automatica delle prenotazioni generate automaticamente, svolgi una delle seguenti operazioni:

    • Per consentire a Compute Engine di eliminare in automatico le prenotazioni create automaticamente per la tua richiesta di prenotazione futura, segui questi passaggi:

      1. Se non è già stato fatto, fai clic sul pulsante di attivazione/disattivazione Abilita eliminazione automatica in modo che sia impostato su On.

      2. (Facoltativo) In Data/ora eliminazione automatica, inserisci una data e un'ora in cui eliminare le prenotazioni create automaticamente. La data e l'ora devono essere successive alla data/ora di fine del periodo di prenotazione. Se lasci vuoto questo campo, le prenotazioni create automaticamente vengono eliminate entro due ore dall'ora di fine del periodo di prenotazione.

    • Altrimenti, fai clic sul pulsante di attivazione/disattivazione Abilita eliminazione automatica in modo che sia impostato su Off.

  13. Per completare la creazione della bozza della richiesta di prenotazione futura, fai clic su Salva una bozza.

Viene visualizzata la pagina Prenotazioni. La creazione della richiesta di prenotazione futura può richiedere fino a un minuto.

gcloud

Per creare una richiesta di prenotazione futura per un singolo progetto specificando direttamente le proprietà, utilizza il comando gcloud beta compute future-reservations create.

Per creare una bozza della richiesta di prenotazione futura specificando direttamente le proprietà senza includere flag facoltativi ed eliminare in automatico la prenotazione creata automaticamente al termine del periodo di prenotazione, esegui il seguente comando:

gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
    --auto-delete-auto-created-reservations \
    --machine-type=MACHINE_TYPE \
    --start-time=START_TIME \
    --end-time=END_TIME \
    --total-count=TOTAL_COUNT \
    --zone=ZONE

Sostituisci quanto segue:

  • FUTURE_RESERVATION_NAME: il nome della richiesta di prenotazione futura.

  • MACHINE_TYPE: il tipo di macchina da utilizzare per ogni VM prenotata.

  • START_TIME: la data/ora di inizio del periodo di prenotazione come timestamp RFC 3339, che deve essere formattato come segue:

    YYYY-MM-DDTHH:MM:SSOFFSET
    

    Sostituisci quanto segue:

    • YYYY-MM-DD: una data formattata con l'anno a 4 cifre, il mese a 2 cifre e il giorno del mese a 2 cifre, separati da trattini (-).

    • HH:MM:SS: un orario formattato con l'ora a due cifre utilizzando il sistema a 24 ore, i minuti a due cifre e i secondi a due cifre, separati da due punti (:).

    • OFFSET: il fuso orario formattato come offset rispetto al Tempo Universale Coordinato (UTC). Ad esempio, per utilizzare il fuso orario PST (Pacific Standard Time), specifica -08:00. In alternativa, per non utilizzare alcun offset, specifica Z.

    La data/ora di inizio non può essere successiva a un anno dalla data e dall'ora di invio della richiesta di prenotazione futura per la revisione. Per avere tempo sufficiente per annullare, eliminare o modificare facoltativamente una richiesta di prenotazione futura dopo l'approvazione e prima del periodo di blocco, specifica un valore consigliato per la data/ora di inizio.

  • END_TIME: la data/ora di fine del periodo di prenotazione formattata come timestamp RFC 3339. Per aumentare le probabilità che Google Cloud approvi la tua richiesta dopo l'invio, specifica un periodo di prenotazione minimo. Per specificare una durata anziché una data/ora di fine, sostituisci il flag --end-time con il flag --duration=END_DURATION. Sostituisci END_DURATION con una durata in secondi. Ad esempio, specifica 1209600 per 1.209.600 secondi (14 giorni).

    Per aumentare le probabilità che Google Cloud approvi una richiesta di prenotazione futura dopo averla inviata per la revisione, specifica una durata minima consigliata.

  • TOTAL_COUNT: il numero totale di VM che vuoi prenotare.

  • ZONE: la zona in cui prenotare le risorse.

Ad esempio, supponiamo che tu voglia creare una bozza di richiesta di prenotazione futura chiamata fr-01 nella zona us-central1-a con le seguenti proprietà:

  • Un periodo di prenotazione che inizia a mezzanotte del 10 novembre 2024 UTC e termina a mezzanotte del 10 dicembre 2024 UTC.

  • Un numero totale di 80 VM.

  • Un tipo di macchina N2 predefinita con 4 vCPU.
  • L'opzione di eliminazione automatica abilitata. Le prenotazioni create automaticamente vengono eliminate al termine del periodo di prenotazione.

Per creare fr-01, esegui il comando seguente:

gcloud beta compute future-reservations create fr-01 \
    --auto-delete-auto-created-reservations \
    --machine-type=n2-standard-4 \
    --start-time=2024-11-10T00:00:00Z \
    --end-time=2024-12-10T00:00:00Z \
    --total-count=80 \
    --zone=us-central1-a

Facoltativamente, puoi eseguire una o più delle seguenti operazioni:

  • Per collegare le GPU alle VM N1 prenotate, includi il flag --accelerator.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
        --accelerator=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \
        --auto-delete-auto-created-reservations \
        --machine-type=MACHINE_TYPE \
        --start-time=START_TIME \
        --end-time=END_TIME \
        --total-count=TOTAL_COUNT \
        --zone=ZONE
    

    Sostituisci quanto segue:

    • NUMBER_OF_ACCELERATORS: il numero di GPU da aggiungere a ciascuna VM prenotata.

    • ACCELERATOR_TYPE: un modello di GPU supportato per le VM N1. Per evitare errori, verifica che il modello di GPU scelto sia disponibile nella zona in cui stai creando la richiesta di prenotazione futura.

  • Per eliminare le prenotazioni create automaticamente dopo la data/ora di fine del periodo di prenotazione, seleziona uno dei seguenti metodi:

    • Per eliminare le prenotazioni create automaticamente in una data e un'ora specifiche dopo la data/ora di fine del periodo di prenotazione, includi il flag --auto-created-reservations-delete-time.

      gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
          --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \
          --auto-delete-auto-created-reservations \
          --machine-type=MACHINE_TYPE \
          --start-time=START_TIME \
          --end-time=END_TIME \
          --total-count=TOTAL_COUNT \
          --zone=ZONE
      

      Sostituisci AUTO_CREATED_RESERVATIONS_DELETE_TIME con una data e un'ora formattate come timestamp RFC 3339.

    • Per eliminare le prenotazioni create automaticamente dopo una durata specifica dalla data/ora di fine del periodo di prenotazione, includi il flag --auto-created-reservations-duration.

      gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
          --auto-created-reservations-duration=DURATION_BEFORE_DELETE \
          --auto-delete-auto-created-reservations \
          --machine-type=MACHINE_TYPE \
          --start-time=START_TIME \
          --end-time=END_TIME \
          --total-count=TOTAL_COUNT \
          --zone=ZONE
      

      Sostituisci DURATION_BEFORE_DELETE con una durata in giorni, ore, minuti o secondi. Ad esempio, specifica 30m per 30 minuti o 1d2h3m4s per un giorno, due ore, tre minuti e quattro secondi.

  • Per disattivare l'opzione di eliminazione automatica per le prenotazioni create automaticamente, sostituisci il flag --auto-delete-auto-created-reservations con il flag --no-auto-delete-auto-created-reservations.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
        --no-auto-delete-auto-created-reservations \
        --machine-type=MACHINE_TYPE \
        --start-time=START_TIME \
        --end-time=END_TIME \
        --total-count=TOTAL_COUNT \
        --zone=ZONE
    
  • Per collegare i dischi SSD locali a un tipo di macchina che non li include per impostazione predefinita, includi il flag --local-ssd. Puoi collegare solo un disco SSD locale da 375 GB.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
        --auto-delete-auto-created-reservations \
        --local-ssd=count=NUMBER_OF_LOCAL_SSD_DISKS,size=375,interface=INTERFACE_TYPE \
        --machine-type=MACHINE_TYPE \
        --start-time=START_TIME \
        --end-time=END_TIME \
        --total-count=TOTAL_COUNT \
        --zone=ZONE
    

    Sostituisci quanto segue:

    • NUMBER_OF_LOCAL_SSD_DISKS: il numero di dischi SSD locali da collegare.

    • INTERFACE_TYPE: il tipo di interfaccia del disco che vuoi che venga utilizzato dai dischi SSD locali e che sia supportato dal tipo di macchina specificato. Specifica uno dei seguenti valori:

      • Per l'interfaccia disco NVME: nvme

      • Per l'interfaccia disco SCSI: scsi

  • Per fare in modo che le VM prenotate utilizzino una specifica piattaforma CPU minima anziché la piattaforma CPU predefinita della zona, includi il flag --min-cpu-platform.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
        --auto-delete-auto-created-reservations \
        --machine-type=MACHINE_TYPE \
        --min-cpu-platform="MIN_CPU_PLATFORM" \
        --start-time=START_TIME \
        --end-time=END_TIME \
        --total-count=TOTAL_COUNT \
        --zone=ZONE
    

    Sostituisci MIN_CPU_PLATFORM con una piattaforma CPU minima. Per assicurarti che una piattaforma CPU sia disponibile nella zona in cui stai prenotando le risorse, visualizza le piattaforme CPU disponibili per zona.

  • Per specificare un prefisso del nome per le prenotazioni create automaticamente, includi il flag --name-prefix.

    gcloud beta compute future-reservations create FUTURE_RESERVATION_NAME \
        --auto-delete-auto-created-reservations \
        --machine-type=MACHINE_TYPE \
        --name-prefix=NAME_PREFIX \
        --start-time=START_TIME \
        --end-time=END_TIME \
        --total-count=TOTAL_COUNT \
        --zone=ZONE
    

    Sostituisci NAME_PREFIX con il prefisso del nome di ogni prenotazione creata automaticamente. Per aiutarti a identificare le prenotazioni create automaticamente per questa richiesta di prenotazione futura, Google Cloud consiglia di specificare un prefisso del nome univoco.

REST

Per creare una richiesta di prenotazione futura per un singolo progetto specificando direttamente le proprietà, invia una richiesta POST al metodo beta.futureReservations.insert.

Per creare una bozza di richiesta di prenotazione futura specificando direttamente le proprietà senza includere campi facoltativi, effettua una richiesta POST nel modo seguente:

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

{
  "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
  "name": "FUTURE_RESERVATION_NAME",
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "MACHINE_TYPE"
    },
    "totalCount": TOTAL_COUNT
  },
  "timeWindow": {
    "startTime": "START_TIME",
    "endTime": "END_TIME"
  }
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui vuoi prenotare le risorse.

  • ZONE: la zona in cui prenotare le risorse.

  • AUTO_DELETE_AUTO_CREATED_RESERVATIONS: se imposti questo campo su true, Compute Engine elimina in automatico le prenotazioni create automaticamente per questa prenotazione futura entro due ore dall'ora di fine del periodo di prenotazione. Se vuoi collegare le prenotazioni create automaticamente a un impegno, imposta questo campo su false.

  • TOTAL_COUNT: il numero totale di VM che vuoi prenotare.

  • START_TIME: la data/ora di inizio del periodo di prenotazione come timestamp RFC 3339, che deve essere formattato come segue:

    YYYY-MM-DDTHH:MM:SSOFFSET
    

    Sostituisci quanto segue:

    • YYYY-MM-DD: una data formattata con l'anno a 4 cifre, il mese a 2 cifre e il giorno del mese a 2 cifre, separati da trattini (-).

    • HH:MM:SS: un orario formattato con l'ora a due cifre utilizzando il sistema a 24 ore, i minuti a due cifre e i secondi a due cifre, separati da due punti (:).

    • OFFSET: il fuso orario formattato come offset rispetto al Tempo Universale Coordinato (UTC). Ad esempio, per utilizzare il fuso orario PST (Pacific Standard Time), specifica -08:00. In alternativa, per non utilizzare alcun offset, specifica Z.

    La data/ora di inizio non può essere successiva a un anno dalla data e dall'ora di invio della richiesta di prenotazione futura per la revisione. Per avere tempo sufficiente per annullare, eliminare o modificare facoltativamente una richiesta di prenotazione futura dopo l'approvazione e prima del periodo di blocco, specifica un valore consigliato per la data/ora di inizio.

  • END_TIME: la data/ora di fine del periodo di prenotazione formattata come timestamp RFC 3339. Per aumentare le probabilità che Google Cloud approvi la tua richiesta dopo l'invio, specifica un periodo di prenotazione minimo. Per specificare una durata anziché una data e ora di fine, puoi sostituire il campo endTime con il campo duration:

    "duration": {
      "seconds": END_DURATION
    }
    

    Sostituisci END_DURATION con una durata in secondi. Ad esempio, specifica 1209600 per 1.209.600 secondi (14 giorni).

Ad esempio, supponiamo che tu voglia creare una bozza di richiesta di prenotazione futura chiamata fr-01 nella zona us-central1-a con le seguenti proprietà:

  • Un periodo di prenotazione che inizia a mezzanotte del 10 novembre 2024 UTC e termina a mezzanotte del 10 dicembre 2024 UTC.

  • Un numero totale di 80 VM.

  • Un tipo di macchina N2 predefinita con 4 vCPU.
  • L'opzione di eliminazione automatica abilitata. Le prenotazioni create automaticamente vengono eliminate al termine del periodo di prenotazione.

Per creare fr-01, invia una richiesta POST come segue:

POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations

{
  "autoDeleteAutoCreatedReservations": true,
  "name": "fr-01",
  "specificSkuProperties": { 
    "instanceProperties": {
      "machineType": "n2-standard-4"
    },
    "totalCount": 80
  },
  "timeWindow": {
    "startTime": "2024-11-10T00:00:00Z",
    "endTime": "2024-12-10T00:00:00Z"
  }
}

Facoltativamente, puoi eseguire una o più delle seguenti operazioni:

  • Per specificare un prefisso del nome per le prenotazioni create automaticamente, includi il campo namePrefix.

    POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations
    
    {
      "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
      "name": "FUTURE_RESERVATION_NAME",
      "namePrefix": "NAME_PREFIX",
      "specificSkuProperties": { 
        "instanceProperties": {
          "machineType": "MACHINE_TYPE"
        },
        "totalCount": TOTAL_COUNT
      },
      "timeWindow": {
        "startTime": "START_TIME",
        "endTime": "END_TIME"
      }
    }
    

    Sostituisci NAME_PREFIX con il prefisso del nome di ogni prenotazione creata automaticamente. Per aiutarti a identificare le prenotazioni create automaticamente per questa richiesta di prenotazione futura, Google Cloud ti consiglia di specificare un prefisso del nome univoco.

  • Per collegare le GPU alle VM N1 prenotate, includi il campo guestAccelerators.

    POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations
    
    {
      "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
      "name": "FUTURE_RESERVATION_NAME",
      "specificSkuProperties": {
        "instanceProperties": {
          "guestAccelerators": [
            {
              "acceleratorCount": NUMBER_OF_ACCELERATORS,
              "acceleratorType": "ACCELERATOR_TYPE"
            }
          ],
          "machineType": "MACHINE_TYPE"
        },
        "totalCount": TOTAL_COUNT
      },
      "timeWindow": {
        "startTime": "START_TIME",
        "endTime": "END_TIME"
      }
    }
    

    Sostituisci quanto segue:

    • NUMBER_OF_ACCELERATORS: il numero di GPU da aggiungere a ciascuna VM prenotata.

    • ACCELERATOR_TYPE: un modello di GPU supportato per le VM N1. Per evitare errori, verifica che il modello di GPU scelto sia disponibile nella zona in cui stai creando la richiesta di prenotazione futura.

  • Per collegare i dischi SSD locali a un tipo di macchina che non li include per impostazione predefinita, includi il campo localSsds nel corpo della richiesta. Puoi collegare solo dischi SSD locali da 375 GB.

    Ad esempio, per specificare due dischi SSD locali quando crei una bozza della richiesta di prenotazione futura, invia una richiesta POST come segue:

    POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations
    
    {
      "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
      "name": "FUTURE_RESERVATION_NAME",
      "specificSkuProperties": {
        "instanceProperties": {
          "localSsds": [
            {
              "diskSizeGb": "375",
              "interface": "INTERFACE_TYPE"
            },
            {
              "diskSizeGb": "375",
              "interface": "INTERFACE_TYPE"
            }
          ],
          "machineType": "MACHINE_TYPE"
        },
        "totalCount": TOTAL_COUNT
      },
      "timeWindow": {
        "startTime": "START_TIME",
        "endTime": "END_TIME"
      }
    }
    

    Sostituisci INTERFACE_TYPE con il tipo di interfaccia disco che verrà utilizzato da ogni disco SSD locale e che è supportato dal tipo di macchina specificato. Specifica uno dei seguenti valori:

    • Per l'interfaccia disco NVME: NVME

    • Per l'interfaccia disco SCSI: SCSI

  • Per fare in modo che le VM prenotate utilizzino una specifica piattaforma CPU minima anziché la piattaforma CPU predefinita della zona, includi il minCpuPlatform.

    POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations
    
    {
      "autoDeleteAutoCreatedReservations": AUTO_DELETE_AUTO_CREATED_RESERVATIONS,
      "name": "FUTURE_RESERVATION_NAME",
      "specificSkuProperties": {
        "instanceProperties": {
          "machineType": "MACHINE_TYPE",
          "minCpuPlatform": "MINIMUM_CPU_PLATFORM"
        },
        "totalCount": TOTAL_COUNT
      },
      "timeWindow": {
        "startTime": "START_TIME",
        "endTime": "END_TIME"
      }
    }
    

    Sostituisci MIN_CPU_PLATFORM con una piattaforma CPU minima. Per verificare che una piattaforma CPU sia disponibile nella zona in cui stai prenotando le risorse, visualizza le piattaforme CPU disponibili per zona.

  • Per eliminare le prenotazioni create automaticamente dopo la data/ora di fine del periodo di prenotazione, seleziona uno dei seguenti metodi:

    • Per eliminare le prenotazioni create automaticamente dopo un'ora specifica successiva al termine del periodo di prenotazione, imposta autoDeleteAutoCreatedReservations su true e includi il campo autoCreatedReservationsDeleteTime.

      POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations
      
      {
        "autoCreatedReservationsDeleteTime": "DELETE_TIME",
        "autoDeleteAutoCreatedReservations": true,
        "name": "FUTURE_RESERVATION_NAME",
        "specificSkuProperties": { 
          "instanceProperties": {
            "machineType": "MACHINE_TYPE"
          },
          "totalCount": TOTAL_COUNT
        },
        "timeWindow": {
          "startTime": "START_TIME",
          "endTime": "END_TIME"
        }
      }
      

      Sostituisci DELETE_TIME con una data e un'ora in cui Compute Engine elimina le prenotazioni create automaticamente. La data e l'ora devono essere formattate come timestamp RFC 3339.

    • Per eliminare le prenotazioni create automaticamente dopo una durata specifica a partire dalla data/ora di inizio del periodo di prenotazione, imposta autoDeleteAutoCreatedReservations su true e includi il campo autoCreatedReservationsDuration.

      POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations
      
      {
        "autoCreatedReservationsDuration": {
          "seconds": "DURATION_BEFORE_DELETE"
        },
        "autoDeleteAutoCreatedReservations": true,
        "name": "FUTURE_RESERVATION_NAME",
        "specificSkuProperties": { 
          "instanceProperties": {
            "machineType": "MACHINE_TYPE"
          },
          "totalCount": TOTAL_COUNT
        },
        "timeWindow": {
          "startTime": "START_TIME",
          "endTime": "END_TIME"
        }
      }
      

      Sostituisci DURATION_BEFORE_DELETE con una durata in secondi. Ad esempio, specifica 604800 per 604.800 secondi (7 giorni).

Dopo aver creato una bozza di richiesta di prenotazione futura, puoi determinare il numero di VM di cui Compute Engine eseguirà il provisioning per la richiesta.

Invia una bozza di richiesta

Dopo che una richiesta di prenotazione futura è stata inviata, approvata da Google Cloud e una volta passato il periodo di blocco, puoi eliminare la prenotazione futura e le sue prenotazioni create automaticamente solo dopo la fine del periodo di prenotazione della prenotazione futura. L'eliminazione di una prenotazione futura esistente è utile se devi creare un'altra prenotazione futura con le stesse proprietà. Pertanto, prima di creare una richiesta di prenotazione futura, accertati di quanto segue:

  • Eventuali prenotazioni esistenti o future in un progetto impongono limiti alle impostazioni di condivisione delle richieste di prenotazione futura che puoi creare. Per avere la certezza di poter creare correttamente una richiesta di prenotazione futura e che la tua richiesta non causi problemi in altri progetti con cui condividi richieste di prenotazione o prenotazioni future, consulta le Limitazioni.

  • Devi assumerti l'impegno di pagare le risorse prenotate di cui Compute Engine effettua il provisioning per l'intero periodo di prenotazione, indipendentemente dal fatto che le prenotazioni create automaticamente vengano utilizzate o meno. Per ulteriori informazioni, consulta la Fatturazione.

Se vuoi modificare una o più proprietà quando invii la bozza della richiesta di prenotazione futura per la revisione, consulta Modifica le richieste di prenotazione futura.

Per inviare una bozza di richiesta di prenotazione futura a Google Cloud per la revisione, 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 con stato di approvvigionamento Bozza.

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

  4. Fai clic su Modifica bozza.

    Viene visualizzata la pagina per aggiornare la bozza della richiesta di prenotazione futura.

  5. Per inviare la bozza della richiesta di prenotazione futura per la revisione, fai clic su Invia.

Viene visualizzata la pagina Prenotazione. Nella colonna Stato della richiesta di prenotazione futura che hai appena inviato, lo stato dell'approvvigionamento è impostato su In attesa di approvazione.

gcloud

Per inviare una bozza di richiesta di prenotazione futura per la revisione, utilizza il comando gcloud beta compute future-reservations update con il flag --planning-status impostato su SUBMITTED.

gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \
    --planning-status=SUBMITTED \
    --zone=ZONE

Sostituisci quanto segue:

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

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

REST

Per inviare una bozza di richiesta di prenotazione futura per la revisione, invia una richiesta PATCH al metodo beta.futureReservations.update. Nel corpo della richiesta, includi il campo planningStatus e impostalo su SUBMITTED.

PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=planningStatus

{
  "name": "FUTURE_RESERVATION_NAME",
  "planningStatus": "SUBMITTED"
}

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

Dopo aver inviato una bozza di richiesta di prenotazione futura per la revisione, puoi fare quanto segue:

Risoluzione dei problemi

Se si verificano errori durante la creazione di una richiesta di prenotazione futura, scopri come risolvere i problemi relativi alle richieste di prenotazione futura.

Se i problemi persistono dopo la risoluzione dei problemi, contatta il tuo team dedicato all'account o il team di vendita.

Passaggi successivi