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à. # Gestione dei cluster elastici di Amazon DocumentDB Per gestire un cluster elastico di Amazon DocumentDB, è necessario disporre di una policy IAM con le autorizzazioni appropriate del piano di controllo di Amazon DocumentDB. Queste autorizzazioni consentono di creare, modificare ed eliminare i cluster. La policy di Amazon Document DBFull Access fornisce tutte le autorizzazioni necessarie per amministrare un cluster elastico Amazon DocumentDB. I seguenti argomenti mostrano come eseguire varie attività quando si lavora con i cluster elastici di Amazon DocumentDB. **Topics** + [Modifica delle configurazioni dei cluster elastici](#elastic-modify) + [Monitoraggio di un cluster elastico](#elastic-monitor) + [Eliminazione di un cluster elastico](#elastic-delete) + [Gestione delle istantanee dei cluster elastici](elastic-manage-snapshots.md) + [Arresto e avvio di un cluster elastico Amazon DocumentDB](elastic-cluster-stop-start.md) + [Manutenzione dei cluster elastici di Amazon DocumentDB](elastic-cluster-maintenance.md) ## Modifica delle configurazioni dei cluster elastici In questa sezione spieghiamo come modificare il cluster elastico, utilizzando Console di gestione AWS o AWS CLI con le seguenti istruzioni. Uno degli usi principali della modifica del cluster consiste nel ridimensionare gli shard aumentando o diminuendo il numero di frammenti (capacità di calcolo and/or dello shard). ------ #### [ Using the Console di gestione AWS ] Per modificare una configurazione elastica del cluster utilizzando: Console di gestione AWS 1. Accedi [Console di gestione AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1)e apri la console Amazon DocumentDB. 1. Nel pannello di navigazione scegliere **Cluster**. **Suggerimento** Se non vedi il riquadro di navigazione sul lato sinistro dello schermo, scegli l'icona del menu nell'angolo in alto a sinistra del pannello di navigazione. 1. Scegli il nome del cluster che desideri modificare nella colonna Identificatore del **cluster**. 1. Scegli **Modifica**. 1. Modifica i campi che desideri modificare, quindi seleziona **Modifica cluster**. ![\[Modulo che mostra le opzioni di configurazione, manutenzione, autenticazione e impostazioni di rete che possono essere modificate, con il pulsante Modifica cluster nell'angolo in basso a destra.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/cluster-shard-modify-3.png) **Nota** **In alternativa, puoi accedere alla finestra di dialogo **Modifica cluster** accedendo alla pagina **Cluster**, selezionando la casella accanto al cluster, scegliendo **Azioni**, quindi Modifica.** ------ #### [ Using the AWS CLI ] Per modificare una configurazione di cluster elastico utilizzando il AWS CLI, utilizza l'`update-cluster`operazione con i seguenti parametri: + **--cluster-arn**: obbligatorio. L'identificatore ARN del cluster che si desidera modificare. + **--shard-capacity**—Facoltativo. Il numero di v CPUs assegnato a ogni shard. Il massimo è 64. I valori consentiti sono 2, 4, 8, 16, 32, 64. + **--shard-count**—Facoltativo. Il numero di shard assegnati al cluster. Il massimo è 32. + **--shard-instance**-Count: facoltativo. Il numero di istanze di replica applicabili a tutti gli shard di questo cluster. Il massimo è 16. + **--auth-type**—Facoltativo. Il tipo di autenticazione utilizzato per determinare dove recuperare la password utilizzata per accedere al cluster elastico. I tipi validi sono `PLAIN_TEXT` o`SECRET_ARN`. + **--admin-user-password**—Facoltativo. La password associata all'utente amministratore. + **--vpc-security-group-ids**—Facoltativo. Configura un elenco di gruppi di sicurezza Amazon EC2 e Amazon Virtual Private Cloud (VPC) da associare a questo cluster. + **--preferred-maintenance-window**—Facoltativo. Configura l'intervallo di tempo settimanale durante il quale può avvenire la manutenzione del sistema, in UTC (Universal Coordinated Time) Il formato è:`ddd:hh24:mi-ddd:hh24:mi`. Giorni validi (gdd): lun, mar, mer, gio, ven, sab, dom L'impostazione predefinita è una finestra di 30 minuti selezionata a caso da un periodo di 8 ore per ogni regione di Amazon Web Services, che si verifica in un giorno casuale della settimana. Finestra minima di 30 minuti. + **--subnet-ids**—Facoltativo. Configura gli ID delle sottoreti di rete. Nell'esempio seguente, sostituisci ciascuno di essi *user input placeholder* con le tue informazioni. Per Linux, macOS o Unix: ``` aws docdb-elastic update-cluster \ --cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 \ --shard-capacity 8 \ --shard-count 4 \ --shard-instance-count 3 \ --admin-user-password testPassword \ --vpc-security-group-ids ec-65f40350 \ --subnet-ids subnet-9253c6a3, subnet-9f1b5af9 ``` Per Windows: ``` aws docdb-elastic update-cluster ^ --cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ^ --shard-capacity 8 ^ --shard-count 4 ^ --shard-instance-count 3 ^ --admin-user-password testPassword ^ --vpc-security-group-ids ec-65f40350 ^ --subnet-ids subnet-9253c6a3, subnet-9f1b5af9 ``` ------ Per monitorare lo stato del cluster elastico dopo la modifica, vedi Monitoraggio di un cluster elastico. ## Monitoraggio di un cluster elastico In questa sezione, spieghiamo come monitorare il cluster elastico, utilizzando Console di gestione AWS o AWS CLI con le seguenti istruzioni. ------ #### [ Using the Console di gestione AWS ] Per monitorare una configurazione di cluster elastico utilizzando Console di gestione AWS: 1. Accedi [Console di gestione AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1)e apri la console Amazon DocumentDB. 1. Nel pannello di navigazione scegliere **Cluster**. **Suggerimento** Se non vedi il riquadro di navigazione sul lato sinistro dello schermo, scegli l'icona del menu nell'angolo in alto a sinistra del pannello di navigazione. 1. Scegli il nome del cluster che desideri monitorare nella colonna Identificatore del **cluster**. 1. Scegli la scheda **Monitoraggio**. ![\[Informazioni di riepilogo del cluster elastico mostrate nella scheda Monitoraggio.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/cluster-shard-monitor-2.png) CloudWatch Vengono visualizzati alcuni grafici di Amazon per le seguenti categorie di monitoraggio: + Utilizzo delle risorse + Throughput + Operazioni + Sistema Puoi anche accedere ad Amazon CloudWatch tramite il Console di gestione AWS per configurare il tuo ambiente di monitoraggio per i tuoi cluster elastici. ------ #### [ Using the AWS CLI ] Per monitorare una configurazione specifica di un cluster elastico utilizzando il AWS CLI, utilizza l'`get-cluster`operazione con i seguenti parametri: + **--cluster-arn**: obbligatorio. L'identificatore ARN del cluster per il quale desideri informazioni. Nell'esempio seguente, sostituisci ciascuno di essi *user input placeholder* con le tue informazioni. Per Linux, macOS o Unix: ``` aws docdb-elastic get-cluster \ --cluster-arn arn:aws:docdb-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9 ``` Per Windows: ``` aws docdb-elastic get-cluster ^ --cluster-arn arn:aws:docdb:-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9 ``` L'output di questa operazione è simile al seguente: ``` "cluster": { ... "clusterArn": "arn:aws:docdb-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9", "clusterEndpoint": "stretch-11-477568257630.us-east-1.docdb-elastic.amazonaws.com", "readerEndpoint": "stretch-11-477568257630-ro.us-east-1.docdb-elastic.amazonaws.com", "clusterName": "stretch-11", "shardCapacity": 2, "shardCount": 3, "shardInstanceCount: 5, "status": "ACTIVE", ... } ``` Per ulteriori informazioni, consulta `DescribeClusterSnapshot` Amazon DocumentDB Resource Management API Reference. Per visualizzare i dettagli di tutti i cluster elastici che utilizzano il AWS CLI, utilizza l'`list-clusters`operazione con i seguenti parametri: + **--next-token**—Facoltativo. Se l'output del numero di elementi (`--max-results`) è inferiore rispetto al numero totale di elementi restituito dalle chiamate API sottostanti, l'output include `NextToken`, che può essere trasferito a un comando successivo per recuperare il set di elementi successivo. + **--max-results**—Facoltativo. Il numero totale di elementi da restituire nell'output del comando. Se esistono più risultati rispetto al `max-results` valore specificato, nella risposta viene incluso un token di paginazione (`next-token`) in modo da poter recuperare i risultati rimanenti. + Impostazione predefinita: 100 + Minimo 20, massimo 100 Nell'esempio seguente, sostituisci ciascuno *user input placeholder* con le tue informazioni. Per Linux, macOS o Unix: ``` aws docdb-elastic list-clusters \ --next-token eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ== \ --max-results 2 ``` Per Windows: ``` aws docdb-elastic list-clusters ^ --next-token eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ== ^ --max-results 2 ``` L'output di questa operazione è simile al seguente: ``` { "Clusters": [ { "ClusterIdentifier":"mycluster-1", "ClusterArn":"arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster" "Status":"available", "ClusterEndpoint":"sample-cluster.sharded-cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com" } { "ClusterIdentifier":"mycluster-2", "ClusterArn":"arn:aws:docdb:us-west-2:987654321098:sharded-cluster:sample-cluster" "Status":"available", "ClusterEndpoint":"sample-cluster2.sharded-cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com" } ] } ``` ------ ## Eliminazione di un cluster elastico In questa sezione spieghiamo come eliminare un cluster elastico, utilizzando Console di gestione AWS o AWS CLI con le seguenti istruzioni. ------ #### [ Using the Console di gestione AWS ] Per eliminare una configurazione di cluster elastico utilizzando Console di gestione AWS: 1. Accedi [Console di gestione AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1)e apri la console Amazon DocumentDB. 1. Nel pannello di navigazione scegliere **Cluster**. **Suggerimento** Se non vedi il riquadro di navigazione sul lato sinistro dello schermo, scegli l'icona del menu nell'angolo in alto a sinistra del pannello di navigazione. 1. **Nella tabella con l'elenco dei cluster, seleziona la casella di controllo a sinistra del nome del cluster che desideri eliminare, quindi scegli Azioni.** Dal menu a discesa, scegli **Delete (Elimina)**. 1. Nel cluster **elastico Elimina «nome-cluster»?** **nella finestra di dialogo, scegli Elimina.** ![\[Finestra di dialogo Elimina, con il pulsante Elimina nell'angolo in basso a destra.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/cluster-delete-dialog.png) Sono necessari alcuni minuti per l'eliminazione del cluster. Per monitorare lo stato del cluster, consulta [Monitoraggio dello stato di un cluster Amazon DocumentDB](https://docs.aws.amazon.com//documentdb/latest/developerguide/monitoring_docdb-cluster_status.html). ------ #### [ Using the AWS CLI ] Per eliminare un cluster elastico utilizzando il AWS CLI, utilizza l'`delete-cluster`operazione con i seguenti parametri: + **--cluster-arn**: obbligatorio. L'identificatore ARN del cluster che si desidera eliminare. + **--no-skip-final-backup**—Facoltativo. Se si desidera un backup finale, è necessario includere questo parametro con un nome per il backup finale. È necessario includere `--final-backup-identifier` o `--skip-final-backup`. + **--skip-final-backup**—Facoltativo. Utilizzate questo parametro solo se non desiderate eseguire un backup finale prima di eliminare il cluster. L'impostazione predefinita prevede l'acquisizione di uno snapshot finale I seguenti esempi di AWS CLI codice eliminano un cluster con un ARN di arn:aws:docdb:us-west- 2:123456789012:sharded-cluster:sample-cluster con un backup finale. Nell'esempio seguente, sostituisci ciascuno *user input placeholder* con le tue informazioni.. Per Linux, macOS o Unix: ``` aws docdb-elastic delete-cluster \ --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster \ --no-skip-final-backup \ --final-backup-identifier finalArnBU-arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster ``` Per Windows: ``` aws docdb-elastic delete-cluster ^ --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster ^ --no-skip-final-backup ^ --final-backup-identifier finalArnBU-arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster ``` I seguenti esempi di AWS CLI codice eliminano un cluster con un ARN di arn:aws:docdb:us-west- 2:123456789012:sharded-cluster:sample-cluster senza eseguire un backup finale. Nell'esempio seguente, sostituisci ciascuno *user input placeholder* con le tue informazioni. Per Linux, macOS o Unix: ``` aws docdb-elastic delete-cluster \ --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster \ --skip-final-backup \ ``` Per Windows: ``` aws docdb-elastic delete-cluster ^ --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster ^ --skip-final-backup ^ ``` L'output dell'`delete-cluster`operazione è una visualizzazione del cluster che si sta eliminando. Sono necessari alcuni minuti per l'eliminazione del cluster. Per monitorare lo stato del cluster, consulta [Monitoraggio dello stato di un cluster Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/monitoring_docdb-cluster_status.html). ------ # Gestione delle istantanee dei cluster elastici Le istantanee manuali possono essere scattate dopo la creazione di un cluster elastico. I backup automatici vengono creati nel momento in cui viene creata l'istantanea del cluster elastico. **Nota** Il cluster elastico deve essere nello `Available` stato in cui è possibile scattare un'istantanea manuale. Questa sezione spiega come creare, visualizzare, ripristinare ed eliminare istantanee di cluster elastici. I seguenti argomenti mostrano come eseguire varie attività quando si lavora con istantanee di cluster elastici di Amazon DocumentDB. **Topics** + [Creazione manuale di uno snapshot del cluster elastico](#elastic-create-snapshot) + [Visualizzazione di un'istantanea del cluster elastico](#elastic-view-snapshot) + [Ripristino di un cluster elastico da un'istantanea](#elastic-restore-snapshot) + [Copia di un'istantanea del cluster elastico](#elastic-copy-snapshot) + [Eliminazione di un'istantanea del cluster elastico](#elastic-delete-snapshot) + [Gestione di un backup automatico di snapshot del cluster elastico](#elastic-auto-snapshot) ## Creazione manuale di uno snapshot del cluster elastico In questa sezione viene spiegato come creare uno snapshot manuale di un cluster elastico, utilizzando Console di gestione AWS o AWS CLI con le seguenti istruzioni. ------ #### [ Using the Console di gestione AWS ] Per creare un'istantanea manuale del cluster elastico utilizzando: Console di gestione AWS 1. Accedi [Console di gestione AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1)e apri la console Amazon DocumentDB. 1. Nel pannello di navigazione, selezionare **Snapshots (Snapshot)**. **Suggerimento** Se non vedi il riquadro di navigazione sul lato sinistro dello schermo, scegli l'icona del menu nell'angolo in alto a sinistra del pannello di navigazione. 1. Nella pagina **Snapshots (Snapshot)** scegli **Create (Crea)**. 1. Nella pagina **Crea un'istantanea del cluster**, nel campo **Identificatore del cluster**, scegli il tuo cluster elastico dall'elenco a discesa. Nel campo Identificatore **Snapshot, inserisci un identificatore** univoco per il tuo cluster elastico. Scegli **Create** (Crea). ![\[Diagramma: cluster elastico, creazione di un'istantanea\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/elastic-create-snapshot.png) **Nota** **In alternativa, puoi accedere alla finestra di dialogo **Crea istantanea del cluster** andando alla pagina **Cluster**, selezionando la casella accanto al cluster, quindi scegliendo **Azioni**, quindi Scatta istantanea.** Lo snapshot del cluster elastico è ora in fase di provisioning. Il completamento di questa operazione può richiedere fino a qualche minuto. È possibile visualizzare e ripristinare dall'istantanea quando lo stato è visualizzato, come `Available` nell'elenco **Istantanee**. ------ #### [ Using the AWS CLI ] Per creare un'istantanea manuale del cluster elastico utilizzando il AWS CLI, utilizzate l'`create-cluster-snapshot`operazione con i seguenti parametri: + **--snapshot-name**: obbligatorio. Il nome dello snapshot del cluster che si desidera creare. + **--cluster-arn**: obbligatorio. L'identificatore ARN del cluster di cui si desidera creare un'istantanea. Nell'esempio seguente, sostituisci ciascuno di essi *user input placeholder* con le tue informazioni. Per Linux, macOS o Unix: ``` aws docdb-elastic create-cluster-snapshot \ --snapshot-name sample-snapshot-1 \ --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster ``` Per Windows: ``` aws docdb-elastic create-cluster-snapshot ^ --snapshot-name sample-snapshot-1 ^ --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster ``` ------ ## Visualizzazione di un'istantanea del cluster elastico In questa sezione spieghiamo come visualizzare le informazioni sugli snapshot del cluster elastico, utilizzando Console di gestione AWS o AWS CLI con le seguenti istruzioni. ------ #### [ Using the Console di gestione AWS ] Per visualizzare le informazioni su uno specifico snapshot del cluster elastico, utilizzare: Console di gestione AWS 1. Accedi [Console di gestione AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1)e apri la console Amazon DocumentDB. 1. Nel pannello di navigazione, selezionare **Snapshots (Snapshot)**. **Suggerimento** Se non vedi il riquadro di navigazione sul lato sinistro dello schermo, scegli l'icona del menu nell'angolo in alto a sinistra del pannello di navigazione. 1. **Nella pagina **Istantanee**, scegli la tua istantanea dall'elenco facendo clic sul nome nella colonna dell'identificatore dell'istantanea.** 1. **Visualizza le informazioni sull'istantanea in Dettagli.** ![\[Diagramma: snapshot di Elastic Cluster View\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/elastic-snapshot-view.png) ------ #### [ Using the AWS CLI ] Per visualizzare informazioni su uno specifico snapshot del cluster elastico utilizzando il AWS CLI, utilizzate l'`get-cluster-snapshot`operazione con i seguenti parametri: + **--snapshot-arn**: obbligatorio. L'identificatore ARN dell'istantanea per la quale desideri informazioni. Nell'esempio seguente, sostituisci ciascuno di essi *user input placeholder* con le tue informazioni. Per Linux, macOS o Unix: ``` aws docdb-elastic get-cluster-snapshot \ --snapshot-arn sampleResourceName ``` Per Windows: ``` aws docdb-elastic get-cluster-snapshot ^ --snapshot-arn sampleResourceName ``` Per visualizzare informazioni su uno specifico snapshot di un cluster elastico utilizzando il AWS CLI, utilizzate l'`get-cluster-snapshot`operazione con i seguenti parametri: + **--snapshot-arn**: obbligatorio. L'identificatore ARN dell'istantanea per la quale desideri informazioni. Nell'esempio seguente, sostituisci ciascuno di essi *user input placeholder* con le tue informazioni. Per Linux, macOS o Unix: ``` aws docdb-elastic get-cluster-snapshot \ --snapshot-arn sampleResourceName ``` Per Windows: ``` aws docdb-elastic get-cluster-snapshot ^ --snapshot-arn sampleResourceName ``` Per visualizzare le informazioni su tutte le istantanee del cluster elastico che utilizzano il AWS CLI, utilizzate l'`list-cluster-snapshots`operazione con i seguenti parametri: + **--snapshot-type**—Facoltativo. Il tipo di istantanee del cluster da restituire. È possibile specificare uno dei seguenti valori: + `automated`- Restituisci tutte le istantanee del cluster che Amazon DocumentDB ha creato automaticamente per AWS il tuo account. + `manual`- Restituisci tutte le istantanee del cluster che hai creato manualmente per il tuo account. AWS + `shared`- Restituisci tutte le istantanee manuali del cluster che sono state condivise con il tuo AWS account. + `public`- Restituisce tutte le istantanee del cluster che sono state contrassegnate come pubbliche. + **--next-token**—Facoltativo. Token di paginazione opzionale fornito da una richiesta precedente. Se viene specificato questo parametro, la risposta include solo i record oltre a questo token, fino al valore specificato da`max-results`. + **--max-results**—Facoltativo. Il numero massimo di risultati da includere nella risposta. Se esistono più risultati rispetto al `max-results` valore specificato, nella risposta viene incluso un token di paginazione (`next-token`) in modo da poter recuperare i risultati rimanenti. + Impostazione predefinita: 100 + Minimo 20, massimo 100 Nell'esempio seguente, sostituisci ciascuno *user input placeholder* con le tue informazioni. Per Linux, macOS o Unix: ``` aws docdb-elastic list-cluster-snapshots \ --snapshot-type value \ --next-token value \ --max-results 50 ``` Per Windows: ``` aws docdb-elastic list-cluster-snapshots ^ --snapshot-type value ^ --next-token value ^ --max-results 50 ``` ------ ## Ripristino di un cluster elastico da un'istantanea In questa sezione viene spiegato come ripristinare un cluster elastico da un'istantanea, utilizzando Console di gestione AWS o AWS CLI con le seguenti istruzioni. ------ #### [ Using the Console di gestione AWS ] Per ripristinare un cluster elastico da un'istantanea utilizzando: Console di gestione AWS 1. Accedi [Console di gestione AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1)e apri la console Amazon DocumentDB. 1. Nel pannello di navigazione, selezionare **Snapshots (Snapshot)**. **Suggerimento** Se non vedi il riquadro di navigazione sul lato sinistro dello schermo, scegli l'icona del menu nell'angolo in alto a sinistra del pannello di navigazione. 1. **Scegli il pulsante a sinistra dell'istantanea, che desideri utilizzare per ripristinare un cluster, nella colonna Identificatore dell'istantanea.** 1. Seleziona **Operazioni**, quindi **Ripristina**. ![\[Diagramma: ripristino elastico del cluster da un'istantanea\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/elastic-restore-snapshot.png) 1. Nella pagina **Ripristina istantanea**, inserisci un nome per il nuovo cluster nel campo Identificatore del **cluster**. **Nota** Per qualsiasi ripristino manuale delle istantanee, è necessario creare un nuovo cluster. 1. Nel campo **Virtual Private Cloud (VPC)**, scegli un VPC dall'elenco a discesa. 1. Per le **sottoreti** e i **gruppi di sicurezza VPC**, puoi utilizzare le impostazioni predefinite o selezionare tre sottoreti a tua scelta e fino a tre gruppi di sicurezza VPC (almeno uno). 1. Se si è soddisfatti della configurazione del cluster, scegliere **Restore cluster (Ripristina cluster)** e attendere il ripristino del cluster. ------ #### [ Using the AWS CLI ] Per ripristinare un cluster elastico da un'istantanea utilizzando il, utilizzate l'operazione con i seguenti parametri: AWS CLI`restore-cluster-from-snapshot` + **--cluster-name**: obbligatorio. Il nome corrente del cluster elastico immesso durante la creazione o l'ultima modifica. + **--snapshot-arn**: obbligatorio. L'identificatore ARN dello snapshot utilizzato per ripristinare il cluster. + **--vpc-security-group-ids**—Facoltativo. Uno o più gruppi di sicurezza Amazon EC2 e Amazon Virtual Private Cloud (VPC) da associare al cluster. + **--kms-key-id**—Facoltativo. Configurare l'identificatore della chiave KMS per un cluster crittografato. L'identificatore della chiave KMS è l'Amazon Resource Name (ARN) per la chiave di crittografia. AWS KMS Se stai creando un cluster utilizzando lo stesso account Amazon Web Services che possiede la chiave di crittografia KMS utilizzata per crittografare il nuovo cluster, puoi utilizzare l'alias della chiave KMS anziché l'ARN per la chiave di crittografia KMS. Se non è specificata una chiave di crittografia KmsKeyId e se il `StorageEncrypted` parametro è vero, Amazon DocumentDB utilizza la chiave di crittografia predefinita. + **--subnet-ids**—Facoltativo. ID di sottorete di rete. Nell'esempio seguente, sostituisci ciascuno *user input placeholder* con le tue informazioni. Per Linux, macOS o Unix: ``` aws docdb-elastic restore-cluster-from-snapshot \ --cluster-name elastic-sample-cluster \ --snapshot-arn sampleResourceName \ --vpc-security-group-ids value ec-65f40350 \ --kms-key-id arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 \ --subnet-ids subnet-9253c6a3, subnet-9f1b5af9 ``` Per Windows: ``` aws docdb-elastic restore-cluster-from-snapshot ^ --cluster-name elastic-sample-cluster ^ --snapshot-arn sampleResourceName ^ --vpc-security-group-ids value ec-65f40350 ^ --kms-key-id arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ^ --subnet-ids subnet-9253c6a3, subnet-9f1b5af9 ``` ------ ## Copia di un'istantanea del cluster elastico In Amazon DocumentDB, puoi copiare istantanee di cluster elastici manuali e automatici all'interno della stessa regione e all'interno dello stesso account. In questa sezione spieghiamo come copiare uno snapshot di un cluster elastico, utilizzando o. Console di gestione AWS AWS CLI ------ #### [ Using the Console di gestione AWS ] Per copiare un'istantanea del cluster elastico utilizzando: Console di gestione AWS 1. Accedi [Console di gestione AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1)e apri la console Amazon DocumentDB. 1. Nel pannello di navigazione, selezionare **Snapshots (Snapshot)**. **Suggerimento** Se non vedi il riquadro di navigazione sul lato sinistro dello schermo, scegli l'icona del menu nell'angolo in alto a sinistra del pannello di navigazione. 1. **Scegli il pulsante a sinistra dell'istantanea che desideri copiare nella colonna dell'identificatore dell'istantanea.** 1. **Scegli **Azioni, quindi Copia**.** ![\[Diagramma: copia istantanea del cluster elastico\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/ec-copy-snapshot.png) 1. Per **New snapshot identifier**, inserisci il nome della nuova istantanea. 1. Per **Copia tag**, seleziona la casella se desideri copiare tutti i tag dallo snapshot del cluster elastico di origine allo snapshot del cluster elastico di destinazione. 1. Per la **crittografia**, scegli una chiave AWS KMS predefinita o una chiave KMS a tua scelta. La seconda opzione ti consente di selezionare una chiave KMS esistente che hai già creato o di crearne una nuova. 1. Scegli **Copia istantanea** al termine. ------ #### [ Using the AWS CLI ] Per copiare un'istantanea del cluster elastico utilizzando il AWS CLI, utilizzate l'`copy-cluster-snapshot`operazione con i seguenti parametri: + **‐‐source-db-cluster-snapshot-identifier**: obbligatorio. L'identificatore dello snapshot del cluster elastico esistente che viene copiato. L'istantanea del cluster elastico deve esistere ed essere nello stato disponibile. Questo parametro non distingue tra maiuscole e minuscole. + **‐‐target-db-cluster-snapshot-identifier**: obbligatorio. L'identificatore della nuova istantanea del cluster elastico da creare a partire dallo snapshot del cluster esistente. Questo parametro non distingue tra maiuscole e minuscole. Vincoli relativi al nome dello snapshot di destinazione: + Non può essere il nome di uno snapshot esistente. + 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. Nell'esempio seguente, sostituisci ciascuno di essi *user input placeholder* con le tue informazioni. Per Linux, macOS o Unix: ``` aws docdb-elastic copy-cluster-snapshot \ ‐‐source-cluster-snapshot-arn \ ‐‐target-cluster-snapshot-name my-target-copied-snapshot ``` Per Windows: ``` aws docdb-elastic copy-cluster-snapshot ^ ‐‐source-cluster-snapshot-arn ^ ‐‐target-cluster-snapshot-name my-target-copied-snapshot ``` ------ ## Eliminazione di un'istantanea del cluster elastico In questa sezione viene spiegato come eliminare un'istantanea di un cluster elastico, utilizzando o. Console di gestione AWS AWS CLI ------ #### [ Using the Console di gestione AWS ] Per ripristinare un cluster elastico da un'istantanea utilizzando: Console di gestione AWS 1. Accedi [Console di gestione AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1)e apri la console Amazon DocumentDB. 1. Nel pannello di navigazione, selezionare **Snapshots (Snapshot)**. **Suggerimento** Se non vedi il riquadro di navigazione sul lato sinistro dello schermo, scegli l'icona del menu nell'angolo in alto a sinistra del pannello di navigazione. 1. **Scegli il pulsante a sinistra dell'istantanea, che desideri utilizzare per ripristinare un cluster, nella colonna Identificatore dell'istantanea.** 1. Scegli **Operazioni**, quindi **Elimina**. ![\[Diagramma: snapshot di eliminazione del cluster elastico\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/elastic-delete-snapshot.png) 1. **Nella finestra di dialogo **Elimina istantanea «snapshot-name»**, scegli Elimina.** ------ #### [ Using the AWS CLI ] Per eliminare un'istantanea del cluster elastico utilizzando il AWS CLI, utilizzate l'operazione con i seguenti parametri: `delete-cluster-snapshot` + **--snapshot-arn**: obbligatorio. L'identificatore ARN dello snapshot utilizzato per ripristinare il cluster. Nell'esempio seguente, sostituisci ciascuno di essi *user input placeholder* con le tue informazioni. Per Linux, macOS o Unix: ``` aws docdb-elastic delete-cluster-snapshot \ --snapshot-arn sampleResourceName ``` Per Windows: ``` aws docdb-elastic delete-cluster-snapshot ^ --snapshot-arn sampleResourceName ``` ------ ## Gestione di un backup automatico di snapshot del cluster elastico Amazon DocumentDB acquisisce istantanee giornaliere dei tuoi cluster elastici. Puoi specificare la finestra di backup preferita e il periodo di conservazione del backup in una configurazione di snapshot del cluster elastico nuova o esistente. In questa sezione viene spiegato come impostare i parametri di backup automatico in un'istantanea del cluster elastico, utilizzando o. Console di gestione AWS AWS CLI ------ #### [ Using the Console di gestione AWS ] Per impostare un backup automatico per una nuova istantanea del cluster elastico utilizzando: Console di gestione AWS 1. Accedi [Console di gestione AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1)e apri la console Amazon DocumentDB. 1. Nel pannello di navigazione scegliere **Cluster**. **Suggerimento** Se non vedi il riquadro di navigazione sul lato sinistro dello schermo, scegli l'icona del menu nell'angolo in alto a sinistra del pannello di navigazione. 1. Scegli il pulsante a sinistra del cluster per il quale desideri modificare le impostazioni di backup nella colonna Identificatore del **cluster**. 1. Scegli **Azioni**, quindi **Modifica**. 1. Nella sezione **Backup**, modifica i campi in base ai requisiti di 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/ec-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. Scegli **Seleziona finestra** se desideri configurare l'ora e la durata di creazione dei backup. **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. **Durata**: nell'elenco, scegli il numero di ore da assegnare alla creazione di backup automatici. 1. Scegli **Nessuna preferenza** se desideri che Amazon DocumentDB scelga l'ora e la durata di creazione dei backup. 1. Al termine, scegli **Modifica cluster**. ------ #### [ Using the AWS CLI ] Per impostare un backup automatico per una nuova istantanea del cluster elastico utilizzando il AWS CLI, utilizzate l'`create-cluster-snapshot`operazione con i seguenti parametri: + **--preferred-backup-window**—Facoltativo. L'intervallo di tempo giornaliero preferito durante il quale vengono creati i backup automatici. L'impostazione predefinita è una finestra di 30 minuti selezionata a caso da un intervallo di tempo di 8 ore per ciascuna. Regione AWS Vincoli: + Il valore deve essere nel formato `hh24:mi-hh24:mi`. + Il valore deve essere nel fuso orario UTC (Universal Coordinated Time). + Il valore non deve essere in conflitto con la finestra di manutenzione preferita. + Il valore deve essere almeno di 30 minuti. + **--backup-retention-period**—Facoltativo. Il numero di giorni durante i quali vengono conservati i backup automatici. Il valore predefinito è 1. Vincoli: + È necessario specificare un valore minimo di 1. + L'intervallo è compreso tra 1 e 35. **Nota** I backup automatici vengono eseguiti solo quando il cluster è in uno stato «attivo». **Nota** È inoltre possibile modificare i `backup-retention-period` parametri `preferred-backup-window` e di un cluster elastico esistente utilizzando il `aws docdb-elastic update-cluster` comando. Nell'esempio seguente, sostituisci ciascuno di essi *user input placeholder* con le tue informazioni. L'`create-cluster`esempio seguente crea il cluster elastico Amazon DocumentDB *sample-cluster* con il periodo di conservazione per i backup automatici di *7* giorni e una finestra di backup preferita di. *18:00-18:30 UTC* Per Linux, macOS o Unix: ``` aws docdb-elastic create-cluster \ --cluster-name sample-cluster \ --shard-capacity 2 \ --shard-count 2 \ --admin-user-name SampleAdmin \ --auth-type PLAIN_TEXT \ --admin-user-password SamplePass123! \ --preferred-backup-window 18:00-18:30 \ --backup-retention-period 7 ``` Per Windows: ``` aws docdb-elastic create-cluster ^ --cluster-name sample-cluster ^ --shard-capacity 2 ^ --shard-count 2 ^ --admin-user-name SampleAdmin ^ --auth-type PLAIN_TEXT ^ --admin-user-password SamplePass123! ^ --preferred-backup-window 18:00-18:30 ^ --backup-retention-period 7 ``` ------ # Arresto e avvio di un cluster elastico Amazon DocumentDB L'arresto e l'avvio dei cluster elastici di Amazon DocumentDB può aiutarti a gestire i costi per gli ambienti di sviluppo e test. Invece di creare ed eliminare cluster elastici ogni volta che usi Amazon DocumentDB, puoi interrompere temporaneamente il cluster quando non è necessario. Potrai quindi riavviarlo quando riprenderai i test. **Topics** + [Panoramica dell'arresto e dell'avvio di un cluster elastico](#elastic-cluster-stop-start-overview) + [Operazioni che è possibile eseguire su un cluster elastico interrotto](#elastic-cluster-stopped-operations) ## Panoramica dell'arresto e dell'avvio di un cluster elastico Nei periodi in cui non è necessario un cluster elastico Amazon DocumentDB, è possibile interrompere il cluster. È possibile avviare nuovamente il cluster ogni volta che è necessario utilizzarlo. L'avvio e l'arresto semplificano i processi di configurazione e smontaggio dei cluster elastici utilizzati per lo sviluppo, il test o attività simili che non richiedono una disponibilità continua. È possibile arrestare e avviare un cluster elastico utilizzando Console di gestione AWS o il AWS CLI con una singola azione. Mentre il cluster elastico è fermo, il volume di archiviazione del 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. Amazon DocumentDB avvia automaticamente il cluster elastico dopo sette giorni in modo da non rimanere indietro rispetto agli aggiornamenti di manutenzione richiesti. Quando il cluster si avvia dopo sette giorni, inizieranno nuovamente a essere addebitati i costi per l'utilizzo del cluster elastico. Mentre il cluster è fermo, non è possibile interrogare il volume di archiviazione perché l'interrogazione richiede che il cluster sia nello stato disponibile. Quando un cluster elastico di Amazon DocumentDB viene interrotto, il cluster non può essere modificato in alcun modo. Ciò include l'eliminazione del cluster. ------ #### [ Using the Console di gestione AWS ] La procedura seguente mostra come arrestare un cluster elastico nello stato disponibile o avviare un cluster elastico interrotto. **Per arrestare o avviare un cluster elastico 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. ![\[Un cluster dall'elenco dei cluster, con la casella di controllo selezionata a sinistra del nome del cluster.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/cluster-list-ec.png) 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)**. ![\[L'elenco a discesa Azioni con l'opzione Stop selezionata.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/ec-stop.png) 1. Nella finestra di dialogo di conferma, conferma che desideri interrompere il cluster elastico scegliendo **Arresta cluster** oppure, per mantenere il cluster in esecuzione, scegli **Annulla**. ![\[Finestra di dialogo di conferma per l'arresto di un cluster, con i pulsanti Annulla e Arresta cluster nella parte inferiore.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/ec-stop-confirm.png) + Se si desidera avviare il cluster e il cluster è arrestato, scegliere **Start (Avvia)**. ![\[L'elenco a discesa Azioni con l'opzione Avvia selezionata.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/ec-start.png) 1. Monitora lo stato del cluster elastico. Se hai avviato il cluster, puoi riprendere a utilizzarlo quando il cluster *sarà disponibile*. Per ulteriori informazioni, consulta [Determinazione dello stato di un cluster](db-cluster-status.md). ![\[Colonna di stato nella tabella Cluster che mostra gli stati disponibili e iniziali.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/ec-starting-status.png) ------ #### [ Using the AWS CLI ] I seguenti esempi di codice mostrano come arrestare un cluster elastico nello stato attivo o disponibile o avviare un cluster elastico interrotto. Per interrompere un cluster elastico utilizzando il AWS CLI, utilizzare l'`stop-cluster`operazione. Per avviare un cluster arrestato, utilizzare l'operazione `start-cluster`. Entrambe le operazioni consentono di utilizzare il parametro `--cluster-arn`. **Parametro:** + **--cluster-arn**: obbligatorio. L'identificatore ARN del cluster elastico che si desidera interrompere o avviare. **Example — Per arrestare un cluster elastico utilizzando il AWS CLI** Nell'esempio seguente, sostituite ciascuno di essi *user input placeholder* con le vostre informazioni. Il codice seguente arresta il cluster elastico con un ARN di. `arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2` Il cluster elastico deve essere nello stato attivo o disponibile. Per Linux, macOS o Unix: ``` aws docdb-elastic stop-cluster \ --cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ``` Per Windows: ``` aws docdb-elastic stop-cluster ^ --cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ``` **Example — Per avviare un cluster elastico utilizzando il AWS CLI** Nell'esempio seguente, sostituite ciascuno di essi *user input placeholder* con le vostre informazioni. Il codice seguente avvia il cluster elastico con un ARN di. `arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2` Il cluster elastico deve essere attualmente interrotto. Per Linux, macOS o Unix: ``` aws docdb-elastic start-cluster \ --cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ``` Per Windows: ``` aws docdb-elastic start-cluster ^ --cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ``` ------ ## Operazioni che è possibile eseguire su un cluster elastico interrotto Non è possibile modificare la configurazione di un cluster elastico Amazon DocumentDB mentre il cluster è fermo. Devi avviare il cluster prima di eseguire questo tipo di operazioni amministrative. Amazon DocumentDB applica qualsiasi manutenzione programmata al cluster elastico interrotto solo dopo il riavvio. Dopo sette giorni, Amazon DocumentDB avvia automaticamente un cluster elastico interrotto in modo che non rimanga troppo indietro nello stato di manutenzione. Al riavvio del cluster elastico, ricomincerai a farti pagare per gli shard presenti nel cluster. Mentre un cluster elastico viene interrotto, Amazon DocumentDB non esegue backup automatici né prolunga il periodo di conservazione dei backup. # Manutenzione dei cluster elastici di Amazon DocumentDB **Topics** + [Visualizzazione delle azioni di manutenzione del cluster elastico in sospeso](#view-elastic-cluster-maintenance) + [Aggiornamenti del motore Elastic Cluster](#elastic-cluster-engine-updates) + [Aggiornamenti del sistema operativo Elastic Cluster](#elastic-cluster-os-updates) Periodicamente, Amazon DocumentDB esegue la manutenzione sulle risorse del cluster elastico di Amazon DocumentDB. La manutenzione prevede più spesso aggiornamenti al motore di database (manutenzione elastica del cluster) o al sistema operativo sottostante del cluster elastico (aggiornamenti del sistema operativo). 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 ai cluster elastici di Amazon DocumentDB non appena sono disponibili. Le patch del motore di database richiedono che i cluster elastici di 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 elastico Amazon DocumentDB. I cluster elastici hanno le rispettive finestre di manutenzione. Le modifiche ai cluster elastici che hai scelto di non applicare immediatamente vengono applicate durante la finestra di manutenzione. Per impostazione predefinita, quando crei un cluster elastico, Amazon DocumentDB assegna una finestra di manutenzione per il cluster elastico. Puoi scegliere la finestra di manutenzione quando crei un cluster elastico. 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). ## Visualizzazione delle azioni di manutenzione del cluster elastico in sospeso È possibile verificare se è disponibile un aggiornamento di manutenzione per il cluster elastico utilizzando 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. + Pianifica l'avvio delle azioni di manutenzione durante la finestra di applicazione selezionata. La finestra di manutenzione determina l'avvio delle operazioni in sospeso, ma non limita il tempo di esecuzione totale di tali operazioni. Utilizzate la seguente AWS CLI operazione per determinare quali azioni di manutenzione sono in sospeso. Elenca tutte le azioni di manutenzione in sospeso: ``` aws docdb-elastic list-pending-maintenance-actions ``` L'output di questa operazione è simile al seguente (formato JSON): ``` { 'ResourcePendingMaintenanceActions': [ { 'ResourceArn': 'string-arn', 'PendingMaintenanceActionDetails': [ { 'Action': 'ENGINE_UPDATE', 'AutoAppliedAfterDate': 'string', 'ForcedApplyDate': 'string', 'OptInStatus': 'string', 'CurrentApplyDate': 'string', 'Description': 'string' }, ] }, ], 'NextToken': 'string' } ``` Ottieni un'azione di manutenzione in sospeso (se ce ne sono) su un dato: `resourceArn` ``` aws docdb-elastic get-pending-maintenance-action --resource-arn string-arn ``` L'aspetto dell'output di questa operazione è simile al seguente (formato JSON). ``` { 'ResourcePendingMaintenanceAction': { 'ResourceArn': 'string-arn', 'PendingMaintenanceActionDetails': [ { 'Action': 'ENGINE_UPDATE', 'AutoAppliedAfterDate': 'string', 'ForcedApplyDate': 'string', 'OptInStatus': 'string', 'CurrentApplyDate': 'string', 'Description': 'string' } ] } } ``` Parametri: + `ResourceArn`—Amazon DocumentDB Amazon Resource Name (ARN) della risorsa a cui si applica l'azione di manutenzione in sospeso. + `Action`—L'azione di manutenzione in sospeso applicata alla risorsa. Valori validi: + `ENGINE_UPDATE` + `ENGINE_UPGRADE` + `SECURITY_UPDATE` + `OS_UPDATE` + `MASTER_USER_PASSWORD_UPDATE` + `AutoAppliedAfterDate`—Prima finestra di manutenzione dopo questa data. `NEXT_MAINTENANCE OPT_IN`viene ignorata in questo caso. + `ForcedApplyDate`—Applicato indipendentemente dalla finestra di manutenzione. `IMMEDIATE OPT_IN`viene ignorato in questo caso. + `OptInStatus`—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. + `APPLY_ON`—Applica l'azione di manutenzione alla data di applicazione specificata indipendentemente dalla finestra di manutenzione successiva per la risorsa. + `UNDO_OPT_IN`—Annulla qualsiasi richiesta esistente `NEXT_MAINTENANCE` o di `APPLY_ON` attivazione. + `CurrentApplyDate`—Viene visualizzato se lo è opt-in-type. `APPLY_ON` + `Description`—Una descrizione dell'opzione per l'azione di manutenzione. ## Aggiornamenti del motore Elastic Cluster Con Amazon DocumentDB, puoi scegliere quando applicare le operazioni di manutenzione. Puoi decidere quando Amazon DocumentDB applicare gli aggiornamenti utilizzando. AWS CLI Applica le azioni di manutenzione in sospeso: ``` aws docdb-elastic apply-pending-maintenance-action --resource-arn string-arn --apply-action string-enum --opt-in-type string-enum [--apply-on string-date-range] ``` Parametri: + **--resource-arn**—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: + `ENGINE_UPDATE` + `ENGINE_UPGRADE` + `SECURITY_UPDATE` + `OS_UPDATE` + `MASTER_USER_PASSWORD_UPDATE` + **--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. + `APPLY_ON`—Applica l'azione di manutenzione alla data di applicazione specificata indipendentemente dalla finestra di manutenzione successiva per la risorsa. + `UNDO_OPT_IN`—Annulla qualsiasi richiesta esistente `NEXT_MAINTENANCE` o di `APPLY_ON` attivazione. + **[--apply-on]**—Obbligatorio se lo è opt-in-type. `APPLY_ON` Formato: `yyyy/MM/dd HH:mm-yyyy/MM/dd HH:mm` (Questa opzione utilizza l'ora UTC. L'ora di inizio può essere in qualsiasi momento futuro compreso tra un minimo di 30 minuti e un massimo di 14 giorni, oppure la data in cui è in sospeso l'azione, a seconda di quale force/apply data si verifichi prima. L'intervallo temporale dall'inizio alla fine può durare da un minimo di 30 minuti a un massimo di 8 ore.) L'output di questa operazione è simile al seguente (formato JSON): ``` { 'ResourcePendingMaintenanceAction': { 'ResourceArn': 'string-arn', 'PendingMaintenanceActionDetails': [ { 'Action': 'SECURITY_UPDATE', 'AutoAppliedAfterDate': 'string', 'ForcedApplyDate': 'string', 'OptInStatus': 'IMMEDIATE', 'CurrentApplyDate': 'string', 'Description': 'string' }, ] } } ``` Parametri: + `ResourceArn`—Amazon DocumentDB Amazon Resource Name (ARN) della risorsa a cui si applica l'azione di manutenzione in sospeso. + `Action`—L'azione di manutenzione in sospeso applicata alla risorsa. Valori validi: + `ENGINE_UPDATE` + `ENGINE_UPGRADE` + `SECURITY_UPDATE` + `OS_UPDATE` + `MASTER_USER_PASSWORD_UPDATE` + `AutoAppliedAfterDate`—Prima finestra di manutenzione dopo questa data. `NEXT_MAINTENANCE OPT_IN`viene ignorata in questo caso. + `ForcedApplyDate`—Applicato indipendentemente dalla finestra di manutenzione. `IMMEDIATE OPT_IN`viene ignorato in questo caso. + `OptInStatus`—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. + `APPLY_ON`—Applica l'azione di manutenzione alla data di applicazione specificata indipendentemente dalla finestra di manutenzione successiva per la risorsa. + `UNDO_OPT_IN`—Annulla qualsiasi richiesta esistente `NEXT_MAINTENANCE` o di `APPLY_ON` attivazione. + `CurrentApplyDate`—Viene visualizzato se lo è opt-in-type. `APPLY_ON` + `Description`—Una descrizione dell'opzione per l'azione di manutenzione. ### 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: + `CurrentApplyDate`—La data in cui l'azione di manutenzione verrà applicata immediatamente o durante la finestra di manutenzione successiva. Se la manutenzione è facoltativa, questo valore può essere nullo. + `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. ### Azioni di manutenzione create dall'utente In qualità di utente del DBelastic cluster Amazon Document, puoi avviare aggiornamenti alle configurazioni dei tuoi cluster. **Aggiornamento della password principale del cluster** ``` aws docdb-elastic update-cluster --cluster-arn string-arn [--admin-user-password string] [--auth-type string-enum] [--apply-method string-enum] [--apply-on string-date-range] #... other parameters of the API that follow here are not relevant for this configuration ``` Parametri: + **--cluster-arn**—Amazon DocumentDB Amazon Resource Name (ARN) della risorsa a cui verrà applicata l'azione di manutenzione. + **[--admin-user-password]**—La password associata all'utente amministratore. + **[--auth-type]**—Il tipo di autenticazione utilizzato per determinare dove recuperare la password utilizzata per accedere al cluster elastico. I tipi validi sono `PLAIN_TEXT` o. `SECRET_ARN` + **[--apply-method]**—Un valore che specifica il tipo di metodo da applicare. I valori consentiti sono `IMMEDIATE` e `APPLY_ON`. Il valore predefinito è “`IMMEDIATE`”. + **[--apply-on]**—Obbligatorio se lo è. `apply-method` `APPLY_ON` Formato: `yyyy/MM/dd HH:mm-yyyy/MM/dd HH:mm` (Questa opzione utilizza l'ora UTC. L'orario di inizio può essere in qualsiasi momento futuro da un minimo di 30 minuti a un massimo di 14 giorni. L'intervallo di tempo dall'inizio alla fine può essere compreso tra un minimo di 30 minuti e un massimo di 8 ore.) L'output di questa operazione è simile al seguente (formato JSON): ``` { 'ResourcePendingMaintenanceAction': { 'ResourceArn': 'string-arn', 'PendingMaintenanceActionDetails': [ { 'Action': 'MASTER_USER_PASSWORD_UPDATE', 'OptInStatus': 'APPLY_ON', 'CurrentApplyDate': 'string', 'Description': 'string' }, ] } } ``` ### 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. Il cluster elastico non è disponibile durante questo periodo solo se vengono applicate modifiche al sistema (ad esempio una modifica delle operazioni di storage su scala) che richiedono un'interruzione. Non è disponibile solo per il tempo minimo necessario per apportare le modifiche necessarie. L'impostazione predefinita è una finestra di 30 minuti selezionata a caso da un periodo di 8 ore per ogni regione di Amazon Web Services, che si verifica in un giorno casuale della settimana. Per modificare la finestra di manutenzione, consulta. [Modifica delle configurazioni dei cluster elastici](elastic-managing.md#elastic-modify) ## Aggiornamenti del sistema operativo Elastic Cluster I cluster elastici di 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 di un cluster elastico Amazon DocumentDB. La maggior parte degli aggiornamenti del sistema operativo per i cluster elastici di 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 dei cluster. Questo serve a mantenere il livello di sicurezza del database. Per evitare interruzioni impreviste, ti consigliamo di applicare gli aggiornamenti del sistema operativo al tuo cluster elastico Amazon DocumentDB non appena sono disponibili e di impostare la finestra di manutenzione del cluster nel momento che preferisci, in base alle tue esigenze aziendali.