Questo documento spiega come modificare le richieste di prenotazione future.
Puoi modificare una richiesta di prenotazione futura in qualsiasi momento prima dell'orario di inizio, a condizione che non sia stata annullata o non sia in attesa di approvazione. La modifica di una richiesta di prenotazione futura è utile quando le tue esigenze di capacità cambiano, ad esempio quando vuoi aumentare il numero di istanze di macchine virtuali (VM) riservate o modificare il periodo di prenotazione. Se vuoi modificare una richiesta di prenotazione futura condivisa, devi modificarla utilizzando il progetto proprietario.
Per modificare una prenotazione creata automaticamente al termine del relativo periodo di prenotazione, consulta Modifica le prenotazioni.
Prima di iniziare
-
Se non l'hai ancora fatto, configura l'autenticazione.
L'autenticazione verifica la tua identità per l'accesso a Google Cloud servizi e 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
-
Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il seguente comando:
gcloud init
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere alla gcloud CLI con la tua identità federata.
- Set a default region and zone.
REST
Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali fornite a gcloud CLI.
Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il seguente comando:
gcloud init
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere alla gcloud CLI con la tua identità federata.
Per saperne di più, consulta Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud .
Ruoli obbligatori
Per ottenere l'autorizzazione necessaria per modificare le richieste di prenotazione futura, chiedi all'amministratore di concederti il ruolo IAM Compute Future Reservation Admin (
roles/compute.futureReservationAdmin
) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.Questo ruolo predefinito contiene l'autorizzazione
compute.futureReservations.update
necessaria per modificare le richieste di prenotazione future.Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.
Proprietà modificabili
Una richiesta di prenotazione futura ha diverse proprietà che definiscono la prenotazione, ne determinano il comportamento e specificano le risorse da prenotare. Puoi modificare queste proprietà come descritto nelle sezioni seguenti.
Dopo la creazione
Dopo aver creato una richiesta di prenotazione futura, non puoi modificare le seguenti proprietà:
Il nome della richiesta di prenotazione futura.
Il progetto in cui è stata creata la richiesta di prenotazione futura.
La zona in cui si trova la richiesta di prenotazione futura.
Il modello di istanza da utilizzare e le proprietà della VM specificate nel modello di istanza.
Per modificare una di queste proprietà prima che una richiesta di prenotazione futura entri nel periodo di blocco, crea una nuova richiesta.
Prima dell'invio
Prima di inviare una richiesta di prenotazione futura a Google Cloud per la revisione oppure dopo aver inviato una richiesta di prenotazione futura per la revisione e la richiesta è stata rifiutata, puoi modificare le seguenti proprietà:
Opzione di eliminazione automatica
Descrizione
GPU e tipo di GPU
Dischi SSD locali e tipo di interfaccia dei dischi
Serie di macchine e tipo di macchina
Piattaforma CPU minima
Prefisso nome
Impostazioni di condivisione
Ora di inizio e di fine del periodo di prenotazione
Conteggio totale (numero di VM)
La modifica dello stato di una bozza di richiesta di prenotazione futura è immediata e non ci sono limiti al numero di volte in cui puoi modificarla. Se stai modificando una richiesta di prenotazione futura rifiutata (
DECLINED
), puoi modificarla solo se la invii di nuovo per la revisione.Dopo l'approvazione
Dopo che Google Cloud approva una prenotazione futura, puoi modificarla prima che la prenotazione futura raggiunga lo stato di provisioning (
PROVISIONING
). Nello specifico, puoi modificare le seguenti proprietà:Modificando la prenotazione futura in qualsiasi momento:
Opzione di eliminazione automatica
Descrizione
Prefisso nome
Inviando una richiesta di modifica non prima di 72 ore prima dell'ora di inizio:
GPU e tipo di GPU*
Dischi SSD locali e tipo di interfaccia dei dischi*
Serie di macchine e tipo di macchina*
Piattaforma CPU minima*
Impostazioni di condivisione
Ora di inizio e di fine del periodo di prenotazione
Conteggio totale (numero di VM)*
* Se richiedi di modificare le proprietà di una VM o di aumentare o diminuire in modo significativo il conteggio totale entro 14 giorni dalla data/ora di inizio della prenotazione futura, è probabile che Google Cloud rifiuti la tua richiesta di modifica.
Modificare le richieste di prenotazione futura
Prima di modificare una richiesta di prenotazione futura, esamina le proprietà che puoi modificare, se non l'hai ancora fatto.
Se vuoi modificare una richiesta di prenotazione futura per un singolo progetto creata tramite un template di istanza in una richiesta di prenotazione futura condivisa, non puoi utilizzare lo stesso template per creare VM che possono utilizzare le prenotazioni create automaticamente al di fuori del progetto che ha creato la richiesta di prenotazione futura condivisa. Per i progetti con cui la prenotazione futura è condivisa, devi creare template di istanza simili nei progetti o creare VM specificando direttamente le proprietà.
Per modificare una richiesta di prenotazione futura, seleziona una delle seguenti opzioni:
Console
Nella console Google Cloud , vai alla pagina Prenotazioni.
Fai clic sulla scheda Prenotazioni future.
Nella colonna Nome, fai clic sul nome della richiesta di prenotazione futura da modificare.
Viene visualizzata la pagina dei dettagli della richiesta di prenotazione futura selezionata.
Se vuoi modificare l'opzione di eliminazione automatica, la descrizione o il prefisso del nome di una prenotazione futura approvata, esegui una o più delle seguenti operazioni:
Per modificare l'opzione di eliminazione automatica, nella riga Data/ora eliminazione automatica delle prenotazioni create automaticamente, fai clic su
Modifica e poi svolgi le seguenti operazioni:Specifica se vuoi attivare, disattivare o modificare l'opzione di eliminazione automatica eseguendo una delle seguenti operazioni:
Per attivare l'opzione di eliminazione automatica o modificare l'ora in cui Compute Engine elimina automaticamente le prenotazioni create automaticamente, segui questi passaggi:
Fai clic sul pulsante di attivazione/disattivazione Attiva l'eliminazione automatica in modo che sia impostato su On.
(Facoltativo) In Data/ora eliminazione automatica, inserisci una nuova data e 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.
Fai clic su Invia.
Per modificare il prefisso del nome, nella riga Prefisso, fai clic su
Modifica, quindi esegui le seguenti operazioni:In Prefisso, inserisci un nuovo prefisso per il nome.
Fai clic su Invia.
Per modificare la descrizione, nella riga Descrizione, fai clic su
Modifica e poi esegui le seguenti operazioni:In Descrizione, inserisci una nuova descrizione.
Fai clic su Invia.
Fai clic su
Modifica o Modifica bozza.Viene visualizzata la pagina per modificare la richiesta di prenotazione futura selezionata.
Per modificare una richiesta di prenotazione futura e inviarla a Google Cloud per la revisione o salvare la bozza della richiesta, esegui una o più delle seguenti operazioni:
In Prefisso, inserisci un nuovo prefisso del nome per le prenotazioni create automaticamente di cui è stato eseguito il provisioning per questa richiesta di prenotazione futura.
In Descrizione, inserisci una nuova descrizione.
Modifica l'ora di inizio o l'ora di fine della tua richiesta di prenotazione futura. Verifica quanto segue:
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.
Specifica un valore consigliato per l'ora di inizio per assicurarti di avere tempo sufficiente prima che la tua prenotazione futura entri nel periodo di blocco.
Specifica un periodo di prenotazione minimo consigliato per aumentare le probabilità che Google Cloud approvi la tua richiesta dopo averla inviata per la revisione.
Nella sezione Tipo di condivisione, puoi selezionare Locale o Condiviso. Se selezioni Condivisa, puoi aggiungere o rimuovere progetti con cui condividere la richiesta di prenotazione futura. Puoi includere fino a 100 progetti.
In Numero di istanze VM, inserisci il numero totale di VM che vuoi prenotare.
Se stai modificando una prenotazione futura che non è stata creata tramite un modello di istanza, nella sezione Configurazione macchina puoi modificare quanto segue:
La serie e il tipo di macchina utilizzati nelle VM riservate.
Le GPU da collegare alle VM prenotate.
I dischi SSD locali e il tipo di interfaccia disco delle VM prenotate.
Nella sezione Eliminazione automatica delle prenotazioni generate automaticamente, puoi attivare o disattivare l'eliminazione automatica delle prenotazioni create automaticamente per la tua richiesta di prenotazione futura.
A seconda dello stato dell'approvvigionamento della richiesta di prenotazione futura che stai modificando, esegui una delle seguenti operazioni:
Se stai modificando una bozza di richiesta di prenotazione futura, esegui una delle seguenti operazioni:
Per salvare le modifiche, fai clic su Salva bozza.
Per inviare la bozza della richiesta di prenotazione futura a Google Cloud per la revisione, fai clic su Invia.
In caso contrario, fai clic su Invia.
Se invii una richiesta di modifica, viene visualizzata la pagina Prenotazioni. In caso contrario, viene visualizzata la pagina dei dettagli della prenotazione futura.
gcloud
Per modificare una richiesta di prenotazione futura, utilizza il comando
gcloud beta compute future-reservations update
.gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \ --accelerator=count=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE \ --description="DESCRIPTION" \ --local-ssd=size=375,interface=INTERFACE \ --machine-type=MACHINE_TYPE \ --min-cpu-platform=MIN_CPU_PLATFORM \ --name-prefix=NAME_PREFIX \ --planning-status=PLANNING_STATUS \ --share-setting=SHARE_SETTING \ --share-with=CONSUMER_PROJECT_IDS \ --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 futuraPLANNING_STATUS
: lo stato di pianificazione della richiesta di prenotazione futura. Specifica uno dei seguenti valori:Per modificare una bozza di richiesta di prenotazione futura senza inviarla per la revisione:
DRAFT
.Per inviare la richiesta di prenotazione futura per la revisione:
SUBMITTED
.
ZONE
: la zona in cui si trova la richiesta di prenotazione futura
Sostituisci uno o più dei seguenti segnaposto o rimuovili insieme ai flag corrispondenti:
Per consentire a Compute Engine di eliminare automaticamente le prenotazioni create automaticamente dopo l'ora di fine del periodo di prenotazione, svolgi una delle seguenti operazioni:
Per eliminare le prenotazioni entro due ore dalla data/ora di fine (impostazione predefinita), includi il flag
--auto-delete-auto-created-reservations
.gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \ --auto-delete-auto-created-reservations \ --planning-status=PLANNING_STATUS \ --zone=ZONE
Per eliminare le prenotazioni create automaticamente a un'ora specifica dopo la data/ora di fine del periodo di prenotazione, includi i flag
--auto-delete-auto-created-reservations
e--auto-created-reservations-delete-time
.gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \ --auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME \ --auto-delete-auto-created-reservations \ --planning-status=PLANNING_STATUS \ --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 i flag
--auto-delete-auto-created-reservations
e--auto-created-reservations-duration
.gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \ --auto-created-reservations-duration=DURATION_BEFORE_DELETE \ --auto-delete-auto-created-reservations \ --planning-status=PLANNING_STATUS \ --zone=ZONE
Sostituisci
DURATION_BEFORE_DELETE
con una durata in giorni, ore, minuti o secondi. Ad esempio, specifica30m
per 30 minuti o1d2h3m4s
per 1 giorno, 2 ore, 3 minuti e 4 secondi.
Per impedire a Compute Engine di eliminare automaticamente le prenotazioni create automaticamente di cui è stato eseguito il provisioning per questa richiesta di prenotazione futura, includi il flag
--no-auto-delete-auto-created-reservations
.gcloud beta compute future-reservations update FUTURE_RESERVATION_NAME \ --no-auto-delete-auto-created-reservations \ --planning-status=PLANNING_STATUS \ --zone=ZONE
Per aggiungere o rimuovere GPU collegate alle VM N1 prenotate o aggiornare il tipo di GPU, esegui una delle seguenti operazioni:
Per modificare il numero e il tipo di GPU, sostituisci quanto segue:
NUMBER_OF_ACCELERATORS
: il numero di GPU da aggiungere per VM prenotata.ACCELERATOR_TYPE
: il tipo di GPU da aggiungere alle VM prenotate. Verifica che la GPU sia disponibile nella zona in cui si trova la richiesta di prenotazione futura. In caso contrario, la modifica della richiesta non va a buon fine.
Per rimuovere tutte le GPU collegate alle VM N1 prenotate, sostituisci il flag
--accelerator
con il flag--clear-accelerator
.
DESCRIPTION
: una nuova descrizione per la richiesta di prenotazione futura.Per aggiungere o rimuovere dischi SSD locali dalle VM prenotate o modificare il tipo di interfaccia del disco SSD locale, esegui una delle seguenti operazioni:
Per aggiungere dischi SSD locali o modificare il tipo di interfaccia del disco, sostituisci
INTERFACE
con uno dei seguenti valori:Se l'immagine del disco di avvio contiene driver NVMe ottimizzati:
nvme
.Altrimenti:
scsi
.
Includi il flag
--local-ssd
per tutti i dischi SSD locali che vuoi aggiungere. Puoi specificare un massimo di 24 dischi SSD locali.Per rimuovere tutti i dischi SSD locali collegati alle VM riservate, rimuovi tutti i flag
--local-ssd
e includi il flag--clear-local-ssd
.
MACHINE_TYPE
: Il nuovo tipo di macchina da utilizzare per ogni VM prenotata. Se modifichi il tipo di macchina, specifica anche un periodo di prenotazione minimo consigliato per la nuova serie di macchine. In caso contrario, Google Cloud probabilmente rifiuterà la tua richiesta di modifica.MINIMUM_CPU_PLATFORM
: una nuova piattaforma CPU minima da utilizzare per ogni VM prenotata.NAME_PREFIX
: Un nuovo prefisso del nome per le prenotazioni create automaticamente di cui è stato eseguito il provisioning per la richiesta di prenotazione futura.SHARE_SETTING
: un nuovo tipo di condivisione per la tua richiesta di prenotazione futura. Specifica uno dei seguenti valori:Per una richiesta di prenotazione futura per un singolo progetto:
local
. Per evitare errori, devi anche sostituire il flag--share-with
con il flag--clear-share-settings
.Per una richiesta di prenotazione futura condivisa:
projects
. Per evitare errori, devi specificare almeno un progetto consumer nel flag--share-with
.
CONSUMER_PROJECT_IDS
: un elenco separato da virgole di ID dei progetti con cui vuoi condividere la richiesta di prenotazione futura, ad esempioproject-1,project-2
. Puoi specificare fino a 100 progetti consumer.START_TIME
: la nuova data/ora di inizio del periodo di prenotazione formattata come timestamp RFC 3339. La data/ora di inizio non può essere successiva a un anno dalla data e dall'ora di invio della richiesta di modifica per la revisione. Per avere tempo sufficiente per annullare, eliminare o modificare facoltativamente una prenotazione futura dopo che è stata approvata e prima del periodo di blocco, specifica un orario di inizio consigliato.END_TIME
: La nuova 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 consigliato. Per specificare una durata anziché una data/ora di fine, sostituisci il flag--end-time
con il flag--duration=END_DURATION
. SostituisciEND_DURATION
con la durata del periodo di prenotazione in secondi. Ad esempio, specifica1209600
per 1.209.600 secondi (14 giorni).TOTAL_COUNT
: il nuovo numero totale di VM che vuoi prenotare per il periodo, la configurazione delle VM e i progetti specificati nella richiesta di prenotazione futura. Se vuoi aumentare il conteggio totale, verifica di disporre di una quota sufficiente per le risorse che stai prenotando. In caso contrario, Google Cloud rifiuta la tua richiesta di modifica.
Ad esempio, considera una bozza di richiesta di prenotazione futura condivisa denominata
fr-03
e che si trova nella zonaus-central1-a
. Supponiamo che tu voglia modificare questa richiesta di prenotazione futura condivisa apportando le seguenti modifiche:Converti la richiesta in una richiesta di prenotazione futura per un singolo progetto.
Disattiva l'opzione di eliminazione automatica.
Prenota 100 VM.
Invia la richiesta di prenotazione futura a Google Cloud per la revisione.
Per modificare
fr-03
, esegui questo comando:gcloud beta compute future-reservations update fr-03 \ --clear-share-settings \ --no-auto-delete-auto-created-reservations \ --planning-status=SUBMITTED \ --share-setting=local \ --total-count=100 \ --zone=us-central1-a
REST
Per modificare una richiesta di prenotazione futura, invia una richiesta
PATCH
al metodobeta.futureReservations.update
.PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=UPDATE_FIELDS { "autoDeleteAutoCreatedReservations": "AUTO_DELETE_AUTO_CREATED_RESERVATIONS", "description": "DESCRIPTION", "name": "FUTURE_RESERVATION_NAME", "namePrefix": "NAME_PREFIX", "planningStatus": "PLANNING_STATUS", "shareSettings": { "projects": [ "CONSUMER_PROJECT_ID_1", "CONSUMER_PROJECT_ID_2" ], "shareType": "SHARE_TYPE" }, "specificSkuProperties": { "instanceProperties": { "guestAccelerators": [ { "acceleratorCount": NUMBER_OF_ACCELERATORS, "acceleratorType": "ACCELERATOR_TYPE" } ], "localSsds": [ { "diskSizeGb": "375", "interface": "INTERFACE_1" }, { "diskSizeGb": "375", "interface": "INTERFACE_2" } ], "machineType": "MACHINE_TYPE", "minCpuPlatform": "MINIMUM_CPU_PLATFORM" }, "totalCount": "TOTAL_COUNT" }, "timeWindow": { "endTime": "END_TIME", "startTime": "START_TIME" } }
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto in cui si trova la richiesta di prenotazione futuraZONE
: la zona in cui si trova la richiesta di prenotazione futuraFUTURE_RESERVATION_NAME
: il nome della richiesta di prenotazione futuraUPDATE_FIELDS
: un elenco separato da virgole dei campi da aggiornare nel corpo della richiesta. Devi codificare ogni virgola come%2C
. Se specifichi un campo nel parametro di queryupdateMask
e nel corpo della richiesta, il valore del campo viene aggiornato. In caso contrario, se specifichi il campo solo nel parametro di queryupdateMask
, questo viene eliminato.Ad esempio, per aggiornare i campi
autoDeleteAutoCreatedReservations
,totalCount
eendTime
nella richiesta di prenotazione futura, specifica quanto segue:autoDeleteAutoCreatedReservations%2CspecificSkuProperties.totalCount%2CtimeWindow.endTime
PLANNING_STATUS
: lo stato di pianificazione della richiesta di prenotazione futura. Specifica uno dei seguenti valori:Per modificare una bozza di richiesta di prenotazione futura senza inviarla per la revisione:
DRAFT
.Per inviare la richiesta di modifica per la revisione:
SUBMITTED
.
Sostituisci uno o più dei seguenti segnaposto o rimuovili insieme ai campi corrispondenti:
AUTO_DELETE_AUTO_CREATED_RESERVATIONS
: se imposti questo campo sutrue
, Compute Engine elimina automaticamente le prenotazioni create automaticamente di cui è stato eseguito il provisioning per la tua richiesta di prenotazione futura. Per impostazione predefinita, l'eliminazione avviene entro due ore dall'ora di fine del periodo di prenotazione. Per modificare questa impostazione, procedi in uno dei seguenti modi:Per eliminare le prenotazioni create automaticamente a un'ora specifica successiva al termine del periodo di prenotazione, imposta
autoDeleteAutoCreatedReservations
sutrue
e specifica il campoautoCreatedReservationsDeleteTime
.PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDeleteTime%2CplanningStatus { "autoDeleteAutoCreatedReservations": "true", "autoCreatedReservationsDeleteTime": "DELETE_TIME", "name": "FUTURE_RESERVATION_NAME", "planningStatus": "PLANNING_STATUS" }
Sostituisci
DELETE_TIME
con una data e un'ora in cui Compute Engine elimina le prenotazioni. 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
sutrue
e specifica il campoautoCreatedReservationsDuration
.PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=autoDeleteAutoCreatedReservations%2CautoCreatedReservationsDuration%2CplanningStatus { "autoDeleteAutoCreatedReservations": "true", "autoCreatedReservationsDuration": { "seconds": "DURATION_BEFORE_DELETE" }, "name": "FUTURE_RESERVATION_NAME", "planningStatus": "PLANNING_STATUS" }
Sostituisci
DURATION_BEFORE_DELETE
con una durata in secondi. Ad esempio, specifica604800
per 604.800 secondi (7 giorni).
DESCRIPTION
: una nuova descrizione per la richiesta di prenotazione futura.NAME_PREFIX
: Un nuovo prefisso del nome per le prenotazioni create automaticamente di cui è stato eseguito il provisioning per la richiesta di prenotazione futura.CONSUMER_PROJECT_ID_1
eCONSUMER_PROJECT_ID_2
: gli ID dei progetti con cui vuoi condividere la richiesta di prenotazione futura. I progetti devono appartenere alla stessa organizzazione del progetto proprietario. Puoi specificare fino a 100 progetti consumer.SHARE_TYPE
: un nuovo tipo di condivisione per la tua richiesta di prenotazione futura. Esegui una di queste operazioni:Per specificare una richiesta di prenotazione futura per un singolo progetto, segui questi passaggi:
Specifica
LOCAL
.Rimuovi il campo
shareSettings.projects
.
Per specificare una richiesta di prenotazione futura condivisa:
Specifica
SPECIFIC_PROJECTS
.Specifica almeno un progetto consumer nel campo
shareSettings.projects
. I progetti consumer devono appartenere alla stessa organizzazione del progetto proprietario. Puoi specificare fino a 100 progetti consumer.
Per modificare il numero e il tipo di GPU da collegare alle VM N1 prenotate, sostituisci quanto segue:
NUMBER_OF_ACCELERATORS
: il numero di GPU da aggiungere per VM prenotata.ACCELERATOR_TYPE
: il tipo di GPU da aggiungere alle VM prenotate. Verifica che la GPU sia disponibile nella zona in cui si trova la richiesta di prenotazione futura. In caso contrario, la modifica della richiesta non va a buon fine.
INTERFACE_1
eINTERFACE_2
: il tipo di interfaccia del disco per i dischi SSD locali collegati a ogni VM prenotata. Specifica uno dei seguenti valori:Se l'immagine disco di avvio contiene driver NVMe ottimizzati:
NVME
.Altrimenti:
SCSI
.Puoi specificare un massimo di 24 dischi SSD locali.
MACHINE_TYPE
: Il nuovo tipo di macchina da utilizzare per ogni VM prenotata. Se modifichi il tipo di macchina, specifica anche un periodo di prenotazione minimo consigliato per la nuova serie di macchine. In caso contrario, Google Cloud ha meno probabilità di approvare la tua richiesta di modifica.MINIMUM_CPU_PLATFORM
: una nuova piattaforma CPU minima da utilizzare per ogni VM prenotata.TOTAL_COUNT
: il nuovo numero totale di VM che vuoi prenotare per il periodo, la configurazione delle VM e i progetti specificati in questa richiesta di prenotazione futura. Se vuoi aumentare il conteggio totale, verifica di disporre di una quota sufficiente per le risorse che stai prenotando. In caso contrario, Google Cloud rifiuta la tua richiesta di modifica.START_TIME
: la nuova data/ora di inizio del periodo di prenotazione formattata come timestamp RFC 3339. La data/ora di inizio non può essere successiva a un anno dalla data e dall'ora di invio della richiesta di modifica per la revisione. Per avere tempo sufficiente per annullare, eliminare o modificare facoltativamente una prenotazione futura dopo che è stata approvata e prima del periodo di blocco, specifica un orario di inizio consigliato.END_TIME
: La nuova 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, sostituisci il campoendTime
con il campoduration
:PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/futureReservations/FUTURE_RESERVATION_NAME?updateMask=timeWindow.duration%2CplanningStatus { "name": "FUTURE_RESERVATION_NAME", "planningStatus": "PLANNING_STATUS", "timeWindow": { "duration": { "seconds": "END_DURATION" } } }
Sostituisci
END_DURATION
con una durata in secondi. Ad esempio, specifica1209600
per 1.209.600 secondi (14 giorni).
Ad esempio, considera una bozza di richiesta di prenotazione futura condivisa denominata
fr-03
e che si trova nella zonaus-central1-a
. Supponiamo che tu voglia modificare questa richiesta di prenotazione futura condivisa apportando le seguenti modifiche:Converti la richiesta in una richiesta di prenotazione futura per un singolo progetto.
Disattiva l'opzione di eliminazione automatica.
Prenota 100 VM.
Invia la richiesta di prenotazione futura a Google Cloud per la revisione.
Per modificare
fr-03
, invia una richiestaPATCH
come segue:PATCH https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations/fr-03?updateMask=autoDeleteAutoCreatedReservations%2CplanningStatus%2CshareSettings.shareType%2CspecificSkuProperties.totalCount { "autoDeleteAutoCreatedReservations": false, "name": "fr-03", "planningStatus": "SUBMITTED", "shareSettings": { "shareType": "LOCAL" }, "specificSkuProperties": { "totalCount": "100" } }
Dopo aver modificato una richiesta di prenotazione futura, puoi monitorare lo stato dell'approvvigionamento o degli aggiornamenti visualizzando i dettagli della richiesta di prenotazione futura.
Modifica altre proprietà in una richiesta di prenotazione futura
Per modificare le proprietà che non puoi modificare dopo aver creato una richiesta di prenotazione futura, e prima che la richiesta venga approvata e inizi il periodo di blocco, segui questi passaggi:
Per impedire che la richiesta di prenotazione futura limiti il tipo di richieste di prenotazione futura che puoi creare nel tuo progetto o nei progetti con cui la richiesta di prenotazione futura è condivisa, elimina la richiesta di prenotazione futura.
Crea una nuova richiesta di prenotazione futura condivisa o una per un progetto singolo con gli aggiornamenti che preferisci.
Risoluzione dei problemi
Se si verificano errori durante la modifica di una richiesta di prenotazione futura, scopri come risolvere i problemi relativi alle richieste di prenotazione futura.
Se i problemi persistono dopo l'intervento di risoluzione, contatta il tuo rappresentante dell'account o il supporto.Google Cloud
Passaggi successivi
Scopri come visualizzare le richieste di prenotazione futura.
Scopri come annullare o eliminare le richieste di prenotazione futura.
Dopo la data/ora di inizio di un periodo di prenotazione, scopri come utilizzare le prenotazioni create automaticamente.
Dopo l'ora di fine di un periodo di prenotazione, scopri come modificare le prenotazioni create automaticamente.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-09-04 UTC.
-