Aggiorna le proprietà dell'istanza

---

Puoi utilizzare una singola richiesta da Google Cloud CLI o dall'API Compute Engine per aggiornare più proprietà dell'istanza e, facoltativamente, riavviare l'istanza, se necessario. Il metodo di aggiornamento gestisce la logica per la convalida delle proprietà dell'istanza aggiornate e garantisce che le risorse necessarie siano disponibili per completare l'aggiornamento. Se la richiesta include proprietà non valide o se le risorse richieste non sono disponibili, la richiesta restituisce un errore e non apporta modifiche all'istanza. In questo modo, l'istanza viene protetta dagli aggiornamenti parziali e dall'interruzione e non può accedere alle risorse per riavviare.

Prima di iniziare

• Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è la procedura mediante la quale la tua identità viene verificata per l'accesso alle API e ai servizi Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine 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. Install the Google Cloud CLI, then initialize it by running the following command:

     gcloud init

  2. Set a default region and zone.

  REST

  Per utilizzare gli esempi dell'API REST in questa pagina in un ambiente di sviluppo locale, utilizza le credenziali fornite a gcloud CLI.

  Install the Google Cloud CLI, then initialize it by running the following command:

  gcloud init

  Per ulteriori informazioni, consulta Eseguire l'autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.

Limitazioni

• Le richieste di aggiornamento delle istanze tramite gcloud CLI o l'API Compute Engine non supportano la semantica PATCH. La risorsa istanza nella richiesta di aggiornamento deve includere tutte le proprietà dell'istanza. Le proprietà mancanti nella configurazione dell'istanza nella richiesta di aggiornamento sono considerate eliminate dall'istanza.
• Puoi aggiornare solo un elenco specifico di proprietà.
• La modifica delle istanze verso e da proprietà esclusiva non è supportata.
• Puoi spostare un'istanza da una prenotazione all'altra, ma non puoi collegarla o scollegarla da una prenotazione utilizzando la procedura di aggiornamento.
• Se all'istanza è collegata un'unità SSD locale, non puoi aggiornare le proprietà che richiedono il riavvio dell'istanza. Devi eliminare e ricreare l'istanza. Assicurati di eseguire la migrazione dei dati critici dall'unità SSD locale a un disco permanente o a un'altra VM prima di eliminare la VM.
• Se un'istanza utilizza risorse disponibili solo nell'API Compute Engine beta, devi utilizzare la versione corretta del metodo instances.update per aggiornare queste proprietà. Ad esempio, se crei un'istanza utilizzando l'API Compute Engine beta e la configuri con una risorsa riconosciuta solo dall'API beta, devi utilizzare anche la versione beta del metodo instances.update per aggiornare queste risorse. La versione 1 del metodo instances.update non riconosce le risorse beta utilizzate dall'istanza, pertanto le elimina dalla configurazione dell'istanza durante il processo di aggiornamento. Questo si applica anche alle risorse nell'API alpha.

Autorizzazioni

Per aggiornare le istanze, devi disporre dell'autorizzazione compute.instances.update. Questa autorizzazione è inclusa in diversi ruoli IAM (Identity and Access Management) esistenti. Devi inoltre disporre dell'autorizzazione per utilizzare le risorse che vuoi modificare nell'istanza. Ad esempio, per aggiungere un disco a un'istanza, devi disporre delle seguenti autorizzazioni:

• L'autorizzazione compute.instances.update per l'istanza che vuoi aggiornare.
• L'autorizzazione compute.disks.use per un disco esistente ocompute.disks.create per un progetto in cui vuoi creare un nuovo disco.

Best practice

Per assicurarti che l'interfaccia di aggiornamento dell'istanza funzioni in modo ottimale, utilizza le seguenti best practice:

• Se possibile, utilizza sempre la stessa versione dell'API Compute Engine per creare, impostare e aggiornare le istanze. In questo modo, puoi aggiornare e modificare le risorse dell'istanza se sono disponibili solo in una versione dell'API.
• Sebbene sia possibile utilizzare il metodo instances.update per aggiornare le istanze in un gruppo di istanze gestite (MIG), per la maggior parte delle situazioni è meglio modificare il modello di istanza del gruppo e implementare l'aggiornamento nel MIG.

Proprietà che puoi aggiornare

Puoi modificare solo un insieme specifico di proprietà dell'istanza tramite il metodo update. Gli aggiornamenti di alcune proprietà richiedono il riavvio dell'istanza. Per evitare riavvii accidentali delle istanze, la richiesta deve definire quali azioni sono consentite sulle istanze. La richiesta può specificare una delle seguenti azioni:

• NO_EFFECT: la richiesta di aggiornamento verifica se la richiesta è valida e se le risorse sono disponibili, ma non esegue l'aggiornamento. Utilizzalo per testare i comandi senza avviare aggiornamenti effettivi.
• REFRESH: la richiesta di aggiornamento viene eseguita solo se le proprietà dell'istanza modificate non richiedono il riavvio dell'istanza. La richiesta restituisce un errore INFEASIBLE se è valida, ma è necessario un riavvio.
• RESTART: se l'aggiornamento richiede il riavvio dell'istanza, il sistema lo farà.

Proprietà che richiedono l'aggiornamento di RESTART:

• disks - Dischi di avvio
  • disks.deviceName - Tutti i dischi
• displayDevice
• enableNestedVirtualization
• guestAccelerators
• machineType
• minCpuPlatform
• networkPerformanceConfig
• performanceMonitoringUnit
• reservationAffinity
• resourcePolicies
• scheduling
• serviceAccounts
• shieldedInstanceConfig
• threadsPerCore
• visibleCoreCount

Proprietà che richiedono solo REFRESH per l'aggiornamento:

• canIpForward
• deletionProtection
• description
• disks - Proprietà dei dischi diversi da quello di avvio, escluso deviceName
• labels
• metadata
• nodeAffinities
• tags

Aggiorna le proprietà dell'istanza

Aggiorna le istanze seguendo questi passaggi:

1. Esporta le proprietà di configurazione dell'istanza esistenti.
2. Modifica le proprietà della configurazione dell'istanza.
3. Esegui una richiesta di test specificando NO_EFFECT come azione più invasiva. La risposta indica i campi non validi nella configurazione dell'istanza e l'azione richiesta per applicare le modifiche.
4. Se la configurazione è accettabile, richiedi un aggiornamento dell'istanza e specifica l'azione più invasiva accettabile per l'aggiornamento dell'istanza.

Il sistema avvia la procedura di aggiornamento solo se la tua richiesta soddisfa i seguenti requisiti:

• La proprietà fingerprint dell'istanza nella richiesta deve corrispondere a fingerprint dell'istanza che stai aggiornando. In questo modo, le richieste di aggiornamento simultanee nella stessa istanza non si sovrascrivono.
• Le proprietà nella richiesta di aggiornamento devono essere valide.
• Le risorse richieste devono essere disponibili.
• Se le proprietà nella richiesta richiedono il riavvio dell'istanza, la richiesta deve specificare RESTART come azione consentita.

Se i requisiti sono soddisfatti, il sistema avvia la procedura di aggiornamento dell'istanza. In caso contrario, il sistema non apporta modifiche all'istanza esistente o alla relativa configurazione.

Puoi avviare gli aggiornamenti utilizzando gcloud CLI o l'API Compute Engine.

Passaggi successivi

• Controlla lo stato dell'istanza.
• Scopri come prenotare risorse in una zona specifica.