Questo documento spiega come modificare una prenotazione esistente.
Se vuoi modificare una prenotazione condivisa, devi utilizzare il progetto proprietario.
Se vuoi modificare una prenotazione collegata a un impegno, consulta invece Sostituire le prenotazioni collegate agli impegni.
Prima di iniziare
- Esamina i requisiti e le limitazioni per le prenotazioni.
-
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:
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, quindi initialize eseguendo questo comando:
gcloud init
- Set a default region and zone.
-
Per modificare l'opzione di eliminazione automatica in una prenotazione o nei progetti consumer in una prenotazione condivisa:
compute.reservations.update
nel progetto -
Per modificare il numero di VM in una prenotazione:
compute.reservations.resize
nel progetto Modificare l'eliminazione automatica di una prenotazione.
Puoi abilitare l'opzione di eliminazione automatica per una prenotazione, modificare la data e l'ora in cui Compute Engine elimina automaticamente una prenotazione o disabilitare l'eliminazione automatica della prenotazione.
Modificare i progetti consumer in una prenotazione condivisa.
Puoi aggiungere o rimuovere i progetti consumer che possono utilizzare una prenotazione condivisa.
Modifica il numero di VM prenotate in una prenotazione.
Puoi aumentare o diminuire il numero di istanze di macchine virtuali (VM) prenotate in una prenotazione.
Abilita l'opzione di eliminazione automatica o modifica il momento in cui la prenotazione viene eliminata automaticamente.
Disattiva l'opzione di eliminazione automatica.
Nella console Google Cloud, vai alla pagina Prenotazioni.
Nella colonna Nome, fai clic sul nome della prenotazione che vuoi modificare.
Si apre la pagina dei dettagli della prenotazione selezionata.
Nella riga Ora di eliminazione automatica, fai clic su
Modifica ora di eliminazione automatica.Nel riquadro Aggiorna prenotazione, esegui una delle seguenti operazioni:
Per eliminare la prenotazione in una data e un'ora specifiche:
Se l'opzione di eliminazione automatica non è già attivata, fai clic sul pulsante di attivazione/disattivazione Abilita eliminazione automatica per attivare l'opzione.
Nel campo Data/ora eliminazione automatica, inserisci una data e un'ora in cui Compute Engine eliminerà automaticamente la prenotazione.
In caso contrario, fai clic sul pulsante di attivazione/disattivazione Abilita eliminazione automatica per disattivare l'opzione.
Fai clic su Invia.
La modifica della prenotazione potrebbe richiedere alcuni secondi.
Per eliminare la prenotazione in una data e un'ora specifiche, utilizza il comando
gcloud beta compute reservations update
con il flag--delete-at-time
.gcloud beta compute reservations update RESERVATION_NAME \ --delete-at-time=DELETE_AT_TIME \ --project=PROJECT_ID \ --zone=ZONE
Sostituisci quanto segue:
RESERVATION_NAME
: il nome di una prenotazione esistente.DELETE_AT_TIME
: una data e un'ora formattate come timestamp RFC 3339, che deve essere come segue:YYYY-MM-DDTHH:MM:SSOFFSET
Sostituisci quanto segue:
YYYY-MM-DD
: una data formattata come giorno del mese a 4 cifre, a 2 cifre e mese a 2 cifre, separate da trattini (-
).HH:MM:SS
: un'ora formattata come ora a due cifre con formato di 24 ore, minuti a due cifre e secondi a due cifre, separati dai due punti (:
).OFFSET
: il fuso orario formattato come offset del Tempo coordinato universale (UTC). Ad esempio, per utilizzare il fuso orario PST (Pacific Standard Time), specifica-08:00
. In alternativa, per non usare alcun offset, specificaZ
.
PROJECT_ID
: l'ID del progetto in cui si trova la prenotazione.ZONE
: la zona in cui si trova la prenotazione.
Per eliminare la prenotazione dopo un determinato periodo di tempo, utilizza il comando
gcloud beta compute reservations update
con il flag--delete-after-duration
.gcloud beta compute reservations update RESERVATION_NAME \ --delete-after-duration=DELETE_AFTER_DURATION \ --project=PROJECT_ID \ --zone=ZONE
Sostituisci quanto segue:
RESERVATION_NAME
: il nome di una prenotazione esistente.DELETE_AFTER_DURATION
: una durata espressa in giorni, ore, minuti o secondi prima che la prenotazione venga eliminata automaticamente. Ad esempio, specifica30m
per 30 minuti o1d2h3m4s
per 1 giorno, 2 ore, 3 minuti e 4 secondi.PROJECT_ID
: l'ID del progetto in cui si trova la prenotazione.ZONE
: la zona in cui si trova la prenotazione.
RESERVATION_NAME
: il nome di una prenotazione esistente.PROJECT_ID
: l'ID del progetto in cui si trova la prenotazione.ZONE
: la zona in cui si trova la prenotazione.Per eliminare la prenotazione in una data e un'ora specifiche, effettua una richiesta
PATCH
al metodobeta.reservations.update
con il parametro di querypaths
impostato sudeleteAtTime
.PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAtTime { "name": "RESERVATION_NAME", "deleteAtTime": "DELETE_AT_TIME" }
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto in cui si trova la prenotazione.ZONE
: la zona in cui si trova la prenotazione.RESERVATION_NAME
: il nome di una prenotazione esistente.DELETE_AT_TIME
: una data e un'ora formattate come timestamp RFC 3339, che deve essere come segue:YYYY-MM-DDTHH:MM:SSOFFSET
Sostituisci quanto segue:
YYYY-MM-DD
: una data formattata come giorno del mese a 4 cifre, a 2 cifre e mese a 2 cifre, separate da trattini (-
).HH:MM:SS
: un'ora formattata come ora a due cifre con formato di 24 ore, minuti a due cifre e secondi a due cifre, separati dai due punti (:
).OFFSET
: il fuso orario formattato come offset del Tempo coordinato universale (UTC). Ad esempio, per utilizzare il fuso orario PST (Pacific Standard Time), specifica-08:00
. In alternativa, per non usare alcun offset, specificaZ
.
Per eliminare la prenotazione dopo una durata specifica, effettua una richiesta
PATCH
al metodobeta.reservations.update
con il parametro di querypaths
impostato sudeleteAfterDuration
.PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAfterDuration { "name": "RESERVATION_NAME", "deleteAfterDuration": { "seconds": "DELETE_AFTER_DURATION" } }
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto in cui si trova la prenotazione.ZONE
: la zona in cui si trova la prenotazione.RESERVATION_NAME
: il nome di una prenotazione esistente.DELETE_AFTER_DURATION
: durata in secondi che precede l'eliminazione automatica della prenotazione. Ad esempio, specifica86400
per 86.400 secondi (1 giorno).
PROJECT_ID
: l'ID del progetto in cui si trova la prenotazione.ZONE
: la zona in cui si trova la prenotazione.RESERVATION_NAME
: il nome di una prenotazione esistente.Nella console Google Cloud, vai alla pagina Prenotazioni.
Nella colonna Nome, fai clic sul nome della prenotazione che vuoi descrivere.
Si apre la pagina dei dettagli della prenotazione.
Fai clic su
Modifica.Nella sezione Progetti selezionati, esegui una delle seguenti operazioni:
Per interrompere la condivisione della prenotazione con un progetto consumer specifico, fai clic su
Elimina.Per iniziare a condividere la prenotazione con uno o più progetti specifici:
Fai clic su
Aggiungi progetti.Seleziona la casella di controllo per ogni progetto dell'organizzazione del progetto proprietario con cui vuoi condividere la prenotazione.
Fai clic su Seleziona.
Per confermare le modifiche, fai clic su Salva.
La modifica della prenotazione potrebbe richiedere alcuni secondi.
Per consentire a uno o più progetti di utilizzare una prenotazione condivisa, utilizza il comando
gcloud compute reservations update
con il flag--add-share-with
.gcloud compute reservations update RESERVATION_NAME \ --project=PROJECT_ID \ --add-share-with=CONSUMER_PROJECT_IDS \ --zone=ZONE
Sostituisci quanto segue:
RESERVATION_NAME
: il nome di una prenotazione condivisa esistente.PROJECT_ID
: l'ID del progetto proprietario, ovvero il progetto utilizzato per creare la prenotazione condivisa.CONSUMER_PROJECT_IDS
: un elenco separato da virgole di ID di progetti con cui condividere la prenotazione. Ad esempio, specificaproject-1,project-2
.ZONE
: la zona in cui si trova la prenotazione condivisa.
Per non consentire più a uno o più progetti di utilizzare una prenotazione condivisa, utilizza il comando
gcloud compute reservations update
con il flag--remove-share-with
.gcloud compute reservations update RESERVATION_NAME \ --project=PROJECT_ID \ --remove-share-with=CONSUMER_PROJECT_IDS \ --zone=ZONE
Sostituisci quanto segue:
RESERVATION_NAME
: il nome di una prenotazione condivisa esistente.PROJECT_ID
: l'ID del progetto proprietario, ovvero il progetto utilizzato per creare la prenotazione condivisa.CONSUMER_PROJECT_IDS
: un elenco separato da virgole di ID di progetti con cui vuoi interrompere la condivisione della prenotazione. Ad esempio, specificaproject-1,project-2
.ZONE
: la zona in cui si trova la prenotazione condivisa.
Per sostituire l'elenco dei progetti che possono utilizzare una prenotazione condivisa, utilizza il comando
gcloud beta compute reservations update
con il flag--share-with
.gcloud beta compute reservations update RESERVATION_NAME \ --project=PROJECT_ID \ --share-with=CONSUMER_PROJECT_IDS \ --zone=ZONE
Sostituisci quanto segue:
RESERVATION_NAME
: il nome di una prenotazione condivisa esistente.PROJECT_ID
: l'ID del progetto proprietario, ovvero il progetto utilizzato per creare la prenotazione condivisa.ZONE
: la zona in cui si trova la prenotazione condivisa.CONSUMER_PROJECT_IDS
: un elenco separato da virgole di ID di progetti con cui condividere la prenotazione. Ad esempio, specificaproject-1,project-2
.
Per consentire a uno o più progetti di utilizzare una prenotazione condivisa, effettua una richiesta
PATCH
al metodoreservations.update
. Nell'URL della richiesta, includi il parametro di querypaths=shareSettings.projectMap.PROJECT_ID
per ogni progetto con cui vuoi condividere la prenotazione.Ad esempio, per consentire a due progetti di utilizzare una prenotazione condivisa, effettua la seguente richiesta
PATCH
:PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.projectMap.CONSUMER_PROJECT_ID_1&paths=shareSettings.projectMap.CONSUMER_PROJECT_ID_2 { "name": "RESERVATION_NAME", "shareSetting": { "projectMap": { "CONSUMER_PROJECT_ID_1": { "projectId": "CONSUMER_PROJECT_ID_1" }, "CONSUMER_PROJECT_ID_2": { "projectId": "CONSUMER_PROJECT_ID_2" } } } }
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto proprietario, ovvero il progetto utilizzato per creare la prenotazione condivisa.ZONE
: la zona in cui si trova la prenotazione condivisa.RESERVATION_NAME
: il nome di una prenotazione condivisa esistente.CONSUMER_PROJECT_ID_1
eCONSUMER_PROJECT_ID_2
: gli ID di due progetti con cui vuoi condividere la prenotazione.
Per non consentire più a uno o più progetti di utilizzare una prenotazione condivisa, effettua una richiesta
PATCH
al metodoreservations.update
. Nell'URL della richiesta, includi il parametro di querypaths=shareSettings.projectMap.PROJECT_ID
per ogni progetto con cui vuoi interrompere la condivisione della prenotazione. Inoltre, devi omettere il camposhareSetting
dal corpo della richiesta.Ad esempio, per non consentire più a due progetti di utilizzare una prenotazione condivisa, effettua la seguente richiesta
PATCH
:PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.projectMap.CONSUMER_PROJECT_ID_1&paths=shareSettings.projectMap.CONSUMER_PROJECT_ID_2 { "name": "RESERVATION_NAME" }
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto proprietario, ovvero il progetto utilizzato per creare la prenotazione condivisa.ZONE
: la zona in cui si trova la prenotazione condivisa.RESERVATION_NAME
: il nome di una prenotazione condivisa esistente.CONSUMER_PROJECT_ID_1
eCONSUMER_PROJECT_ID_2
: gli ID di due progetti con cui vuoi interrompere la condivisione della prenotazione.
Se vuoi aumentare il numero di VM prenotate in una prenotazione, si applicano le seguenti limitazioni:
Devono essere presenti risorse sufficienti nella zona in cui si trova la prenotazione.
Devi disporre di una quota sufficiente per le risorse aggiuntive che stai prenotando.
Se il tipo di consumo della prenotazione è specifico e vuoi ridurre il numero di VM prenotate nella prenotazione, assicurati che il numero di VM che utilizzano la prenotazione non superi le dimensioni della prenotazione che preferisci. Puoi farlo utilizzando i seguenti metodi:
In caso contrario, si verificano errori.
Nella console Google Cloud, vai alla pagina Prenotazioni.
Nella colonna Nome, fai clic sul nome della prenotazione che vuoi modificare.
Si apre la pagina dei dettagli della prenotazione.
Fai clic su
Modifica.Nel campo Numero di istanze VM, inserisci il numero aggiornato di VM da prenotare.
Per confermare, fai clic su Salva.
La modifica della prenotazione potrebbe richiedere alcuni secondi.
RESERVATION_NAME
: il nome di una prenotazione esistente.PROJECT_ID
: l'ID del progetto in cui si trova la prenotazione.NUMBER_OF_VMS
: il nuovo numero di VM da prenotare.ZONE
: la zona in cui si trova la prenotazione.PROJECT_ID
: l'ID del progetto in cui si trova la prenotazione.ZONE
: la zona in cui si trova la prenotazione.RESERVATION_NAME
: il nome di una prenotazione esistente.NUMBER_OF_VMS
: il nuovo numero di VM da prenotare.Crea un nuovo single-project o una prenotazione condivisa con le proprietà aggiornate.
Se la prenotazione originale non ti serve più, elimina la prenotazione.
Scopri come visualizzare le prenotazioni.
Scopri come utilizzare le prenotazioni.
Scopri come eliminare le prenotazioni.
REST
Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, devi utilizzare le credenziali che fornisci a gcloud CLI.
Installa Google Cloud CLI, quindi initialize eseguendo questo comando:
gcloud init
Per maggiori informazioni, consulta Autenticazione per REST nella documentazione sull'autenticazione di Google Cloud.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per modificare le prenotazioni, chiedi all'amministratore di concederti il ruolo IAM Amministratore Compute (
roles/compute.admin
) per il progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.Questo ruolo predefinito contiene le autorizzazioni necessarie per modificare le prenotazioni. Per visualizzare le autorizzazioni esatte necessarie, espandi la sezione Autorizzazioni richieste:
Autorizzazioni obbligatorie
Per modificare le prenotazioni sono necessarie le seguenti autorizzazioni:
Potresti anche essere in grado di ottenere queste autorizzazioni con i ruoli personalizzati o altri ruoli predefiniti.
Modifica le prenotazioni
Per modificare direttamente una prenotazione esistente, puoi eseguire una o più delle seguenti operazioni:
Se vuoi modificare le proprietà non menzionate in questo elenco, consulta Modificare altre proprietà in una prenotazione in questo documento.
Modificare l'eliminazione automatica di una prenotazione
Puoi modificare il momento in cui Compute Engine elimina automaticamente una prenotazione esistente in uno dei seguenti modi:
Per modificare l'eliminazione automatica di una prenotazione, seleziona una delle seguenti opzioni:
Console
Per modificare l'eliminazione automatica di una prenotazione:
gcloud
Quando abiliti l'opzione di eliminazione automatica in una prenotazione, puoi specificare una data e un'ora in cui eliminare la prenotazione o specificare una durata trascorsa la quale deve essere eliminata.
Per abilitare l'opzione di eliminazione automatica o cambiare il momento in cui eliminare la prenotazione, esegui una delle seguenti operazioni:
Per disabilitare l'opzione di eliminazione automatica, utilizza il comando
gcloud beta compute reservations update
con il flag--disable-auto-delete
.gcloud beta compute reservations update RESERVATION_NAME \ --disable-auto-delete \ --project=PROJECT_ID \ --zone=ZONE
Sostituisci quanto segue:
REST
Quando abiliti l'opzione di eliminazione automatica in una prenotazione, puoi specificare una data e un'ora in cui eliminare la prenotazione o specificare una durata trascorsa la quale deve essere eliminata.
Per abilitare l'opzione di eliminazione automatica o cambiare il momento in cui eliminare la prenotazione, esegui una delle seguenti operazioni:
Per disabilitare l'opzione di eliminazione automatica, effettua una richiesta
PATCH
utilizzando il metodobeta.reservations.update
. Nella richiesta, specifica il parametro di querypaths=deleteAtTime&paths=deleteAfterDuration
e ometti il corpo della richiesta.PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAtTime&paths=deleteAfterDuration
Sostituisci quanto segue:
Modifica i progetti consumer in una prenotazione condivisa
Puoi consentire ai progetti di utilizzare una prenotazione condivisa solo se si trovano nella stessa organizzazione del progetto proprietario. Per scoprire come eseguire la migrazione di un progetto all'organizzazione del progetto del proprietario, consulta Migrazione di progetti tra risorse dell'organizzazione nella documentazione di Resource Manager.
Dopo aver modificato i progetti consumer che possono utilizzare una prenotazione condivisa, il consumo della prenotazione potrebbe cambiare. Ad esempio, qualsiasi progetto consumer rimosso smette di consumare risorse dalla prenotazione. Inoltre, se la prenotazione è stata configurata per essere utilizzata automaticamente da qualsiasi VM che corrisponde alle proprietà della prenotazione (comportamento predefinito), qualsiasi progetto consumer aggiunto potrebbe iniziare a utilizzare risorse della prenotazione. Se vuoi monitorare il consumo di una prenotazione, scopri come verificare l'utilizzo delle prenotazioni.
Per modificare i progetti consumer che possono utilizzare una prenotazione condivisa, seleziona una delle seguenti opzioni:
Console
Per modificare i progetti consumer per una prenotazione condivisa, segui questi passaggi:
gcloud
Quando modifichi i progetti consumer per una prenotazione condivisa, devi specificare un elenco separato da virgole di ID di progetti per cui vuoi consentire o interrompere l'utilizzo della prenotazione condivisa. Questi progetti devono trovarsi nella stessa organizzazione del progetto proprietario. Non specificare il progetto del proprietario nell'elenco. Per impostazione predefinita, è già consentito a utilizzare la prenotazione condivisa.
Per modificare i progetti consumer per una prenotazione condivisa, seleziona uno dei seguenti metodi:
REST
Quando modifichi i progetti consumer per una prenotazione condivisa, devi specificare gli ID dei progetti che vuoi consentire o non consentire più di utilizzare la prenotazione condivisa. Questi progetti devono trovarsi nella stessa organizzazione del progetto del proprietario. Non specificare il progetto del proprietario. Per impostazione predefinita, è già consentito a utilizzare la prenotazione condivisa.
Per modificare i progetti consumer per una prenotazione condivisa, seleziona uno dei seguenti metodi:
Modifica il numero di VM prenotate in una prenotazione
Puoi modificare una prenotazione esistente per aumentare o diminuire il numero di VM prenotate.
Prima di modificare il numero di VM prenotate in una prenotazione, assicurati di quanto segue:
Per modificare il numero di VM prenotate in una prenotazione, seleziona una delle seguenti opzioni:
Console
Per modificare il numero di VM prenotate in una prenotazione:
gcloud
Per modificare il numero di VM prenotate in una prenotazione, utilizza il comando
gcloud compute reservations update
.gcloud compute reservations update RESERVATION_NAME \ --project=PROJECT_ID \ --vm-count=NUMBER_OF_VMS \ --zone=ZONE
Sostituisci quanto segue:
REST
Per modificare il numero di VM prenotate in una prenotazione, effettua una richiesta
POST
al metodoreservations.resize
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/resize { "specificSkuCount": "NUMBER_OF_VMS" }
Sostituisci quanto segue:
Modificare altre proprietà in una prenotazione
Se vuoi modificare una proprietà non menzionata nella sezione Modifica prenotazioni, devi creare una prenotazione sostitutiva.
Per sostituire una prenotazione senza rischiare una riduzione involontaria della capacità prenotata:
Passaggi successivi
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 2024-05-31 UTC.
[{ "type": "thumb-down", "id": "hardToUnderstand", "label":"Hard to understand" },{ "type": "thumb-down", "id": "incorrectInformationOrSampleCode", "label":"Incorrect information or sample code" },{ "type": "thumb-down", "id": "missingTheInformationSamplesINeed", "label":"Missing the information/samples I need" },{ "type": "thumb-down", "id": "translationIssue", "label":"Problema di traduzione" },{ "type": "thumb-down", "id": "otherDown", "label":"Altra" }] [{ "type": "thumb-up", "id": "easyToUnderstand", "label":"Facile da capire" },{ "type": "thumb-up", "id": "solvedMyProblem", "label":"Il problema è stato risolto" },{ "type": "thumb-up", "id": "otherUp", "label":"Altra" }] -