Gestione delle istantanee dei cluster elastici - Amazon DocumentDB
Creazione manuale di uno snapshot del cluster elasticoVisualizzazione di un'istantanea del cluster elasticoRipristino di un cluster elastico da un'istantaneaCopia di un'istantanea del cluster elasticoEliminazione di un'istantanea del cluster elasticoGestione di un backup automatico di snapshot del cluster elastico

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.

Creazione manuale di uno snapshot del cluster elastico

In questa sezione viene spiegato come creare uno snapshot manuale di un cluster elastico, utilizzando AWS Management Console o AWS CLI con le seguenti istruzioni.

Using the AWS Management Console

Per creare un'istantanea manuale del cluster elastico utilizzando: AWS Management Console

  1. Accedi AWS Management Consolee apri la console Amazon DocumentDB.

  2. 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.

  3. Nella pagina Snapshots (Snapshot) scegli Create (Crea).

  4. 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 Crea.

    Diagramma: cluster elastico, creazione di un'istantanea
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-snapshotoperazione 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 ogni segnaposto dell'input utente 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 AWS Management Console o AWS CLI con le seguenti istruzioni.

Using the AWS Management Console

Per visualizzare le informazioni su uno specifico snapshot del cluster elastico, utilizzare: AWS Management Console

  1. Accedi AWS Management Consolee apri la console Amazon DocumentDB.

  2. 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.

  3. Nella pagina Istantanee, scegli la tua istantanea dall'elenco facendo clic sul nome nella colonna dell'identificatore dell'istantanea.

  4. Visualizza le informazioni sull'istantanea in Dettagli.

    Diagramma: snapshot di Elastic Cluster View
Using the AWS CLI

Per visualizzare informazioni su uno specifico snapshot del cluster elastico utilizzando il AWS CLI, utilizzate l'get-cluster-snapshotoperazione con i seguenti parametri:

  • --snapshot-arn: obbligatorio. L'identificatore ARN dell'istantanea per la quale desideri informazioni.

Nell'esempio seguente, sostituisci ogni segnaposto dell'input utente 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 del cluster elastico utilizzando il AWS CLI, utilizzate l'get-cluster-snapshotoperazione con i seguenti parametri:

  • --snapshot-arn: obbligatorio. L'identificatore ARN dell'istantanea per la quale desideri informazioni.

Nell'esempio seguente, sostituisci ogni segnaposto dell'input utente 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-snapshotsoperazione 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 damax-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 ogni segnaposto dell'input utente 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 AWS Management Console o AWS CLI con le seguenti istruzioni.

Using the AWS Management Console

Per ripristinare un cluster elastico da un'istantanea utilizzando: AWS Management Console

  1. Accedi AWS Management Consolee apri la console Amazon DocumentDB.

  2. 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.

  3. Scegli il pulsante a sinistra dell'istantanea, che desideri utilizzare per ripristinare un cluster, nella colonna Identificatore dell'istantanea.

  4. Scegli Azioni, quindi Ripristina.

    Diagramma: ripristino del cluster elastico da un'istantanea

  5. 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.

  6. Nel campo Virtual Private Cloud (VPC), scegli un VPC dall'elenco a discesa.

  7. 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).

  8. 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 ogni segnaposto di input dell'utente 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. AWS Management Console AWS CLI

Using the AWS Management Console

Per copiare un'istantanea del cluster elastico utilizzando: AWS Management Console

  1. Accedi AWS Management Consolee apri la console Amazon DocumentDB.

  2. 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.

  3. Scegli il pulsante a sinistra dell'istantanea che desideri copiare nella colonna dell'identificatore dell'istantanea.

  4. Scegli Azioni, quindi Copia.

    Diagramma: copia istantanea del cluster elastico

  5. Per New snapshot identifier, inserisci il nome della nuova istantanea.

  6. 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.

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

  8. Scegli Copia istantanea al termine.

Using the AWS CLI

Per copiare un'istantanea del cluster elastico utilizzando il AWS CLI, utilizzate l'copy-cluster-snapshotoperazione 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. Se si copia l'istantanea su un'altra Regione AWS, questo identificatore deve essere nel formato ARN dell'origine. Regione AWS 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 dall'istantanea 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 ogni segnaposto dell'input utente con le tue informazioni.

Per Linux, macOS o Unix:

aws docdb-elastic copy-cluster-snapshot \
     ‐‐source-cluster-snapshot-arn <sample ARN> \
     ‐‐target-cluster-snapshot-name my-target-copied-snapshot

Per Windows:

aws docdb-elastic copy-cluster-snapshot ^
     ‐‐source-cluster-snapshot-arn <sample 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. AWS Management Console AWS CLI

Using the AWS Management Console

Per ripristinare un cluster elastico da un'istantanea utilizzando: AWS Management Console

  1. Accedi AWS Management Consolee apri la console Amazon DocumentDB.

  2. 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.

  3. Scegli il pulsante a sinistra dell'istantanea, che desideri utilizzare per ripristinare un cluster, nella colonna Identificatore dell'istantanea.

  4. Scegli Operazioni, quindi Elimina.

    Diagramma: snapshot di eliminazione del cluster elastico

  5. 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 ogni segnaposto di input dell'utente 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. AWS Management Console AWS CLI

Using the AWS Management Console

Per impostare un backup automatico per una nuova istantanea del cluster elastico utilizzando: AWS Management Console

  1. Accedi AWS Management Consolee apri la console Amazon DocumentDB.

  2. Nel pannello di navigazione scegliere Clusters (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.

  3. Scegli il pulsante a sinistra del cluster per il quale desideri modificare le impostazioni di backup nella colonna Identificatore del cluster.

  4. Scegli Azioni, quindi Modifica.

  5. 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.

    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.

    2. 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.

      2. Scegli Nessuna preferenza se desideri che Amazon DocumentDB scelga l'ora e la durata di creazione dei backup.

  6. 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-snapshotoperazione 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 ogni segnaposto dell'input utente con le tue informazioni.

L'create-clusteresempio seguente crea il cluster elastico Amazon DocumentDB sample-cluster con un 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