Aggiorna proprietà istanza

---

Puoi utilizzare una singola richiesta Google Cloud CLI o il API Compute Engine per aggiornare più proprietà dell'istanza e, facoltativamente, se necessario, riavvia l'istanza. Il metodo di aggiornamento gestisce la logica convalidare le proprietà dell'istanza aggiornate e garantire che siano siano disponibili risorse 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. Questo protegge l'istanza da aggiornamenti parziali e da aggiornamenti è stato arrestato e non è in grado di accedere alle risorse per riavviarlo.

Prima di iniziare

• Se non l'hai ancora fatto, configura l'autenticazione. Autenticazione è Il processo di verifica dell'identità per l'accesso ai servizi e alle API di Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi eseguire l'autenticazione Compute Engine come segue.
  

  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 di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.

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

  gcloud init

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

Limitazioni

• Richieste di aggiornamento delle istanze tramite gcloud CLI l'API Compute Engine non supporta la semantica PATCH. La risorsa istanza nella richiesta di aggiornamento deve includere tutte le proprietà dell'istanza. Proprietà che non sono presenti 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 collegare o scollegare un'istanza da una prenotazione utilizzando la procedura di aggiornamento.
• Se all'istanza è collegato un SSD locale, non puoi aggiornare le proprietà che e richiede il riavvio dell'istanza. Devi eliminare e poi ricreare il cluster in esecuzione in un'istanza Compute Engine. Assicurati di eseguire la migrazione dei dati critici dall'SSD locale a un disco permanente o a un'altra VM prima l'eliminazione della VM.
• Se un'istanza utilizza risorse disponibili solo nella versione beta l'API Compute Engine, devi utilizzare la versione corretta instances.update metodo per aggiornare queste proprietà. Ad esempio, se creare un'istanza utilizzando l'API Compute Engine beta e configurare con una risorsa riconosciuta solo dall'API beta, devi anche utilizzare la versione beta del metodo instances.update per aggiornarli Google Cloud. La versione v1 del metodo instances.update non riconosce le risorse beta utilizzate dall'istanza, per cui vengono eliminate delle risorse della 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 avere le seguenti autorizzazioni:

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

Best practice

Per assicurarti che l'interfaccia di aggiornamento dell'istanza funzioni nel modo più efficace per te, segui queste best practice:

• Se possibile, utilizza sempre la stessa versione API Compute Engine per creare, impostare e aggiornare le istanze. Questo consente di aggiornare e modificare tutte 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, nella maggior parte delle situazioni è meglio modificare modello di istanza del gruppo implementare l'aggiornamento al gruppo di istanze gestite .

Proprietà che puoi aggiornare

Puoi modificare solo un insieme specifico di proprietà dell'istanza tramite l'aggiornamento . 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 tua richiesta può specificare una delle seguenti azioni:

• NO_EFFECT: la richiesta di aggiornamento verifica che sia valida e se le risorse sono disponibili, ma non esegue l'aggiornamento. Usa questa per testare i comandi senza avviare alcun aggiornamento effettivo.
• REFRESH: la richiesta di aggiornamento viene eseguita solo se l'istanza modificata non richiedono il riavvio dell'istanza. La richiesta restituisce un INFEASIBLE errore se la richiesta è valida, ma è necessario un riavvio.
• RESTART: se l'aggiornamento richiede il riavvio dell'istanza, il sistema e riavviare l'istanza.

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à del disco non di avvio, deviceName escluso
• labels
• metadata
• nodeAffinities
• tags

Aggiorna proprietà istanza

Aggiorna le istanze seguendo questa procedura:

1. Esporta le proprietà di configurazione dell'istanza esistente.
2. Modifica le proprietà della configurazione dell'istanza.
3. Esegui una richiesta di test specificando NO_EFFECT come l'azione più invasiva. La risposta indica campi non validi nella configurazione dell'istanza e indica 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 il processo di aggiornamento solo se la tua richiesta soddisfa quanto segue requisiti:

• La proprietà dell'istanza fingerprint nella richiesta deve corrispondere alla fingerprint dell'istanza che stai aggiornando. In questo modo di sovrascrivere più richieste di aggiornamento simultanee sulla stessa istanza tra loro.
• Le proprietà nella richiesta di aggiornamento devono essere valide.
• Le risorse richieste devono essere disponibili.
• Se le proprietà nella tua richiesta richiedono il riavvio dell'istanza, la richiesta deve specificare RESTART come azione consentita.

Se i requisiti sono soddisfatti, il sistema avvia il processo di aggiornamento dell'istanza. In caso contrario, il sistema non apporta modifiche all'istanza esistente o ai suoi configurazione.

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

Passaggi successivi

• Controlla lo spazio di archiviazione stato.
• Scopri come prenotare risorse in una zona specifica.