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 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
```
------