

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Sostituisci le istanze nel tuo gruppo Auto Scaling
<a name="ec2-auto-scaling-group-replacing-instances"></a>

Amazon EC2 Auto Scaling offre funzionalità che consentono di sostituire le istanze Amazon EC2 nel gruppo Auto Scaling dopo aver effettuato aggiornamenti, ad esempio l'aggiunta di un nuovo modello di lancio con una nuova Amazon Machine Image (AMI) o l'aggiunta di nuovi tipi di istanze. Inoltre, ti aiuta a semplificare gli aggiornamenti dandoti la possibilità di includerli nella stessa operazione che sostituisce le istanze.

In questa sezione sono incluse informazioni che consentono di completare le seguenti operazioni:
+ Avviare un aggiornamento istanza per sostituire le istanze nel gruppo con dimensionamento automatico.
+ Dichiarare aggiornamenti specifici che descrivono una configurazione desiderata e aggiornare il gruppo con scalabilità automatica alla configurazione desiderata.
+ Saltare la sostituzione delle istanze già aggiornate.
+ Utilizza i checkpoint per aggiornare le istanze in fasi ed eseguire verifiche sulle istanze in punti specifici. 
+ Usa il tempo di cottura per fare una pausa alla fine di un aggiornamento dell'istanza per convalidare lo stato dell'istanza.
+ Ricevere notifiche via e-mail quando viene raggiunto un punto di controllo.
+ Usare un rollback per ripristinare il gruppo con scalabilità automatica alla configurazione utilizzata in precedenza.
+ Effettua automaticamente il rollback se l'aggiornamento dell'istanza fallisce per qualche motivo o se gli CloudWatch allarmi Amazon specificati entrano nello `ALARM` stato.
+ Limitare la durata delle istanze per fornire versioni software coerenti e configurazioni delle istanze nel gruppo con scalabilità automatica.
+ Sostituisci i volumi root senza terminare le istanze mantenendo le interfacce di rete, i volumi non root e le policy IAM.

