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à.
# Ciclo di vita del cluster Amazon DocumentDB
Il ciclo di vita di un cluster Amazon DocumentDB include la creazione, la descrizione, la modifica e l'eliminazione del cluster. Questa sezione fornisce informazioni su come completare questi processi.
**Topics**
+ [Creazione di un cluster](db-cluster-create.md)
+ [Descrizione dei cluster](db-cluster-view-details.md)
+ [Modifica di un cluster](db-cluster-modify.md)
+ [Determinazione della manutenzione in sospeso](db-cluster-determine-pending-maintenance.md)
+ [Patch che aggiorna la versione del motore di un cluster](db-cluster-version-upgrade.md)
+ [Avvio e arresto di un cluster](db-cluster-stop-start.md)
+ [Eliminazione di un cluster](db-cluster-delete.md)
# Creazione di un cluster Amazon DocumentDB
Un cluster Amazon DocumentDB è composto da istanze e un volume di cluster che rappresenta i dati del cluster. Il volume cluster viene replicato in sei modi su tre zone di disponibilità come un unico volume virtuale. Il cluster contiene un'istanza primaria e, facoltativamente, fino a 15 istanze di replica.
Le seguenti sezioni mostrano come creare un cluster Amazon DocumentDB utilizzando il Console di gestione AWS o il. AWS CLI Puoi quindi aggiungere al cluster istanze di replica aggiuntive. Quando usi la console per creare il tuo cluster Amazon DocumentDB, contemporaneamente viene creata automaticamente un'istanza primaria per te. Se usi il AWS CLI per creare il tuo cluster Amazon DocumentDB, dopo che lo stato del cluster è *disponibile*, devi creare l'istanza principale per quel cluster.
## Prerequisiti
Di seguito sono riportati i prerequisiti per la creazione di un cluster Amazon DocumentDB.
Se non ne hai uno Account AWS, completa i seguenti passaggi per crearne uno.
**Per iscriverti a un Account AWS**
1. Apri la [https://portal.aws.amazon.com/billing/registrazione.](https://portal.aws.amazon.com/billing/signup)
1. Segui le istruzioni online.
Nel corso della procedura di registrazione riceverai una telefonata o un messaggio di testo e ti verrà chiesto di inserire un codice di verifica attraverso la tastiera del telefono.
Quando ti iscrivi a un Account AWS, *Utente root dell'account AWS*viene creato un. L’utente root dispone dell’accesso a tutte le risorse e tutti i Servizi AWS nell’account. Come best practice di sicurezza, assegna l’accesso amministrativo a un utente e utilizza solo l’utente root per eseguire [attività che richiedono l’accesso di un utente root](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks).
### Prerequisiti per VPC
Puoi creare un cluster Amazon DocumentDB solo in un Amazon Virtual Private Cloud (Amazon VPC). Il tuo Amazon VPC deve avere almeno una sottorete in ciascuna di almeno due zone di disponibilità per poterlo utilizzare con un cluster Amazon DocumentDB. Distribuendo le istanze del cluster tra le zone di disponibilità, ti assicuri che le istanze siano disponibili nel cluster nel caso improbabile di un errore nella zona di disponibilità.
### Prerequisiti per la sottorete
Quando crei un cluster Amazon DocumentDB, devi scegliere un VPC e il gruppo di sottoreti corrispondente all'interno di quel VPC per avviare il cluster. Le sottoreti determinano la zona di disponibilità e l'intervallo IP all'interno della zona di disponibilità che desideri utilizzare per avviare un'istanza. In questa documentazione i termini *sottorete* e *zona di disponibilità* saranno utilizzati indifferentemente. Un gruppo di sottoreti è un set di sottoreti denominato (o zone di disponibilità). Ciò che un gruppo di sottoreti consente di fare è specificare le zone di disponibilità che si desidera utilizzare per avviare le istanze di Amazon DocumentDB. Ad esempio, per avere alta disponibilità in un cluster con tre istanze, è consigliabile effettuare il provisioning di ciascuna di queste istanze in zone di disponibilità separate. In questo modo, se una singola zona di disponibilità non funziona, sarà interessata solo una singola istanza.
Le istanze di Amazon DocumentDB possono attualmente essere fornite in un massimo di tre zone di disponibilità. Anche se un gruppo di sottoreti ha più di tre sottoreti, puoi utilizzarne solo tre per creare un cluster Amazon DocumentDB. Di conseguenza, quando crei un gruppo di sottoreti, è consigliabile scegliere solo le tre sottoreti in cui desideri distribuire le tue istanze. Negli Stati Uniti orientali (Virginia settentrionale), un gruppo di sottoreti può avere sei sottoreti (o zone di disponibilità). Tuttavia, quando viene effettuato il provisioning di un cluster Amazon DocumentDB, Amazon DocumentDB sceglie tre di quelle zone di disponibilità che utilizza per il provisioning delle istanze.
Ad esempio, supponiamo che durante la creazione di un cluster, Amazon DocumentDB scelga le zone di disponibilità \$11A, 1B e 1C\$1. Se tenti di creare un'istanza nella zona di disponibilità \$11D\$1, la chiamata API non riesce. Tuttavia, se scegli di creare un'istanza senza specificare una particolare zona di disponibilità, Amazon DocumentDB sceglie una zona di disponibilità per tuo conto. Amazon DocumentDB utilizza un algoritmo per bilanciare il carico delle istanze tra le zone di disponibilità per aiutarti a raggiungere un'elevata disponibilità. Ad esempio, se viene effettuato il provisioning di tre istanze, per impostazione predefinita il provisioning viene effettuato nelle tre zone di disponibilità e non in una sola di esse.
**Raccomandazioni:**
+ A meno che non si abbia un motivo specifico, creare sempre un gruppo di sottoreti con tre sottoreti. In questo modo si assicura che i cluster con tre o più istanze possano ottenere una disponibilità più elevata in quanto ne verrà effettuato il provisioning su tre zone di disponibilità.
+ Distribuisci sempre le istanze in più zone di disponibilità per ottenere una disponibilità più elevata. Non posizionare mai tutte le istanze di un cluster in una singola zona di disponibilità.
+ Poiché gli eventi di failover possono verificarsi in qualsiasi momento, non devi presumere che un'istanza primaria o le istanze di replica siano sempre in una determinata zona di disponibilità.
### Prerequisiti aggiuntivi
Di seguito sono riportati alcuni prerequisiti aggiuntivi per la creazione di un cluster Amazon DocumentDB:
+ Se ti connetti AWS utilizzando credenziali AWS Identity and Access Management (IAM), il tuo account IAM deve disporre di politiche IAM che concedano le autorizzazioni necessarie per eseguire le operazioni di Amazon DocumentDB.
Se utilizzi un account IAM per accedere alla console Amazon DocumentDB, devi prima accedervi Console di gestione AWS con il tuo account IAM. [Quindi vai alla console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
+ Per personalizzare i parametri di configurazione per il cluster, devi specificare un gruppo di parametri del cluster e un gruppo di parametri con le impostazioni dei parametri richieste. Per informazioni sulla creazione o la modifica di un gruppo di parametri del cluster o un gruppo di parametri, consulta [Gestione dei gruppi di parametri del cluster Amazon DocumentDB](cluster_parameter_groups.md).
+ È necessario determinare il numero di TCP/IP porta che si desidera specificare per il cluster. I firewall di alcune aziende bloccano le connessioni alle porte predefinite per Amazon DocumentDB. Se il firewall della tua azienda blocca la porta predefinita, scegli un'altra porta per il cluster. Tutte le istanze in un cluster utilizzano la stessa porta.
## Creazione di un cluster e di un'istanza primaria utilizzando Console di gestione AWS
Le seguenti procedure descrivono come utilizzare la console per avviare un cluster Amazon DocumentDB con una o più istanze.
### Creare un cluster: utilizzando le impostazioni predefinite
**Per creare un cluster con istanze utilizzando le impostazioni predefinite utilizzando il 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. Se desideri creare il cluster in una regione Regione AWS diversa da quella degli Stati Uniti orientali (Virginia settentrionale), scegli la regione dall'elenco nella sezione in alto a destra della console.
1. Nel riquadro di navigazione scegliere **Clusters (Cluster)**, quindi **Create (Crea)**.
**Suggerimento**
Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina.
1. Nella pagina **Crea cluster Amazon DocumentDB**, completa il riquadro **Configurazione**.
1. **Identificatore del cluster**: accetta il nome fornito da Amazon DocumentDB o immetti un nome per il cluster, ad esempio. **sample-cluster**
Vincoli per la denominazione del cluster:
+ La lunghezza è di [1—63] lettere, numeri o trattini.
+ Il primo carattere deve essere una lettera.
+ Non può terminare con un trattino o contenere due trattini consecutivi.
+ Deve essere unico per tutti i cluster di Amazon RDS, Neptune e Amazon DocumentDB per regione. Account AWS
1. **Versione del motore: accetta la versione** predefinita del motore 5.0.0 o, facoltativamente, scegli 8.0.0, 4.0.0 o 3.6.0.
1. **Classe di istanza**: accettate l'impostazione predefinita o scegliete la classe di istanza `db.r5.large` desiderata dall'elenco.
1. **Numero di istanze**: nell'elenco, scegliete il numero di istanze che desiderate creare con questo cluster. La prima istanza è l'istanza primaria, tutte le altre sono istanze di replica di sola lettura. È possibile aggiungere ed eliminare le istanze in un secondo momento, se necessario. Per impostazione predefinita, un cluster Amazon DocumentDB viene avviato con tre istanze (una principale e due repliche).
1. Completa la sezione Configurazione dello storage del **cluster**.
Scegli tra **Amazon DocumentDB Standard** (impostazione predefinita) o **Amazon DocumentDB I/O Optimized**. Per ulteriori informazioni, consulta [Configurazioni di storage in cluster Amazon DocumentDB](db-cluster-storage-configs.md).
1. Compila il riquadro **Authentication (Autenticazione)**.
1. **Nome utente**: immetti un nome per l'utente principale. Per accedere al cluster, è necessario utilizzare il nome utente principale.
Vincoli principali di denominazione degli utenti:
+ La lunghezza è di [1-63] caratteri alfanumerici.
+ Il primo carattere deve essere una lettera.
+ Non può essere una parola riservata del motore di database.
1. Scegli una delle seguenti opzioni di password:
+ **Gestito in Gestione dei segreti AWS**: scegli questa opzione se desideri Gestione dei segreti AWS gestire automaticamente la password dell'utente principale.
Se scegli questa opzione, configura la chiave KMS creandone una tua o usando una chiave creata da Secrets Manager.
+ **Gestione automatica**: scegli questa opzione se desideri gestire automaticamente la password dell'utente principale. Se scegli questa opzione, inserisci una password per l'utente principale, quindi confermala. Per accedere al cluster, è necessario utilizzare la password dell'utente principale.
Vincoli per la password:
+ La lunghezza è di [8-100] caratteri ASCII stampabili.
+ È possibile utilizzare qualsiasi carattere ASCII stampabile eccetto i seguenti:
+ **/** (barra)
+ **"** (virgolette doppie)
+ **@** (simbolo chiocciola)
1. Nella parte inferiore della schermata, scegli uno dei seguenti:
+ Per creare subito il cluster, scegli **Create cluster (Crea cluster)**.
+ Per non creare il cluster, scegli **Cancel (Annulla)**.
+ Per configurare ulteriormente il cluster prima di crearlo, scegliere **Show additional configurations (Mostra configurazioni aggiuntive)**, quindi continuare in [Creare un cluster: configurazioni aggiuntive](#db-cluster-create-con-additional-configs).
Le configurazioni comprese nella sezione **Additional Configurations (Configurazioni aggiuntive)** sono:
+ **Impostazioni di rete**: l'impostazione predefinita prevede l'utilizzo del gruppo di `default` sicurezza VPC.
+ **Opzioni del cluster**: l'impostazione predefinita prevede l'utilizzo della porta 27017 e il gruppo di parametri predefinito.
+ **Crittografia**: l'impostazione predefinita è abilitare la crittografia utilizzando la chiave. `(default) aws/rds`
**Importante**
Una volta che un cluster è crittografato, non può essere decrittografato.
+ **Backup**: l'impostazione predefinita prevede di conservare i backup per 1 giorno e lasciare che Amazon DocumentDB scelga la finestra di backup.
+ **Esportazioni di log**: l'impostazione predefinita prevede di non esportare i log di controllo in Logs. CloudWatch
+ **Manutenzione**: l'impostazione predefinita prevede che Amazon DocumentDB scelga la finestra di manutenzione.
+ **Protezione dall'eliminazione**: protegge il cluster dall'eliminazione accidentale. L'impostazione predefinita per i cluster creati utilizzando la console è *abilitata*.
Se accetti le impostazioni predefinite ora, potrai modificare la maggior parte di esse successivamente modificando il cluster.
1. Abilita la connessione in entrata per il gruppo di sicurezza del cluster.
Se non sono state modificate le impostazioni predefinite per il cluster, questo è stato creato utilizzando il gruppo di sicurezza predefinito per il VPC predefinito nella regione selezionata. Per connetterti ad Amazon DocumentDB, devi abilitare le connessioni in entrata sulla porta 27017 (o sulla porta di tua scelta) per il gruppo di sicurezza del cluster.
**Per aggiungere una connessione in entrata al gruppo di sicurezza del cluster**
1. Accedi Console di gestione AWS e apri la console Amazon EC2 all'indirizzo. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)
1. Nella sezione **Resources (Risorse)** della finestra principale, selezionare **Security groups (Gruppi di sicurezza)**.
![\[Immagine: elenco delle risorse che evidenzia l'opzione di collegamento Security Groups.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-ec2-security-groups.png)
1. Dall'elenco di gruppi di sicurezza, individuare il gruppo di sicurezza utilizzato quando si crea il cluster (è probabile che il gruppo di sicurezza *predefinito* ) e scegliere la casella a sinistra del nome del gruppo di sicurezza.
![\[Immagine: elenco dei gruppi di sicurezza che evidenzia un gruppo di sicurezza con la casella selezionata.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-ec2-default-sg.png)
1. Dal menu **Actions (Operazioni)** , scegliere **Edit inbound rules (Modifica regole in entrata)**, quindi scegliere o inserire i vincoli della regola.
1. **Tipo**: dall'elenco, scegli il protocollo da aprire al traffico di rete.
1. **Protocollo**: dall'elenco, scegli il tipo di protocollo.
1. **Intervallo di porte**: per una regola personalizzata, inserisci un numero di porta o un intervallo di porte. Assicurati che il numero di porta o l'intervallo includa la porta specificata quando hai creato il cluster (valore predefinito: 27017).
1. **Fonte**: specifica il traffico che può raggiungere l'istanza. Dall'elenco, scegliere l'origine del traffico. Se si sceglie **Custom (Personalizzata)**, specificare un solo indirizzo IP o un intervallo di indirizzi IP nella notazione CIDR (ad es., 203.0.113.5/32).
1. **Descrizione**: inserisci una descrizione per questa regola.
1. Dopo aver creato la regola, scegliere **Save (Salva)**.
### Creare un cluster: configurazioni aggiuntive
Se desideri accettare le impostazioni predefinite per il cluster, puoi ignorare le seguenti fasi e scegliere **Create cluster (Crea cluster)**.
1. Completa il riquadro **Network settings (Impostazioni di rete)**.
![\[Screenshot che mostra il riquadro delle impostazioni di rete e le fasi per la configurazione delle impostazioni di rete.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/create-db-cluster-console-network-settings.png)
1. **Virtual Private Cloud (VPC)**: nell'elenco, scegli l'Amazon VPC in cui desideri avviare questo cluster.
1. **Gruppo di sottoreti**: nell'elenco, scegli il gruppo di sottoreti che desideri utilizzare per questo cluster.
1. **Gruppi di sicurezza VPC**: nell'elenco, scegli il gruppo di sicurezza VPC per questo cluster.
1. Completa il riquadro **Cluster options (Opzioni cluster)**.
![\[Screenshot che mostra il riquadro delle opzioni cluster con le fasi per la configurazione delle impostazioni dei cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/create-db-cluster-console-cluster-options.png)
1. **Porta del database**: utilizza le frecce su e giù per impostare la TCP/IP porta che le applicazioni utilizzeranno per connettersi all'istanza.
1. **Gruppo di parametri del cluster**: nell'elenco dei gruppi di parametri, scegli il gruppo di parametri del cluster per questo cluster.
1. Completa il riquadro **Encryption (Crittografia)**.
![\[Screenshot del riquadro di crittografia che mostra le fasi per la crittografia del cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/encrypt-at-rest.png)
1. **E ncryption-at-rest** —Scegliete una delle seguenti opzioni:
+ **Abilita crittografia: impostazione** predefinita. Tutti i dati inattivi vengono crittografati. Se scegli di crittografare i dati, non è possibile annullare questa operazione.
+ **Disattiva la crittografia**: i dati non sono crittografati.
1. **AWS Chiave KMS**: è disponibile solo se si crittografano i dati. Scegliere nell'elenco la chiave che si desidera utilizzare per crittografare i dati nel cluster. Il valore predefinito è `(default) aws/rds`.
Se si sceglie **Enter a key ARN (Immetti ARN chiave)**, è necessario immettere un Amazon Resource Name (ARN) per la chiave.
1. Completa il riquadro **Backup**.
![\[Screenshot del riquadro Backup che mostra le fasi per la configurazione della finestra di backup del cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/create-db-cluster-console-backup.png)
1. **Periodo di conservazione dei backup**: nell'elenco, scegli il numero di giorni in cui conservare i backup automatici di questo cluster prima di eliminarli.
1. **Finestra di backup**: imposta l'ora e la durata giornaliere durante le quali Amazon DocumentDB deve effettuare i backup di questo cluster.
1. **Ora di inizio**: nel primo elenco, scegli l'ora di inizio (UTC) per avviare i backup automatici. Dal secondo elenco scegli il minuto dell'ora in cui desideri inizino i backup automatici.
1. **Durata**: nell'elenco, scegli il numero di ore da assegnare alla creazione di backup automatici.
1. Completa il riquadro **Esportazioni dei log** selezionando i tipi di log che desideri esportare in Logs. CloudWatch
![\[Screenshot del riquadro delle esportazioni di log che mostra le fasi per configurare il logging DML del cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/create-db-cluster-console-log-exports.png)
+ **Registri di controllo**: seleziona questa opzione per abilitare l'esportazione dei log di controllo in Amazon Logs. CloudWatch Se selezioni **Audit logs (Log di audit)**, devi abilitare `audit_logs` nel gruppo personalizzato di parametri del cluster. Per ulteriori informazioni, consulta [Controllo degli eventi di Amazon DocumentDB](event-auditing.md).
+ **Registri del profiler: seleziona questa opzione per abilitare l'esportazione dei log del profiler operativo su Amazon Logs**. CloudWatch Se selezioni **Profiler logs (Log del profiler)**, devi anche modificare i seguenti parametri nel gruppo personalizzato dei parametri del cluster:
+ `profiler``enabled`—Imposta su.
+ `profiler_threshold_ms`—Imposta su un valore `[0-INT_MAX]` per impostare la soglia per le operazioni di profilatura.
+ `profiler_sampling_rate`—Imposta su un valore `[0.0-1.0]` per impostare la percentuale di operazioni lente da profilare.
Per ulteriori informazioni, consulta [Profilazione delle operazioni di Amazon DocumentDB](profiling.md).
1. Compilare il riquadro **Maintenance (Manutenzione)**.
![\[Screenshot del riquadro Maintenance (Manutenzione) che mostra le fasi per la configurazione della finestra di manutenzione del cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/create-db-cluster-console-maintenance.png)
1. Scegli una delle seguenti opzioni
+ **Seleziona finestra**: puoi specificare il giorno della settimana, l'ora di inizio UTC e la durata affinché Amazon DocumentDB esegua la manutenzione del cluster.
1. **Giorno di inizio**: nell'elenco, scegli il giorno della settimana in cui iniziare la manutenzione del cluster.
1. **Ora di inizio**: negli elenchi, scegli l'ora e il minuto (UTC) per avviare la manutenzione.
1. **Durata**: nell'elenco, scegli quanto tempo dedicare alla manutenzione del cluster. Se la manutenzione non può essere completata nel tempo specificato, il processo di manutenzione proseguirà oltre l'orario indicato fino al completamento.
+ **Nessuna preferenza**: Amazon DocumentDB sceglie il giorno della settimana, l'ora di inizio e la durata per eseguire la manutenzione.
1. Per aggiungere uno o più tag a questo cluster, completare il riquadro **Tags (Tag)**.
![\[Schermata del selettore dell'abilitazione della protezione, che è selezionato.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/create-db-cluster-console-tags.png)
Per ogni tag che si desidera aggiungere al cluster, ripetere i seguenti passaggi. È possibile averne fino a 10 in un cluster.
1. Scegli **Aggiungi tag**.
1. Digita il tag **Key (Chiave)**.
1. Opzionalmente digita il **Value (Valore)** del tag.
Per rimuovere un tag, scegli **Remove (Rimuovi)**.
1. Quando si crea un cluster utilizzando la console, la **Deletion Protection (Protezione dall'eliminazione)** viene abilitata per impostazione predefinita. Per disabilitare la protezione dall'eliminazione, deseleziona **Enable deletion protection (Abilita la protezione dall'eliminazione)**. Quando abilitata, la protezione dall'eliminazione impedisce che un cluster venga eliminato. Per eliminare un cluster protetto dall'eliminazione, è necessario prima modificare il cluster per disabilitare la protezione dall'eliminazione.
![\[Schermata del selettore dell'abilitazione della protezione, che è selezionato.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/create-db-cluster-console-deletion-protection.png)
Per ulteriori informazioni sulla protezione dall'eliminazione, consultare [Eliminazione di un cluster Amazon DocumentDB](db-cluster-delete.md).
1. Per creare il cluster, scegli **Create cluster (Crea cluster)**. Altrimenti, scegli **Cancel** (Annulla).
## Creazione di un cluster utilizzando il AWS CLI
Le seguenti procedure descrivono come utilizzare AWS CLI per avviare un cluster Amazon DocumentDB e creare una replica Amazon DocumentDB.
**Parameters**
+ **--db-cluster-identifier**: obbligatorio. Una stringa di lettere minuscole che identifica il cluster.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/db-cluster-create.html)
+ **--engine**: obbligatorio. Deve essere **docdb**.
+ **--deletion-protection \$1 --no-deletion-protection**—Facoltativo. Quando è abilitata la protezione dall'eliminazione, questa impedisce che il cluster venga eliminato. Quando si utilizza la AWS CLI, l'impostazione predefinita prevede che la protezione da eliminazione sia disabilitata.
Per ulteriori informazioni sulla protezione dall'eliminazione, consultare [Eliminazione di un cluster Amazon DocumentDB](db-cluster-delete.md).
+ **--storage-type standard \$1 iopt1**—Facoltativo. Default: **standard**. La configurazione di archiviazione del cluster. I valori validi sono `standard` (Standard) o `iopt1` (ottimizzato per l'I/O).
+ **--master-username**: obbligatorio. Il nome utilizzato per autenticare l'utente.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/db-cluster-create.html)
+ **--master-user-password**—Facoltativo. La password utilizzata per autenticare l'utente.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/db-cluster-create.html)
+ **--manage-master-user-password**—Facoltativo. Amazon DocumentDB genera la password dell'utente principale e la gestisce per tutto il suo ciclo di vita in Secrets Manager.
Per altri parametri, vedi [CreateDBCluster](API_CreateDBCluster.md).
**Per avviare un cluster Amazon DocumentDB utilizzando AWS CLI**
Per creare un cluster Amazon DocumentDB, chiama il. `create-db-cluster` AWS CLI Il AWS CLI comando seguente crea un cluster Amazon DocumentDB denominato `sample-cluster` con la protezione da eliminazione abilitata. Per ulteriori informazioni sulla protezione da eliminazione, consulta[Eliminazione di un cluster Amazon DocumentDB](db-cluster-delete.md).
Inoltre, `--engine-version` è un parametro opzionale che utilizza per impostazione predefinita l'ultima versione principale del motore. L'attuale versione predefinita del motore è 5.0.0 (nota: Amazon DocumentDB 8.0 è disponibile ma deve essere specificata in modo esplicito). Quando vengono rilasciate nuove versioni principali del motore, la versione del motore di default di viene aggiornata in `--engine-version` modo da riflettere l'ultima versione principale del motore. Di conseguenza, per i carichi di lavoro di produzione, in particolare quelli che dipendono da script, automazione o CloudFormation modelli, si consiglia di specificare esplicitamente la versione `--engine-version` principale desiderata.
**Nota**
Se non `vpc-security-group-id` viene specificato un `db-subnet-group-name` or, Amazon DocumentDB utilizzerà il gruppo di sottoreti e il gruppo di sicurezza Amazon VPC predefiniti per la regione specificata.
Per Linux, macOS o Unix:
```
aws docdb create-db-cluster \
--db-cluster-identifier sample-cluster \
--engine docdb \
--engine-version 5.0.0 \
--deletion-protection \
--master-username masteruser \
--master-user-password password
```
Per Windows:
```
aws docdb create-db-cluster ^
--db-cluster-identifier sample-cluster ^
--engine docdb ^
--engine-version 5.0.0 ^
--deletion-protection ^
--master-username masteruser ^
--master-user-password password
```
L'aspetto dell'output di questa operazione è simile al seguente (formato JSON).
```
{
"DBCluster": {
"StorageEncrypted": false,
"DBClusterMembers": [],
"Engine": "docdb",
"DeletionProtection" : "enabled",
"ClusterCreateTime": "2018-11-26T17:15:19.885Z",
"DBSubnetGroup": "default",
"EngineVersion": "5.0.0",
"MasterUsername": "masteruser",
"BackupRetentionPeriod": 1,
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
"DBClusterIdentifier": "sample-cluster",
"MultiAZ": false,
"DBClusterParameterGroup": "default.docdb5.0",
"PreferredBackupWindow": "09:12-09:42",
"DbClusterResourceId": "cluster-KQSGI4MHU4NTDDRVNLNTU7XVAY",
"PreferredMaintenanceWindow": "tue:04:17-tue:04:47",
"Port": 27017,
"Status": "creating",
"ReaderEndpoint": "sample-cluster.cluster-ro-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com",
"AssociatedRoles": [],
"HostedZoneId": "ZNKXTT8WH85VW",
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-77186e0d",
"Status": "active"
}
],
"AvailabilityZones": [
"us-east-1a",
"us-east-1c",
"us-east-1e"
],
"Endpoint": "sample-cluster.cluster-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com"
}
}
```
La creazione del cluster richiede diversi minuti. Puoi usare Console di gestione AWS o AWS CLI per monitorare lo stato del tuo cluster. Per ulteriori informazioni, consulta [Monitoraggio dello stato di un cluster Amazon DocumentDB](monitoring_docdb-cluster_status.md).
**Importante**
Quando si utilizza AWS CLI per creare un cluster Amazon DocumentDB, non viene creata alcuna istanza. Di conseguenza, devi creare esplicitamente un'istanza primaria e le eventuali istanze di replica di cui hai bisogno. È possibile utilizzare la console o AWS CLI creare le istanze. Per ulteriori informazioni, consulta [Aggiungere un'istanza Amazon DocumentDB a un cluster](db-instance-add.md).
Per ulteriori informazioni, consulta [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_CreateDBCluster.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_CreateDBCluster.html)*Amazon DocumentDB API* Reference.
# Descrizione dei cluster Amazon DocumentDB
Puoi utilizzare la Console di gestione Amazon DocumentDB o AWS CLI visualizzare dettagli come endpoint di connessione, gruppi di sicurezza e gruppi di parametri relativi ai tuoi cluster Amazon DocumentDB. VPCs
Per ulteriori informazioni, consulta gli argomenti seguenti:
+ [Monitoraggio dello stato di un cluster Amazon DocumentDB](monitoring_docdb-cluster_status.md)
+ [Individuazione degli endpoint di un cluster](db-cluster-endpoints-find.md)
------
#### [ Using the Console di gestione AWS ]
Utilizza la seguente procedura per visualizzare i dettagli di un cluster Amazon DocumentDB specificato utilizzando la console.
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**.
**Suggerimento**
Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina.
1. Nell'elenco dei cluster scegli il nome del cluster di cui desideri visualizzare i dettagli. Le informazioni sul cluster vengono organizzate nei seguenti gruppi:
+ **Riepilogo**: informazioni generali sul cluster, tra cui la versione del motore, lo stato del cluster, la manutenzione in corso e lo stato del relativo gruppo di parametri.
+ **Connettività e sicurezza**: la sezione **Connect** elenca gli endpoint di connessione per connettersi a questo cluster con la shell mongo o con un'applicazione. Nella sezione **Security Groups (Gruppi di sicurezza)** sono elencati i gruppi di protezione associati a questo cluster e l'ID VPC e le descrizioni.
+ **Configurazione**: la sezione dei **dettagli del cluster** elenca i dettagli sul cluster, inclusi l'Amazon Resource Name (ARN), l'endpoint e il gruppo di parametri del cluster. Vengono inoltre elencate le informazioni di backup del cluster, i dettagli di manutenzione e le impostazioni di sicurezza e di rete. La sezione **Cluster instances (Istanze del cluster)** elenca le istanze che appartengono a questo cluster con lo stato del ruolo e del gruppo di parametri del cluster di ogni istanza.
+ **Monitoraggio**: i parametri di Amazon CloudWatch Logs per questo cluster. Per ulteriori informazioni, consulta [Monitoraggio di Amazon DocumentDB con CloudWatch](cloud_watch.md).
+ **Eventi e tag**: la sezione **Eventi recenti** elenca gli eventi recenti per questo cluster. Amazon DocumentDB registra gli eventi relativi a cluster, istanze, snapshot, gruppi di sicurezza e gruppi di parametri del cluster. Queste informazioni includono la data, l'ora e il messaggio associati a ciascun evento. La sezione **Tag** elenca i tag allegati al cluster.
------
#### [ Using the AWS CLI ]
Per visualizzare i dettagli dei tuoi cluster Amazon DocumentDB utilizzando il AWS CLI, usa il `describe-db-clusters` comando come mostrato negli esempi seguenti. Per ulteriori informazioni, consulta [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBClusters.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBClusters.html)*Amazon DocumentDB Resource Management API* Reference.
**Nota**
Per alcune funzionalità di gestione come la gestione del ciclo di vita di cluster e istanze, Amazon DocumentDB sfrutta la tecnologia operativa condivisa con Amazon RDS. Il parametro `filterName=engine,Values=docdb` filter restituisce solo cluster Amazon DocumentDB.
**Example**
**Esempio 1: elenca tutti i cluster Amazon DocumentDB**
Il AWS CLI codice seguente elenca i dettagli per tutti i cluster Amazon DocumentDB in una regione.
```
aws docdb describe-db-clusters --filter Name=engine,Values=docdb
```
L'aspetto dell'output di questa operazione è simile al seguente.
```
{
"DBClusters": [
{
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster-1",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
...
},
{
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster-2",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
...
},
{
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster-3",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
...
}
]
}
```
**Example**
**Esempio 2: elenca tutti i dettagli per un cluster Amazon DocumentDB specificato**
Il AWS CLI codice seguente elenca i dettagli del cluster`sample-cluster`.
Per Linux, macOS o Unix:
```
aws docdb describe-db-clusters \
--filter Name=engine,Values=docdb \
--db-cluster-identifier sample-cluster
```
Per Windows:
```
aws docdb describe-db-clusters ^
--filter Name=engine,Values=docdb ^
--db-cluster-identifier sample-cluster
```
L'aspetto dell'output di questa operazione è simile al seguente.
```
{
"DBClusters": [
{
"AllocatedStorage": 1,
"AvailabilityZones": [
"us-east-1c",
"us-east-1a",
"us-east-1d"
],
"BackupRetentionPeriod": 2,
"DBClusterIdentifier": "sample-cluster",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
"EarliestRestorableTime": "2023-11-07T22:34:08.148000+00:00",
"Endpoint": "sample-cluster.node.us-east-1.amazon.com",
"ReaderEndpoint": "sample-cluster.node.us-east-1.amazon.com",
"MultiAZ": false,
"Engine": "docdb",
"EngineVersion": "5.0.0",
"LatestRestorableTime": "2023-11-10T07:21:16.772000+00:00",
"Port": 27017,
"MasterUsername": "chimeraAdmin",
"PreferredBackupWindow": "22:22-22:52",
"PreferredMaintenanceWindow": "sun:03:01-sun:03:31",
"ReadReplicaIdentifiers": [],
"DBClusterMembers": [
{
"DBInstanceIdentifier": "sample-instance-1",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
{
"DBInstanceIdentifier": "sample-instance-2",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
],
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-9084c2ec",
"Status": "active"
}
],
"HostedZoneId": "Z06853723JYKYBXTJ49RB",
"StorageEncrypted": false,
"DbClusterResourceId": "cluster-T4LGLANHVAPGQYYULWUDKLVQL4",
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
"AssociatedRoles": [],
"IAMDatabaseAuthenticationEnabled": false,
"ClusterCreateTime": "2023-11-06T18:05:41.568000+00:00",
"EngineMode": "provisioned",
"DeletionProtection": false,
"HttpEndpointEnabled": false,
"CopyTagsToSnapshot": false,
"CrossAccountClone": false,
"DomainMemberships": [],
"TagList": [],
"StorageType": "iopt1",
"AutoMinorVersionUpgrade": false,
"NetworkType": "IPV4",
"IOOptimizedNextAllowedModificationTime": "2023-12-07T18:05:41.580000+00:00"
}
]
}
```
**Example**
**Esempio 3: elenca dettagli specifici per un cluster Amazon DocumentDB**
Per elencare un sottoinsieme dei dettagli dei cluster utilizzando il AWS CLI, aggiungi un elenco `--query` che specifichi quali membri del cluster l'`describe-db-clusters`operazione deve elencare. Il parametro `--db-cluster-identifier` è l'identificatore per il particolare cluster del quale desideri visualizzare i dettagli. *Per ulteriori informazioni sulle interrogazioni, consulta [Come filtrare l'output con l'`--query`opzione nella Guida per l'](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output.html#controlling-output-filter)utente.AWS Command Line Interface *
L'esempio seguente elenca le istanze in un cluster Amazon DocumentDB.
Per Linux, macOS o Unix:
```
aws docdb describe-db-clusters \
--filter Name=engine,Values=docdb \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterMembers]'
```
Per Windows:
```
aws docdb describe-db-clusters ^
--filter Name=engine,Values=docdb ^
--db-cluster-identifier sample-cluster ^
--query 'DBClusters[*].[DBClusterMembers]'
```
L'aspetto dell'output di questa operazione è simile al seguente.
```
[
[
[
{
"DBInstanceIdentifier": "sample-instance-1",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
{
"DBInstanceIdentifier": "sample-instance-2",
"IsClusterWriter": false,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
}
]
]
]
```
------
# Modifica di un cluster Amazon DocumentDB
Per modificare un cluster, il cluster deve essere nello stato *disponibile*. Non è possibile modificare un cluster arrestato. Se il cluster viene arrestato, per prima cosa avviare il cluster, attendere che diventi *disponibile*, quindi apportare le modifiche desiderate. Per ulteriori informazioni, consulta [Arresto e avvio di un cluster Amazon DocumentDB](db-cluster-stop-start.md).
------
#### [ Using the Console di gestione AWS ]
Utilizza la seguente procedura per modificare uno specifico cluster Amazon DocumentDB utilizzando la console.
**Come modificare un cluster Amazon DocumentDB**
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**.
**Suggerimento**
Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina.
1. Specifica il cluster da modificare scegliendo il pulsante a sinistra del nome del cluster.
1. Scegli **Actions (Operazioni)**, quindi **Modify (Modifica)**.
1. Nel riquadro **Modify Cluster: cluster-name (Modifica cluster: cluster-name)** apporta le modifiche desiderate. È possibile modificare le seguenti aree:
+ **Specifiche del cluster**: nome, gruppi di sicurezza e gestione delle credenziali del cluster.
+ **Configurazione dello storage del cluster**: la modalità di archiviazione dei dati del cluster. Scegli tra la configurazione standard e quella ottimizzata per l'I/O.
+ **Opzioni del cluster**: la porta e il gruppo di parametri del cluster.
+ **Backup**: il periodo di conservazione dei backup e la finestra di backup del cluster.
+ **Esportazioni di log**: abilita o disabilita l'esportazione dei log di controllo o del profiler.
+ **Manutenzione**: imposta la finestra di manutenzione del cluster.
+ **Protezione dall'eliminazione**: abilita o disabilita la protezione da eliminazione sul cluster. Per impostazione predefinita, la protezione da eliminazione è abilitata.
1. Al termine, scegli **Continue (Continua)** per visualizzare un riepilogo delle modifiche.
1. Se accetti le modifiche, puoi scegliere **Modify cluster (Modifica cluster)** per modificare il cluster. In alternativa, puoi scegliere **Back (Indietro)** o **Cancel (Annulla)** per modificare o annullare le modifiche, rispettivamente.
L'applicazione delle modifiche richiede qualche minuto. Puoi utilizzare il cluster solo quando ha lo stato *disponibile*. Puoi monitorare lo stato del cluster con la console o l' AWS CLI. Per ulteriori informazioni, consulta [Monitoraggio dello stato di un cluster Amazon DocumentDB](monitoring_docdb-cluster_status.md).
------
#### [ Using the AWS CLI ]
Utilizzare l'operazione `modify-db-cluster` per modificare il cluster specificato utilizzando il comando AWS CLI. Per ulteriori informazioni, consulta [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBCluster.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBCluster.html)*Amazon DocumentDB API* Reference.
**Parameters**
+ **--db-cluster-identifier**: obbligatorio. L'identificatore del cluster Amazon DocumentDB che intendi modificare.
+ **--backup-retention-period**—Facoltativo. Il numero di giorni durante i quali vengono conservati i backup automatici. I valori validi sono compresi tra 1 e 35.
+ **--storage-type**—Facoltativo. La configurazione di archiviazione del cluster. I valori validi sono `standard` (Standard) o `iopt1` (ottimizzato per l'I/O).
+ **--db-cluster-parameter-group-name**—Facoltativo. Il nome del gruppo di parametri del cluster da utilizzare per il cluster.
+ **--manage-master-user-password**—Facoltativo. Amazon DocumentDB genera la password dell'utente principale e la gestisce per tutto il suo ciclo di vita in Secrets Manager.
+ **--rotate-master-user-password**—Facoltativo. Secrets Manager genera una nuova versione segreta per il segreto esistente. La nuova versione del segreto contiene la nuova password dell'utente principale. Amazon DocumentDB modifica la password dell'utente principale per il cluster in modo che corrisponda alla password per la nuova versione segreta.
È necessario specificare l'**--apply-immediately**opzione quando si ruota la password principale.
+ **--master-user-password**—Facoltativo. La nuova password per l'utente principale del database.
Vincoli per la password:
+ La lunghezza è di [8—100] caratteri ASCII stampabili.
+ È possibile utilizzare qualsiasi carattere ASCII stampabile eccetto i seguenti:
+ **/** (barra)
+ **"** (virgolette doppie)
+ **@** (simbolo chiocciola)
+ **--new-db-cluster-identifier**—Facoltativo. Il nuovo identificatore per il cluster quando un cluster viene rinominato. Questo valore è archiviato come stringa in caratteri minuscoli.
Vincoli per la denominazione
+ La lunghezza è di [1—63] lettere, numeri o trattini.
+ Il primo carattere deve essere una lettera.
+ Non può terminare con un trattino o contenere due trattini consecutivi.
+ Deve essere unico per tutti i cluster di Amazon RDS, Amazon Neptune e Amazon DocumentDB per regione. Account AWS
+ **--preferred-backup-window**—Facoltativo. L'intervallo temporale giornaliero durante il quale vengono creati i backup automatici, in UTC.
+ Formato: `hh24:mm-hh24:mm`
+ **--preferred-maintenance-window**—Facoltativo. L'intervallo temporale settimanale durante il quale può avvenire la manutenzione dei sistemi, in UTC.
+ Formato: `ddd:hh24:mm-ddd:hh24:mm`
+ Giorni validi: `Sun`, `Mon`, `Tue`, `Wed`, `Thu`, `Fri` e `Sat`.
+ **--deletion-protection**o **--no-deletion-protection** —Facoltativo. Se la protezione dall'eliminazione deve essere abilitata su questo cluster. La protezione dall'eliminazione impedisce che un cluster venga accidentalmente eliminato finché il cluster non viene modificato per disabilitare la protezione dall'eliminazione. Per ulteriori informazioni, consulta [Eliminazione di un cluster Amazon DocumentDB](db-cluster-delete.md).
+ **--apply-immediately**o**--no-apply-immediately**: `--apply-immediately` da utilizzare per apportare immediatamente la modifica. Utilizzare `--no-apply-immediately` per apportare la modifica durante la finestra di manutenzione successiva del cluster.
**Example**
Il codice seguente cambia il periodo di retention dei backup per il cluster `sample-cluster`.
Per Linux, macOS o Unix:
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--apply-immediately \
--backup-retention-period 7
```
Per Windows:
```
aws docdb modify-db-cluster ^
--db-cluster-identifier sample-cluster ^
--apply-immediately ^
--backup-retention-period 7
```
L'aspetto dell'output di questa operazione è simile al seguente.
```
{
"DBCluster": {
"BackupRetentionPeriod": 7,
"DbClusterResourceId": "cluster-VDP53QEWST7YHM36TTXOPJT5YE",
"Status": "available",
"DBClusterMembers": [
{
"PromotionTier": 1,
"DBClusterParameterGroupStatus": "in-sync",
"DBInstanceIdentifier": "sample-cluster-instance",
"IsClusterWriter": true
}
],
"ReadReplicaIdentifiers": [],
"AvailabilityZones": [
"us-east-1b",
"us-east-1c",
"us-east-1a"
],
"ReaderEndpoint": "sample-cluster.cluster-ro-ctevjxdlur57.us-east-1.rds.amazonaws.com",
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
"PreferredMaintenanceWindow": "sat:09:51-sat:10:21",
"EarliestRestorableTime": "2018-06-17T00:06:19.374Z",
"StorageEncrypted": false,
"MultiAZ": false,
"AssociatedRoles": [],
"MasterUsername": "",
"DBClusterIdentifier": "sample-cluster",
"VpcSecurityGroups": [
{
"Status": "active",
"VpcSecurityGroupId": "sg-77186e0d"
}
],
"HostedZoneId": "Z2SUY0A1719RZT",
"LatestRestorableTime": "2018-06-18T21:17:05.737Z",
"AllocatedStorage": 1,
"Port": 27017,
"Engine": "docdb",
"DBClusterParameterGroup": "default.docdb3.4",
"Endpoint": "sample-cluster.cluster-ctevjxdlur57.us-east-1.rds.amazonaws.com",
"DBSubnetGroup": "default",
"PreferredBackupWindow": "00:00-00:30",
"EngineVersion": "3.4",
"ClusterCreateTime": "2018-06-06T19:25:47.991Z",
"IAMDatabaseAuthenticationEnabled": false
}
}
```
L'applicazione delle modifiche richiede qualche minuto. Puoi utilizzare il cluster solo quando ha lo stato *disponibile*. Puoi monitorare lo stato del cluster con la console o l' AWS CLI. Per ulteriori informazioni, consulta [Monitoraggio dello stato di un cluster Amazon DocumentDB](monitoring_docdb-cluster_status.md).
------
# Determinazione della manutenzione in sospeso
Puoi determinare se disponi della versione più recente del motore Amazon DocumentDB determinando se hai una manutenzione del cluster in sospeso.
------
#### [ Using the Console di gestione AWS ]
Puoi usare il Console di gestione AWS per determinare se un cluster ha una manutenzione in sospeso.
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**.
**Suggerimento**
Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina.
1. Individuare la colonna **Maintenance (Manutenzione)** per determinare se un cluster è in attesa di manutenzione.
![\[Schermata della console che mostra il campo di manutenzione del cluster Amazon DocumentDB.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-cluster-pending-maintenance.png)
**None (Nessuno)** indica che sul cluster è in esecuzione l'ultima versione del motore. **Available (Disponibile)** indica che il cluster è in attesa di manutenzione, il che potrebbe significare che è necessario l'aggiornamento del motore.
1. Se il cluster è in attesa di manutenzione, continuare con la procedura in [Esecuzione di un aggiornamento della patch alla versione del motore di un cluster](db-cluster-version-upgrade.md).
------
#### [ Using the AWS CLI ]
Puoi utilizzare il AWS CLI per determinare se un cluster dispone della versione più recente del motore utilizzando l'`describe-pending-maintenance-actions`operazione con i seguenti parametri.
**Parameters**
+ **--resource-identifier**—Facoltativo. L'ARN per la risorsa (cluster). Se questo parametro viene omesso, vengono elencate le operazioni di manutenzione in attesa per tutti i cluster.
+ **--region**—Facoltativo. L'endpoint della regione AWS in cui eseguire l'operazione, ad esempio `us-east-1`.
**Example**
Per Linux, macOS o Unix:
```
aws docdb describe-pending-maintenance-actions \
--resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster \
--region us-east-1
```
Per Windows:
```
aws docdb describe-pending-maintenance-actions ^
--resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster ^
--region us-east-1
```
L'aspetto dell'output di questa operazione è simile al seguente.
```
{
"PendingMaintenanceActions": [
{
"ResourceIdentifier": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
"PendingMaintenanceActionDetails": [
{
"Description": "New feature",
"Action": "db-upgrade",
"ForcedApplyDate": "2019-02-25T21:46:00Z",
"AutoAppliedAfterDate": "2019-02-25T07:41:00Z",
"CurrentApplyDate": "2019-02-25T07:41:00Z"
}
]
}
]
}
```
Se il cluster è in attesa di manutenzione, continuare con la procedura in [Esecuzione di un aggiornamento della patch alla versione del motore di un cluster](db-cluster-version-upgrade.md).
------
# Esecuzione di un aggiornamento della patch alla versione del motore di un cluster
In questa sezione, spiegheremo come distribuire un aggiornamento di patch utilizzando Console di gestione AWS o il AWS CLI. Un aggiornamento patch è un aggiornamento all'interno della stessa versione del motore (ad esempio, l'aggiornamento di una versione del motore 3.6 a una versione più recente del motore 3.6). Puoi aggiornarlo immediatamente o durante la prossima finestra di manutenzione del cluster. Per determinare se il motore necessita di un aggiornamento, consulta[Determinazione della manutenzione in sospeso](db-cluster-determine-pending-maintenance.md). Tieni presente che quando applichi l'aggiornamento, il cluster subirà dei tempi di inattività.
**Nota**
Se stai cercando di eseguire l'aggiornamento da una versione principale del motore a un'altra, ad esempio dalla 3.6 alla 5.0, consulta una delle due versioni oppure[Aggiornamento immediato della versione principale di Amazon DocumentDB](docdb-mvu.md). [Aggiornamento del cluster Amazon DocumentDB tramite AWS Database Migration Service](docdb-migration.versions.md) Un aggiornamento immediato della versione principale supporta solo docdb 5.0 come versione del motore di destinazione.
Esistono due requisiti di configurazione per ottenere gli ultimi aggiornamenti delle patch per la versione del motore di un cluster:
+ Lo stato del cluster deve essere *disponibile*.
+ Il cluster deve eseguire una versione precedente del motore.
------
#### [ Using the Console di gestione AWS ]
La procedura seguente applica gli aggiornamenti delle patch alla versione del motore del cluster utilizzando la console. Hai la possibilità di eseguire l'aggiornamento immediatamente o durante la prossima finestra di manutenzione del 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**. Dall'elenco di cluster scegliere il pulsante a sinistra del cluster che si desidera aggiornare. Lo stato del cluster deve essere *disponibile*.
**Suggerimento**
Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina.
1. Nel menu **Actions (Operazioni)** scegliere una delle opzioni indicate di seguito. Queste opzioni di menu sono selezionabili solo se sul cluster scelto non è in esecuzione la versione più recente del motore.
![\[Immagine: azioni di aggiornamento di Amazon DocumentDB\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-upgrade-action.png)
+ **Aggiorna ora**: avvia immediatamente il processo di aggiornamento. Il cluster sarà temporaneamente offline durante l'aggiornamento alla versione più recente del motore.
+ **Aggiorna alla finestra successiva**: avvia il processo di aggiornamento durante la successiva finestra di manutenzione del cluster. Il cluster sarà temporaneamente offline durante l'aggiornamento del cluster alla versione più recente del motore.
1. Quando si apre la finestra di conferma, scegliere una delle seguenti opzioni:
+ **Aggiornamento**: per aggiornare il cluster alla versione più recente del motore in base alla pianificazione scelta nel passaggio precedente.
+ **Annulla**: per annullare l'aggiornamento del motore del cluster e continuare con la versione corrente del motore del cluster.
------
#### [ Using the AWS CLI ]
È possibile applicare gli aggiornamenti delle patch al cluster utilizzando l'`apply-pending-maintenance-action`operazione AWS CLI and con i seguenti parametri.
**Parameters**
+ **--resource-identifier**: obbligatorio. L'ARN del cluster Amazon DocumentDB che intendi aggiornare.
+ **--apply-action**: obbligatorio. Sono consentiti i seguenti valori. Per aggiornare la versione del motore di un cluster, utilizzare `db-upgrade`.
+ **db-upgrade**
+ **system-update**
+ **--opt-in-type**: obbligatorio. Sono consentiti i seguenti valori.
+ `immediate`—Applica immediatamente l'azione di manutenzione.
+ `next-maintenance`—Applica l'azione di manutenzione durante la finestra di manutenzione successiva.
+ `undo-opt-in`—Annulla tutte le richieste di `next-maintenance` opt-in esistenti.
**Example**
La seguente patch di esempio aggiorna la versione del motore `sample-cluster` alla versione 4.0.0.
Per Linux, macOS o Unix:
```
aws docdb apply-pending-maintenance-action \
--resource-identifier arn:aws:rds:us-east-1:123456789012\:cluster:sample-cluster \
--apply-action db-upgrade \
--opt-in-type immediate
```
Per Windows:
```
aws docdb apply-pending-maintenance-action ^
--resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster ^
--apply-action db-upgrade ^
--opt-in-type immediate
```
L'aspetto dell'output di questa operazione è simile al seguente.
```
{
"ResourcePendingMaintenanceActions": {
"ResourceIdentifier": "arn:aws:rds:us-east-1:444455556666:cluster:docdb-2019-01-09-23-55-38",
"PendingMaintenanceActionDetails": [
{
"CurrentApplyDate": "2019-02-20T20:57:06.904Z",
"Description": "Bug fixes",
"ForcedApplyDate": "2019-02-25T21:46:00Z",
"OptInStatus": "immediate",
"Action": "db-upgrade",
"AutoAppliedAfterDate": "2019-02-25T07:41:00Z"
}
]
}
}
```
------
# Arresto e avvio di un cluster Amazon DocumentDB
L'interruzione e l'avvio dei cluster Amazon DocumentDB può aiutarti a gestire i costi per gli ambienti di sviluppo e test. Invece di creare ed eliminare cluster e istanze ogni volta che usi Amazon DocumentDB, puoi interrompere temporaneamente tutte le istanze del cluster quando non sono necessarie. È quindi possibile avviarle nuovamente quando è necessario riprendere il testing.
**Topics**
+ [Panoramica dell'avvio e dell'arresto di un cluster.](#db-cluster-stop-start-overview)
+ [Operazioni che è possibile eseguire su un cluster interrotto](#db-cluster-stopped-operations)
## Panoramica dell'avvio e dell'arresto di un cluster.
Nei periodi in cui non è necessario un cluster Amazon DocumentDB, è possibile interrompere tutte le istanze in quel cluster contemporaneamente. È possibile avviare nuovamente il cluster ogni volta che è necessario utilizzarlo. L'avvio e l'arresto semplificano i processi di impostazione e rimozione dei cluster utilizzati per lo sviluppo, i test o attività analoghe che non richiedono una disponibilità continua. Puoi arrestare e avviare un cluster utilizzando il Console di gestione AWS o AWS CLI con una singola azione, indipendentemente dal numero di istanze nel cluster.
Quando il cluster viene arrestato, il volume di archiviazione associato al cluster rimane invariato. Vengono addebitati solo i costi per lo storage, gli snapshot manuali e lo storage di backup automatici all'interno della finestra di retention specificata. Non ti viene addebitato alcun costo per le ore di utilizzo delle istanze. Amazon DocumentDB avvia automaticamente il cluster dopo sette giorni in modo da non rimanere indietro rispetto agli aggiornamenti di manutenzione richiesti. Quando il cluster viene avviato dopo 7 giorni, avrà nuovamente inizio l'addebito relativo alle istanze del cluster. Mentre il cluster viene arrestato, non è possibile eseguire query sul volume di archiviazione perché l'esecuzione di query richiede che le istanze siano nello stato disponibile.
Quando un cluster Amazon DocumentDB viene arrestato, né il cluster né le relative istanze possono essere modificati in alcun modo. Ciò include l'aggiunta o la rimozione di istanze o l'eliminazione del cluster.
------
#### [ Using the Console di gestione AWS ]
La seguente procedura mostra come arrestare un cluster con una o più istanze in stato disponibile o avviare un cluster arrestato.
**Per arrestare o avviare un cluster Amazon DocumentDB**
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**.
**Suggerimento**
Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina.
1. Quindi, nell'elenco dei cluster, scegliere il pulsante a sinistra del nome del cluster che si desidera arrestare o avviare.
1. Scegliere **Actions (Operazioni)** e quindi scegliere l'operazione che si desidera eseguire sul cluster.
+ Se si desidera arrestare il cluster e il cluster è disponibile:
1. Scegli **Stop (Arresta)**.
![\[Immagine: Arresto di un cluster\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/db-cluster-stop.png)
Per evitare l'attivazione del meccanismo di failover, l'operazione di arresto interrompe prima le istanze di replica e poi l'istanza primaria.
1. Nella finestra di dialogo di conferma, confermare che si desidera arrestare il cluster scegliendo **Stop cluster (Arresta cluster)** oppure, per mantenere il cluster in esecuzione, scegliere **Cancel (Annulla)**.
![\[Immagine: Avviamento di un cluster\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/db-cluster-stop-confirm.png)
+ Se si desidera avviare il cluster e il cluster è arrestato, scegliere **Start (Avvia)**.
![\[Immagine: Avviamento di un cluster\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/db-cluster-start.png)
1. Monitorare lo stato del cluster e delle relative istanze. Se si avvia il cluster, è possibile riprendere ad utilizzare il cluster quando il cluster e le relative istanze risultano *disponibili*. Per ulteriori informazioni, consulta [Determinazione dello stato di un cluster](db-cluster-status.md).
![\[Immagine: stato dei cluster in stato di arresto e avvio\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/db-cluster-stop-start-status.png)
------
#### [ Using the AWS CLI ]
I seguenti codici di esempio illustrano come arrestare un cluster con una o più istanze in stato disponibile o avviare un cluster arrestato.
Per arrestare un cluster con una o più istanze disponibili utilizzando il AWS CLI, usa l'operazione. `stop-db-cluster` Per avviare un cluster arrestato, utilizzare l'operazione `start-db-cluster`. Entrambe le operazioni consentono di utilizzare il parametro `--db-cluster-identifier`.
**Parametro:**
+ **--db-cluster-identifier**: obbligatorio. Il nome del cluster da arrestare o avviare.
**Example — Per arrestare un cluster utilizzando AWS CLI**
Il codice seguente arresta il cluster `sample-cluster`. Il cluster deve avere una o più istanze in stato disponibile.
Per Linux, macOS o Unix:
```
aws docdb stop-db-cluster \
--db-cluster-identifier sample-cluster
```
Per Windows:
```
aws docdb stop-db-cluster ^
--db-cluster-identifier sample-cluster
```
**Example — Per avviare un cluster utilizzando il AWS CLI**
Il codice seguente avvia il cluster `sample-cluster`. Il cluster deve attualmente essere arrestato.
Per Linux, macOS o Unix:
```
aws docdb start-db-cluster \
--db-cluster-identifier sample-cluster
```
Per Windows:
```
aws docdb start-db-cluster ^
--db-cluster-identifier sample-cluster
```
------
## Operazioni che è possibile eseguire su un cluster interrotto
Mentre un cluster Amazon DocumentDB è fermo, puoi eseguire un point-in-time ripristino in qualsiasi punto all'interno della finestra di conservazione dei backup automatizzata specificata. Per informazioni dettagliate su come eseguire un point-in-time ripristino, consulta[Ripristino in un determinato momento](backup_restore-point_in_time_recovery.md).
Non è possibile modificare la configurazione di un cluster Amazon DocumentDB o di nessuna delle sue istanze mentre il cluster è fermo. Inoltre, non è possibile aggiungere o rimuovere istanze di database dal cluster o eliminarlo se possiede ancora istanze di database associate. Devi avviare il cluster prima di eseguire questo tipo di operazioni amministrative.
Amazon DocumentDB applica qualsiasi manutenzione programmata al cluster interrotto solo dopo che è stato riavviato. Dopo sette giorni, Amazon DocumentDB avvia automaticamente un cluster interrotto in modo che non rimanga troppo indietro nello stato di manutenzione. Quando il cluster viene riavviato, avrà nuovamente inizio l'addebito relativo alle istanze del cluster.
Mentre un cluster è fermo, Amazon DocumentDB non esegue backup automatici né estende il periodo di conservazione dei backup.
# Eliminazione di un cluster Amazon DocumentDB
Puoi eliminare un cluster Amazon DocumentDB utilizzando Console di gestione AWS o il. AWS CLI Per eliminare un cluster, il cluster deve trovarsi nello stato *disponibile* e non deve avere alcuna istanza associata. Se il cluster viene arrestato, per prima cosa avviare il cluster, attendere che diventi *disponibile*, quindi eliminarlo. Per ulteriori informazioni, consulta [Arresto e avvio di un cluster Amazon DocumentDB](db-cluster-stop-start.md).
## Protezione da eliminazione
Per proteggere il cluster dall'eliminazione accidentale, è possibile abilitare la *protezione dall'eliminazione *. Quando si crea un cluster utilizzando la console, la protezione dall'eliminazione viene abilitata per impostazione predefinita. Tuttavia, la protezione dall'eliminazione è disabilitata per impostazione predefinita se si crea un cluster utilizzando la AWS CLI.
Amazon DocumentDB applica la protezione da eliminazione per un cluster indipendentemente dal fatto che l'operazione di eliminazione venga eseguita utilizzando la console o il. AWS CLI Se la protezione dall'eliminazione è abilitata, non puoi eliminare un cluster. Per eliminare un cluster con la protezione dall'eliminazione abilitata, devi modificare il cluster e disabilitare la protezione dall'eliminazione.
Quando si utilizza la console con la protezione dall'eliminazione abilitata su un cluster, non è possibile eliminare l'ultima istanza del cluster perché questa operazione elimina anche il cluster. È possibile eliminare l'ultima istanza di un cluster con protezione dall'eliminazione attiva utilizzando la AWS CLI. Il cluster, tuttavia, è ancora esistente e i dati sono conservati. È possibile accedere ai dati mediante la creazione di nuove istanze per il cluster. Per ulteriori informazioni sull'abilitazione e la disabilitazione della protezione dall'eliminazione, consulta:
+ [Creazione di un cluster Amazon DocumentDB](db-cluster-create.md)
+ [Modifica di un cluster Amazon DocumentDB](db-cluster-modify.md)
------
#### [ Using the Console di gestione AWS ]
Per eliminare un cluster utilizzando la Console di gestione AWS, la protezione dall'eliminazione deve essere disabilitata.
**Per determinare se la protezione dall'eliminazione di un cluster è abilitata:**
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**.
**Suggerimento**
Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina.
1. Tieni presente che nella casella di navigazione Clusters, la colonna **Cluster identifier mostra sia i cluster** che le istanze. Le istanze sono elencate sotto i cluster, in modo simile alla schermata seguente.
![\[Immagine: la casella di navigazione Clusters che mostra un elenco di collegamenti cluster esistenti e i collegamenti di istanza corrispondenti.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/clusters.png)
1. Scegliere il nome del cluster e selezionare la scheda **Configuration (Configurazione)** . Nella sezione **Cluster details (Dettagli cluster)** individuare l’opzione **Deletion protection (Protezione dall’eliminazione)**. Se la protezione dall'eliminazione è abilitata, modificare il cluster per disabilitarla. Per ulteriori informazioni sulla modifica di un cluster database, consultare [Modifica di un cluster Amazon DocumentDB](db-cluster-modify.md).
Dopo aver eliminato la **Deletion protection (Protezione dall'eliminazione)**, è possibile eliminare il cluster.
**Per eliminare un cluster:**
1. Nel pannello di navigazione scegliere **Cluster**.
1. Determina se il cluster ha delle istanze controllando la colonna **Identificatore del cluster** per le istanze elencate sotto di essa. Per eliminare un cluster, devi eliminare tutte le sue istanze. Per ulteriori informazioni, consulta [Eliminazione di un'istanza Amazon DocumentDB](db-instance-delete.md).
1. A seconda che il cluster disponga o meno di qualche istanza, eseguire una delle seguenti operazioni.
+ Se il cluster non dispone di istanze, selezionare il pulsante a sinistra del nome del cluster e scegliere **Actions (Operazioni)**. Dal menu a discesa, scegli **Delete (Elimina)**. Completare la finestra di dialogo **Delete (Elimina )** e quindi scegliere **Delete (Elimina)**.
+ Se il cluster dispone di una o più istanze, eseguire le operazioni descritte qui di seguito:
1. Nel pannello di navigazione scegliere **Cluster**.
1. Elimina ciascuna istanza del cluster selezionando la casella di controllo a sinistra del nome del cluster. Scegli **Actions (Operazioni)**, quindi **Delete (Elimina)**. Completare la finestra di dialogo **Delete (Elimina )** e quindi scegliere **Delete (Elimina)**.
Quando elimini l'ultima istanza, verrà eliminato anche il cluster. Per ulteriori informazioni sull'eliminazione delle istanze, consulta. [Eliminazione di un'istanza Amazon DocumentDB](db-instance-delete.md)
Sono necessari alcuni minuti per l'eliminazione del cluster. Per monitorare lo stato del cluster, consulta [Monitoraggio dello stato di un cluster Amazon DocumentDB](monitoring_docdb-cluster_status.md).
------
#### [ Using the AWS CLI ]
Non puoi eliminare un cluster a cui sono associate delle istanze. Per determinare quali istanze sono associate al cluster, esegui il comando `describe-db-clusters` ed elimina tutte le istanze del cluster. Quindi, se necessario, disattiva la protezione dell'eliminazione nel cluster e, infine, elimina il cluster.
1. **In primo luogo, elimina tutte le istanze del cluster.**
Per determinare quali istanze eliminare, esegui il comando seguente.
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]'
```
L'aspetto dell'output di questa operazione è simile al seguente (formato JSON).
```
[
[
"sample-cluster",
[
"sample-instance-1",
"sample-instance-2"
]
]
]
```
Se il cluster da eliminare possiede delle istanze associate, elimina tali istanze prima di continuare.
```
aws docdb delete-db-instance \
--db-instance-identifier sample-instance
```
1. **In secondo luogo, disabilita la protezione da eliminazione.**
L'utilizzo AWS CLI di per eliminare tutte le istanze di un cluster non elimina il cluster. È anche necessario eliminare il cluster, ma è possibile eseguire questa operazione solo se la protezione dall'eliminazione è disattivata.
Per determinare se la protezione dall'eliminazione per il cluster è attivata, eseguire il seguente comando.
**Suggerimento**
Per visualizzare lo stato di protezione dall'eliminazione di tutti i cluster Amazon DocumentDB, ometti il parametro. `--db-cluster-identifier`
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DeletionProtection]'
```
L'aspetto dell'output di questa operazione è simile al seguente.
```
[
[
"sample-cluster",
"true"
]
]
```
Se la protezione dall'eliminazione per il cluster è abilitata, modificare il cluster e disabilitare la protezione dall'eliminazione. Per disabilitare la protezione dall'eliminazione del cluster, utilizzare il seguente codice.
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--no-deletion-protection \
--apply-immediately
```
1. **Infine, eliminare il cluster.**
Dopo la disattivazione della protezione dall'eliminazione, è possibile eliminare il cluster. Per eliminare un cluster, utilizzare l'operazione `delete-db-cluster` con i parametri elencati di seguito.
+ **--db-cluster-identifier**: obbligatorio. L'identificatore del cluster da eliminare.
+ **--final-db-snapshot-identifier**—Facoltativo. Se desideri uno snapshot finale, devi includere questo parametro con un nome per l'ultimo snapshot. È necessario includere `--final-db-snapshot-identifier` o `--skip-final-snapshot`.
Vincoli per la denominazione
+ La lunghezza è di [1—63] lettere, numeri o trattini.
+ Il primo carattere deve essere una lettera.
+ Non può terminare con un trattino o contenere due trattini consecutivi.
+ Deve essere unico per tutti i cluster di Amazon RDS, Amazon Neptune e Amazon DocumentDB per regione. Account AWS
+ **--skip-final-snapshot**—Facoltativo. Utilizzare questo parametro solo se non si desidera acquisire uno snapshot finale prima di eliminare il cluster. L'impostazione predefinita prevede l'acquisizione di uno snapshot finale È necessario includere `--final-db-snapshot-identifier` o `--skip-final-snapshot`.
Il AWS CLI codice seguente elimina il cluster `sample-cluster` con un'istantanea finale. L'operazione ha esito negativo se vi sono istanze associate al cluster o se è abilitata la protezione dall'eliminazione.
**Example**
Per Linux, macOS o Unix:
```
aws docdb delete-db-cluster \
--db-cluster-identifier sample-cluster \
--final-db-snapshot-identifier sample-cluster-final-snapshot
```
Per Windows:
```
aws docdb delete-db-cluster ^
--db-cluster-identifier sample-cluster ^
--final-db-snapshot-identifier sample-cluster-final-snapshot
```
**Example**
Il AWS CLI codice seguente elimina il cluster `sample-cluster` senza scattare un'istantanea finale.
Per Linux, macOS o Unix:
```
aws docdb delete-db-cluster \
--db-cluster-identifier sample-cluster \
--skip-final-snapshot
```
Per Windows:
```
aws docdb delete-db-cluster ^
--db-cluster-identifier sample-cluster ^
--skip-final-snapshot
```
L'output dell'operazione `delete-db-cluster` è il cluster che stai eliminando.
Sono necessari alcuni minuti per l'eliminazione del cluster. Per monitorare lo stato del cluster, consulta [Monitoraggio dello stato di un cluster](monitoring_docdb-cluster_status.md).
------