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à.
# Manutenzione di Amazon DocumentDB
Periodicamente, Amazon DocumentDB esegue la manutenzione sulle risorse Amazon DocumentDB. La manutenzione spesso richiede aggiornamenti del motore di database (manutenzione del cluster) o del sistema operativo sottostante dell'istanza (manutenzione dell'istanza). Gli aggiornamenti del motore di database sono patch necessarie e includono correzioni di sicurezza, correzioni di bug e miglioramenti al motore di database. Sebbene la maggior parte delle patch del sistema operativo siano opzionali, se non le applichi per un certo periodo, la patch potrebbe essere richiesta e applicata automaticamente per mantenere il tuo livello di sicurezza. Pertanto, ti consigliamo di applicare gli aggiornamenti del sistema operativo alle istanze di Amazon DocumentDB non appena sono disponibili.
Le patch del motore di database richiedono che i cluster Amazon DocumentDB vengano messi offline per un breve periodo. Una volta disponibili, queste patch vengono automaticamente programmate per essere applicate durante una prossima finestra di manutenzione programmata del cluster Amazon DocumentDB.
Le operazioni di manutenzione su cluster e istanze hanno le loro rispettive finestre di manutenzione. Le modifiche a cluster e istanze che hai scelto di non applicare immediatamente vengono applicate anche durante la finestra di manutenzione. Per impostazione predefinita, quando crei un cluster, Amazon DocumentDB assegna una finestra di manutenzione sia per un cluster che per ogni singola istanza. Durante la creazione di un cluster o di un'istanza è possibile scegliere la finestra di manutenzione, che può anche essere modificata in qualsiasi momento per adeguarsi alla pianificazione o alle prassi del business. In genere è consigliabile scegliere finestre di manutenzione con impatto minimo sull'applicazione (per esempio, in serata o nel week end).
**Topics**
+ [Notifiche per le patch del motore Amazon DocumentDB](#patch-notifications)
+ [Visualizzazione delle azioni di manutenzione in sospeso di Amazon DocumentDB](#view-pending-maintenance)
+ [Aggiornamenti del motore Amazon DocumentDB](#db-instance-updates-apply)
+ [Aggiornamenti avviati dall'utente](#user-initiated-updates)
+ [Gestione delle finestre di manutenzione di Amazon DocumentDB](#maintenance-window)
+ [Aggiornamenti del sistema operativo Amazon DocumentDB](#os-system-updates)
+ [Applicazione di patch ai cluster globali](#global-clusters-patching)
## Notifiche per le patch del motore Amazon DocumentDB
Riceverai notifiche di manutenzione per le patch richieste al motore di database tramite eventi di salute in Health Dashboard (AHD) nella AWS console e tramite e-mail. Quando una patch di manutenzione del motore Amazon DocumentDB diventa disponibile in una particolare AWS regione, tutti gli account utente di Amazon DocumentDB interessati nella regione riceveranno una notifica AHD e via e-mail per ogni versione di Amazon DocumentDB interessata dalla patch. Puoi visualizzare queste notifiche nella sezione **Modifiche pianificate** dell'AHD nella console. AWS La notifica conterrà dettagli sulla tempistica della disponibilità delle patch, sulla pianificazione dell'applicazione automatica, sull'elenco dei cluster interessati e sulle note di rilascio. Questa notifica verrà inviata anche via e-mail all'indirizzo e-mail dell'utente root dell' AWS account.
![\[Console Amazon DocumentDB che mostra la scheda Modifiche pianificate per gli aggiornamenti delle patch del motore.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/scheduled-changes.png)
Una volta ricevuta questa notifica, puoi scegliere di applicare automaticamente queste patch del motore ai tuoi cluster Amazon DocumentDB prima della data di applicazione automatica pianificata. Oppure puoi attendere che le patch del motore vengano applicate automaticamente durante una finestra di manutenzione imminente (opzione predefinita).
**Nota**
Lo **stato** della notifica nell'AHD sarà impostato su «In corso» fino al rilascio di una nuova patch del motore Amazon DocumentDB con una nuova versione della patch del motore.
Una volta applicata la patch del motore al cluster Amazon DocumentDB, la versione della patch del motore del cluster verrà aggiornata in modo da riflettere la versione nella notifica. Puoi eseguire il `db.runCommand({getEngineVersion: 1})` comando per verificare questo aggiornamento.
AWS Health si integra anche con Amazon EventBridge , che utilizza gli eventi per creare applicazioni scalabili basate sugli eventi e si integra con oltre 20 destinazioni AWS Lambda, tra cui Amazon Simple Queue Service (SQS) e altre. Puoi utilizzare il codice `AWS_DOCDB_DB_PATCH_UPGRADE_MAINTENANCE_SCHEDULED` evento per configurare Amazon EventBridge prima che le patch del motore diventino disponibili. Puoi configurare la risposta EventBridge all'evento ed eseguire automaticamente azioni come l'acquisizione di informazioni sull'evento, l'avvio di eventi aggiuntivi, l'invio di notifiche tramite canali aggiuntivi come notifiche push e l'adozione di azioni correttive o di altro tipo AWS Console Mobile Application, quando una patch del motore Amazon DocumentDB diventa disponibile nella tua regione.
Nel raro scenario in cui Amazon DocumentDB annulli una patch del motore, riceverai una notifica AHD e un'e-mail che ti informa dell'annullamento. Di conseguenza, puoi utilizzare il codice `AWS_DOCDB_DB_PATCH_UPGRADE_MAINTENANCE_CANCELLED` evento per configurare Amazon in modo EventBridge che risponda a questo evento. Consulta la *Amazon EventBridge User Guide* per ulteriori informazioni sull'uso [ EventBridge delle regole di Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html).
## Visualizzazione delle azioni di manutenzione in sospeso di Amazon DocumentDB
È possibile verificare se è disponibile un aggiornamento di manutenzione per il cluster utilizzando Console di gestione AWS o il AWS CLI.
Se è disponibile un aggiornamento, puoi scegliere una di queste operazioni:
+ Rimanda un'azione di manutenzione attualmente pianificata per la prossima finestra di manutenzione (solo per le patch del sistema operativo).
+ Applica immediatamente le operazioni di manutenzione.
+ Pianificare le operazioni di manutenzione perché vengano avviate durante la successiva finestra di manutenzione.
**Nota**
Se non intraprendi alcuna azione, le azioni di manutenzione richieste, come le patch del motore, verranno applicate automaticamente in una finestra di manutenzione programmata imminente.
La finestra di manutenzione determina l'avvio delle operazioni in sospeso, ma non limita il tempo di esecuzione totale di tali operazioni.
------
#### [ Using the Console di gestione AWS ]
1. [Accedi a e apri Console di gestione AWS la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. Nel pannello di navigazione scegliere **Cluster**.
1. Se è disponibile un aggiornamento, è indicato dalla parola Available, ****Required**** o **Next Window** nella colonna **Maintenance** per il cluster sulla console Amazon DocumentDB, come illustrato di seguito:
![\[Console Amazon DocumentDB che mostra la colonna Maintenance per i cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/db-cluster-maintenance-updates-status.png)
1. Per eseguire un'azione, scegli il cluster per visualizzarne i dettagli, quindi scegli **Manutenzione e backup**. Vengono visualizzati gli elementi **di manutenzione in sospeso**.
![\[Console Amazon DocumentDB che mostra la finestra di manutenzione del cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/cluster-maint-3.png)
------
#### [ Using the AWS CLI ]
Utilizza la seguente AWS CLI operazione per determinare quali azioni di manutenzione sono in sospeso. L'output di seguito mostra che non ci sono operazioni di manutenzione in attesa.
```
aws docdb describe-pending-maintenance-actions
```
L'aspetto dell'output di questa operazione è simile al seguente (formato JSON).
```
{
"PendingMaintenanceActions": []
}
```
------
## Aggiornamenti del motore Amazon DocumentDB
Con Amazon DocumentDB, puoi scegliere quando applicare le operazioni di manutenzione. Puoi decidere quando Amazon DocumentDB applicare gli aggiornamenti utilizzando o. Console di gestione AWS AWS CLI
Utilizza le procedure descritte in questo argomento per aggiornare immediatamente o pianificare un aggiornamento per il tuo cluster.
------
#### [ Using the Console di gestione AWS ]
Puoi utilizzare la console per gestire gli aggiornamenti per i tuoi cluster Amazon DocumentDB.
**Per gestire un aggiornamento per un cluster**
1. [Accedi a e apri Console di gestione AWS la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. Nel pannello di navigazione scegliere **Cluster**.
1. Nell'elenco dei cluster, scegliere il pulsante accanto al nome del cluster a cui applicare l'operazione di manutenzione.
1. Nel menu **Actions (Operazioni)** scegliere una di queste opzioni:
+ **Upgrade Now (Esegui l'aggiornamento ora)** per eseguire subito le attività di manutenzione in sospeso.
+ **Upgrade at next window (Aggiorna alla prossima finestra)** per eseguire le attività di manutenzione in sospeso durante la finestra di manutenzione successiva del cluster.
In alternativa, puoi fare clic su **Applica ora** o **Applica alla prossima finestra di manutenzione** nella sezione Manutenzione in sospeso della scheda **Manutenzione e backup** del cluster (vedi **Utilizzo del** file Console di gestione AWS nella sezione precedente).
**Nota**
Se non ci sono attività di manutenzione in sospeso, tutte le opzioni precedenti sono inattive.
------
#### [ Using the AWS CLI ]
Per applicare un aggiornamento in sospeso a un cluster, utilizzare l'operazione. `apply-pending-maintenance-action` AWS CLI
**Parameters**
+ **--resource-identifier**—Amazon DocumentDB Amazon Resource Name (ARN) della risorsa a cui si applica l'azione di manutenzione in sospeso.
+ **--apply-action**—L'azione di manutenzione in sospeso da applicare a questa risorsa.
Valori validi: `system-update` e `db-upgrade`.
+ **--opt-in-type**—Un valore che specifica il tipo di richiesta di opt-in o annulla una richiesta di opt-in. Una richiesta di consenso esplicito di tipo `immediate` non può essere annullata.
Valori validi:
+ `immediate`—Applica immediatamente l'azione di manutenzione.
+ `next-maintenance`—Applica l'azione di manutenzione durante la finestra di manutenzione successiva per la risorsa.
+ `undo-opt-in`—Annulla tutte le richieste di `next-maintenance` opt-in esistenti.
**Example**
Per Linux, macOS o Unix:
```
aws docdb apply-pending-maintenance-action \
--resource-identifier arn:aws:rds:us-east-1:123456789012:db:docdb \
--apply-action system-update \
--opt-in-type immediate
```
Per Windows:
```
aws docdb apply-pending-maintenance-action ^
--resource-identifier arn:aws:rds:us-east-1:123456789012:db:docdb ^
--apply-action system-update ^
--opt-in-type immediate
```
Per restituire un elenco di risorse con almeno un aggiornamento in sospeso, usa il comando. `describe-pending-maintenance-actions` AWS CLI
**Example**
Per Linux, macOS o Unix:
```
aws docdb describe-pending-maintenance-actions \
--resource-identifier arn:aws:rds:us-east-1:001234567890:db:docdb
```
Per Windows:
```
aws docdb describe-pending-maintenance-actions ^
--resource-identifier arn:aws:rds:us-east-1:001234567890:db:docdb
```
L'aspetto dell'output di questa operazione è simile al seguente (formato JSON).
```
{
"PendingMaintenanceActions": [
{
"ResourceIdentifier": "arn:aws:rds:us-east-1:001234567890:cluster:sample-cluster",
"PendingMaintenanceActionDetails": [
{
"Action": "system-update",
"CurrentApplyDate": "2019-01-11T03:01:00Z",
"Description": "db-version-upgrade",
"ForcedApplyDate": "2019-01-18T03:01:00Z",
"AutoAppliedAfterDate": "2019-01-11T03:01:00Z"
}
]
}
]
}
```
È inoltre possibile restituire un elenco di risorse per un cluster specificando il `--filters` parametro dell'`describe-pending-maintenance-actions` AWS CLI operazione. Il formato dell'operazione `--filters` è `Name=filter-name,Values=resource-id,...`.
`db-cluster-id`è il valore accettabile per il `Name` parametro del filtro. Questo valore accetta un elenco di identificatori di cluster o ARNs. L'elenco restituito include solo le azioni di manutenzione in sospeso per i cluster identificati da questi identificatori o. ARNs
L'esempio seguente restituisce le operazioni di manutenzione in sospeso per i cluster `sample-cluster1` e `sample-cluster2`.
**Example**
Per Linux, macOS o Unix:
```
aws docdb describe-pending-maintenance-actions \
--filters Name=db-cluster-id,Values=sample-cluster1,sample-cluster2
```
Per Windows:
```
aws docdb describe-pending-maintenance-actions ^
--filters Name=db-cluster-id,Values=sample-cluster1,sample-cluster2
```
------
### Applica le date
Ogni operazione di manutenzione ha una rispettiva data di applicazione che è possibile trovare nella descrizione delle operazioni di manutenzione in attesa. Quando leggi l'output delle azioni di manutenzione in sospeso di AWS CLI, vengono elencate tre date. Questi valori di data `null` si riferiscono a quando la manutenzione è facoltativa. I valori vengono inseriti una volta pianificata o applicata l'azione di manutenzione corrispondente.
+ **CurrentApplyDate**—La data in cui l'azione di manutenzione verrà applicata immediatamente o durante la finestra di manutenzione successiva.
+ **ForcedApplyDate**—La data in cui la manutenzione verrà applicata automaticamente, indipendentemente dalla finestra di manutenzione.
+ **AutoAppliedAfterDate**—La data dopo la quale la manutenzione verrà applicata durante la finestra di manutenzione del cluster.
## Aggiornamenti avviati dall'utente
In qualità di utente di Amazon DocumentDB, puoi avviare aggiornamenti ai tuoi cluster o istanze. Ad esempio, puoi modificare la classe di un'istanza con una con più o meno memoria oppure puoi modificare il gruppo di parametri di un cluster. Amazon DocumentDB visualizza queste modifiche in modo diverso dagli aggiornamenti avviati da Amazon DocumentDB. Per ulteriori informazioni sulla modifica di un cluster o di un'istanza, consulta:
+ [Modifica di un cluster Amazon DocumentDB](db-cluster-modify.md)
+ [Modifica di un'istanza Amazon DocumentDB](db-instance-modify.md)
Per vedere un elenco delle modifiche in attesa avviate manualmente dall'utente, esegui il comando seguente.
**Example**
**Per visualizzare le modifiche in attesa avviate dall'utente per le tue istanze**
Per Linux, macOS o Unix:
```
aws docdb describe-db-instances \
--query 'DBInstances[*].[DBClusterIdentifier,DBInstanceIdentifier,PendingModifiedValues]'
```
Per Windows:
```
aws docdb describe-db-instances ^
--query 'DBInstances[*].[DBClusterIdentifier,DBInstanceIdentifier,PendingModifiedValues]'
```
L'aspetto dell'output di questa operazione è simile al seguente (formato JSON).
In questo caso, per `sample-cluster-instance` è in attesa il passaggio a una classe di istanza `db.r5.xlarge`, mentre per `sample-cluster-instance-2` non ci sono modifiche in attesa.
```
[
[
"sample-cluster",
"sample-cluster-instance",
{
"DBInstanceClass": "db.r5.xlarge"
}
],
[
"sample-cluster",
"sample-cluster-instance-2",
{}
]
]
```
## Gestione delle finestre di manutenzione di Amazon DocumentDB
Ogni istanza e ogni cluster hanno una finestra di manutenzione settimanale durante la quale vengono applicate le eventuali modifiche in attesa. La finestra di manutenzione è un'opportunità per controllare quando vengono applicate le modifiche e le patch software, nel caso in cui siano richieste o obbligatorie. Se un evento di manutenzione è pianificato per una settimana specifica, viene avviato durante la finestra di manutenzione di 30 minuti specificata dall'utente. La maggior parte degli eventi di manutenzione viene completata durante la finestra di manutenzione di 30 minuti, tuttavia l'esecuzione degli eventi di manutenzione di dimensioni maggiori può richiedere più di 30 minuti per il completamento.
La finestra di manutenzione di 30 minuti viene selezionata casualmente da un blocco di tempo di 8 ore per ogni regione. Se non specifichi una finestra di manutenzione preferita quando crei l'istanza o il cluster, Amazon DocumentDB assegna una finestra di manutenzione di 30 minuti in un giorno della settimana selezionato casualmente.
La seguente tabella elenca i blocchi temporali per ciascuna regione da cui sono assegnate le finestre di manutenzione predefinite.
| Nome della regione | Regione | Blocco di tempo UTC |
| --- | --- | --- |
| Stati Uniti orientali (Ohio) | us-east-2 | 03:00-11:00 |
| Stati Uniti orientali (Virginia settentrionale) | us-east-1 | 03:00-11:00 |
| Stati Uniti occidentali (Oregon) | us-west-2 | 06:00-14:00 |
| Africa (Città del Capo) | af-south-1 | 03:00 — 11:00 |
| Asia Pacific (Hong Kong) | ap-east-1 | 06:00-14:00 |
| Asia Pacifico (Hyderabad) | ap-south-2 | 06:30 — 14:30 |
| Asia Pacifico (Malesia) | ap-southeast-5 | 13:00-21:00 |
| Asia Pacifico (Mumbai) | ap-south-1 | 06:00-14:00 |
| Asia Pacifico (Osaka-Locale) | ap-northeast-3 | 12:00-20:00 |
| Asia Pacific (Seoul) | ap-northeast-2 | 13:00-21:00 |
| Asia Pacifico (Singapore) | ap-southeast-1 | 14:00-22:00 |
| Asia Pacifico (Sydney) | ap-southeast-2 | 12:00-20:00 |
| Asia Pacifico (Giacarta) | ap-southeast-3 | 08:00-16:00 |
| Asia Pacifico (Melbourne) | ap-southeast-4 | 11:00-19:00 |
| Asia Pacifico (Thailandia) | ap-southeast-7 | 15:00-23:00 |
| Asia Pacifico (Tokyo) | ap-northeast-1 | 13:00-21:00 |
| Canada (Centrale) | ca-central-1 | 03:00-11:00 |
| Cina (Pechino) | cn-north-1 | 06:00-14:00 |
| China (Ningxia) | cn-northwest-1 | 06:00-14:00 |
| Europa (Francoforte) | eu-central-1 | 21:00-05:00 |
| Europa (Zurigo) | eu-central-2 | 02:00-10:00 |
| Europa (Irlanda) | eu-west-1 | 22:00-06:00 |
| Europe (London) | eu-west-2 | 22:00-06:00 |
| Europe (Milan) | eu-south-1 | 02:00-10:00 |
| Europa (Parigi) | eu-west-3 | 23:59-07:29 |
| Europa (Spagna) | eu-south-2 | 02:00 — 10:00 |
| Europa (Stoccolma) | eu-north-1 | 04:00 — 12:00 |
| Messico (Centrale) | mx-central-1 | 03:00-11:00 |
| Medio Oriente (Emirati Arabi Uniti) | me-central-1 | 05:00 — 13:00 |
| Sud America (San Paolo) | sa-east-1 | 00:00-08:00 |
| Israele (Tel Aviv) | il-central-1 | 04:00-12:00 |
| AWS GovCloud (Stati Uniti orientali) | us-gov-east-1 | 17:00-01:00 |
| AWS GovCloud (Stati Uniti occidentali) | us-gov-west-1 | 06:00-14:00 |
### Modifica delle finestre di manutenzione di Amazon DocumentDB
La finestra di manutenzione deve essere eseguita nel momento di utilizzo più basso e quindi potrebbe essere necessario cambiarla di tanto in tanto. In questo lasso di tempo, il cluster o l'istanza non è disponibile solo in caso vengano applicate modifiche al sistema (ad esempio per un'operazione di storage su larga scala o la modifica della classe di un'istanza) che richiedono un'interruzione. L'inattività dura solo per il tempo strettamente necessario all'esecuzione delle modifiche richieste.
Per gli aggiornamenti al motore di database, Amazon DocumentDB utilizza la finestra di manutenzione preferita del cluster e non la finestra di manutenzione per le singole istanze.
**Per modificare la finestra di manutenzione**
+ Per un cluster: consulta [Modifica di un cluster Amazon DocumentDB](db-cluster-modify.md)
+ Per un'istanza: consulta [Modifica di un'istanza Amazon DocumentDB](db-instance-modify.md).
## Aggiornamenti del sistema operativo Amazon DocumentDB
Le istanze nei cluster Amazon DocumentDB richiedono occasionalmente aggiornamenti del sistema operativo. Amazon DocumentDB aggiorna il sistema operativo a una versione più recente per migliorare le prestazioni del database e il livello di sicurezza generale dei clienti. Gli aggiornamenti del sistema operativo non modificano la versione del motore del cluster o la classe di istanza di un'istanza Amazon DocumentDB.
Ti consigliamo di aggiornare prima le istanze reader in un cluster, poi l'istanza writer per massimizzare la disponibilità del cluster. Non è consigliabile aggiornare contemporaneamente le istanze Reader e Writer, poiché in caso di failover potrebbero verificarsi tempi di inattività più lunghi.
La maggior parte degli aggiornamenti del sistema operativo per Amazon DocumentDB sono facoltativi e non hanno una data prestabilita per applicarli. Tuttavia, se non applichi questi aggiornamenti per un certo periodo, alla fine potrebbero diventare necessari e applicati automaticamente durante la finestra di manutenzione dell'istanza. Questo serve a mantenere il livello di sicurezza del database. Per evitare interruzioni impreviste, ti consigliamo di applicare gli aggiornamenti del sistema operativo alle istanze di Amazon DocumentDB non appena sono disponibili e di impostare la finestra di manutenzione dell'istanza nel momento che preferisci, in base alle tue esigenze aziendali.
Per ricevere una notifica quando diventa disponibile un nuovo aggiornamento facoltativo, è possibile iscriversi a RDS-EVENT-0230 nella categoria degli eventi di patch di sicurezza. Per informazioni sulla sottoscrizione agli eventi di Amazon DocumentDB, [consulta Abbonamento agli abbonamenti agli eventi di Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/event-subscriptions.subscribe.html).
È possibile che si verifichi un failover durante la manutenzione del cluster o dell'istanza, se l'istanza è un'istanza primaria. Per migliorare la tua disponibilità, ti consigliamo di utilizzare più di un'istanza per i tuoi cluster Amazon DocumentDB. Per ulteriori informazioni, consulta [Failover di Amazon DocumentDB](failover.md).
**Nota**
Per alcune funzionalità di gestione, Amazon DocumentDB utilizza la tecnologia operativa condivisa con Amazon Relational Database Service (Amazon RDS).
**Importante**
L'istanza di Amazon DocumentDB verrà messa offline durante l'aggiornamento del sistema operativo. Puoi ridurre al minimo i tempi di inattività del cluster disponendo di un cluster multiistanza. Se non disponi di un cluster a più istanze, puoi scegliere di crearne temporaneamente uno aggiungendo istanze secondarie per eseguire questa manutenzione, quindi eliminando le istanze Reader aggiuntive una volta completata la manutenzione (verranno applicate le normali tariffe per l'istanza secondaria).
**Nota**
Potrebbe essere necessario rimanere aggiornati su tutti gli aggiornamenti facoltativi e obbligatori per soddisfare vari obblighi di conformità. Ti consigliamo di applicare regolarmente tutti gli aggiornamenti resi disponibili da Amazon DocumentDB durante le finestre di manutenzione.
Puoi usare Console di gestione AWS o the AWS CLI per determinare se è disponibile un aggiornamento.
------
#### [ Using the Console di gestione AWS ]
Per determinare se un aggiornamento è disponibile, utilizzare Console di gestione AWS:
1. [Accedi a e apri Console di gestione AWS la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. Nel pannello di navigazione, scegli **Clusters**, quindi seleziona l'istanza.
1. Scegli **Manutenzione**.
1. Nella sezione **Manutenzione in sospeso**, trova l'aggiornamento del sistema operativo.
![\[Console Amazon DocumentDB che mostra la colonna Maintenance per i cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/maintenance-available-1.png)
Puoi selezionare l'aggiornamento del sistema operativo e fare clic su **Applica ora o Applica** **alla finestra di manutenzione successiva** nella sezione Manutenzione in **sospeso**. **Se il valore di manutenzione è **nella finestra successiva**, rimanda gli elementi di manutenzione scegliendo Rinvia aggiornamento.** Non puoi rinviare un’azione di manutenzione se è già stata avviata.
****In alternativa, puoi scegliere l'istanza da un elenco di cluster facendo clic su Cluster nel riquadro di navigazione e selezionando **Applica ora o Applica** **alla finestra di manutenzione successiva** dal menu Azioni.****
------
#### [ Using the AWS CLI ]
Per determinare se è disponibile un aggiornamento utilizzando il AWS CLI, chiamate il `describe-pending-maintenance-actions` comando:
```
aws docdb describe-pending-maintenance-actions
```
```
{
"ResourceIdentifier": "arn:aws:docdb:us-east-1:123456789012:db:mydb2",
"PendingMaintenanceActionDetails": [
{
"Action": "system-update",
"Description": "New Operating System update is available"
}
]
}
```
------
Gli aggiornamenti del sistema operativo sono specifici per le versioni del motore e le classi di istanze di Amazon DocumentDB. Pertanto, le istanze di Amazon DocumentDB ricevono o richiedono aggiornamenti in momenti diversi. Quando è disponibile un aggiornamento del sistema operativo per l'istanza in base alla versione del motore e alla classe di istanza, l'aggiornamento viene visualizzato nella console. Può essere visualizzato anche eseguendo il AWS CLI `describe-pending-maintenance-actions` comando o chiamando l'operazione `DescribePendingMaintenanceActions` API.
Se non stai eseguendo l'ultima versione di patch del cluster del tuo motore Amazon DocumentDB, potresti non vedere l'aggiornamento del sistema operativo elencato come manutenzione disponibile. Per visualizzare e gestire l'aggiornamento del sistema operativo, devi prima eseguire l'aggiornamento alla versione più recente della patch del motore.
## Applicazione di patch ai cluster globali
La versione patch del motore dei cluster primari e secondari viene aggiornata durante la finestra di manutenzione di ciascun cluster. Riceverai una notifica non appena una nuova versione della patch del motore sarà disponibile in tutte le regioni. La notifica viene inviata tramite Health Dashboard e-mail.
Una volta ricevuta la notifica, puoi scegliere di applicare automaticamente queste patch del motore ai cluster secondari e primari. Applicate sempre prima le patch ai cluster secondari e poi al cluster primario. Questo ordine garantisce che FailOver ciò SwitchOver rimanga disponibile durante tutto il processo di applicazione delle patch.
**Importante**
Se hai già applicato le patch al cluster primario prima dei cluster secondari, aggiorna tutti i cluster secondari alla stessa versione il prima possibile. FailOver e non SwitchOver funzionerà finché tutti i cluster secondari e primari non utilizzeranno la stessa versione.
Se non si sceglie di applicare automaticamente, la patch verrà applicata automaticamente durante la successiva finestra di manutenzione di ogni cluster. Verrà applicata prima sui cluster secondari. Una volta applicata la patch a tutti i cluster secondari, la patch verrà applicata al cluster primario durante la successiva finestra di manutenzione del cluster primario.
Ti consigliamo di eseguire l'aggiornamento dei cluster di database primario e secondario alla stessa versione. È possibile eseguire un failover di database interregionale gestito su un database globale di Amazon DocumentDB solo se i cluster DB primari e secondari hanno la stessa versione del motore e lo stesso livello di patch.
Quando i cluster primari e secondari utilizzano versioni di patch del motore diverse, le SwitchOver richieste verranno FailOver rifiutate per evitare problemi di compatibilità delle versioni del motore. Ciò può verificarsi anche quando si aggiunge un nuovo cluster secondario a un database globale utilizzando una versione del motore più recente rispetto al cluster primario. Per evitare ciò, assicurati che ogni nuovo cluster secondario venga creato con la stessa versione del motore del cluster primario prima di aggiungerlo al database globale.
Una volta ricevuta la notifica della patch, consigliamo di aggiornare i cluster primari e secondari alla versione più recente il prima possibile per garantire SwitchOver e FailOver continuare a funzionare come previsto. Se la tua FailOver SwitchOver richiesta viene rifiutata, controlla la versione della patch del motore sui cluster primari e secondari. Se non corrispondono, controlla e applica la patch disponibile sui cluster secondari e primari.