**Topics**
+ [Aggiornamento istanza](asg-instance-refresh.md)
+ [Durata massima dell'istanza](asg-max-instance-lifetime.md)

# Usa un aggiornamento dell'istanza per aggiornare le istanze in un gruppo di Auto Scaling
<a name="asg-instance-refresh"></a>

È possibile utilizzare un aggiornamento dell'istanza per aggiornare le istanze nel gruppo Auto Scaling. Questa funzionalità può essere utile quando una modifica alla configurazione richiede la sostituzione delle istanze o dei relativi volumi root, specialmente se il gruppo Auto Scaling contiene un gran numero di istanze. 

Alcune situazioni in cui un aggiornamento dell'istanza può essere utile includono:
+ Implementazione di una nuova Amazon Machine Image (AMI) o di uno script di dati utente nel tuo gruppo di Auto Scaling. Puoi creare un nuovo modello di lancio con le modifiche e quindi utilizzare un aggiornamento dell'istanza per implementare immediatamente gli aggiornamenti.
+ Migrazione delle istanze verso nuovi tipi di istanze per sfruttare i miglioramenti e le ottimizzazioni più recenti.
+ Passaggio dai gruppi di Auto Scaling dall'utilizzo di una configurazione di avvio all'utilizzo di un modello di avvio. Puoi copiare le configurazioni di avvio nei modelli di avvio e quindi utilizzare un aggiornamento dell'istanza per aggiornare le istanze ai nuovi modelli. Per ulteriori informazioni sulla migrazione dei modelli di avvio, consulta [Migra i tuoi gruppi di Auto Scaling ai modelli di avvio](migrate-to-launch-templates.md).
+ Applica patch di sicurezza o aggiornamenti software preservando lo stato dell'istanza a lunga durata ed evitando i vincoli di capacità con tipi di istanze specializzati come GPU o istanze Mac.

**Topics**
+ [Come funziona l'aggiornamento di un'istanza](instance-refresh-overview.md)
+ [Informazioni sui valori predefiniti](understand-instance-refresh-default-values.md)
+ [Avvio dell’aggiornamento di un’istanza](start-instance-refresh.md)
+ [Monitora l'aggiornamento di un'istanza](check-status-instance-refresh.md)
+ [Sostituisci i volumi root](replace-root-volume.md)
+ [Annullamento dell'aggiornamento di un'istanza](cancel-instance-refresh.md)
+ [Annullamento delle modifiche tramite un rollback](instance-refresh-rollback.md)
+ [Utilizzo dell'opzione Ignora la corrispondenza](asg-instance-refresh-skip-matching.md)
+ [Aggiunta di checkpoint](asg-adding-checkpoints-instance-refresh.md)

# Come funziona l'aggiornamento di un'istanza in un gruppo di Auto Scaling
<a name="instance-refresh-overview"></a>

Questo argomento descrive come funziona l'aggiornamento di un'istanza e introduce i concetti chiave da comprendere per utilizzarlo in modo efficace.

**Topics**
+ [Come funziona](#instance-refresh-how-it-works)
+ [Concetti principali](#instance-refresh-core-concepts)
+ [Periodo di tolleranza dei controlli dell’integrità](#instance-refresh-health-check-grace-period)
+ [Compatibilità del tipo di istanza](#instance-type-compatibility)
+ [Limitazioni](#instance-refresh-limitations)

## Come funziona
<a name="instance-refresh-how-it-works"></a>

Per aggiornare le istanze in un gruppo Auto Scaling, puoi definire una nuova configurazione che contenga la versione più recente dell'applicazione e tutti gli altri aggiornamenti che desideri apportare. 

L'aggiornamento delle istanze supporta due strategie per l'aggiornamento delle istanze:
+ **Strategia a rotazione (impostazione predefinita)**: termina le istanze e ne avvia di nuove in batch in base alle preferenze dell'utente. Ciò garantisce che il gruppo Auto Scaling mantenga la capacità e la disponibilità desiderate durante tutto il processo di aggiornamento.
+ **Strategia di sostituzione del volume root**: aggiorna le istanze sostituendo solo il volume root senza terminare l'istanza. In questo modo vengono preservate le interfacce di rete delle istanze, i volumi EBS non root e i dati dell'archivio delle istanze.

Requisiti per la strategia Replace Root Volume:
+ Il gruppo Auto Scaling deve utilizzare una politica a istanze miste
+ Tutte le sostituzioni nella politica relativa alle istanze miste devono specificare un `ImageId` 
+ AMIs deve contenere un solo volume radice
+ Tutte le istanze devono corrispondere alla configurazione del modello di lancio del gruppo
+ È necessario avviare l'aggiornamento dell'istanza con la configurazione desiderata con una politica per istanze miste contenente le sostituzioni. `ImageId`

Quando l'opzione Skip Matching è abilitata, Auto Scaling confronta l'ID AMI corrente di ogni istanza con l' IDs AMI nella configurazione desiderata. Sostituisce solo le istanze in cui l'AMI IDs non corrisponde, consentendoti di saltare le istanze già aggiornate.

### Esegui un aggiornamento dell'istanza
<a name="instance-refresh-process"></a>

Avvia un aggiornamento dell'istanza per sostituire le istanze esistenti con nuove in base a quella configurazione.

1. Crea un nuovo modello di lancio o aggiorna il modello esistente con le modifiche di configurazione desiderate, ad esempio una nuova Amazon Machine Image (AMI). Per ulteriori informazioni, consulta [Creare un modello di avvio per un gruppo con dimensionamento automatico](create-launch-template.md).

1. Avvia l'aggiornamento dell'istanza utilizzando la console AWS CLI Amazon EC2 Auto Scaling o l'SDK:
   + Specificate il nuovo modello di lancio o la nuova versione del modello di lancio che avete creato. Verrà utilizzato per avviare nuove istanze.
   + Imposta la percentuale di salute minima e massima preferita. Questo controlla quante istanze vengono sostituite contemporaneamente e se vengono lanciate nuove istanze prima di terminare quelle vecchie. 
   + Configura tutte le impostazioni opzionali, ad esempio:
     + **Checkpoint**: sospende l'aggiornamento dell'istanza dopo una certa percentuale di sostituzioni per verificare l'avanzamento.
     + **Tempo di cottura**: metti in pausa alla fine dell'aggiornamento dell'istanza per convalidare lo stato dell'istanza prima che l'aggiornamento sia considerato completo.
     + **Ignora la corrispondenza**: confronta le vecchie istanze con la nuova configurazione e sostituisci solo quelle che non corrispondono. Quando avvii l'aggiornamento di un'istanza dalla console, l'opzione Skip Matching è attiva per impostazione predefinita.
     + **Tipi di istanze multiple**: applica una [politica per le istanze miste](ec2-auto-scaling-mixed-instances-groups.md) nuova o aggiornata come parte della configurazione desiderata.

Una volta avviato l'aggiornamento dell'istanza, Amazon EC2 Auto Scaling:
+ Sostituisci le istanze in batch in base alle percentuali di integrità minima e massima. 
+ Avvia le nuove istanze prima di terminare quelle vecchie se la percentuale minima di integrità è impostata al 100%. Ciò garantisce che la capacità desiderata venga mantenuta in ogni momento.
+ Controlla lo stato di salute delle istanze e concedi loro il tempo di riscaldarsi prima che vengano sostituite altre istanze. 
+ Termina e sostituisci le istanze che risultano non integre.
+ Aggiorna automaticamente le impostazioni del gruppo Auto Scaling con le nuove modifiche alla configurazione dopo il completamento dell'aggiornamento dell'istanza.
+ Sostituisci `InService` le istanze prima delle istanze che si trovano in un pool caldo.

Il seguente diagramma di flusso illustra il comportamento dell'avvio prima del termine quando si imposta la percentuale minima di integrità al 100%. 

![\[Un diagramma che mostra come funziona l'aggiornamento dell'istanza quando la percentuale minima di integrità è impostata al 100%.\]](http://docs.aws.amazon.com/it_it/autoscaling/ec2/userguide/images/instance-refresh-high-level-flowchart-diagram.png)


**Nota**  
Le percentuali di integrità minima e massima per l'aggiornamento di un'istanza devono essere specificate solo se non è stata impostata una politica di manutenzione dell'istanza o se è necessario sostituire la politica esistente. Per ulteriori informazioni, consulta [Policy di manutenzione delle istanze](ec2-auto-scaling-instance-maintenance-policy.md).  
Analogamente, è necessario specificare il periodo di riscaldamento dell'istanza per un aggiornamento dell'istanza solo se non è stato abilitato il riscaldamento predefinito o se è necessario sovrascrivere l'impostazione predefinita. Per ulteriori informazioni, consulta [Impostazione della preparazione di default dell'istanza per un gruppo con scalabilità automatica](ec2-auto-scaling-default-instance-warmup.md).

## Concetti principali
<a name="instance-refresh-core-concepts"></a>

Prima di iniziare, acquisisci familiarità con i concetti principali di base dell'aggiornamento delle istanze, riportati di seguito:

**Percentuale minima di integrità**  
La *percentuale minima di integrità* è la percentuale della capacità desiderata da mantenere in servizio, integra e pronta all'uso durante l'aggiornamento dell'istanza in modo che l'aggiornamento possa continuare. Ad esempio, se la percentuale minima di integrità è del 90% e la percentuale di integrità massima è del 100%, la percentuale di capacità che verrà sostituita sarà del 10%. Se le nuove istanze non superano i controlli dell'integrità, Dimensionamento automatico Amazon EC2 le termina e le sostituisce. Se l’aggiornamento dell’istanza non riesce ad avviare istanze integre, esso avrà esito negativo, lasciando intatto il restante 90% del gruppo. Se le nuove istanze rimangono integre e terminano il periodo di riscaldamento, Amazon EC2 Auto Scaling può continuare a sostituire altre istanze.  
L'aggiornamento di un'istanza può sostituire le istanze una alla volta, più alla volta o tutte contemporaneamente. Per sostituire un'istanza alla volta, imposta la percentuale minima e massima di integrità al 100%. Ciò modifica il comportamento dell'aggiornamento dell'istanza da avviare prima del termine, il che impedisce alla capacità del gruppo di scendere al di sotto del 100% della capacità desiderata. Per sostituire tutte le istanze contemporaneamente, imposta tale percentuale allo 0%. 

**Percentuale massima di integrità**  
La *percentuale massima integra* è la percentuale della capacità desiderata che il gruppo con dimensionamento automatico può raggiungere quando si sostituiscono le istanze. La differenza tra il valore minimo e massimo non può essere maggiore di 100. Un intervallo più ampio aumenta il numero di istanze che possono essere sostituite contemporaneamente.

**Preparazione dell'istanza**  
La *preparazione dell'istanza* è il periodo di tempo da quando lo stato di una nuova istanza cambia in `InService` fino a quando la sua inizializzazione è considerata terminata. Dopo aver determinato che un'istanza appena avviata è integra, se le istanze superano i controlli dell'integrità, Dimensionamento automatico Amazon EC2 non passa immediatamente alla sostituzione successiva. Attende il periodo di riscaldamento prima di passare alla sostituzione dell'istanza successiva. Questo può essere utile quando l'applicazione necessita ancora di un po' di tempo di inizializzazione prima di rispondere alle richieste.  
Il funzionamento è identico alla preparazione dell'istanza predefinita. Pertanto, valgono le stesse considerazioni sul dimensionamento. Per ulteriori informazioni, consulta [Impostazione della preparazione di default dell'istanza per un gruppo con scalabilità automatica](ec2-auto-scaling-default-instance-warmup.md).

**Configurazione desiderata**  
La *configurazione desiderata* è la nuova configurazione che desideri che Dimensionamento automatico Amazon EC2 implementi nel tuo gruppo con scalabilità automatica. Ad esempio, puoi specificare un nuovo modello di avvio e nuovi tipi di istanza per le istanze. Durante un aggiornamento delle istanze, Amazon EC2 Auto Scaling aggiorna il gruppo con scalabilità automatica alla configurazione desiderata. Se durante l'aggiornamento delle istanze si verifica un evento di aumento orizzontale, Amazon EC2 Auto Scaling avvia nuove istanze con la configurazione desiderata, anziché le impostazioni correnti del gruppo. Dopo aver completato l'aggiornamento delle istanze, Dimensionamento automatico Amazon EC2 aggiorna le impostazioni del gruppo con scalabilità automatica in modo da riflettere la nuova configurazione desiderata specificata nell'ambito dell'aggiornamento. 

**Salta corrispondenza**  
Ignora la corrispondenza indica ad Amazon EC2 Auto Scaling di ignorare le istanze che dispongono già degli aggiornamenti più recenti, in modo da non sostituire più istanze del necessario. Questa opzione è utile quando si desidera assicurarsi che il gruppo con scalabilità automatica utilizzi una particolare versione del modello di avvio e sostituisca solo le istanze che non la utilizzano.

**Punti di controllo**  
Un *punto di controllo* è un punto nel tempo in cui l'aggiornamento dell'istanza si interrompe per un periodo di tempo specificato. Un aggiornamento delle istanze può avere più punti di controllo. Amazon EC2 Auto Scaling emette eventi per ogni punto di controllo. Pertanto, puoi aggiungere una EventBridge regola per inviare gli eventi a una destinazione, come Amazon SNS, per ricevere una notifica quando viene raggiunto un checkpoint. Dopo aver raggiunto un punto di controllo, è possibile verificare l'implementazione. Se vengono identificati problemi, è possibile annullare l'aggiornamento delle istanze o eseguirne il rollback. La possibilità di implementare gli aggiornamenti in fasi è un vantaggio fondamentale dei punti di controllo. Se non si utilizzano i punti di controllo, le sostituzioni a rotazione vengono eseguite in modo continuo.

Per ulteriori informazioni su tutte le impostazioni predefinite che puoi configurare all'avvio di un aggiornamento dell'istanza, consulta [Informazioni sui valori predefiniti per l'aggiornamento di un'istanza](understand-instance-refresh-default-values.md).

## Periodo di tolleranza dei controlli dell’integrità
<a name="instance-refresh-health-check-grace-period"></a>

Dimensionamento automatico Amazon EC2 determina se un'istanza è integra in base allo stato dei controlli dell'integrità utilizzati dal gruppo con dimensionamento automatico. Per ulteriori informazioni, consulta [Controlli dell'integrità per le istanze in un gruppo con dimensionamento automatico](ec2-auto-scaling-health-checks.md). 

Per assicurarsi che questi controlli dell'integrità vengano avviati il prima possibile, non impostare un periodo di tolleranza del controllo dell'integrità del gruppo troppo alto, ma abbastanza alto da consentire ai controlli dell'integrità di Elastic Load Balancing di determinare se una destinazione è disponibile per gestire le richieste. Per ulteriori informazioni, consulta [Impostazione del periodo di tolleranza del controllo dell'integrità per un gruppo con scalabilità automatica](health-check-grace-period.md).

## Compatibilità del tipo di istanza
<a name="instance-type-compatibility"></a>

Prima di modificare il tipo di istanza, è consigliabile verificarne il funzionamento con il modello di avvio. Questa operazione consente di confermare la compatibilità con l'AMI specificata. Ad esempio, se sono state avviate le istanze originali da un'AMI paravirtuale (PV) ma si desidera passare a un tipo di istanza di generazione corrente supportato solo da un'AMI di una macchina virtuale hardware (HVM), è necessario utilizzare un'AMI HVM nel modello di avvio. 

Per verificare la compatibilità del tipo di istanza senza avviare le istanze, utilizza il comando [run-instances](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/run-instances.html) con l'opzione `--dry-run`, come mostrato nell'esempio seguente.

```
aws ec2 run-instances --launch-template LaunchTemplateName=my-template,Version='1' --dry-run
```

Per informazioni su come viene determinata la compatibilità, consulta [Compatibilità per la modifica del tipo di istanza](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/resize-limitations.html) nella Guida per l'*utente di Amazon EC2*.

## Limitazioni
<a name="instance-refresh-limitations"></a>
+ **Durata totale**: il periodo di tempo massimo in cui un aggiornamento dell'istanza può continuare a sostituire attivamente le istanze è di 14 giorni. 
+ **Differenza di comportamento specifica dei gruppi ponderati**: se un gruppo di istanze miste è configurato con un peso dell'istanza maggiore o uguale alla capacità desiderata del gruppo, Amazon EC2 Auto Scaling potrebbe sostituire tutte le istanze contemporaneamente. `InService` Per evitare questa situazione, segui i suggerimenti riportati nell'argomento [Configurare un gruppo Auto Scaling per utilizzare i pesi delle istanze](ec2-auto-scaling-mixed-instances-groups-instance-weighting.md). Quando utilizzi pesi con il gruppo con scalabilità automatica, specifica una capacità desiderata maggiore del peso massimo.
+ **Timeout di un'ora**: quando l'aggiornamento di un'istanza non è in grado di continuare a effettuare sostituzioni perché è in attesa di sostituire le istanze in standby o protette dallo scalabilità in, oppure le nuove istanze non superano i controlli di integrità, Amazon EC2 Auto Scaling continua a riprovare per un'ora. Fornisce inoltre un messaggio di stato per aiutarti a risolvere il problema. Se trascorsa un'ora il problema persiste, l'operazione ha esito negativo. Lo scopo è lasciare tempo per il recupero in caso di problemi temporanei. 
+ **Distribuzione del codice tramite dati utente**: Skip matching non verifica le modifiche al codice distribuite da uno script di dati utente. Se utilizzi i dati utente per estrarre nuovo codice e installare questi aggiornamenti su nuove istanze, ti consigliamo di disattivare lo skip matching per assicurarti che tutte le istanze ricevano il codice più recente, anche senza un aggiornamento della versione del modello di lancio.
+ **Restrizione all'aggiornamento**: se si tenta di aggiornare il modello di avvio, la configurazione di avvio o la politica delle istanze miste di un gruppo di Auto Scaling mentre è attivo un aggiornamento dell'istanza con la configurazione desiderata, la richiesta avrà esito negativo con il seguente errore di convalida: `An active instance refresh with a desired configuration exists. All configuration options derived from the desired configuration are not available for update while the instance refresh is active.` 
+ Selezione dell'**istanza basata sugli attributi: se il gruppo Auto Scaling utilizza la selezione** dell'istanza basata sugli attributi (specificandola `InstanceRequirements` in una politica di istanze miste), i seguenti parametri di aggiornamento dell'istanza non sono supportati:
  + **SkipMatching**- L'aggiornamento dell'istanza avrà esito negativo se viene avviato con il `SkipMatching` parametro in un gruppo Auto Scaling configurato. `InstanceRequirements`
  + **DesiredConfiguration**- L'aggiornamento dell'istanza avrà esito negativo se viene avviato con il `DesiredConfiguration` parametro in un gruppo Auto Scaling configurato. `InstanceRequirements`

  Se è necessario eseguire un aggiornamento dell'istanza su un gruppo di Auto Scaling con selezione di istanze basata sugli attributi, avviate l'aggiornamento dell'istanza senza questi parametri.
+ La sostituzione del volume root non supporta Elastic Load Balancing.

# Informazioni sui valori predefiniti per l'aggiornamento di un'istanza
<a name="understand-instance-refresh-default-values"></a>

Prima di avviare l'aggiornamento di un'istanza, puoi personalizzare varie preferenze che influiscono sull'aggiornamento dell'istanza. Alcune impostazioni predefinite delle preferenze sono diverse a seconda che si utilizzi la console o la riga di comando (AWS CLI o AWS SDK).

La tabella seguente elenca i valori predefiniti per le impostazioni di aggiornamento dell'istanza.


| Impostazione | AWS CLI o SDK AWS  | Console dimensionamento automatico Amazon EC2 | 
| --- | --- | --- | 
| CloudWatch allarme | Disabilitato (null) | Disabilitato | 
| Rollback automatico | Disabilitato (false) | Disabilitato | 
| Tempo di cottura | Zero | Zero | 
| Punti di controllo | Disabilitato (false) | Disabilitato | 
| Ritardo del checkpoint | 1 ora (3600 secondi) | 1 ora | 
| Preparazione dell'istanza | La [preparazione dell'istanza di default](ec2-auto-scaling-default-instance-warmup.md), se definita, o in caso contrario il [periodo di tolleranza dei controlli dell'integrità](health-check-grace-period.md). | La [preparazione dell'istanza di default](ec2-auto-scaling-default-instance-warmup.md), se definita, o in caso contrario il [periodo di tolleranza dei controlli dell'integrità](health-check-grace-period.md). | 
| Percentuale massima di integrità | Varia in base alla policy di manutenzione dell'istanza. Se non esiste una policy di manutenzione dell'istanza, il valore predefinito è il 100% (nullo). | Varia in base alla policy di manutenzione dell'istanza. Se non esiste una policy di manutenzione dell'istanza, il valore predefinito è il 100% (nullo). | 
| Percentuale minima di integrità | Varia in base alla policy di manutenzione dell'istanza. Se non esiste una policy di manutenzione dell'istanza, il valore predefinito è il 90%. | Varia in base alla policy di manutenzione dell'istanza. Se non esiste una policy di manutenzione dell'istanza, il valore predefinito è il 90%. | 
| Istanze protette dalla riduzione orizzontale | Attendi | Ignorare | 
| Salta corrispondenza | Disabilitato (false) | Abilitato | 
| Istanze in standby | Attendi | Ignorare | 

Di seguito viene fornita una descrizione di ciascuna impostazione:

**CloudWatch allarme (`AlarmSpecification`)**  
Le specifiche CloudWatch dell'allarme. CloudWatch gli allarmi possono essere utilizzati per identificare eventuali problemi e fallire l'operazione se un allarme entra in `ALARM` stato. Per ulteriori informazioni, consulta [Avvio dell'aggiornamento di un'istanza con rollback automatico](instance-refresh-rollback.md#instance-refresh-using-auto-rollback). 

**Rollback automatico (`AutoRollback`)**  
Controlla se il Dimensionamento automatico Amazon EC2 esegue il rollback del gruppo con dimensionamento automatico alla configurazione precedente in caso di esito negativo dell'aggiornamento dell'istanza. Per ulteriori informazioni, consulta [Annulla le modifiche con un rollback manuale o automatico](instance-refresh-rollback.md). 

**Tempo di cottura () `BakeTime`**  
Il tempo di attesa alla fine di un aggiornamento dell'istanza prima che l'aggiornamento dell'istanza venga considerato completo.

**Checkpoint (`CheckpointPercentages`)**  
Controlla se Dimensionamento automatico Amazon EC2 sostituisce le istanze in fasi. È utile se devi eseguire verifiche sulle istanze prima di sostituirle tutte. Per ulteriori informazioni, consulta [Aggiungere punti di controllo a un aggiornamento delle istanze](asg-adding-checkpoints-instance-refresh.md). 

**Ritardo del checkpoint (`CheckpointDelay`)**  
Il tempo di attesa, espresso in secondi, necessario al raggiungimento di un checkpoint prima di continuare. Per ulteriori informazioni, consulta [Aggiungere punti di controllo a un aggiornamento delle istanze](asg-adding-checkpoints-instance-refresh.md). 

**Preparazione dell'istanza (`InstanceWarmup`)**  
Intervallo di tempo, espresso in secondi, durante il quale Dimensionamento automatico Amazon EC2 attende che una nuova istanza sia considerata terminata prima di passare alla sostituzione dell'istanza successiva. Se hai già definito correttamente una preparazione dell'istanza di default per il gruppo con scalabilità automatica, non devi modificare la preparazione dell'istanza, a meno che non desideri ignorare l'impostazione predefinita. Per ulteriori informazioni, consulta [Impostazione della preparazione di default dell'istanza per un gruppo con scalabilità automatica](ec2-auto-scaling-default-instance-warmup.md).

**Percentuale massima di integrità (`MaxHealthyPercentage`)**  
La percentuale della capacità desiderata che il gruppo con dimensionamento automatico può raggiungere quando si sostituiscono le istanze.

**Percentuale minima di integrità (`MinHealthyPercentage`)**  
La percentuale della capacità desiderata del gruppo con dimensionamento automatico che deve essere in servizio, integra e pronta all'uso prima che l'operazione possa continuare.

**Istanze protette dalla riduzione orizzontale (`ScaleInProtectedInstances`)**  
Determina il comportamento di Dimensionamento automatico Amazon EC2 nel caso in cui siano presenti istanze protette dalla riduzione orizzontale. Per ulteriori informazioni su tali istanze, consulta [Utilizza la protezione scalabile in base alle istanze per controllare la chiusura dell'istanza](ec2-auto-scaling-instance-protection.md).  
Dimensionamento automatico Amazon EC2 offre le seguenti opzioni:  
+ **Replace** (`Refresh`): sostituisce le istanze protette dallo scalabilità in.
+ **Ignore** (`Ignore`): ignora le istanze protette da scalabilità in e continua a sostituire le istanze non protette.
+ **Wait** (`Wait`): attende un'ora prima che l'utente rimuova la protezione scale-in. In caso contrario, l'aggiornamento dell'istanza ha esito negativo.

**Ignora la corrispondenza (`SkipMatching`)**  
Determina se Dimensionamento automatico Amazon EC2 ignora la sostituzione delle istanze che corrispondono alla configurazione desiderata. Se non viene specificata alcuna configurazione desiderata, viene ignorata la sostituzione delle istanze con lo stesso modello di avvio e gli stessi tipi di istanze utilizzati dal gruppo con scalabilità automatica prima dell'avvio dell'aggiornamento dell'istanza. Per ulteriori informazioni, consulta [Utilizzo di un aggiornamento dell'istanza con l'opzione Ignora la corrispondenza](asg-instance-refresh-skip-matching.md). 

**Istanze in standby (`StandbyInstances`)**  
Determina il comportamento di Dimensionamento automatico Amazon EC2 nel caso in cui siano presenti istanze con stato `Standby`. Per ulteriori informazioni su tali istanze, consulta [Rimuovere temporaneamente le istanze dal gruppo con scalabilità automatica](as-enter-exit-standby.md).  
Dimensionamento automatico Amazon EC2 offre le seguenti opzioni:  
+ **Terminate** (`Terminate`): termina le istanze presenti in. `Standby`
+ **Ignore** (`Ignore`): ignora le istanze presenti nello stato `Standby` e continua a sostituire le istanze che si trovano nello stato. `InService`
+ **Wait (`Wait`) — Attende** un'ora prima che l'utente restituisca le istanze al servizio. In caso contrario, l'aggiornamento dell'istanza ha esito negativo.

# Avvia un aggiornamento dell'istanza utilizzando o Console di gestione AWS AWS CLI
<a name="start-instance-refresh"></a>

**Importante**  
Puoi eseguire il rollback dell'aggiornamento di un'istanza in corso per annullare eventuali modifiche. Per poter utilizzare questa opzione, il gruppo con scalabilità automatica deve soddisfare i prerequisiti per l'utilizzo dei rollback prima di avviare l'aggiornamento dell'istanza. Per ulteriori informazioni, consulta [Annulla le modifiche con un rollback manuale o automatico](instance-refresh-rollback.md).

Le seguenti procedure consentono di avviare l'aggiornamento di un'istanza utilizzando o. Console di gestione AWS AWS CLI

## Avvio dell'aggiornamento di un'istanza (console)
<a name="start-instance-refresh-console"></a>

Se è la prima volta che avvii un aggiornamento delle istanze, utilizzare la console ti sarà utile per scoprire le caratteristiche e le opzioni disponibili.

### Avviare un aggiornamento delle istanze nella console (procedura di base)
<a name="starting-an-instance-refresh-in-the-console"></a>

Se non hai definito in precedenza una [policy di istanze miste](ec2-auto-scaling-mixed-instances-groups.md) per il gruppo con scalabilità automatica, utilizza la seguente procedura. Se in precedenza hai definito una policy di istanze miste, consulta [Avviare un aggiornamento delle istanze nella console (gruppo di istanze miste)](#starting-an-instance-refresh-in-the-console-mig) per avviare l'aggiornamento di un'istanza.

**Come avviare l'aggiornamento di un'istanza**

1. Apri la console Amazon EC2 all'indirizzo [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)e scegli **Auto Scaling** Groups dal pannello di navigazione.

1. Seleziona la casella di controllo accanto al gruppo con dimensionamento automatico.

   Si aprirà un riquadro diviso nella parte inferiore della pagina **Auto Scaling groups** (Gruppi Auto Scaling). 

1. Nella scheda **Aggiornamento istanza** in **Active instance refresh** (Aggiornamento attivo istanza), scegli **Start instance refresh** (Avvia aggiornamento istanza).

1. In **Impostazioni di disponibilità**, esegui la seguente operazione:

   1. Per il **metodo di sostituzione dell’istanza**:
      + Se *non hai* impostato una policy di manutenzione delle istanze nel gruppo con dimensionamento automatico, l'impostazione predefinita per il **metodo di sostituzione dell'istanza** è **Termina e avvia**. Questo è il comportamento predefinito precedente per l'aggiornamento di un'istanza.
      + Se imposti una policy di manutenzione dell'istanza nel gruppo con dimensionamento automatico, vengono forniti valori predefiniti per il **metodo di sostituzione dell'istanza**. Per sovrascrivere la policy di manutenzione dell'istanza, scegli **Sostituisci**. La sostituzione si applica solo all'aggiornamento dell'istanza corrente. Al successivo avvio di un aggiornamento dell'istanza, questi valori vengono ripristinati ai valori predefiniti della policy di manutenzione dell'istanza. 

      Nella procedura seguente viene descritto come aggiornare il metodo di sostituzione delle istanze.

      1. Seleziona uno dei seguenti metodi di sostituzione delle istanze:
         + **Avvio prima del termine**: è necessario eseguire il provisioning di una nuova istanza prima di poter chiudere un'istanza esistente. Si tratta di una buona scelta per le applicazioni che privilegiano la disponibilità rispetto al risparmio.
         + **Termina e avvia**: le nuove istanze vengono fornite contemporaneamente alla chiusura delle istanze esistenti. Si tratta di una buona scelta per le applicazioni che privilegiano il risparmio rispetto alla disponibilità. È anche una buona scelta per le applicazioni che non dovrebbero avviare una capacità superiore a quella attualmente disponibile.
         + **Comportamento personalizzato**: questa opzione consente di impostare un intervallo minimo e massimo personalizzato per la quantità di capacità che desideri rendere disponibile quando si sostituiscono le istanze. Questo approccio può aiutarti a raggiungere il giusto equilibrio tra costi e disponibilità.

      1. Per **Imposta una percentuale di integrità** adeguata, inserisci i valori per uno o entrambi i campi seguenti. I campi di attivazione variano a seconda dell'opzione scelta per il **metodo di sostituzione dell'istanza**. 
         + **Min**: imposta la percentuale minima di integrità necessaria per procedere con l’aggiornamento dell’istanza.
         + **Max**: imposta la percentuale massima di integrità possibile durante l’aggiornamento dell’istanza. 

      1. Espandi la sezione **Visualizza la capacità temporanea stimata durante le sostituzioni in base alla capacità desiderata** per confermare in che modo i valori di **Min** e **Max** si applicano al gruppo. I valori esatti utilizzati dipendono dal valore di capacità desiderato, che cambierà se il gruppo cresce.

      1. Espandi la sezione **Imposta il comportamento di fallback per le dimensioni sostitutive non valide**, quindi scegli se **Viola la percentuale massima di integrità** per dare priorità alla disponibilità o **Viola la percentuale minima di integrità**. 

         Non è consigliabile mantenere l'opzione **Viola la percentuale minima di integrità** predefinita per gruppi molto piccoli. Quando nel gruppo con dimensionamento automatico è presente una sola istanza, l'avvio di un aggiornamento delle istanze può causare un'interruzione.

         Questo passaggio configura il comportamento di fallback se utilizzi un gruppo con dimensionamento automatico che non dispone ancora di una policy di manutenzione dell'istanza. Questa opzione non è disponibile e non viene visualizzata quando il gruppo ha una policy di manutenzione delle istanze. Questa opzione è disponibile anche solo per il metodo di sostituzione **Termina e avvia**. Gli altri metodi di sostituzione violeranno la percentuale massima di integrità per dare priorità alla disponibilità.

   1. In **Preparazione dell'istanza**, inserisci il numero di secondi da quando lo stato di una nuova istanza cambia in `InService` a quando termina l’inizializzazione. Dimensionamento automatico Amazon EC2 attende il tempo prestabilito prima di passare alla sostituzione dell'istanza successiva. 

      Durante la preparazione, un'istanza appena avviata non viene conteggiata per i parametri aggregati dell'istanza del gruppo con scalabilità automatica (come `CPUUtilization`, `NetworkIn` e `NetworkOut`). Se sono state aggiunte policy di dimensionamento al gruppo con scalabilità automatica, le attività di dimensionamento vengono eseguite in parallelo. Se imposti un intervallo lungo per il periodo di aggiornamento dell'istanza, ci vorrà più tempo prima che le istanze appena lanciate vengano visualizzate nelle metriche. Pertanto, un periodo di riscaldamento adeguato impedisce ad Amazon EC2 Auto Scaling di scalare su dati metrici obsoleti.

      Se hai già definito correttamente una preparazione dell'istanza di default per il gruppo con scalabilità automatica, non devi modificare la preparazione dell'istanza. Puoi tuttavia impostare un valore per questa opzione se desideri sovrascrivere l'impostazione predefinita. Per ulteriori informazioni sull'impostazione della preparazione dell'istanza di default, consulta [Impostazione della preparazione di default dell'istanza per un gruppo con scalabilità automatica](ec2-auto-scaling-default-instance-warmup.md).

1. In **Impostazioni di aggiornamento**, esegui la seguente operazione:

   1. (Facoltativo) Per **Checkpoints** (Punti di controllo), scegli **Enable checkpoints** (Abilita punti di controllo) per sostituire le istanze utilizzando un approccio incrementale o graduale all'aggiornamento delle istanze. Ciò consente di avere tempo aggiuntivo per la verifica tra i set delle sostituzioni. Se scegli di non abilitare i punti di controllo, le istanze vengono sostituite in un'operazione quasi continua.

      Se abiliti i punti di controllo, consulta [Abilitazione dei punti di controllo (console)](enable-checkpoints-console-cli.md#enable-checkpoints-console) per ulteriori passaggi.

   1. (Facoltativo) Per **Bake time**, specifica il tempo di attesa alla fine dell'aggiornamento dell'istanza prima che l'aggiornamento dell'istanza sia considerato completo.

   1. Attiva o disattiva **Skip matching** (Salta corrispondenza):
      + Per ignorare la sostituzione delle istanze che corrispondono già al modello di avvio, mantieni selezionata la casella di controllo **Abilita Ignora la corrispondenza**.
      + Se disattivi l'opzione Salta corrispondenza deselezionando questa casella di controllo, tutte le istanze possono essere sostituite.

      Quando abiliti la funzione Ignora la corrispondenza, invece di utilizzare il modello esistente, puoi impostare un nuovo modello di avvio o una nuova versione del modello di avvio. Puoi eseguire questa operazione nella sezione **Configurazione desiderata** della pagina **Avvio dell'aggiornamento dell'istanza**. 
**Nota**  
Per utilizzare la funzionalità Salta corrispondenza per aggiornare un gruppo con scalabilità automatica che attualmente utilizza una configurazione di avvio, devi selezionare un modello di avvio in **Configurazione desiderata**. L'utilizzo della funzionalità Salta corrispondenza con una configurazione di avvio non è supportato.

   1. In **Istanze in standby**, scegli **Ignora**, **Termina** o **Attendi**. Ciò determina cosa succede se vengono individuate istanze il cui stato è `Standby`. Per ulteriori informazioni, consulta [Rimuovere temporaneamente le istanze dal gruppo con scalabilità automatica](as-enter-exit-standby.md).

      Se scegli **Attendi**, devi eseguire ulteriori operazioni per ripristinare l'utilizzo di queste istanze. In caso contrario, l’aggiornamento dell’istanza sostituisce tutte le istanze `InService` e attende un’ora. Nel caso in cui siano presenti ancora istanze in stato `Standby`, l’aggiornamento dell’istanza ha esito negativo. Per evitare questa situazione, scegli l'opzione **Ignora** o **Termina** per tali istanze. 

   1. In **Istanze protette dalla riduzione orizzontale**, scegli **Ignora**, **Sostituisci** o **Attendi**. Ciò determina cosa succede se vengono individuate istanze protette dalla riduzione orizzontale. Per ulteriori informazioni, consulta [Utilizza la protezione scalabile in base alle istanze per controllare la chiusura dell'istanza](ec2-auto-scaling-instance-protection.md).

      Se scegli **Attendi**, devi eseguire ulteriori operazioni per rimuovere la protezione dalla riduzione orizzontale da tali istanze. In caso contrario, l’aggiornamento dell’istanza sostituisce tutte le istanze non protette e attende un’ora. Nel caso in cui siano ancora presenti istanze protette dalla riduzione orizzontale, l’aggiornamento dell’istanza ha esito negativo. Per evitare questa situazione, scegli l’opzione **Ignora** o **Sostituisci** per tali istanze. 

1. (Facoltativo) Per gli **CloudWatch allarmi**, scegli **Abilita CloudWatch allarmi**, quindi scegli uno o più allarmi. CloudWatch gli allarmi possono essere utilizzati per identificare eventuali problemi e fallire l'operazione se un allarme entra in stato. `ALARM` Per ulteriori informazioni, consulta [Avvio dell'aggiornamento di un'istanza con rollback automatico](instance-refresh-rollback.md#instance-refresh-using-auto-rollback). 

1. (Facoltativo) Espandi la sezione **Configurazione desiderata** per specificare gli aggiornamenti che desideri apportare al gruppo con scalabilità automatica.

   Per questo passaggio, puoi scegliere di utilizzare la sintassi JSON o YAML per modificare i valori dei parametri anziché effettuare selezioni nell'interfaccia della console. Per farlo, scegli **Use code editor** (Usa editor di codice) e non **Use console interface** (Usa interfaccia console). La procedura seguente spiega come effettuare selezioni utilizzando l'interfaccia della console.

   1. Per **Update launch template** (Aggiornamento del modello di avvio): 
      + Se *non hai* creato un nuovo modello di avvio o una nuova versione del modello di avvio per il gruppo con scalabilità automatica, lascia questa casella di controllo deselezionata.
      + In caso contrario, selezionala. Quando selezioni questa opzione, Dimensionamento automatico Amazon EC2 mostra il modello di avvio corrente e la relativa versione ed elenca tutte le altre versioni disponibili. Scegli il modello di avvio e la versione. 

        Una volta scelta la versione, puoi visualizzare le relative informazioni. Questa è la versione del modello di avvio che verrà utilizzata per sostituire le istanze nell'ambito di un aggiornamento delle istanze. Se l'aggiornamento viene eseguito correttamente, questa versione del modello di avvio verrà utilizzata anche ogni volta che vengono avviate nuove istanze, ad esempio quando il gruppo viene dimensionato.

   1. Per **Choose a set of instance types and purchase options to override the instance type in the launch template** (Scelta di un set di tipi di istanza e opzioni di acquisto per sovrascrivere il tipo di istanza nel modello di avvio):
      + Non selezionare questa casella di controllo se vuoi utilizzare il tipo di istanza e l'opzione di acquisto specificati nel modello di avvio.
      + Seleziona questa casella di controllo se desideri sovrascrivere il tipo di istanza nel modello di avvio o eseguire istanze spot. Puoi aggiungere manualmente ogni tipo di istanza oppure scegliere un tipo di istanza principale e un'opzione di raccomandazione che recupera eventuali tipi di istanza corrispondenti aggiuntivi. Se prevedi di avviare istanze spot, ti consigliamo di aggiungere alcuni tipi di istanza diversi. In questo modo, Dimensionamento automatico Amazon EC2 può avviare un altro tipo di istanza se la capacità dell’istanza non è sufficiente nelle zone di disponibilità scelte. Per ulteriori informazioni, consulta [Gruppi Auto Scaling con più tipi di istanze e opzioni di acquisto](ec2-auto-scaling-mixed-instances-groups.md).
**avvertimento**  
Le istanze spot non devono essere utilizzate con applicazioni che non sono in grado di gestire un'eventuale interruzione dell'istanza che potrebbe verificarsi se il servizio Spot di Amazon EC2 deve recuperare capacità.

      Se selezioni questa casella di controllo, assicurati che il modello di avvio non richieda già istanze Spot. Non puoi utilizzare un modello di avvio che richiede alle istanze spot di creare un gruppo con scalabilità automatica che utilizzi più tipi di istanza e che avvii istanze spot e on demand.
**Nota**  
Per utilizzare queste opzioni per un gruppo con scalabilità automatica che attualmente utilizza una configurazione di avvio, devi selezionare un modello di avvio in **Update launch template** (Aggiorna modello di avvio). La sovrascrittura del tipo di istanza nella configurazione di avvio non è supportata.

1. (Facoltativo) In **Impostazioni di rollback**, scegli **Abilita il rollback automatico** per eseguire automaticamente il rollback dell'aggiornamento dell'istanza in caso di errore.

   Questa impostazione può essere abilitata solo se il gruppo con dimensionamento automatico soddisfa i prerequisiti per l'utilizzo dei rollback. 

   Per ulteriori informazioni, consulta [Annulla le modifiche con un rollback manuale o automatico](instance-refresh-rollback.md).

1. Rivedi tutte le selezioni per confermare che siano impostate correttamente.

   A questo punto, è consigliabile verificare che le differenze tra le modifiche correnti e quelle proposte non influiscano sull'applicazione in modo imprevisto o indesiderato. Per verificare che il tipo di istanza è compatibile con il modello di avvio, consulta [Compatibilità del tipo di istanza](instance-refresh-overview.md#instance-type-compatibility).

1. Se le selezioni per l'aggiornamento delle istanze sono quelle desiderate, scegli **Avvia aggiornamento dell'istanza**. 

### Avviare un aggiornamento delle istanze nella console (gruppo di istanze miste)
<a name="starting-an-instance-refresh-in-the-console-mig"></a>

Se hai creato un gruppo con scalabilità automatica con una [policy di istanze miste](ec2-auto-scaling-mixed-instances-groups.md), utilizza la seguente procedura. Se in precedenza non hai definito una policy di istanze miste per il gruppo, consulta [Avviare un aggiornamento delle istanze nella console (procedura di base)](#starting-an-instance-refresh-in-the-console) per avviare un aggiornamento delle istanze.

**Come avviare l'aggiornamento di un'istanza**

1. Apri la console Amazon EC2 all'indirizzo [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)e scegli **Auto Scaling** Groups dal pannello di navigazione.

1. Seleziona la casella di controllo accanto al gruppo con dimensionamento automatico.

   Si aprirà un riquadro diviso nella parte inferiore della pagina **Auto Scaling groups** (Gruppi Auto Scaling). 

1. Nella scheda **Aggiornamento istanza** in **Active instance refresh** (Aggiornamento attivo istanza), scegli **Start instance refresh** (Avvia aggiornamento istanza).

1. In **Impostazioni di disponibilità**, esegui la seguente operazione:

   1. Per il **metodo di sostituzione dell’istanza**:
      + Se *non hai* impostato una policy di manutenzione delle istanze nel gruppo con dimensionamento automatico, l'impostazione predefinita per il **metodo di sostituzione dell'istanza** è **Termina e avvia**. Questo è il comportamento predefinito precedente per l'aggiornamento di un'istanza.
      + Se imposti una policy di manutenzione dell'istanza nel gruppo con dimensionamento automatico, vengono forniti valori predefiniti per il **metodo di sostituzione dell'istanza**. Per sovrascrivere la policy di manutenzione dell'istanza, scegli **Sostituisci**. La sostituzione si applica solo all'aggiornamento dell'istanza corrente. Al successivo avvio di un aggiornamento dell'istanza, questi valori vengono ripristinati ai valori predefiniti della policy di manutenzione dell'istanza. 

      Nella procedura seguente viene descritto come aggiornare il metodo di sostituzione delle istanze.

      1. Seleziona uno dei seguenti metodi di sostituzione delle istanze:
         + **Avvio prima del termine**: è necessario eseguire il provisioning di una nuova istanza prima di poter chiudere un'istanza esistente. Si tratta di una buona scelta per le applicazioni che privilegiano la disponibilità rispetto al risparmio.
         + **Termina e avvia**: le nuove istanze vengono fornite contemporaneamente alla chiusura delle istanze esistenti. Si tratta di una buona scelta per le applicazioni che privilegiano il risparmio rispetto alla disponibilità. È anche una buona scelta per le applicazioni che non dovrebbero avviare una capacità superiore a quella attualmente disponibile.
         + **Comportamento personalizzato**: questa opzione consente di impostare un intervallo minimo e massimo personalizzato per la quantità di capacità che desideri rendere disponibile quando si sostituiscono le istanze. Questo approccio può aiutarti a raggiungere il giusto equilibrio tra costi e disponibilità.

      1. Per **Imposta una percentuale di integrità** adeguata, inserisci i valori per uno o entrambi i campi seguenti. I campi di attivazione variano a seconda dell'opzione scelta per il **metodo di sostituzione dell'istanza**. 
         + **Min**: imposta la percentuale minima di integrità necessaria per procedere con l’aggiornamento dell’istanza.
         + **Max**: imposta la percentuale massima di integrità possibile durante l’aggiornamento dell’istanza.

      1. Espandi la sezione **Visualizza la capacità temporanea stimata durante le sostituzioni in base alla capacità desiderata** per confermare in che modo i valori di **Min** e **Max** si applicano al gruppo. I valori esatti utilizzati dipendono dal valore di capacità desiderato, che cambierà se il gruppo cresce.

      1. Espandi la sezione **Imposta il comportamento di fallback per le dimensioni sostitutive non valide**, quindi scegli se **Viola la percentuale massima di integrità** per dare priorità alla disponibilità o **Viola la percentuale minima di integrità**. 

         Non è consigliabile mantenere l'opzione **Viola la percentuale minima di integrità** predefinita per gruppi molto piccoli. Quando nel gruppo con dimensionamento automatico è presente una sola istanza, l'avvio di un aggiornamento delle istanze può causare un'interruzione.

         Questo passaggio configura il comportamento di fallback se utilizzi un gruppo con dimensionamento automatico che non dispone ancora di una policy di manutenzione dell'istanza. Questa opzione non è disponibile e non viene visualizzata quando il gruppo ha una policy di manutenzione delle istanze. Questa opzione è disponibile anche solo per il metodo di sostituzione **Termina e avvia**. Gli altri metodi di sostituzione violeranno la percentuale massima di integrità per dare priorità alla disponibilità.

   1. In **Preparazione dell'istanza**, inserisci il numero di secondi da quando lo stato di una nuova istanza cambia in `InService` a quando termina l’inizializzazione. Dimensionamento automatico Amazon EC2 attende il tempo prestabilito prima di passare alla sostituzione dell'istanza successiva. 

      Durante la preparazione, un'istanza appena avviata non viene conteggiata per i parametri aggregati dell'istanza del gruppo con scalabilità automatica (come `CPUUtilization`, `NetworkIn` e `NetworkOut`). Se sono state aggiunte policy di dimensionamento al gruppo con scalabilità automatica, le attività di dimensionamento vengono eseguite in parallelo. Se imposti un intervallo lungo per il periodo di aggiornamento dell'istanza, ci vorrà più tempo prima che le istanze appena lanciate vengano visualizzate nelle metriche. Pertanto, un periodo di riscaldamento adeguato impedisce ad Amazon EC2 Auto Scaling di scalare su dati metrici obsoleti.

      Se hai già definito correttamente una preparazione dell'istanza di default per il gruppo con scalabilità automatica, non devi modificare la preparazione dell'istanza. Puoi tuttavia impostare un valore per questa opzione se desideri sovrascrivere l'impostazione predefinita. Per ulteriori informazioni sull'impostazione della preparazione dell'istanza di default, consulta [Impostazione della preparazione di default dell'istanza per un gruppo con scalabilità automatica](ec2-auto-scaling-default-instance-warmup.md).

1. In **Impostazioni di aggiornamento**, esegui la seguente operazione:

   1. (Facoltativo) Per **Checkpoints** (Punti di controllo), scegli **Enable checkpoints** (Abilita punti di controllo) per sostituire le istanze utilizzando un approccio incrementale o graduale all'aggiornamento delle istanze. Ciò consente di avere tempo aggiuntivo per la verifica tra i set delle sostituzioni. Se scegli di non abilitare i punti di controllo, le istanze vengono sostituite in un'operazione quasi continua.

      Se abiliti i punti di controllo, consulta [Abilitazione dei punti di controllo (console)](enable-checkpoints-console-cli.md#enable-checkpoints-console) per ulteriori passaggi.

   1. Attiva o disattiva **Skip matching** (Salta corrispondenza):
      + Per ignorare la sostituzione delle istanze che già corrispondono al modello di avvio e la sovrascrittura di qualsiasi tipo di istanza, mantieni selezionata la casella di controllo **Abilita Ignora la corrispondenza**.
      + Se scegli di disattivare l'opzione Salta corrispondenza deselezionando questa casella di controllo, tutte le istanze possono essere sostituite.

      Quando abiliti la funzione Ignora la corrispondenza, invece di utilizzare il modello esistente, puoi impostare un nuovo modello di avvio o una nuova versione del modello di avvio. Puoi eseguire questa operazione nella sezione **Configurazione desiderata** della pagina **Avvio dell'aggiornamento dell'istanza**. Puoi anche aggiornare le sovrascritture del tipo di istanza in **Configurazione desiderata**. 

   1. In **Istanze in standby**, scegli **Ignora**, **Termina** o **Attendi**. Ciò determina cosa succede se vengono individuate istanze il cui stato è `Standby`. Per ulteriori informazioni, consulta [Rimuovere temporaneamente le istanze dal gruppo con scalabilità automatica](as-enter-exit-standby.md).

      Se scegli **Attendi**, devi eseguire ulteriori operazioni per ripristinare l'utilizzo di queste istanze. In caso contrario, l'aggiornamento dell'istanza sostituisce tutte le istanze `InService` e attende un'ora. Nel caso in cui siano presenti ancora istanze in stato `Standby`, l'aggiornamento dell'istanza ha esito negativo. Per evitare questa situazione, scegli l'opzione **Ignora** o **Termina** per tali istanze. 

   1. In **Istanze protette dalla riduzione orizzontale**, scegli **Ignora**, **Sostituisci** o **Attendi**. Ciò determina cosa succede se vengono individuate istanze protette dalla riduzione orizzontale. Per ulteriori informazioni, consulta [Utilizza la protezione scalabile in base alle istanze per controllare la chiusura dell'istanza](ec2-auto-scaling-instance-protection.md).

      Se scegli **Attendi**, devi eseguire ulteriori operazioni per rimuovere la protezione dalla riduzione orizzontale da tali istanze. In caso contrario, l’aggiornamento dell’istanza sostituisce tutte le istanze non protette e attende un’ora. Nel caso in cui siano ancora presenti istanze protette dalla riduzione orizzontale, l’aggiornamento dell’istanza ha esito negativo. Per evitare questa situazione, scegli l’opzione **Ignora** o **Sostituisci** per tali istanze.

1. (Facoltativo) Per gli **CloudWatch allarmi**, scegli **Abilita allarmi, quindi scegli uno o più CloudWatch allarmi**. CloudWatch gli allarmi possono essere utilizzati per identificare eventuali problemi e fallire l'operazione se un allarme entra in stato. `ALARM` Per ulteriori informazioni, consulta [Avvio dell'aggiornamento di un'istanza con rollback automatico](instance-refresh-rollback.md#instance-refresh-using-auto-rollback). 

1. Nella sezione **Configurazione desiderata**, procedi come segue. 

   Per questo passaggio, puoi scegliere di utilizzare la sintassi JSON o YAML per modificare i valori dei parametri anziché effettuare selezioni nell'interfaccia della console. Per farlo, scegli **Use code editor** (Usa editor di codice) e non **Use console interface** (Usa interfaccia console). La procedura seguente spiega come effettuare selezioni utilizzando l'interfaccia della console.

   1. Per **Update launch template** (Aggiornamento del modello di avvio): 
      + Se *non hai* creato un nuovo modello di avvio o una nuova versione del modello di avvio per il gruppo con scalabilità automatica, lascia questa casella di controllo deselezionata.
      + In caso contrario, selezionala. Quando selezioni questa opzione, Dimensionamento automatico Amazon EC2 mostra il modello di avvio corrente e la relativa versione ed elenca tutte le altre versioni disponibili. Scegli il modello di avvio e la versione. 

        Una volta scelta la versione, puoi visualizzare le relative informazioni. Questa è la versione del modello di avvio che verrà utilizzata per sostituire le istanze nell'ambito di un aggiornamento delle istanze. Se l'aggiornamento viene eseguito correttamente, questa versione del modello di avvio verrà utilizzata anche ogni volta che vengono avviate nuove istanze, ad esempio quando il gruppo viene dimensionato.

   1. Per **Use these settings to override the instance type and purchase option defined in the launch template** (Utilizzo di queste impostazioni per sovrascrivere il tipo di istanza e l'opzione di acquisto definite nel modello di avvio): 

      Per impostazione predefinita, questa casella di controllo è selezionata. Amazon EC2 Auto Scaling popola ciascun parametro con il valore attualmente impostato nella *policy di istanze miste* per il gruppo con scalabilità automatica. Aggiorna solo i valori per i parametri che desideri modificare. Per informazioni su queste impostazioni, consulta [Gruppi Auto Scaling con più tipi di istanze e opzioni di acquisto](ec2-auto-scaling-mixed-instances-groups.md).
**avvertimento**  
Consigliamo di non deselezionare questa casella di controllo. Deselezionala solo se desideri interrompere l'utilizzo di una policy di istanze miste. Dopo un aggiornamento delle istanze, Amazon EC2 Auto Scaling aggiorna il gruppo affinché corrisponda alla **configurazione desiderata**. Se non include più una policy di istanze miste, Amazon EC2 Auto Scaling termina gradualmente tutte le istanze Spot attualmente in esecuzione e le sostituisce con istanze on demand. In alternativa, se il modello di avvio richiede istanze Spot, Amazon EC2 Auto Scaling termina gradualmente le istanze on demand attualmente in esecuzione e le sostituisce con istanze Spot. 

1. (Facoltativo) In **Impostazioni di rollback**, scegli **Abilita il rollback automatico** per eseguire automaticamente il rollback dell'aggiornamento dell'istanza in caso di errore per qualsiasi motivo.

   Questa impostazione può essere abilitata solo se il gruppo con dimensionamento automatico soddisfa i prerequisiti per l'utilizzo dei rollback. 

   Per ulteriori informazioni, consulta [Annulla le modifiche con un rollback manuale o automatico](instance-refresh-rollback.md).

1. Rivedi tutte le selezioni per confermare che siano impostate correttamente.

   A questo punto, è consigliabile verificare che le differenze tra le modifiche correnti e quelle proposte non influiscano sull'applicazione in modo imprevisto o indesiderato. Per verificare che il tipo di istanza è compatibile con il modello di avvio, consulta [Compatibilità del tipo di istanza](instance-refresh-overview.md#instance-type-compatibility).

   Se le selezioni per l'aggiornamento delle istanze sono quelle desiderate, scegli **Avvia aggiornamento dell'istanza**. 

## Avvio dell'aggiornamento di un'istanza (AWS CLI)
<a name="start-instance-refresh-cli"></a>

**Come avviare l'aggiornamento di un'istanza**  
Utilizzate il [start-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/start-instance-refresh.html)comando seguente per avviare l'aggiornamento di un'istanza da. AWS CLI Puoi specificare le preferenze che desideri modificare in un file di configurazione JSON. Quando fai riferimento al file di configurazione, fornisci il percorso e il nome del file come illustrato nell'esempio seguente.

```
aws autoscaling start-instance-refresh --cli-input-json file://config.json
```

Contenuto di `config.json`:

```
{
    "AutoScalingGroupName": "my-asg",
    "Preferences": {
      "InstanceWarmup": 60,
      "MinHealthyPercentage": 50,
      "AutoRollback": true,
      "ScaleInProtectedInstances": Ignore,
      "StandbyInstances": Terminate
    }
}
```

Se le preferenze non vengono fornite, vengono utilizzati i valori predefiniti. Per ulteriori informazioni, consulta [Informazioni sui valori predefiniti per l'aggiornamento di un'istanza](understand-instance-refresh-default-values.md).

Output di esempio:

```
{
    "InstanceRefreshId": "08b91cf7-8fa6-48af-b6a6-d227f40f1b9b"
}
```

# Monitora l'aggiornamento di un'istanza utilizzando o Console di gestione AWS AWS CLI
<a name="check-status-instance-refresh"></a>

È possibile monitorare un aggiornamento dell'istanza in corso o verificare lo stato degli aggiornamenti delle istanze precedenti delle ultime sei settimane utilizzando l'opzione o. Console di gestione AWS AWS CLI

## Monitora e controlla lo stato dell'aggiornamento di un'istanza
<a name="monitor-and-check-status"></a>

Per monitorare e controllare lo stato di un aggiornamento dell'istanza, utilizzate uno dei seguenti metodi:

------
#### [ Console ]

**Suggerimento**  
In questa procedura, le colonne denominate dovrebbero già essere visualizzate. Per visualizzare le colonne nascoste o modificare il numero di righe visualizzate, scegli l'icona a forma di ingranaggio nell'angolo in alto a destra della sezione per aprire la finestra delle preferenze. Aggiorna le impostazioni secondo necessità e scegli **Conferma**.

**Per monitorare e controllare lo stato di un aggiornamento dell'istanza (console)**

1. Apri la console Amazon EC2 all'indirizzo [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)e scegli **Auto Scaling** Groups dal pannello di navigazione.

1. Seleziona la casella di controllo accanto al gruppo con dimensionamento automatico. 

   Si aprirà un riquadro diviso nella parte inferiore della pagina.

1. Nella scheda **Instance refresh** (Aggiornamento istanze) in **Instance refresh history** (Cronologia aggiornamento istanze), puoi determinare lo stato della richiesta esaminando la colonna **Stato**. L'operazione passa `Pending` allo stato durante l'inizializzazione. Lo stato dovrebbe quindi passare rapidamente a `InProgress`. Quando tutte le istanze sono state aggiornate, lo stato cambia in `Successful`.

1. È possibile monitorare ulteriormente il successo o il fallimento delle attività in corso visualizzando le attività di ridimensionamento del gruppo. Nella scheda **Activity (Attività)** in **Activity history (Cronologia attività)**, quando viene avviato l'aggiornamento delle istanze, vengono mostrate le voci al momento della terminazione delle istanze e un altro set di voci all'avvio delle istanze. Se hai numerose attività di scalabilità, puoi visualizzarne altre scegliendo l'icona **>** nella parte superiore della cronologia delle attività. Per informazioni sulla risoluzione dei problemi che potrebbero causare il fallimento delle attività, consulta[Risolvi i problemi in Amazon EC2 Auto Scaling](CHAP_Troubleshooting.md).

1. (Facoltativo) Nella scheda **Gestione delle istanze**, in **Istanze**, è possibile esaminare lo stato di avanzamento di istanze specifiche in base alle esigenze.

------
#### [ AWS CLI ]

**Per monitorare e controllare lo stato di un aggiornamento dell'istanza ()AWS CLI**  
Utilizza il seguente comando [describe-instance-refreshes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-instance-refreshes.html).

```
aws autoscaling describe-instance-refreshes --auto-scaling-group-name my-asg
```

Di seguito è riportato un output di esempio.

Gli aggiornamenti delle istanze sono ordinati in base all'ora di inizio. Gli aggiornamenti delle istanze ancora in corso vengono descritti per primi. 

```
{
  "InstanceRefreshes":[
    {
      "InstanceRefreshId":"08b91cf7-8fa6-48af-b6a6-d227f40f1b9b",
      "AutoScalingGroupName":"my-asg",
      "Status":"InProgress",
      "StatusReason":"Waiting for instances to warm up before continuing. For example: i-0645704820a8e83ff is warming up.",
      "StartTime":"2023-11-24T16:46:52+00:00",
      "PercentageComplete":50,
      "InstancesToUpdate":0,
      "Preferences":{
        "MaxHealthyPercentage":120,
        "MinHealthyPercentage":90,
        "InstanceWarmup":60,
        "SkipMatching":false,
        "AutoRollback":true,
        "ScaleInProtectedInstances":"Ignore",
        "StandbyInstances":"Ignore"
      }
    },
    {
      "InstanceRefreshId":"0e151305-1e57-4a32-a256-1fd14157c5ec",
      "AutoScalingGroupName":"my-asg",
      "Status":"Successful",
      "StartTime":"2023-11-22T13:53:37+00:00",
      "EndTime":"2023-11-22T13:59:45+00:00",
      "PercentageComplete":100,
      "InstancesToUpdate":0,
      "Preferences":{
        "MaxHealthyPercentage":120,
        "MinHealthyPercentage":90,
        "InstanceWarmup":60,
        "SkipMatching":false,
        "AutoRollback":true,
        "ScaleInProtectedInstances":"Ignore",
        "StandbyInstances":"Ignore"
      }
    }
  ]
}
```

È possibile monitorare ulteriormente il successo o il fallimento delle attività in corso visualizzando le attività di scalabilità del gruppo. Le attività di scalabilità consentono inoltre di approfondire la ricerca di maggiori dettagli per la risoluzione dei problemi relativi all'aggiornamento dell'istanza. Per ulteriori informazioni, consulta [Risolvi i problemi in Amazon EC2 Auto Scaling](CHAP_Troubleshooting.md).

------

## Stati di aggiornamento dell'istanza
<a name="instance-refresh-statuses"></a>

Quando avvii l'aggiornamento di un'istanza, quest'ultima passa allo stato **In attesa**. **Passa da **In sospeso** a **InProgress**finché non raggiunge i valori Riuscito, Non ****riuscito****, Annullato o. **RollbackSuccessful**RollbackFailed******

Un aggiornamento dell'istanza può presentare gli stati seguenti:


| Status | Description | 
| --- | --- | 
| Pending (In attesa) | La richiesta è stata creata, ma l'aggiornamento dell'istanza non è stato avviato. | 
| InProgress | È in corso un aggiornamento dell'istanza. | 
| Riuscito | Aggiornamento istanza completato correttamente. | 
| Non riuscito | Impossibile completare l'aggiornamento dell'istanza. È possibile risolvere i problemi utilizzando il motivo dello stato e le attività di dimensionamento. | 
| Annullamento in corso | Un aggiornamento dell'istanza in corso viene annullato. | 
| Annullato | L'aggiornamento dell'istanza viene annullato. | 
| RollbackInProgress | È in corso il rollback di un aggiornamento dell'istanza. | 
| RollbackFailed | Il rollback non è stato completato. È possibile risolvere i problemi utilizzando il motivo dello stato e le attività di dimensionamento. | 
| RollbackSuccessful | Il rollback è stato completato correttamente. | 
| Cottura | In attesa del tempo di cottura specificato dopo che l'aggiornamento di un'istanza ha terminato l'aggiornamento delle istanze. | 

# Sostituisci i volumi root durante l'aggiornamento dell'istanza
<a name="replace-root-volume"></a>

**Topics**
+ [Come funziona](#start-instance-refresh-replace-root-volume-how-it-works)
+ [Requisiti](#start-instance-refresh-replace-root-volume-requirements)
+ [Avvia un aggiornamento dell'istanza con Replace Root Volume](#start-instance-refresh-replace-root-volume-cli)
+ [Limitazioni](#start-instance-refresh-replace-root-volume-limitations)
+ [Usa gli hook del ciclo di vita con Replace Root Volume](#replace-root-volume-lifecycle-hooks)

## Come funziona
<a name="start-instance-refresh-replace-root-volume-how-it-works"></a>

La sostituzione del volume root aggiorna le istanze sostituendo solo il volume EBS principale mantenendo l'istanza in esecuzione. Ciò elimina la necessità di avviare nuove istanze ed evita potenziali limiti di capacità. Questo processo preserva tutte le altre risorse dell'istanza, tra cui:
+ Interfacce di rete e indirizzi IP 
+ Volumi EBS non root 
+ Volumi e dati dell'archivio di istanze 
+ Gruppi di sicurezza e ruoli IAM 

Durante la sostituzione del volume root, l'applicazione continua a funzionare sull'istanza esistente. Il volume root originale viene scollegato, viene creato un nuovo volume root dall'AMI specificato e quindi collegato alla stessa istanza. I volumi root originali vengono eliminati automaticamente dopo una corretta sostituzione.

Quando si utilizza la strategia Replace Root Volume, le istanze attraversano i seguenti stati del ciclo di vita:

1. `ReplacingRootVolume`- Inizia la sostituzione del volume principale

1. `ReplacingRootVolume:Wait`- Attende il completamento del ciclo di vita del hook (se configurato)

1. `ReplacingRootVolume:Proceed`- Procede con la sostituzione

1. `RootVolumeReplaced`- Sostituzione completata con successo

Una volta completata la sostituzione del volume root, Auto Scaling effettua controlli sullo stato delle istanze aggiornate. Se la sostituzione del volume root fallisce per un'istanza, Auto Scaling contrassegna l'istanza per la terminazione e la sostituisce con una nuova istanza.

## Requisiti
<a name="start-instance-refresh-replace-root-volume-requirements"></a>
+ Il gruppo Auto Scaling deve utilizzare una politica a istanze miste
+ Tutte le sostituzioni nella politica relativa alle istanze miste devono specificare un `ImageId` 
+ AMIs deve contenere un solo volume radice
+ Tutte le istanze devono corrispondere alla configurazione del modello di lancio del gruppo
+ È necessario avviare l'aggiornamento dell'istanza con la configurazione desiderata con una politica per istanze miste contenente le sostituzioni. `ImageId` 

## Avvia un aggiornamento dell'istanza con Replace Root Volume
<a name="start-instance-refresh-replace-root-volume-cli"></a>

**Per avviare l'aggiornamento di un'istanza con Replace Root Volume ()AWS CLI**  
Utilizzate il [start-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/start-instance-refresh.html)comando seguente per avviare l'aggiornamento di un'istanza da. AWS CLI Puoi specificare le preferenze che desideri modificare in un file di configurazione JSON. Quando fai riferimento al file di configurazione, fornisci il percorso e il nome del file come illustrato nell'esempio seguente. 

```
aws autoscaling start-instance-refresh --cli-input-json file://config.json
```

Contenuto di `config.json`: 

**Example**  

```
{
  "AutoScalingGroupName": "my-asg",
  "Strategy" : "ReplaceRootVolume",
  "DesiredConfiguration":{
    "MixedInstancesPolicy":{
      "LaunchTemplate": {
        "LaunchTemplateSpecification": {
          "LaunchTemplateId":"my-launch-template",
          "Version": "1"
        },
        "Overrides": [
          {
            "InstanceType":"c5.large",
            "ImageId":"ami-1234example"
          },
          {
            "InstanceType":"m5.large",
            "ImageId":"ami-2345example"
          }
        ]
      }
    }
  },
  "Preferences": {
    "InstanceWarmup": 60,
    "MinHealthyPercentage": 90,
    "AutoRollback": true,
    "ScaleInProtectedInstances": Ignore,
    "StandbyInstances": Ignore
  }
}
```

Se le preferenze non vengono fornite, vengono utilizzati i valori predefiniti. Per ulteriori informazioni, consulta [Informazioni sui valori predefiniti per l'aggiornamento di un'istanza](understand-instance-refresh-default-values.md). 

Output di esempio:

```
{
    "InstanceRefreshId": "08b91cf7-8fa6-48af-b6a6-d227f40f1b9b"
}
```

## Limitazioni
<a name="start-instance-refresh-replace-root-volume-limitations"></a>
+ Non puoi avviare un aggiornamento dell'istanza con Replace Root Volume se il gruppo EC2 Auto Scaling o la configurazione desiderata per l'aggiornamento dell'istanza utilizzano `$Latest` la versione del modello o lanciano. `$Default`
+ Non puoi avviare un aggiornamento dell'istanza con Replace Root Volume su un gruppo Amazon EC2 Auto Scaling se contiene istanze il cui tipo di istanza non è presente nella politica delle istanze miste.
+ Durante l'aggiornamento di un'istanza con Replace Root Volume, puoi collegare solo istanze con tipi presenti nella politica relativa alle istanze miste della configurazione desiderata.
+ Non puoi avviare un aggiornamento dell'istanza con Replace Root Volume su un gruppo di Auto Scaling EC2 dotato di un pool caldo.
+ Non puoi aggiungere un pool caldo a un gruppo Amazon EC2 Auto Scaling che ha un aggiornamento attivo dell'istanza con Replace Root Volume.

## Usa gli hook del ciclo di vita con Replace Root Volume
<a name="replace-root-volume-lifecycle-hooks"></a>

Le istanze sottoposte a sostituzione del volume root seguono le proprie transizioni del ciclo di vita, consentendoti di richiamare azioni (ad esempio, una funzione Lambda) prima della sostituzione. and/or Per ulteriori informazioni sugli stati del ciclo di vita durante la sostituzione del volume root, consulta. [Transizioni dello stato del ciclo di vita per le istanze in fase di sostituzione del volume root](lifecycle-hooks-overview.md#rvr-lifecycle-state-transitions)

Per ulteriori informazioni sull'aggiunta di un hook del ciclo di vita, consulta [Aggiungi gli hook del ciclo di vita al tuo gruppo Auto Scaling](adding-lifecycle-hooks.md). Per ulteriori informazioni sul completamento di un'operazione del ciclo di vita, consulta [Completa un'azione del ciclo di vita in un gruppo Auto Scaling](completing-lifecycle-hooks.md).

Prima della sostituzione del volume root, un lifecycle hook può essere utile nei seguenti scenari:
+ Si desidera chiudere correttamente l'applicazione prima che il volume root venga sostituito e l'istanza venga riavviata.
+ Volete spostare i dati dal volume principale a un'altra posizione prima che il volume venga sostituito.

Dopo la sostituzione del volume root, un lifecycle hook può essere utile nei seguenti scenari:
+ Vuoi verificare che la tua istanza sia completamente pronta con la nuova AMI prima che inizi a ricevere traffico.
+ Desideri avviare il bootstrap dei dati dell'applicazione che esistevano in precedenza nel volume principale.

Quando aggiungi gli hook del ciclo di vita, considera quanto segue:
+ Quando un lifecycle hook è configurato per l'azione del `autoscaling:EC2_INSTANCE_TERMINATING` ciclo di vita, un'istanza che sta per essere sostituita dal volume root si ferma per eseguire un'azione personalizzata quando raggiunge lo stato. `ReplacingRootVolume:Wait`
+ Quando un lifecycle hook è configurato per l'azione del `autoscaling:EC2_INSTANCE_LAUNCHING` ciclo di vita, un'istanza a cui è stato appena sostituito il volume root si interrompe per eseguire un'azione personalizzata quando raggiunge lo stato. `Pending:Wait`

Quando le istanze raggiungono uno stato di attesa, Dimensionamento automatico Amazon EC2 invia una notifica. Le notifiche Hook del ciclo di vita di Auto Scaling contengono un `Action` campo con un valore che indica che l'istanza è `ReplaceRootVolume` in fase di sostituzione del volume root.

Esempi di queste notifiche sono disponibili nella EventBridge sezione di questa guida. Per ulteriori informazioni, consulta [L'aggiornamento dell'istanza sostituisce gli eventi del ciclo di vita del volume root](instance-refresh-eventbridge-events.md#instance-refresh-rvr-lifecycle-events).

# Annulla l'aggiornamento di un'istanza utilizzando o Console di gestione AWS AWS CLI
<a name="cancel-instance-refresh"></a>

Puoi annullare l'aggiornamento di un'istanza quando l'operazione è ancora in corso, non quando è completata.

L'annullamento dell'aggiornamento di un'istanza non comporta il rollback di tutte le istanze già sostituite. Per ripristinare le modifiche apportate alle istanze, esegui un rollback. Per ulteriori informazioni, consulta [Annulla le modifiche con un rollback manuale o automatico](instance-refresh-rollback.md).

**Topics**
+ [Annullamento dell'aggiornamento di un'istanza (console)](#cancel-instance-refresh-console)
+ [Annullamento dell'aggiornamento di un'istanza (AWS CLI)](#cancel-instance-refresh-cli)

## Annullamento dell'aggiornamento di un'istanza (console)
<a name="cancel-instance-refresh-console"></a>

**Come annullare l’aggiornamento di un’istanza**

1. Apri la console Amazon EC2 all'indirizzo [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)e scegli **Auto Scaling** Groups dal pannello di navigazione.

1. Seleziona la casella di controllo accanto al gruppo con dimensionamento automatico.

1. Nella scheda **Aggiornamento istanza**, in **Aggiornamento dell'istanza attivo**, scegli **Operazioni**, quindi **Annulla**.

1. Quando viene richiesta la conferma, seleziona **Confirm** (Conferma).

Lo stato dell'aggiornamento dell'istanza è impostato su **Annullamento in corso**. Al termine dell'annullamento, lo stato dell'aggiornamento dell'istanza è impostato su **Annullato**.

## Annullamento dell'aggiornamento di un'istanza (AWS CLI)
<a name="cancel-instance-refresh-cli"></a>

**Come annullare l’aggiornamento di un’istanza**  
Utilizzate il [cancel-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/cancel-instance-refresh.html)comando di AWS CLI e fornite il nome del gruppo Auto Scaling. 

```
aws autoscaling cancel-instance-refresh --auto-scaling-group-name my-asg
```

Output di esempio:

```
{
    "InstanceRefreshId": "08b91cf7-8fa6-48af-b6a6-d227f40f1b9b"
}
```

**Per annullare l'aggiornamento di un'istanza senza attendere la transizione delle istanze**  
Utilizzate l'`--no-wait-for-transitioning-instances`opzione con il [cancel-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/cancel-instance-refresh.html)comando di AWS CLI per annullare l'aggiornamento di un'istanza senza attendere le istanze in transizione.

```
aws autoscaling cancel-instance-refresh —auto-scaling-group-name my-asg --no-wait-for-transitioning-instances
```

**Per impostazione predefinita, quando annulli l'aggiornamento di un'istanza, Amazon EC2 Auto Scaling attende il completamento di eventuali lanci e terminazioni in corso prima di impostare lo stato su Annullato.** Se hai istanze con lunghi periodi di esaurimento o devi avviare immediatamente un nuovo aggiornamento dell'istanza, puoi utilizzare il comando in modo da non dover attendere queste operazioni di transizione.

Quando si utilizza questa opzione, lo stato di aggiornamento dell'istanza cambia in **Annullato**, consentendoti di iniziare un nuovo aggiornamento dell'istanza. Tutti i lanci e le terminazioni in volo continuano in background.

# Annulla le modifiche con un rollback manuale o automatico
<a name="instance-refresh-rollback"></a>

Puoi eseguire il rollback di un aggiornamento dell'istanza quando l'operazione è ancora in corso, non quando è stata completata. Tuttavia, puoi aggiornare nuovamente il gruppo con scalabilità automatica avviando un nuovo aggiornamento dell'istanza.

Durante il rollback, Dimensionamento automatico Amazon EC2 sostituisce le istanze implementate fino a quel momento. Le nuove istanze corrispondono all'ultima configurazione salvata nel gruppo con scalabilità automatica prima di avviare l'aggiornamento dell'istanza.

Dimensionamento automatico Amazon EC2 offre i seguenti metodi per eseguire il rollback:
+ Rollback manuale: l'avvio manuale di un rollback consente di rimuovere gli elementi implementati fino al punto di rollback.
+ Rollback automatico: Amazon EC2 Auto Scaling inverte automaticamente ciò che è stato distribuito se l'aggiornamento dell'istanza non riesce per qualche motivo o se CloudWatch vengono attivati degli allarmi specificati. `ALARM`

**Topics**
+ [Considerazioni](#instance-refresh-rollback-considerations)
+ [Avvio manuale di un rollback](#instance-refresh-manual-rollback)
+ [Avvio dell'aggiornamento di un'istanza con rollback automatico](#instance-refresh-using-auto-rollback)

## Considerazioni
<a name="instance-refresh-rollback-considerations"></a>

Le seguenti considerazioni si applicano quando si utilizza il rollback:
+ L'opzione rollback è disponibile solo se specifichi una configurazione desiderata come parte dell'avvio di un aggiornamento dell'istanza.
+ Puoi ripristinare una versione precedente di un modello di avvio solo se la versione è una versione numerata specifica. L'opzione di rollback non è disponibile se il gruppo con dimensionamento automatico è configurato per utilizzare la versione del modello di lancio `$Latest` o `$Default`. 
+ Inoltre, non è possibile tornare a un modello di avvio configurato per utilizzare un alias AMI dal AWS Systems Manager Parameter Store.
+ L’ultima configurazione salvata nel gruppo con dimensionamento automatico deve essere stabile. In caso contrario, il flusso di lavoro del rollback proseguirà ma alla fine l'operazione avrà esito negativo. Finché non si risolve il problema, il gruppo con scalabilità automatica potrebbe trovarsi in uno stato non riuscito, in cui non è in grado di avviare correttamente le istanze. Ciò potrebbe influire sulla disponibilità del servizio o dell'applicazione.

## Avvio manuale di un rollback
<a name="instance-refresh-manual-rollback"></a>

------
#### [ Console ]

**Per avviare manualmente un rollback dell'aggiornamento dell'istanza (console)**

1. Apri la console Amazon EC2 all'indirizzo [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)e scegli **Auto Scaling** Groups dal pannello di navigazione.

1. Seleziona la casella di controllo accanto al gruppo con dimensionamento automatico.

1. Nella scheda **Aggiornamento istanza**, in **Aggiornamento dell'istanza attivo**, scegli **Operazioni**, quindi **Avvia rollback**.

1. Quando viene richiesta la conferma, seleziona **Confirm** (Conferma).

------
#### [ AWS CLI ]

**Per avviare manualmente un rollback dell'aggiornamento dell'istanza (AWS CLI)**  
Utilizzate il [rollback-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/rollback-instance-refresh.html)comando di AWS CLI e fornite il nome del gruppo Auto Scaling. 

```
aws autoscaling rollback-instance-refresh --auto-scaling-group-name my-asg
```

Output di esempio:

```
{
    "InstanceRefreshId": "08b91cf7-8fa6-48af-b6a6-d227f40f1b9b"
}
```

**Suggerimento**  
Se questo comando genera un errore, assicurati di averlo aggiornato AWS CLI localmente alla versione più recente.

------

## Avvio dell'aggiornamento di un'istanza con rollback automatico
<a name="instance-refresh-using-auto-rollback"></a>

Utilizzando la funzione di rollback automatico, puoi ripristinare automaticamente l'aggiornamento dell'istanza in caso di errore, ad esempio quando si verificano errori o viene attivato uno CloudWatch specifico allarme Amazon. `ALARM`

Se abiliti il rollback automatico e si verificano errori durante la sostituzione delle istanze, l'aggiornamento dell'istanza tenta di completare tutte le sostituzioni per un'ora prima che abbia esito negativo ed esegua il rollback. Questi errori sono in genere causati da errori di avvio di EC2, controlli dell'integrità configurati in modo errato o dalla mancata ignorazione o dalla mancata autorizzazione alla chiusura delle istanze nello stato `Standby` o protette dal dimensionamento verticale.

La specificazione degli CloudWatch allarmi è facoltativa. Per specificare un allarme, devi prima crearlo. Puoi specificare sia allarmi dei parametri che allarmi compositi in. Per informazioni sulla creazione dell'allarme, consulta la [Amazon CloudWatch User Guide](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/). Utilizzando i parametri di Elastic Load Balancing come esempio, se utilizzi un Application Load Balancer, puoi utilizzare i parametri `HTTPCode_ELB_5XX_Count` e `HTTPCode_ELB_4XX_Count`.

**Considerazioni**
+ Se si specifica un CloudWatch avviso ma non si abilita il rollback automatico e lo stato dell'allarme passa a`ALARM`, l'aggiornamento dell'istanza fallisce senza il rollback.
+ Quando avvii l'aggiornamento di un'istanza puoi scegliere un massimo di 10 allarmi.
+ Quando si sceglie un CloudWatch allarme, quest'ultimo deve essere in uno stato compatibile. Se lo stato dell'allarme è `INSUFFICIENT_DATA` o `ALARM`, ricevi un errore quando tenti di avviare l'aggiornamento dell'istanza. 
+ Quando crei un allarme da utilizzare per Dimensionamento automatico Amazon EC2, l'allarme deve includere come trattare i punti dati mancanti. Se un parametro è spesso privo di punti di dati in base per progettazione, lo stato dell'allarme è `INSUFFICIENT_DATA` durante tali periodi. In questo caso, Dimensionamento automatico Amazon EC2 non può sostituire le istanze finché non vengono trovati nuovi punti dati. Per forzare l'allarme a mantenere il precedente stato `ALARM` o `OK`, puoi scegliere di ignorare i dati mancanti. Per ulteriori informazioni, consulta [Configurazione del modo in cui gli allarmi trattano i dati mancanti](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html#alarms-and-missing-data) nella *Amazon CloudWatch User Guide*.

------
#### [ Console ]

**Per avviare l'aggiornamento dell'istanza con il rollback automatico (console)**

1. Apri la console Amazon EC2 all'indirizzo [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)e scegli **Auto Scaling** Groups dal pannello di navigazione.

1. Seleziona la casella di controllo accanto al gruppo con dimensionamento automatico.

1. Nella scheda **Aggiornamento istanza** in **Active instance refresh** (Aggiornamento attivo istanza), scegli **Start instance refresh** (Avvia aggiornamento istanza).

1. Segui la procedura [Avvio dell'aggiornamento di un'istanza (console)](start-instance-refresh.md#start-instance-refresh-console) e configura le impostazioni di aggiornamento dell'istanza in base alle esigenze.

1. (Facoltativo) In **Aggiorna impostazioni**, per **CloudWatch allarmi**, scegli **Abilita CloudWatch allarmi**, quindi scegli uno o più allarmi per identificare eventuali problemi e interrompere l'operazione se viene attivato un allarme. `ALARM`

1. In **Impostazioni di rollback**, seleziona **Abilita rollback automatico** per eseguire il rollback automatico di un aggiornamento dell'istanza non riuscito alla configurazione salvata l'ultima volta nel gruppo con dimensionamento automatico prima di avviare l'aggiornamento dell'istanza.

1. Controlla le selezioni, quindi scegli **Avvia aggiornamento dell'istanza**. 

------
#### [ AWS CLI ]

**Per avviare l'aggiornamento dell'istanza con il rollback automatico (AWS CLI)**  
Utilizzate il [start-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/start-instance-refresh.html)comando e specificate `true` l'`AutoRollback`opzione in. `Preferences` 

L'esempio seguente mostra come avviare un aggiornamento dell'istanza che verrà ripristinato automaticamente in caso di errore. Sostituisci i valori del parametro *`italicized`* con i tuoi valori.

```
aws autoscaling start-instance-refresh --cli-input-json file://config.json
```

Contenuto di `config.json`.

```
{
    "AutoScalingGroupName": "my-asg",
    "DesiredConfiguration": {
      "LaunchTemplate": {
          "LaunchTemplateName": "my-launch-template",
          "Version": "1"
       }
    },
    "Preferences": {
      "AutoRollback": true
    }
}
```

In alternativa, per eseguire automaticamente il rollback quando l'aggiornamento dell'istanza fallisce o quando uno specifico CloudWatch allarme è nello `ALARM` stato, specificate l'`AlarmSpecification`opzione in `Preferences` e fornite il nome dell'avviso, come nell'esempio seguente. Sostituisci i valori del parametro *`italicized`* con i tuoi valori.

```
{
    "AutoScalingGroupName": "my-asg",
    "DesiredConfiguration": {
      "LaunchTemplate": {
          "LaunchTemplateName": "my-launch-template",
          "Version": "1"
       }
    },
    "Preferences": {
      "AutoRollback": true,
      "AlarmSpecification": { "Alarms": [ "my-alarm" ] }
    }
}
```

Se il comando viene eseguito correttamente, verrà visualizzato un output simile al seguente:

```
{
  "InstanceRefreshId": "08b91cf7-8fa6-48af-b6a6-d227f40f1b9b"
}
```

**Suggerimento**  
Se questo comando genera un errore, assicurati di averlo aggiornato AWS CLI localmente alla versione più recente.

------

# Utilizzo di un aggiornamento dell'istanza con l'opzione Ignora la corrispondenza
<a name="asg-instance-refresh-skip-matching"></a>

Ignora la corrispondenza indica a Dimensionamento automatico Amazon EC2 di ignorare le istanze che dispongono già degli aggiornamenti più recenti, in modo da non sostituire più istanze del necessario. Ciò è utile quando desideri assicurarti che il gruppo con scalabilità automatica utilizzi una particolare versione del modello di avvio e sostituisca solo le istanze che ne utilizzano una diversa.

All'opzione Salta corrispondenza si applicano le seguenti considerazioni:
+ Se avvii un aggiornamento dell'istanza con l'opzione Ignora la corrispondenza e specifichi una *configurazione desiderata*, Dimensionamento automatico Amazon EC2 verifica la corrispondenza di determinate istanze con la configurazione desiderata. Quindi, sostituisce solo le istanze che non corrispondono a tale configurazione. Al termine dell'aggiornamento dell'istanza, Dimensionamento automatico Amazon EC2 aggiorna il gruppo affinché corrisponda alla configurazione desiderata. 
+ Se avvii un aggiornamento dell'istanza con l'opzione Ignora la corrispondenza ma non specifichi una configurazione desiderata, Dimensionamento automatico Amazon EC2 verifica la corrispondenza di determinate istanze all'ultima configurazione salvata nel gruppo con scalabilità automatica. Quindi, sostituisce solo le istanze non corrispondenti.
+ Puoi usare l'opzione Ignora la corrispondenza con un nuovo modello di avvio, una nuova versione del modello di avvio o un set di tipi di istanze. Se abiliti l'opzione Salta corrispondenza, ma nessuno di questi parametri viene modificato, l'aggiornamento dell'istanza avrà esito positivo senza sostituirne alcuna. Se hai apportato altre modifiche alla configurazione desiderata (ad esempio la modifica della strategia di allocazione Spot), Dimensionamento automatico Amazon EC2 attende che l'aggiornamento dell'istanza abbia esito positivo. Quindi, aggiorna le impostazioni del gruppo con scalabilità automatica in base alla nuova configurazione desiderata. 
+ Non puoi utilizzare l’opzione Salta corrispondenza con una nuova configurazione di avvio.
+ Quando avvii un aggiornamento dell'istanza e fornisci la configurazione desiderata, Amazon EC2 Auto Scaling assicura che tutte le istanze utilizzino la configurazione desiderata. Pertanto, quando specifichi una `$Default` o `$Latest` come versione desiderata per il modello di lancio e poi crei una nuova versione del modello di lancio mentre è in corso un aggiornamento dell'istanza, tutte le istanze già sostituite verranno nuovamente sostituite.
+ Skip matching non sa se uno script di dati utente nel modello di avvio recupererà il codice aggiornato e lo installerà su nuove istanze. Di conseguenza, skip matching potrebbe saltare la sostituzione delle istanze in cui è installato codice obsoleto. In questo caso, dovresti disattivare lo skip matching per assicurarti che tutte le istanze ricevano il codice più recente, anche senza un aggiornamento della versione del modello di lancio.

Questa sezione include AWS CLI le istruzioni per avviare un aggiornamento dell'istanza con skip matching abilitato. Per istruzioni su come usare la console, consulta [Avvio dell'aggiornamento di un'istanza (console)](start-instance-refresh.md#start-instance-refresh-console).

## Ignora la corrispondenza (procedura di base)
<a name="skip-matching"></a>

Segui la procedura descritta in questa sezione per AWS CLI eseguire le seguenti operazioni:
+ Creare il modello di avvio da applicare alle istanze.
+ Avviare un aggiornamento dell'istanza per applicare il modello di avvio al gruppo con scalabilità automatica Se non abiliti l'opzione Ignora la corrispondenza, tutte le istanze verranno sostituite. Ciò vale anche se il modello di avvio utilizzato per eseguire il provisioning dell'istanza è uguale a quello specificato per la configurazione desiderata.

**Per utilizzare l'opzione Ignora la corrispondenza con un nuovo modello di avvio**

1. Utilizzate il [create-launch-template](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-launch-template.html)comando per creare un nuovo modello di lancio per il vostro gruppo Auto Scaling. Includi l'opzione `--launch-template-data` e l'input JSON che definisce i dettagli delle istanze create per il gruppo con scalabilità automatica.

   Ad esempio, utilizza il comando seguente per creare un modello di avvio di base con l'ID AMI *`ami-0123456789abcdef0`* e il tipo di istanza `t2.micro`.

   ```
   aws ec2 create-launch-template --launch-template-name my-template-for-auto-scaling --version-description version1 \
     --launch-template-data '{"ImageId":"ami-0123456789abcdef0","InstanceType":"t2.micro"}'
   ```

   Se il comando viene eseguito correttamente, verrà visualizzato un output simile al seguente:

   ```
   {
      "LaunchTemplate": {
        "LaunchTemplateId": "lt-068f72b729example",
        "LaunchTemplateName": "my-template-for-auto-scaling",
        "CreatedBy": "arn:aws:iam::123456789012:user/Bob",
        "CreateTime": "2023-01-30T18:16:06.000Z",
        "DefaultVersionNumber": 1,
        "LatestVersionNumber": 1
     }
   }
   ```

   Per ulteriori informazioni, consulta [Esempi di creazione e gestione di modelli di lancio con AWS CLI](examples-launch-templates-aws-cli.md).

1. Utilizzate il [start-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/start-instance-refresh.html)comando per avviare il flusso di lavoro di sostituzione delle istanze e applicate il nuovo modello di lancio con l'ID. *`lt-068f72b729example`* Poiché il modello di avvio è nuovo, ha una sola versione. Ciò significa che la versione `1` del modello di avvio è l'obiettivo di tale aggiornamento dell'istanza. Se durante l'aggiornamento dell'istanza si verifica un aumento orizzontale e Dimensionamento automatico Amazon EC2 effettua il provisioning di nuove istanze utilizzando la versione `1` di questo modello di avvio, le istanze non verranno sostituite. Al termine dell'operazione, il nuovo modello di avvio viene applicato correttamente al gruppo con scalabilità automatica. 

   ```
   aws autoscaling start-instance-refresh --cli-input-json file://config.json
   ```

   Contenuto di `config.json`.

   ```
   {
       "AutoScalingGroupName": "my-asg",
       "DesiredConfiguration": {
         "LaunchTemplate": {
             "LaunchTemplateId": "lt-068f72b729example",
             "Version": "$Default"
          }
       },
       "Preferences": {
         "SkipMatching": true
       }
   }
   ```

   Se il comando viene eseguito correttamente, verrà visualizzato un output simile al seguente:

   ```
   {
     "InstanceRefreshId": "08b91cf7-8fa6-48af-b6a6-d227f40f1b9b"
   }
   ```

## Ignora la corrispondenza (gruppo di istanze miste)
<a name="skip-matching-mixed-instances-group"></a>

Se disponi di un gruppo Auto Scaling con una [politica di istanze miste](ec2-auto-scaling-mixed-instances-groups.md), segui i passaggi di questa sezione AWS CLI per avviare un aggiornamento dell'istanza con skip matching. Sono disponibili le seguenti opzioni:
+ Fornire un nuovo modello di avvio da applicare a tutti i tipi di istanze specificati nella policy.
+ Fornire un set aggiornato di tipi di istanze con o senza modifica del modello di avvio nella policy. Supponiamo, ad esempio, che tu voglia eseguire la migrazione da tipi di istanza indesiderati. In questo caso, dovresti utilizzare il modello di avvio così com'è, senza modificare l'AMI, i gruppi di sicurezza o altre specifiche delle istanze da sostituire.

Segui i passaggi indicati in una delle sezioni seguenti, a seconda dell'opzione più adatta alle tue esigenze.

**Per utilizzare l'opzione Ignora la corrispondenza con un nuovo modello di avvio**

1. Utilizzate il [create-launch-template](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-launch-template.html)comando per creare un nuovo modello di lancio per il vostro gruppo Auto Scaling. Includi l'opzione `--launch-template-data` e l'input JSON che definisce i dettagli delle istanze create per il gruppo con scalabilità automatica.

   Ad esempio, utilizza il comando seguente per creare un modello di avvio con l'ID AMI *`ami-0123456789abcdef0`*.

   ```
   aws ec2 create-launch-template --launch-template-name my-new-template --version-description version1 \
     --launch-template-data '{"ImageId":"ami-0123456789abcdef0"}'
   ```

   Se il comando viene eseguito correttamente, verrà visualizzato un output simile al seguente:

   ```
   {
      "LaunchTemplate": {
        "LaunchTemplateId": "lt-04d5cc9b88example",
        "LaunchTemplateName": "my-new-template",
        "CreatedBy": "arn:aws:iam::123456789012:user/Bob",
        "CreateTime": "2023-01-31T15:56:02.000Z",
        "DefaultVersionNumber": 1,
        "LatestVersionNumber": 1
     }
   }
   ```

   Per ulteriori informazioni, consulta [Esempi di creazione e gestione di modelli di lancio con AWS CLI](examples-launch-templates-aws-cli.md).

1. Per visualizzare la politica esistente per le istanze miste per il gruppo Auto Scaling, [describe-auto-scaling-groups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-auto-scaling-groups.html)esegui il comando. Queste informazioni serviranno per avviare l'aggiornamento dell'istanza, come descritto nel passaggio successivo.

   Il seguente comando di esempio restituisce la policy di istanze miste configurata per il gruppo con scalabilità automatica denominato *`my-asg`*.

   ```
   aws autoscaling describe-auto-scaling-groups --auto-scaling-group-name my-asg
   ```

   Se il comando viene eseguito correttamente, verrà visualizzato un output simile al seguente:

   ```
   {
     "AutoScalingGroups":[
       {
         "AutoScalingGroupName":"my-asg",
         "AutoScalingGroupARN":"arn",
         "MixedInstancesPolicy":{
           "LaunchTemplate":{
             "LaunchTemplateSpecification":{
               "LaunchTemplateId":"lt-073693ed27example",
               "LaunchTemplateName":"my-old-template",
               "Version":"$Default"
             },
             "Overrides":[
               {
                 "InstanceType":"c5.large"
               },
               {
                 "InstanceType":"c5a.large"
               },
               {
                 "InstanceType":"m5.large"
               },
               {
                 "InstanceType":"m5a.large"
               }
             ]
           },
           "InstancesDistribution":{
             "OnDemandAllocationStrategy":"prioritized",
             "OnDemandBaseCapacity":1,
             "OnDemandPercentageAboveBaseCapacity":50,
             "SpotAllocationStrategy":"price-capacity-optimized"
           }
         },
         "MinSize":1,
         "MaxSize":5,
         "DesiredCapacity":4,
         ...
       }
     ]
   }
   ```

1. Utilizzate il [start-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/start-instance-refresh.html)comando per avviare il flusso di lavoro di sostituzione delle istanze e applicate il nuovo modello di lancio con l'ID. *`lt-04d5cc9b88example`* Poiché il modello di avvio è nuovo, ha una sola versione. Ciò significa che la versione `1` del modello di avvio è l'obiettivo di tale aggiornamento dell'istanza. Se durante l'aggiornamento dell'istanza si verifica un aumento orizzontale e Dimensionamento automatico Amazon EC2 effettua il provisioning di nuove istanze utilizzando la versione `1` di questo modello di avvio, le istanze non verranno sostituite. Al termine dell'operazione, la policy di istanze miste aggiornata viene applicata correttamente al gruppo con scalabilità automatica.

   ```
   aws autoscaling start-instance-refresh --cli-input-json file://config.json
   ```

   Contenuto di `config.json`.

   ```
   {
     "AutoScalingGroupName":"my-asg",
     "DesiredConfiguration":{
       "MixedInstancesPolicy":{
         "LaunchTemplate":{
           "LaunchTemplateSpecification":{
             "LaunchTemplateId":"lt-04d5cc9b88example",
             "Version":"$Default"
           },
           "Overrides":[
             {
               "InstanceType":"c5.large"
             },
             {
               "InstanceType":"c5a.large"
             },
             {
               "InstanceType":"m5.large"
             },
             {
               "InstanceType":"m5a.large"
             }
           ]
         },
         "InstancesDistribution":{
           "OnDemandAllocationStrategy":"prioritized",
           "OnDemandBaseCapacity":1,
           "OnDemandPercentageAboveBaseCapacity":50,
           "SpotAllocationStrategy":"price-capacity-optimized"
           }
         }
       }
     },
     "Preferences":{
       "SkipMatching":true
     }
   }
   ```

   Se il comando viene eseguito correttamente, verrà visualizzato un output simile al seguente:

   ```
   {
     "InstanceRefreshId": "08b91cf7-8fa6-48af-b6a6-d227f40f1b9b"
   }
   ```

Nella procedura seguente, fornirai un set aggiornato di tipi di istanze senza modificare il modello di avvio. 

**Per utilizzare l'opzione Ignora la corrispondenza con un set aggiornato di tipi di istanza**

1. Per visualizzare la politica esistente per le istanze miste per il gruppo Auto Scaling, [describe-auto-scaling-groups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-auto-scaling-groups.html)esegui il comando. Queste informazioni serviranno per avviare l'aggiornamento dell'istanza, come descritto nel passaggio successivo.

   Il seguente comando di esempio restituisce la policy di istanze miste configurata per il gruppo con scalabilità automatica denominato *`my-asg`*.

   ```
   aws autoscaling describe-auto-scaling-groups --auto-scaling-group-name my-asg
   ```

   Se il comando viene eseguito correttamente, verrà visualizzato un output simile al seguente:

   ```
   {
     "AutoScalingGroups":[
       {
         "AutoScalingGroupName":"my-asg",
         "AutoScalingGroupARN":"arn",
         "MixedInstancesPolicy":{
           "LaunchTemplate":{
             "LaunchTemplateSpecification":{
               "LaunchTemplateId":"lt-073693ed27example",
               "LaunchTemplateName":"my-template-for-auto-scaling",
               "Version":"$Default"
             },
             "Overrides":[
               {
                 "InstanceType":"c5.large"
               },
               {
                 "InstanceType":"c5a.large"
               },
               {
                 "InstanceType":"m5.large"
               },
               {
                 "InstanceType":"m5a.large"
               }
             ]
           },
           "InstancesDistribution":{
             "OnDemandAllocationStrategy":"prioritized",
             "OnDemandBaseCapacity":1,
             "OnDemandPercentageAboveBaseCapacity":50,
             "SpotAllocationStrategy":"price-capacity-optimized"
           }
         },
         "MinSize":1,
         "MaxSize":5,
         "DesiredCapacity":4,
         ...
       }
     ]
   }
   ```

1. Utilizzate il [start-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/start-instance-refresh.html)comando per avviare il flusso di lavoro di sostituzione delle istanze e applicare gli aggiornamenti. Se desideri sostituire le istanze che utilizzano tipi di istanza precisi, la configurazione desiderata deve specificare la policy di istanze miste con solo i tipi di istanza desiderati. Puoi scegliere se aggiungere nuovi tipi di istanza al loro posto.

   Il seguente comando di esempio avvia un aggiornamento dell'istanza senza il tipo di istanza indesiderato *`m5a.large`*. Quando un tipo di istanza nel gruppo non corrisponde a uno dei tre tipi di istanza rimanenti, le istanze vengono sostituite. Tieni presente che un aggiornamento dell'istanza non sceglie i tipi di istanza da cui eseguire il provisioning delle nuove istanze, al contrario delle [strategie di allocazione](allocation-strategies.md). Al termine dell'operazione, la policy di istanze miste aggiornata viene applicata correttamente al gruppo con scalabilità automatica.

   ```
   aws autoscaling start-instance-refresh --cli-input-json file://config.json
   ```

   Contenuto di `config.json` 

   ```
   {
     "AutoScalingGroupName":"my-asg",
     "DesiredConfiguration":{
       "MixedInstancesPolicy":{
         "LaunchTemplate":{
           "LaunchTemplateSpecification":{
             "LaunchTemplateId":"lt-073693ed27example",
             "Version":"$Default"
           },
           "Overrides":[
             {
               "InstanceType":"c5.large"
             },
             {
               "InstanceType":"c5a.large"
             },
             {
               "InstanceType":"m5.large"
             }
           ]
         },
         "InstancesDistribution":{
           "OnDemandAllocationStrategy":"prioritized",
           "OnDemandBaseCapacity":1,
           "OnDemandPercentageAboveBaseCapacity":50,
           "SpotAllocationStrategy":"price-capacity-optimized"
           }
         }
       }
     },
     "Preferences":{
       "SkipMatching":true
     }
   }
   ```

# Aggiungere punti di controllo a un aggiornamento delle istanze
<a name="asg-adding-checkpoints-instance-refresh"></a>

Quando utilizzi un aggiornamento dell'istanza, puoi scegliere di sostituire le istanze in fasi, in modo da poter eseguire delle verifiche sulle istanze man mano che procedi. Per eseguire una sostituzione graduale, aggiungi dei punti di controllo, ovvero punti nel tempo in cui l'aggiornamento dell'istanza si interrompe. L'utilizzo dei punti di controllo consente di avere un maggiore controllo su come scegliere di aggiornare il gruppo con scalabilità automatica. Ti aiuta a verificare che l'applicazione funzioni in modo affidabile e prevedibile.

**Topics**
+ [Come funziona](#instance-refresh-checkpoints-how-it-works)
+ [Considerazioni](#instance-refresh-checkpoints-considerations)
+ [Abilita i checkpoint](enable-checkpoints-console-cli.md)

## Come funziona
<a name="instance-refresh-checkpoints-how-it-works"></a>

Quando si avvia un aggiornamento dell'istanza, si specificano i checkpoint come percentuali del numero totale di istanze nel gruppo Auto Scaling. Questi checkpoint indicano la percentuale minima di istanze nel gruppo Auto Scaling che devono essere nuove istanze prima che il checkpoint venga considerato raggiunto. Ad esempio, se i checkpoint sono nuovi`[20, 50, 100]`, il primo checkpoint viene raggiunto quando il 20% delle istanze sono nuove, il secondo quando il 50% sono nuove e il checkpoint finale quando tutte le istanze sono nuove. 

Amazon EC2 Auto Scaling accelera le sostituzioni delle istanze per rispettare le percentuali di checkpoint specificate, mantenendo al contempo la percentuale minima integra del gruppo. Per raggiungere una percentuale di checkpoint, Dimensionamento automatico Amazon EC2 a volte ne sostituisce una quantità inferiore, ma mai superiore a quella consentita dalla percentuale minima di integrità.

Considera il seguente gruppo con dimensionamento automatico che ha 10 istanze. Le percentuali del checkpoint sono`[20,50,100]`: la percentuale minima di integrità è dell'80% e la percentuale massima di integrità è del 100 percento. Per mantenere la percentuale minima di integrità, solo due istanze vengono sostituite contemporaneamente. Il diagramma seguente riepiloga le operazioni necessarie per la sostituzione delle istanze prima che venga raggiunto un punto di controllo.

![\[Questo diagramma mostra come i punti di controllo influiscono sul flusso di aggiornamento di un'istanza.\]](http://docs.aws.amazon.com/it_it/autoscaling/ec2/userguide/images/checkpoints-instance-refresh.png)


Nell'esempio precedente, è previsto un periodo di riscaldamento dell'istanza per ogni nuova istanza che viene avviata. Potresti anche avere un hook del ciclo di vita che mette un'istanza in uno stato di attesa e poi esegue un'operazione personalizzata durante l'avvio o la chiusura. 

Amazon EC2 Auto Scaling emette eventi per ogni checkpoint ad eccezione del checkpoint completo al 100%. Puoi aggiungere una EventBridge regola per inviare gli eventi a una destinazione come Amazon SNS. In questo modo, riceverai una notifica su quando puoi eseguire le verifiche richieste. Per ulteriori informazioni, consulta [Crea EventBridge regole, ad esempio eventi di aggiornamento](monitor-events-eventbridge-sns.md).

## Considerazioni
<a name="instance-refresh-checkpoints-considerations"></a>

Quando utilizzi i punti di controllo, tieni presente le considerazioni riportate di seguito:
+ Poiché i punti di controllo sono basati su percentuali, il numero di istanze da sostituire cambia in base alla dimensione del gruppo. Quando si verifica un'attività di scalabilità orizzontale e la dimensione del gruppo aumenta, un'operazione in corso potrebbe raggiungere nuovamente un punto di controllo. In tal caso, prima di continuare, Amazon EC2 Auto Scaling invia un'altra notifica e ripete il tempo di attesa tra i punti di controllo.
+ In determinate circostanze, è possibile saltare un punto di controllo. Ad esempio, supponiamo che il gruppo con scalabilità automatica abbia due istanze e che le percentuali del punto di controllo siano `[10,40,100]`. Dopo la sostituzione della prima istanza, Amazon EC2 Auto Scaling calcola che il 50% del gruppo è stato sostituito. Poiché il 50% è superiore ai primi due punti di controllo, salta il primo (`10`) e invia una notifica per il secondo (`40`).
+ L'annullamento dell'operazione interrompe eventuali ulteriori sostituzioni. Se l'operazione viene annullata o non riesce prima di raggiungere l'ultimo punto di controllo, le istanze già sostituite non vengono ripristinate alla configurazione precedente.
+ In un aggiornamento parziale, quando riesegui l'operazione, Dimensionamento automatico Amazon EC2 non si riavvia dal punto dell'ultimo punto di controllo e si interrompe quando vengono sostituite solo le istanze precedenti. Tuttavia, punterà a sostituire le istanze precedenti prima di quelle nuove. 
+ La percentuale effettiva di completamento potrebbe essere superiore alla percentuale di quel checkpoint quando la percentuale del checkpoint è troppo bassa rispetto al numero di istanze del gruppo. Ad esempio, supponiamo che la percentuale del punto di controllo sia del 20% e che il gruppo abbia quattro istanze. Se Dimensionamento automatico Amazon EC2 sostituisce una delle quattro istanze, la percentuale effettiva sostituita (25 percento) sarà superiore alla percentuale del checkpoint (20 percento).
+ Una volta raggiunto un checkpoint, la percentuale complessiva di completamento visualizzata viene aggiornata solo dopo il completamento del riscaldamento delle istanze. Ad esempio, le percentuali dei checkpoint corrispondono `[20,50]` a un ritardo di 15 minuti e a una percentuale minima di salute dell'80%. Il gruppo Auto Scaling è composto da 10 istanze ed effettua le seguenti sostituzioni:
  + 0:00: due istanze precedenti vengono sostituite con istanze nuove. 
  + 0:10: due nuove istanze terminano la preparazione. 
  + 0:25: due istanze precedenti vengono sostituite con istanze nuove. (Per mantenere la percentuale minima di integrità, solo due istanze vengono sostituite).
  + 0:35: due nuove istanze terminano la preparazione. 
  + 0:35: un'istanza precedente viene sostituita con una nuova.
  + 0:45: una nuova istanza termina la preparazione.

  Alle 0:35, l'operazione interrompe l'avvio di nuove istanze. La percentuale di completamento non riflette in modo accurato il numero di sostituzioni completate (50%), perché la nuova istanza non ha terminato la preparazione. Dopo che la nuova istanza ha completato il periodo di riscaldamento alle 0:45, la percentuale di completamento mostra il 50%.
+ Se sono abilitati più checkpoint, il checkpoint di aggiornamento dell'istanza deve essere impostato al 100% per garantire la sostituzione completa di tutte le istanze. Se imposti il checkpoint finale su una percentuale inferiore al 100% (ad esempio, il 50%), l'aggiornamento dell'istanza smetterà di sostituire le istanze dopo aver raggiunto quella percentuale di checkpoint e non proseguirà automaticamente fino al completamento al 100%.

# Abilita i checkpoint utilizzando o Console di gestione AWS AWS CLI
<a name="enable-checkpoints-console-cli"></a>

Puoi usare Console di gestione AWS o AWS CLI per abilitare i checkpoint.

## Abilitazione dei punti di controllo (console)
<a name="enable-checkpoints-console"></a>

Puoi abilitare i punti di controllo prima di avviare l'aggiornamento delle istanze per sostituirle utilizzando un approccio incrementale o graduale. Ciò consente di avere tempo aggiuntivo per la verifica.

**Come avviare un aggiornamento delle istanze che utilizza i punti di controllo**

1. Apri la console Amazon EC2 all'indirizzo [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)e scegli **Auto Scaling** Groups dal pannello di navigazione.

1. Seleziona la casella di controllo accanto al gruppo con dimensionamento automatico.

   Si aprirà un riquadro diviso nella parte inferiore della pagina **Auto Scaling groups** (Gruppi Auto Scaling). 

1. Nella scheda **Aggiornamento istanza** in **Active instance refresh** (Aggiornamento attivo istanza), scegli **Start instance refresh** (Avvia aggiornamento istanza).

1. Nella pagina **Start instance refresh** (Avvia aggiornamento istanza), inserisci i valori per **Percentuale minima di integrità** e **Instance warmup** (Preparazione istanza). 

1. Seleziona la casella di controllo **Enable checkpoints** (Abilita punti di controllo).

   Visualizzerai una casella in cui potrai definire la soglia percentuale per il primo punto di controllo. 

1. Per **Proceed until \$1\$1\$1\$1 % of the group is refreshed** (Procedi fino al \$1\$1\$1\$1% dell'aggiornamento del gruppo), inserisci un numero da 1 a 100. Questa operazione imposta la percentuale per il primo punto di controllo. 

1. Per aggiungere un altro punto di controllo, scegli **Add checkpoint (Aggiungi punto di controllo)** e quindi definisci la percentuale per il punto di controllo successivo.

1. Per specificare quanto tempo Amazon EC2 Auto Scaling attende dopo il raggiungimento di un punto di controllo, aggiorna i campi in **Wait for `1` `hour` between checkpoints (Attendi un'ora tra un punto di controllo e l'altro)**. L'unità di tempo può essere in ore, minuti o secondi.

1. Se hai effettuato tutte le selezioni per l'aggiornamento delle istanze, scegli **Avvia aggiornamento dell'istanza** 

## Abilitazione dei punti di controllo (AWS CLI)
<a name="enable-checkpoints-cli"></a>

Per avviare un aggiornamento dell'istanza con i checkpoint abilitati utilizzando AWS CLI, è necessario un file di configurazione che definisca i seguenti parametri:
+ `CheckpointPercentages`: specifica i valori di soglia per la percentuale di istanze da sostituire. Questi valori di soglia forniscono i punti di controllo. Quando la percentuale di istanze sostituite e preparate raggiunge una delle soglie specificate, l'operazione attende un periodo di tempo specificato. È possibile specificare il numero di secondi di attesa in `CheckpointDelay`. Una volta trascorso il periodo di tempo specificato, l'aggiornamento delle istanze procede fino a raggiungere il punto di controllo successivo (se applicabile).
+ `CheckpointDelay`: specifica il tempo di attesa, espresso in secondi, necessario al raggiungimento di un punto di controllo prima di continuare. Scegli un periodo di tempo sufficiente per eseguire le verifiche.

L'ultimo valore mostrato nell'array `CheckpointPercentages` descrive la percentuale del gruppo con scalabilità automatica che deve essere sostituito correttamente. Una questa percentuale viene sostituita con successo e che ciascuna istanza ha completato la sua inizializzazione, l’operazione passa a `Successful`. 

**Come creare più punti di controllo**  
Per creare più checkpoint, utilizzate il seguente comando di esempio. [start-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/start-instance-refresh.html) In questo esempio viene configurato un aggiornamento delle istanze che inizialmente aggiorna l'1% del gruppo con scalabilità automatica. Dopo aver atteso 10 minuti, aggiorna il 19% successivo e attende altri 10 minuti. Infine, aggiorna il resto del gruppo prima di concludere l'operazione.

```
aws autoscaling start-instance-refresh --cli-input-json file://config.json
```

Contenuto di `config.json`.

```
{
    "AutoScalingGroupName": "my-asg",
    "Preferences": {
      "InstanceWarmup": 60,
      "MinHealthyPercentage": 80,
      "CheckpointPercentages": [1,20,100],
      "CheckpointDelay": 600
    }
}
```

**Come creare un singolo punto di controllo**  
Per creare un singolo checkpoint, utilizzate il seguente comando di esempio [start-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/start-instance-refresh.html). In questo esempio viene configurato un aggiornamento delle istanze che, inizialmente, aggiorna il 20% del gruppo con scalabilità automatica. Dopo aver atteso 10 minuti, aggiorna il resto del gruppo prima di concludere l'operazione.

```
aws autoscaling start-instance-refresh --cli-input-json file://config.json
```

Contenuto di `config.json`.

```
{
    "AutoScalingGroupName": "my-asg",
    "Preferences": {
      "InstanceWarmup": 60,
      "MinHealthyPercentage": 80,
      "CheckpointPercentages": [20,100],
      "CheckpointDelay": 600
    }
}
```

**Aggiornamento parziale del gruppo con scalabilità automatica**  
Per sostituire solo una parte del gruppo Auto Scaling e poi interromperlo completamente, utilizzate il seguente comando di esempio [start-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/start-instance-refresh.html). In questo esempio viene configurato un aggiornamento delle istanze che inizialmente aggiorna l'1% del gruppo con scalabilità automatica. Dopo aver atteso 10 minuti, aggiorna il successivo 19% prima di concludere l'operazione.

```
aws autoscaling start-instance-refresh --cli-input-json file://config.json
```

Contenuto di `config.json`.

```
{
    "AutoScalingGroupName": "my-asg",
    "Preferences": {
      "InstanceWarmup": 60,
      "MinHealthyPercentage": 80,
      "CheckpointPercentages": [1,20],
      "CheckpointDelay": 600
    }
}
```

# Sostituire le istanze Auto Scaling basate sulla durata massima dell'istanza
<a name="asg-max-instance-lifetime"></a>

La durata massima delle istanze specifica la quantità massima di tempo (in secondi) durante la quale un'istanza può restare in servizio prima che venga terminata e sostituita. Un caso d'uso comune può essere un requisito per sostituire le istanze in base a una pianificazione a causa di policy di sicurezza interne o controlli di conformità esterni. 

È necessario specificare un valore di almeno 86.400 secondi (un giorno). Per cancellare un valore impostato in precedenza, specifica un nuovo valore pari a 0. Questa impostazione si applica a tutte le istanze attuali e future del gruppo con scalabilità automatica.

**Topics**
+ [Considerazioni](#max-instance-lifetime-considerations)
+ [Impostazione della durata massima dell'istanza](#set-maximum-instance-lifetime)
+ [Limitazioni](#maximum-instance-lifetime-limitations)

## Considerazioni
<a name="max-instance-lifetime-considerations"></a>

Di seguito sono riportate le considerazioni relative all'utilizzo di questa funzionalità: 
+ Ogni volta che viene sostituita un'istanza precedente e viene avviata una nuova, quest'ultima utilizza il modello di avvio o la configurazione di avvio attualmente associata al gruppo con scalabilità automatica. Se il modello di avvio o la configurazione di avvio specifica l'ID Amazon Machine Image (AMI) di una versione diversa dell'applicazione, questa versione dell'applicazione verrà distribuita automaticamente.
+ Se si imposta una durata massima dell'istanza su un valore troppo basso, è possibile che le istanze vengano sostituite più rapidamente del previsto. Amazon EC2 Auto Scaling sostituisce in genere le istanze una alla volta, con una pausa tra le sostituzioni. Tuttavia, se la durata massima dell'istanza specificata non fornisce il tempo sufficiente per sostituire ogni istanza singolarmente, Amazon EC2 Auto Scaling deve sostituire più di un'istanza alla volta. È possibile sostituire più istanze contemporaneamente, fino al 10% della capacità corrente del gruppo con scalabilità automatica. Per evitare di sostituire troppe istanze contemporaneamente, imposta una durata massima dell'istanza più lunga o utilizza la protezione scalabile dell'istanza per impedire temporaneamente la chiusura di singole istanze. Per ulteriori informazioni, consulta [Utilizza la protezione scalabile in base alle istanze per controllare la chiusura dell'istanza](ec2-auto-scaling-instance-protection.md).
+ Per impostazione predefinita, Dimensionamento automatico Amazon EC2 crea una nuova attività di dimensionamento per terminare l'istanza, quindi la termina. Mentre l'istanza viene terminata, un'altra attività di dimensionamento avvia una nuova istanza. Puoi modificare questo comportamento in modo che venga avviato prima di terminare utilizzando una policy di manutenzione dell'istanza. Per ulteriori informazioni, consulta [Policy di manutenzione delle istanze](ec2-auto-scaling-instance-maintenance-policy.md). 

## Impostazione della durata massima dell'istanza
<a name="set-maximum-instance-lifetime"></a>

Quando si crea un gruppo con scalabilità automatica nella console, non è possibile impostare la durata massima dell'istanza. Tuttavia, dopo aver creato il gruppo, è possibile modificarlo per impostare la durata massima dell'istanza.

**Impostazione della durata massima dell'istanza per un gruppo (console)**

1. Apri la console Amazon EC2 all'indirizzo [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)e scegli **Auto Scaling** Groups dal pannello di navigazione.

1. Seleziona la casella di controllo accanto al gruppo con dimensionamento automatico.

   Visualizzerai un riquadro diviso nella parte inferiore della pagina **Auto Scaling groups** (Gruppi Auto Scaling) in cui vengono mostrate le informazioni sul gruppo selezionato. 

1. Nella scheda **Details (Dettagli)** scegliere **Advanced configurations (Configurazioni avanzate)**, **Edit (Modifica)**.

1. Per **Maximum instance lifetime** (Durata massima dell'istanza), inserisci il numero massimo di secondi in cui un'istanza può essere in servizio.

1. Scegliere **Aggiorna**.

Nella scheda **Activity** (Attività) in **Activity history** (Cronologia attività), è possibile visualizzare tutta la cronologia della sostituzione delle istanze per il gruppo. 

**Impostazione della durata massima dell'istanza per un gruppo (AWS CLI)**  
È inoltre possibile utilizzare il AWS CLI per impostare la durata massima dell'istanza per i gruppi di Auto Scaling nuovi o esistenti.

Per i nuovi gruppi Auto Scaling, utilizzare il [create-auto-scaling-group](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/create-auto-scaling-group.html)comando.

```
aws autoscaling create-auto-scaling-group --cli-input-json file://~/config.json
```

Di seguito è riportato un file `config.json` di esempio che mostra una durata massima dell'istanza di `2592000` secondi (30 giorni).

```
{
    "AutoScalingGroupName": "my-asg",
    "LaunchTemplate": {
        "LaunchTemplateName": "my-launch-template",
        "Version": "$Default"
    },
    "MinSize": 1,
    "MaxSize": 5,
    "MaxInstanceLifetime": 2592000,
    "VPCZoneIdentifier": "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782",
    "Tags": []
}
```

Per i gruppi Auto Scaling esistenti, utilizzare il [update-auto-scaling-group](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/update-auto-scaling-group.html)comando.

```
aws autoscaling update-auto-scaling-group --auto-scaling-group-name my-existing-asg --max-instance-lifetime 2592000
```

**Come verificare la durata massima dell'istanza per un gruppo con scalabilità automatica**  
Utilizza il comando [describe-auto-scaling-groups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-auto-scaling-groups.html).

```
aws autoscaling describe-auto-scaling-groups --auto-scaling-group-name my-asg
```

## Limitazioni
<a name="maximum-instance-lifetime-limitations"></a>
+ **Esattezza della durata massima non garantita per ogni istanza**: non è garantita la sostituzione delle istanze alla fine della loro durata massima. In alcune situazioni, Amazon EC2 Auto Scaling potrebbe richiedere la sostituzione delle istanze dopo l'aggiornamento del parametro di durata massima dell'istanza. La ragione di questo comportamento è quella di evitare di sostituire tutte le istanze allo stesso tempo.
+ **Protezione scalabile in base alle istanze rispettata**: Amazon EC2 Auto Scaling offre una protezione scalabile in base alle istanze per aiutarti a controllare quali istanze possono essere chiuse. Quando questa protezione è abilitata su un'istanza, Amazon EC2 Auto Scaling non interromperà l'istanza anche se ha raggiunto la durata massima dell'istanza. 
+ **Istanze terminate prima dell'avvio**: quando nel gruppo con dimensionamento automatico è presente una sola istanza, la caratteristica di durata massima dell'istanza può causare un'interruzione poiché Dimensionamento automatico Amazon EC2 termina un'istanza e quindi ne avvia una nuova come impostazione predefinita. Per modificare questo comportamento in modo che venga avviato prima della terminazione, consulta [Policy di manutenzione delle istanze](ec2-auto-scaling-instance-maintenance-policy.md).