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à. # Backup e ripristino in Amazon DocumentDB Amazon DocumentDB (compatibile con MongoDB) esegue il backup continuo dei dati su Amazon Simple Storage Service (Amazon S3) per 1-35 giorni, in modo da consentirti di ripristinarli rapidamente in qualsiasi momento entro il periodo di conservazione del backup. Amazon DocumentDB acquisisce anche istantanee automatiche dei dati come parte di questo processo di backup continuo. **Nota** Si tratta di bucket Amazon S3 gestiti dal servizio e non avrai accesso ai file di backup. Se desideri controllare i tuoi backup, segui le istruzioni su [Dumping, Ripristino, Importazione ed Esportazione dei](https://docs.aws.amazon.com/documentdb/latest/developerguide/backup_restore-dump_restore_import_export_data.html) dati. Puoi anche conservare i dati di backup oltre il periodo di retention dei backup creando una snapshot dei dati del cluster. Il processo di backup non ha impatto sulle prestazioni del cluster. Questa sezione illustra i casi d'uso delle funzionalità di backup in Amazon DocumentDB e mostra come gestire i backup per i cluster Amazon DocumentDB. **Topics** + [Backup e ripristino: concetti](backup_restore-nouns_verbs.md) + [Informazioni sull'utilizzo dello storage di backup](backup_restore-understanding_backup_storage_usage.md) + [Scaricamento, ripristino, importazione ed esportazione di dati](backup_restore-dump_restore_import_export_data.md) + [Considerazioni sulle istantanee del cluster](backup_restore-cluster_snapshot_considerations.md) + [Confronto tra istantanee automatiche e manuali](backup_restore-compare_automatic_manual_snapshots.md) + [Creazione di un'istantanea manuale del cluster](backup_restore-create_manual_cluster_snapshot.md) + [Copia di un'istantanea del cluster](backup_restore-copy_cluster_snapshot.md) + [Condivisione di uno snapshot di un cluster](backup_restore-share_cluster_snapshots.md) + [Ripristino da un'istantanea del cluster](backup_restore-restore_from_snapshot.md) + [Ripristino in un determinato momento](backup_restore-point_in_time_recovery.md) + [Eliminazione di un'istantanea del cluster](backup_restore-delete_cluster_snapshot.md) # Backup e ripristino: concetti | Sostantivo | Description | APIs (Verbi) | | --- | --- | --- | | Periodo di conservazione dei backup | Un periodo di tempo compreso tra 1 e 35 giorni per il quale è possibile eseguire un point-in-time ripristino. | `create-db-cluster` `modify-db-cluster` `restore-db-cluster-to-point-in-time` | | Volume di storage Amazon DocumentDB | Volume di storage a disponibilità elevata ed estremamente durevole che replica i dati in sei modi su tre zone di disponibilità. Un cluster Amazon DocumentDB è altamente durevole indipendentemente dal numero di istanze nel cluster. | `create-db-cluster` `delete-db-cluster` | | Backup window (Finestra di backup) | Periodo di tempo durante il giorno in cui vengono acquisite le snapshot automatiche. | `create-db-cluster` `describe-db-cluster` `modify-db-cluster` | | Snapshot automatica | Snapshot giornalieri che sono backup completi del cluster e vengono creati automaticamente dal processo di backup continuo in Amazon DocumentDB. | `restore-db-cluster-from-snapshot` `describe-db-cluster-snapshot-attributes` `describe-db-cluster-snapshots` | | Snapshot manuale | Snapshot create manualmente per conservare i backup completi di un cluster oltre il periodo di backup. | `create-db-cluster-snapshot` `copy-db-cluster-snapshot` `delete-db-cluster-snapshot` `describe-db-cluster-snapshot-attributes` `describe-db-cluster-snapshots` `modify-db-cluster-snapshot-attribute` | # Informazioni sull'utilizzo dello storage di backup Lo storage di backup di Amazon DocumentDB è costituito da backup continui entro il periodo di conservazione dei backup e istantanee manuali al di fuori del periodo di conservazione. Per controllare l'utilizzo dello storage di backup, è possibile ridurre l'intervallo di retention dei backup e/o rimuovere gli snapshot manuali obsoleti e non più necessari. Per informazioni generali sui backup di Amazon DocumentDB, consulta. [Backup e ripristino in Amazon DocumentDB](backup_restore.md) Per informazioni sui prezzi dello storage di backup di Amazon DocumentDB, consulta i prezzi di [Amazon DocumentDB](https://aws.amazon.com/documentdb/pricing/). Per controllare i costi, è sufficiente monitorare la quantità di storage occupata da backup continui e snapshot manuali che permangono oltre il periodo di retention e, all'occorrenza, ridurre l'intervallo di retention dei backup nonché rimuovere gli snapshot manuali non più necessari. Puoi utilizzare i CloudWatch parametri `TotalBackupStorageBilled` di Amazon e rivedere e `BackupRetentionPeriodStorageUsed` monitorare la quantità di storage utilizzata dai tuoi backup di Amazon DocumentDB, come segue: `SnapshotStorageUsed` + `BackupRetentionPeriodStorageUsed` rappresenta la quantità di storage di backup al momento utilizzata per l'archiviazione di backup continui. Il valore di questo parametro dipende dalle dimensioni del volume del cluster e dalla quantità di modifiche apportate durante il periodo di retention. Tuttavia, ai fini della fatturazione, il parametro non supera mai il volume di cluster cumulativo nel periodo di retention. Con un cluster di 100 GiB e un periodo di retention di due giorni, ad esempio, il valore massimo previsto per `BackRetentionPeriodStorageUsed` è di 200 GiB (100 GiB \$1 100 GiB).   + `SnapshotStorageUsed` rappresenta la quantità di storage di backup utilizzata per l'archiviazione di snapshot manuali oltre il periodo di retention dei backup. Gli snapshot manuali acquisiti nel periodo di retention non rientrano nel calcolo dello storage di backup. Analogamente, anche gli snapshot automatici non vengono inclusi nel novero dello storage di backup. Ogni snapshot corrisponde, per dimensioni, al volume del cluster al momento della sua acquisizione. Il valore di `SnapshotStorageUsed` dipende dal numero e dalle dimensioni degli snapshot conservati. Supponiamo, ad esempio, di disporre di uno snapshot al di fuori del periodo di retention, con il volume del cluster, al momento dell'acquisizione di tale snapshot, di 100 GiB. In questo caso, lo `SnapshotStorageUsed` corrisponde a 100 GiB.   + `TotalBackupStorageBilled` corrisponde alla somma di `BackupRetentionPeriodStorageUsed` e `SnapshotStorageUsed`, meno una quantità di storage di backup gratuito pari alla dimensione del volume del cluster per un giorno. Ad esempio, se la dimensione del cluster è 100 GiB, si dispone di un giorno di conservazione e si dispone di una snapshot al di fuori del periodo di conservazione, è 100 GiB (`TotalBackupStorageBilled`100 GiB \$1 100 GiB - 100 GiB).   + Questi parametri vengono calcolati indipendentemente per ogni cluster Amazon DocumentDB. [Puoi monitorare i tuoi cluster Amazon DocumentDB e creare report utilizzando i CloudWatch parametri tramite la console. CloudWatch ](https://console.aws.amazon.com/cloudwatch) Per ulteriori informazioni su come utilizzare i CloudWatch parametri, consulta. [Monitoraggio di Amazon DocumentDB](monitoring_docdb.md) # Scaricamento, ripristino, importazione ed esportazione di dati Puoi utilizzare le `mongoimport` utilità`mongodump`, `mongorestore``mongoexport`, e per spostare i dati all'interno e all'esterno del cluster Amazon DocumentDB. In questa sezione viene descritto lo scopo di ognuno di questi strumenti e configurazioni per migliorare le prestazioni. **Topics** + [`mongodump`](#backup_restore-dump_restore_import_export_data-mongodump) + [`mongorestore`](#backup_restore-dump_restore_import_export_data-mongorestore) + [`mongoexport`](#backup_restore-dump_restore_import_export_data-mongoexport) + [`mongoimport`](#backup_restore-dump_restore_import_export_data-mongoimport) + [Tutorial](#backup_restore-dump_restore_import_export_data-tutorial) ## `mongodump` L'utilità `mongodump` crea un backup binario (BSON) di un database MongoDB. Lo `mongodump` strumento è il metodo preferito per scaricare i dati dalla distribuzione di MongoDB di origine quando si desidera ripristinarli nel cluster Amazon DocumentDB, grazie all'efficienza delle dimensioni ottenuta archiviando i dati in formato binario. A seconda delle risorse disponibili sull'istanza o sulla macchina che si sta utilizzando per eseguire il comando, è possibile velocizzare l'operazione `mongodump` aumentando il numero di raccolte parallele scaricate dall'impostazione predefinita 1 utilizzando l'`--numParallelCollections`opzione. Una buona regola pratica è iniziare con un worker per vCPU sull'istanza principale del cluster Amazon DocumentDB. **Nota** Consigliamo MongoDB Database Tools fino alla versione 100.6.1 inclusa per Amazon DocumentDB. [Puoi accedere ai download di MongoDB Database Tools qui.](https://www.mongodb.com/download-center/database-tools/releases/archive) ### Esempio di utilizzo Di seguito è riportato un esempio di utilizzo dell'`mongodump`utilità nel cluster Amazon DocumentDB,. `sample-cluster` ``` mongodump --ssl \ --host="sample-cluster.node.us-east-1.docdb.amazonaws.com:27017" \ --collection=sample-collection \ --db=sample-database \ --out=sample-output-file \ --numParallelCollections 4 \ --username=sample-user \ --password=abc0123 \ --sslCAFile global-bundle.pem ``` ## `mongorestore` L'utilità `mongorestore` consente di ripristinare un backup binario (BSON) di un database creato con l'utilità `mongodump`. Puoi utilizzare l'opzione `--numInsertionWorkersPerCollection` per migliorare le prestazioni di ripristino aumentando il numero di worker per ogni raccolta durante il ripristino (il valore predefinito è 1). Una buona regola pratica è iniziare con un worker per vCPU sull'istanza principale del cluster Amazon DocumentDB. ### Esempio di utilizzo Di seguito è riportato un esempio di utilizzo dell'`mongorestore`utilità nel cluster Amazon DocumentDB,. `sample-cluster` ``` mongorestore --ssl \ --host="sample-cluster.node.us-east-1.docdb.amazonaws.com:27017" \ --username=sample-user \ --password=abc0123 \ --sslCAFile global-bundle.pem ``` ## `mongoexport` Lo `mongoexport` strumento esporta i dati in Amazon DocumentDB nei formati di file JSON, CSV o TSV. Lo strumento `mongoexport` è il metodo preferito per esportare i dati che devono essere leggibili dall'uomo o dal computer. **Nota** `mongoexport` non supporta direttamente le esportazioni parallele. Tuttavia, è possibile aumentare le prestazioni eseguendo più attività `mongoexport` contemporaneamente per raccolte diverse. ### Esempio di utilizzo Di seguito è riportato un esempio di utilizzo dello `mongoexport` strumento nel cluster Amazon DocumentDB,. `sample-cluster` ``` mongoexport --ssl \ --host="sample-cluster.node.us-east-1.docdb.amazonaws.com:27017" \ --collection=sample-collection \ --db=sample-database \ --out=sample-output-file \ --username=sample-user \ --password=abc0123 \ --sslCAFile global-bundle.pem ``` ## `mongoimport` Lo `mongoimport` strumento importa il contenuto di file JSON, CSV o TSV in un cluster Amazon DocumentDB. È possibile utilizzare il parametro `-–numInsertionWorkers` per parallelizzare e velocizzare l'importazione (il valore predefinito è 1). ### Esempio di utilizzo Di seguito è riportato un esempio di utilizzo dello `mongoimport` strumento nel cluster Amazon DocumentDB,. `sample-cluster` ``` mongoimport --ssl \ --host="sample-cluster.node.us-east-1.docdb.amazonaws.com:27017" \ --collection=sample-collection \ --db=sample-database \ --file= \ --numInsertionWorkers 4 \ --username=sample-user \ --password=abc0123 \ --sslCAFile global-bundle.pem ``` ## Tutorial Il seguente tutorial descrive come utilizzare le `mongoimport` utilità`mongodump`, `mongorestore``mongoexport`, e per spostare dati da e verso un cluster Amazon DocumentDB. 1. **Prerequisiti**: prima di iniziare, assicurati che il cluster Amazon DocumentDB sia predisposto e che tu abbia accesso a un'istanza Amazon EC2 nello stesso VPC del cluster. Per ulteriori informazioni, consulta [Connect tramite Amazon EC2](connect-ec2.md). Per poter utilizzare gli strumenti di utilità mongo, devi avere il mongodb-org-tools pacchetto installato nella tua istanza EC2, come segue. ``` sudo yum install mongodb-org-tools-4.0.18 ``` Poiché Amazon DocumentDB utilizza la crittografia Transport Layer Security (TLS) per impostazione predefinita, devi anche scaricare il file Amazon RDS Certificate Authority (CA) per utilizzare la shell mongo per connetterti, come segue. ``` wget https://truststore.pki.rds.amazonaws.com/global/global-bundle.pem ``` 1. **Scarica dati di esempio**: per questo tutorial, scaricherai alcuni dati di esempio che contengono informazioni sui ristoranti. ``` wget https://raw.githubusercontent.com/ozlerhakan/mongodb-json-files/master/datasets/restaurant.json ``` 1. **Importa i dati di esempio in Amazon DocumentDB**: poiché i dati sono in un formato JSON logico, utilizzerai l'`mongoimport`utilità per importare i dati nel tuo cluster Amazon DocumentDB. ``` mongoimport --ssl \ --host="tutorialCluster.amazonaws.com:27017" \ --collection=restaurants \ --db=business \ --file=restaurant.json \ --numInsertionWorkers 4 \ --username= \ --password= \ --sslCAFile global-bundle.pem ``` 1. **Esegui il dump dei dati con `mongodump`**: ora che hai dati nel tuo cluster Amazon DocumentDB, puoi eseguire un dump binario di tali dati utilizzando l'utilità. `mongodump` ``` mongodump --ssl \ --host="tutorialCluster.us-east-1.docdb.amazonaws.com:27017"\ --collection=restaurants \ --db=business \ --out=restaurantDump.bson \ --numParallelCollections 4 \ --username= \ --password= \ --sslCAFile global-bundle.pem ``` 1. **Elimina la `restaurants` raccolta**: prima di ripristinare la `restaurants` raccolta nel `business` database, devi prima eliminare la raccolta già esistente in quel database, come segue. ``` use business ``` ``` db.restaurants.drop() ``` 1. **Ripristina i dati con `mongorestore`**: con il dump binario dei dati della fase 3, ora puoi utilizzare l'`mongorestore`utilità per ripristinare i dati nel tuo cluster Amazon DocumentDB. ``` mongorestore --ssl \ --host="tutorialCluster.us-east-1.docdb.amazonaws.com:27017" \ --numParallelCollections 4 \ --username= \ --password= \ --sslCAFile global-bundle.pem restaurantDump.bson ``` 1. **Esporta i dati utilizzando `mongoexport`**: per completare il tutorial, esporta i dati dal cluster nel formato di un file JSON, non diverso dal file importato nella fase 1. ``` mongoexport --ssl \ --host="tutorialCluster.node.us-east-1.docdb.amazonaws.com:27017" \ --collection=restaurants \ --db=business \ --out=restaurant2.json \ --username= \ --password= \ --sslCAFile global-bundle.pem ``` 1. **Convalida**: è possibile verificare che l'output del passaggio 5 produca lo stesso risultato del passaggio 1 con i seguenti comandi. ``` wc -l restaurant.json ``` Output da questo comando: ``` 2548 restaurant.json ``` ``` wc -l restaurant2.json ``` Output da questo comando: ``` 2548 restaurant2.json ``` # Considerazioni sulle istantanee del cluster Amazon DocumentDB crea istantanee automatiche giornaliere del cluster durante la finestra di backup del cluster. Amazon DocumentDB salva le istantanee automatiche del cluster in base al periodo di conservazione dei backup specificato. Se necessario, puoi ripristinare il tuo cluster a uno specifico momento durante il periodo di retention dei backup. Le snapshot automatiche non vengono eseguite quando un'operazione di copia è in corso nella stessa regione dello stesso cluster. **Topics** + [Storage di backup](#backup_restore-backup_storage) + [Backup window (Finestra di backup)](#backup_restore-backup_window) + [Periodo di conservazione dei backup](#backup_restore-backup_retention_period) + [Copia la crittografia delle istantanee del cluster](#backup_restore-encryption) Oltre alle snapshot del cluster automatiche, puoi creare manualmente anche una snapshot del cluster. È possibile copiare gli snapshot automatici e manuali. Per ulteriori informazioni, consultare [Creazione di un'istantanea manuale del cluster](backup_restore-create_manual_cluster_snapshot.md) e [Copia delle istantanee del cluster Amazon DocumentDB](backup_restore-copy_cluster_snapshot.md). **Nota** Il cluster deve essere in stato *disponibile* per poter acquisire una snapshot automatica. Non puoi condividere uno snapshot del cluster automatizzato di Amazon DocumentDB. Come soluzione alternativa, è possibile creare uno snapshot manuale copiando lo snapshot automatico e quindi condividere la copia. Per ulteriori informazioni sulla copia di uno snapshot, consulta [Copia delle istantanee del cluster Amazon DocumentDB](backup_restore-copy_cluster_snapshot.md). Per ulteriori informazioni sul ripristino di un cluster da uno snapshot, consulta [Ripristino da un'istantanea del cluster](backup_restore-restore_from_snapshot.md). ## Storage di backup Lo storage di backup di Amazon DocumentDB per ciascuno di essi Regione AWS è composto dallo storage di backup necessario per il periodo di conservazione dei backup, che include istantanee automatiche e manuali del cluster in quella regione. Il periodo di retention dei backup predefinito è 1 giorno. Per ulteriori informazioni sui prezzi dello storage di backup, consulta i prezzi di [Amazon DocumentDB.](https://aws.amazon.com/documentdb/pricing/) Quando elimini un cluster, tutte le relative snapshot automatiche vengono eliminate e non possono essere recuperate. Tuttavia, le istantanee manuali non vengono eliminate quando si elimina un cluster. Se scegli di fare in modo che Amazon DocumentDB crei uno snapshot finale (snapshot manuale) prima dell'eliminazione del cluster, puoi utilizzare lo snapshot finale per ripristinare il cluster. Per ulteriori informazioni su snapshot e storage, consulta [Informazioni sull'utilizzo dello storage di backup](backup_restore-understanding_backup_storage_usage.md). ## Backup window (Finestra di backup) Le snapshot automatiche vengono eseguite quotidianamente durante la finestra di backup scelta. Se la snapshot richiede più tempo rispetto a quello previsto per la finestra di backup, il processo di backup continua fino al completamento, anche se la finestra di backup è terminata. La finestra di backup non può sovrapporsi con la finestra di manutenzione settimanale per il cluster. Se non specifichi una finestra di backup preferita quando crei il cluster, Amazon DocumentDB assegna una finestra di backup predefinita di 30 minuti. Questa finestra viene scelta a caso da un blocco di 8 ore associato alla regione del cluster. Puoi modificare la finestra di backup preferita modificando il cluster. Per ulteriori informazioni, consulta [Modifica di un cluster Amazon DocumentDB](db-cluster-modify.md). | Nome della regione | Regione | Blocco di tempo UTC | | --- | --- | --- | | Stati Uniti orientali (Ohio) | us-east-2 | 03:00-11:00 | | Stati Uniti orientali (Virginia settentrionale) | us-east-1 | 03:00-11:00 | | Stati Uniti occidentali (Oregon) | us-west-2 | 06:00-14:00 | | Africa (Città del Capo) | af-south-1 | 03:00 — 11:00 | | Asia Pacific (Hong Kong) | ap-east-1 | 06:00-14:00 | | Asia Pacifico (Hyderabad) | ap-south-2 | 06:30 — 14:30 | | Asia Pacifico (Malesia) | ap-southeast-5 | 13:00-21:00 | | Asia Pacifico (Mumbai) | ap-south-1 | 06:00-14:00 | | Asia Pacifico (Osaka-Locale) | ap-northeast-3 | 12:00-20:00 | | Asia Pacific (Seoul) | ap-northeast-2 | 13:00-21:00 | | Asia Pacifico (Singapore) | ap-southeast-1 | 14:00-22:00 | | Asia Pacifico (Sydney) | ap-southeast-2 | 12:00-20:00 | | Asia Pacifico (Giacarta) | ap-southeast-3 | 08:00-16:00 | | Asia Pacifico (Melbourne) | ap-southeast-4 | 11:00-19:00 | | Asia Pacifico (Thailandia) | ap-southeast-7 | 15:00-23:00 | | Asia Pacifico (Tokyo) | ap-northeast-1 | 13:00-21:00 | | Canada (Centrale) | ca-central-1 | 03:00-11:00 | | Cina (Pechino) | cn-north-1 | 06:00-14:00 | | China (Ningxia) | cn-northwest-1 | 06:00-14:00 | | Europa (Francoforte) | eu-central-1 | 21:00-05:00 | | Europa (Zurigo) | eu-central-2 | 02:00-10:00 | | Europa (Irlanda) | eu-west-1 | 22:00-06:00 | | Europe (London) | eu-west-2 | 22:00-06:00 | | Europe (Milan) | eu-south-1 | 02:00-10:00 | | Europa (Parigi) | eu-west-3 | 23:59-07:29 | | Europa (Spagna) | eu-south-2 | 02:00 — 10:00 | | Europa (Stoccolma) | eu-north-1 | 04:00 — 12:00 | | Messico (Centrale) | mx-central-1 | 03:00-11:00 | | Medio Oriente (Emirati Arabi Uniti) | me-central-1 | 05:00 — 13:00 | | Sud America (San Paolo) | sa-east-1 | 00:00-08:00 | | Israele (Tel Aviv) | il-central-1 | 04:00-12:00 | | AWS GovCloud (Stati Uniti orientali) | us-gov-east-1 | 17:00-01:00 | | AWS GovCloud (Stati Uniti occidentali) | us-gov-west-1 | 06:00-14:00 | ## Periodo di conservazione dei backup Il periodo di conservazione dei backup è il numero di giorni in cui un backup automatico viene conservato prima di essere eliminato automaticamente. Amazon DocumentDB supporta un periodo di conservazione dei backup di 1—35 giorni. Puoi impostare il periodo di retention dei backup al momento della creazione di un cluster. Se non imposti esplicitamente il periodo di retention dei backup, verrà assegnato un periodo predefinito di un giorno al cluster. Dopo aver creato un cluster, puoi modificare il periodo di conservazione dei backup modificando il cluster utilizzando il o il. Console di gestione AWS AWS CLI Per ulteriori informazioni, consulta [Modifica di un cluster Amazon DocumentDB](db-cluster-modify.md). ## Copia la crittografia delle istantanee del cluster La crittografia di cluster e snapshot si basa su una chiave di crittografia KMS. L'ID della chiave KMS è l'Amazon Resource Name (ARN), l'identificatore della chiave KMS o l'alias della chiave KMS per la chiave di crittografia KMS. Si applicano le seguenti linee guida e limitazioni: + La crittografia viene dedotta dal cluster durante la creazione di un'istantanea. Se il cluster è crittografato, l'istantanea di quel cluster viene crittografata con la stessa chiave KMS. Se il cluster non è crittografato, lo snapshot non è crittografato. + Se copi uno snapshot del cluster crittografato dal tuo account Amazon Web Services, puoi specificare un valore per `KmsKeyId` crittografare la copia con una nuova chiave di crittografia KMS. Se non specifichi un valore per`KmsKeyId`, la copia dello snapshot del cluster viene crittografata con la stessa chiave KMS dello snapshot del cluster di origine. + Se copi un'istantanea del cluster crittografata condivisa da un altro account Amazon Web Services, devi specificare un valore per`KmsKeyId`. + Per copiare uno snapshot del cluster crittografato in un'altra regione Amazon Web Services, imposta `KmsKeyId` l'ID della chiave KMS che desideri utilizzare per crittografare la copia dello snapshot del cluster nella regione di destinazione. Le chiavi di crittografia KMS sono specifiche della regione Amazon Web Services in cui vengono create e non è possibile utilizzare le chiavi di crittografia di una regione Amazon Web Services in un'altra regione Amazon Web Services. + Se si copia uno snapshot del cluster non crittografato e si specifica un valore per il `KmsKeyId` parametro, viene restituito un errore. # Confronto tra istantanee automatiche e manuali Di seguito sono elencate le caratteristiche principali degli snapshot automatici e manuali di Amazon DocumentDB (con compatibilità MongoDB). **Le istantanee automatiche di Amazon DocumentDB hanno le seguenti caratteristiche chiave:** + **Denominazione automatica degli snapshot**: i nomi automatici degli snapshot seguono lo schema `rds:-yyyy-mm-dd-hh-mm` e `yyyy-mm-dd-hh-mm` rappresentano la data e l'ora di creazione dello snapshot. + **Creato automaticamente in base a una pianificazione**: quando si crea o si modifica un cluster, è possibile impostare il *periodo di conservazione del backup su* un valore intero compreso tra 1 e 35 giorni. Per impostazione predefinita, i nuovi cluster hanno un periodo di retention dei backup di un giorno. Il periodo di retention dei backup definisce il numero di giorni di conservazione delle snapshot automatiche prima di essere eliminate automaticamente. Non puoi disabilitare i backup automatici sui cluster Amazon DocumentDB. Oltre a impostare il periodo di retention dei backup, puoi anche impostare la *finestra di backup*, l'ora del giorno in cui vengono create le snapshot automatiche. + **Eliminazione degli snapshot automatici: gli snapshot** automatici vengono eliminati quando si elimina il cluster dello snapshot automatico. Non puoi eliminare manualmente una snapshot automatica. + **Incrementale**: durante il periodo di conservazione dei backup, gli aggiornamenti del database vengono registrati in modo da creare un record incrementale delle modifiche. + **Ripristino da un'istantanea automatica**: è possibile eseguire il ripristino da un'istantanea automatica utilizzando o il. Console di gestione AWS AWS CLI*Quando si esegue il ripristino da un'istantanea utilizzando il AWS CLI, è necessario aggiungere istanze separatamente dopo che il cluster è disponibile.* + **Condivisione**: non è possibile condividere uno snapshot del cluster automatizzato di Amazon DocumentDB. Come soluzione alternativa, è possibile creare uno snapshot manuale copiando lo snapshot automatico e quindi condividere la copia. Per ulteriori informazioni sulla copia di uno snapshot, consulta [Copia delle istantanee del cluster Amazon DocumentDB](backup_restore-copy_cluster_snapshot.md). Per ulteriori informazioni sul ripristino di un cluster da uno snapshot, consulta [Ripristino da un'istantanea del cluster](backup_restore-restore_from_snapshot.md). + **È possibile eseguire il ripristino da qualsiasi momento all'interno del periodo di conservazione del backup**: poiché gli aggiornamenti del database vengono registrati in modo incrementale, è possibile ripristinare il cluster in qualsiasi momento entro il periodo di conservazione del backup. *Quando si esegue il ripristino da un'istantanea automatica o da un point-in-time ripristino utilizzando il AWS CLI, è necessario aggiungere istanze separatamente dopo che il cluster è disponibile.* **Le istantanee manuali di Amazon DocumentDB hanno le seguenti caratteristiche chiave:** + **Creati su richiesta**: gli snapshot manuali di Amazon DocumentDB vengono creati su richiesta utilizzando la console di gestione Amazon DocumentDB o. AWS CLI + **Eliminazione di uno snapshot manuale**: uno snapshot manuale viene eliminato solo quando lo elimini esplicitamente utilizzando la console Amazon DocumentDB o. AWS CLI Una snapshot manuale non viene eliminata quando elimini il cluster. + **Backup completi**: quando viene scattata una istantanea manuale, viene creato e archiviato un backup completo dei dati del cluster. + Denominazione **manuale delle istantanee: si specifica il nome** dell'istantanea manuale. Amazon DocumentDB non aggiunge un `datetime` timbro al nome, quindi è necessario aggiungere tali informazioni se si desidera che siano incluse nel nome. + **Ripristino da un'istantanea manuale**: è possibile ripristinare da un'istantanea manuale utilizzando la console o il. AWS CLI*Quando si esegue il ripristino da un'istantanea utilizzando il AWS CLI, è necessario aggiungere le istanze separatamente dopo che il cluster è disponibile.* + **Service Quotas**: è consentito un massimo di 100 istantanee manuali per persona. Regione AWS + **Condivisione**: è possibile condividere istantanee manuali del cluster, che possono essere copiate da persone autorizzate. Account AWSÈ possibile condividere snapshot manuali crittografati o non crittografati. Per ulteriori informazioni sulla copia di uno snapshot, consulta [Copia delle istantanee del cluster Amazon DocumentDB](backup_restore-copy_cluster_snapshot.md). + **Si esegue il ripristino a quando è stata scattata l'istantanea manuale**: quando si ripristina da un'istantanea manuale, si ripristina a quando è stata scattata l'istantanea manuale. *Quando si esegue il ripristino da un'istantanea utilizzando il AWS CLI, è necessario aggiungere le istanze separatamente dopo che il cluster è disponibile.* # Creazione di un'istantanea manuale del cluster Puoi creare uno snapshot manuale utilizzando o. Console di gestione AWS AWS CLI La quantità di tempo necessaria per creare uno snapshot varia a seconda della dimensione dei database. Quando crei una snapshot, devi: 1. Identificare il cluster di cui eseguire il backup. 1. Dare un nome alla tua snapshot. In questo modo potrai eseguire il ripristino da qui in un secondo momento. ------ #### [ Using the Console di gestione AWS ] Per creare un'istantanea manuale utilizzando Console di gestione AWS, puoi seguire uno dei metodi seguenti. 1. **Metodo 1:** 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, selezionare **Snapshots (Snapshot)**. **Suggerimento** Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina. 1. Nella pagina **Snapshots (Snapshot)** scegli **Create (Crea)**. 1. Nella pagina **Create cluster snapshot (Crea snapshot cluster)**: 1. **Identificatore del cluster**: dall'elenco a discesa dei cluster, scegli il cluster di cui desideri creare uno snapshot. 1. **Identificatore dell'istantanea**: inserisci un nome per la tua istantanea. Vincoli per la denominazione di snapshot: + La lunghezza è di [1-255] lettere, numeri o trattini. + Il primo carattere deve essere una lettera. + Non può terminare con un trattino o contenere due trattini consecutivi. + Deve essere unico per tutti i cluster (tra Amazon RDS, Amazon Neptune e Amazon DocumentDB) per account e per regione. AWS 1. Scegli **Create** (Crea). 1. **Metodo 2:** 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. Nella pagina **Clusters (Cluster)** scegli il pulsante a sinistra del cluster di cui eseguire lo snapshot. 1. Dal menu **Actions (Operazioni)** scegli **Take snapshot (Acquisisci snapshot)**. 1. Nella pagina **Create cluster snapshot (Crea snapshot cluster)**: 1. **Identificatore dello snapshot**: inserisci un nome per lo snapshot. Vincoli per la denominazione di snapshot: + La lunghezza è di [1—63] lettere, numeri o trattini. + Il primo carattere deve essere una lettera. + Non può terminare con un trattino o contenere due trattini consecutivi. + Deve essere unico per tutti i cluster (tra Amazon RDS, Amazon Neptune e Amazon DocumentDB) per account e per regione. AWS 1. Scegli **Create** (Crea). ------ #### [ Using the AWS CLI ] Per creare uno snapshot del cluster utilizzando, utilizza l'operazione con AWS CLI i `create-db-cluster-snapshot` seguenti parametri. **Parameters** + **--db-cluster-identifier**: obbligatorio. Il nome del cluster di cui si sta eseguendo la snapshot. Questo cluster deve esistere ed essere *disponibile*. + **--db-cluster-snapshot-identifier**: obbligatorio. Il nome della snapshot manuale che stai creando. Nell'esempio seguente viene creato uno snapshot denominato `sample-cluster-snapshot` per un cluster denominato `sample-cluster`. Per Linux, macOS o Unix: ``` aws docdb create-db-cluster-snapshot \ --db-cluster-identifier sample-cluster \ --db-cluster-snapshot-identifier sample-cluster-snapshot ``` Per Windows: ``` aws docdb create-db-cluster-snapshot ^ --db-cluster-identifier sample-cluster ^ --db-cluster-snapshot-identifier sample-cluster-snapshot ``` L'aspetto dell'output di questa operazione è simile al seguente. ``` { "DBClusterSnapshot": { "AvailabilityZones": [ "us-east-1a", "us-east-1b", "us-east-1c" ], "DBClusterSnapshotIdentifier": "sample-cluster-snapshot", "DBClusterIdentifier": "sample-cluster", "SnapshotCreateTime": "2020-04-24T04:59:08.475Z", "Engine": "docdb", "Status": "creating", "Port": 0, "VpcId": "vpc-abc0123", "ClusterCreateTime": "2020-01-10T22:13:38.261Z", "MasterUsername": "master-user", "EngineVersion": "4.0.0", "SnapshotType": "manual", "PercentProgress": 0, "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key", "DBClusterSnapshotArn": "arn:aws:rds:us-east-1::cluster-snapshot:sample-cluster-snapshot" } } ``` ------ # Copia delle istantanee del cluster Amazon DocumentDB In Amazon DocumentDB, puoi copiare istantanee all'interno dello stesso Regione AWS o su un altro. Regione AWS Puoi anche copiare istantanee condivise sul tuo account nello stesso account Regione AWS o in un altro. Regione AWS Per ulteriori informazioni sugli snapshot di condivisione, consulta [Condivisione di istantanee del cluster Amazon DocumentDB](backup_restore-share_cluster_snapshots.md). **Nota** Amazon DocumentDB fattura le fatture in base alla quantità di dati di backup e snapshot conservati e al periodo di tempo in cui vengono conservati. Per ulteriori informazioni sullo storage associato ai backup e agli snapshot di Amazon DocumentDB, consulta. [Informazioni sull'utilizzo dello storage di backup](backup_restore-understanding_backup_storage_usage.md) Per informazioni sui prezzi dello storage Amazon DocumentDB, consulta i prezzi di [Amazon DocumentDB](https://aws.amazon.com/documentdb/pricing/). **Topics** + [Copia di snapshot condivise](#backup_restore-copy_shared_cluster_snapshot) + [Copiare istantanee da una all'altra Regioni AWS](#backup_restore-copy_snapshot_across_regions) + [Limitazioni](#backup_restore-copy_cluster_snapshot-limitations) + [Gestione della crittografia](#backup_restore-copy_cluster_snapshot-handle_encryption) + [Considerazioni sui gruppi di parametri](#backup_restore-copy_cluster_snapshot-parameter_group_considerations) + [Copiare uno snapshot del cluster](#backup_restore-copy_a_cluster_snapshot) ## Copia di snapshot condivise Puoi copiare istantanee condivise con te da altri account. AWS Se stai copiando un'istantanea crittografata che è stata condivisa da un altro AWS account, devi avere accesso alla chiave di AWS KMS crittografia utilizzata per crittografare l'istantanea. Per ulteriori informazioni, consulta [Gestione della crittografia](#backup_restore-copy_cluster_snapshot-handle_encryption). ## Copiare istantanee da una all'altra Regioni AWS Quando si copia un'istantanea su un'istantanea diversa da Regione AWS quella di origine Regione AWS, ogni copia è un'istantanea completa. Una copia istantanea completa contiene tutti i dati e i metadati necessari per ripristinare il cluster Amazon DocumentDB. ## Limitazioni Di seguito sono riportate alcune limitazioni che si applicano quando si copiano le snapshot: + Se elimini una snapshot origine prima che la snapshot target diventi disponibile, la copia della snapshot può non riuscire. Verifica che la snapshot target abbia lo stato di `AVAILABLE` prima di eliminare una snapshot origine. + Puoi avere un massimo di cinque richieste di copia di snapshot in corso in una singola regione di destinazione per account + A seconda del soggetto Regioni AWS coinvolto e della quantità di dati da copiare, il completamento di una copia istantanea tra diverse regioni può richiedere ore. In alcuni casi, potrebbe esserci un gran numero di richieste di copia di istantanee tra regioni diverse da una determinata fonte. Regione AWS In questi casi, Amazon DocumentDB potrebbe mettere in coda nuove richieste di copia interregionali provenienti da tale fonte fino al completamento di alcune copie Regione AWS in corso. Nessuna informazione di progresso viene visualizzata sulle richieste di copia mentre sono in coda. Le informazioni sul progresso vengono visualizzate quando inizia la copia. ## Gestione della crittografia Puoi copiare una snapshot che è stata crittografata utilizzando una chiave di crittografia AWS KMS . Se la copia di una snapshot crittografata, la copia della snapshot deve anche essere crittografata. Se copi uno snapshot crittografato all'interno dello stesso Regione AWS, puoi crittografare la copia con la stessa chiave di AWS KMS crittografia dello snapshot originale oppure puoi specificare una chiave di crittografia diversa. AWS KMS Se si copia un'istantanea crittografata in più regioni, non è possibile utilizzare per la copia la stessa chiave di AWS KMS crittografia utilizzata per lo snapshot di origine, poiché le chiavi sono specifiche della regione. AWS KMS È invece necessario specificare una AWS KMS chiave valida nella destinazione n. Regione AWS La snapshot di origine resta crittografata nel processo di copia. Per ulteriori informazioni, consulta [Protezione dei dati in Amazon DocumentDB](security.data-protection.md). **Nota** Per le istantanee del cluster Amazon DocumentDB, non è possibile crittografare un'istantanea del cluster non crittografata quando la si copia. ## Considerazioni sui gruppi di parametri Quando copi uno snapshot tra regioni, la copia non include il gruppo di parametri utilizzato dal cluster Amazon DocumentDB originale. Quando ripristini uno snapshot per creare un nuovo cluster, a quel cluster viene assegnato il gruppo di parametri predefinito in cui Regione AWS è stato creato. Per assegnare al nuovo cluster gli stessi parametri dell'originale, devi fare quanto segue: 1. Nella destinazione Regione AWS, [crea un gruppo di parametri del cluster Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/cluster_parameter_groups-create.html) con le stesse impostazioni del cluster originale. Se ne esiste già uno nel nuovo Regione AWS, puoi utilizzarlo. 1. Dopo aver ripristinato lo snapshot nella destinazione Regione AWS, modifica il nuovo cluster Amazon DocumentDB e aggiungi il gruppo di parametri nuovo o esistente del passaggio precedente. Per ulteriori informazioni, consulta [Modifica di un cluster Amazon DocumentDB](db-cluster-modify.md). ## Copiare uno snapshot del cluster Puoi copiare un cluster Amazon DocumentDB utilizzando Console di gestione AWS o AWS CLI, come segue. ------ #### [ Using the Console di gestione AWS ] Per creare una copia di uno snapshot del cluster utilizzando il Console di gestione AWS, completa i seguenti passaggi. Questa procedura consente di copiare istantanee di cluster crittografate o non crittografate, nella stessa Regione AWS regione o in più regioni. 1. [Accedi a e apri Console di gestione AWS la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb) 1. Nel pannello di navigazione, scegli **Istantanee**, quindi scegli il pulsante a sinistra dell'istantanea che desideri copiare. **Suggerimento** Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina. 1. Nel menu **Actions** (Operazioni) scegliere **Copy (Copia)**. 1. **Nella pagina **Crea copia dell'istantanea del cluster** risultante, completa la sezione Impostazioni.** 1. **Regione di destinazione**: facoltativa. Per copiare l'istantanea del cluster in un'altra Regione AWS, selezionala in **Regione Regione AWS di destinazione**. 1. **Nuovo identificatore di istantanea**: immetti un nome per la nuova istantanea. Vincoli per la denominazione di 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. + Deve essere unico per tutti i cluster di Amazon RDS, Neptune e Amazon DocumentDB per regione. Account AWS 1. **Copia tag****: per copiare tutti i tag presenti sullo snapshot di origine nella copia dello snapshot, scegli Copia tag.** 1. Completa la sezione **E. ncryption-at-rest** 1. **Crittografia a riposo**: se l'istantanea non è crittografata, queste opzioni non sono disponibili perché non è possibile creare una copia crittografata da un'istantanea non crittografata. Se l'istantanea è crittografata, è possibile modificare quella AWS KMS key utilizzata durante la crittografia a riposo. Per ulteriori informazioni sulla crittografia delle copie degli snapshot, consulta. [Copia la crittografia delle istantanee del cluster](backup_restore-cluster_snapshot_considerations.md#backup_restore-encryption) Per ulteriori informazioni sulla crittografia dei dati inattivi, consultare [Crittografia dei dati di Amazon DocumentDB a riposo](encryption-at-rest.md). 1. **AWS KMS Chiave**: dall'elenco a discesa, scegli una delle seguenti opzioni: + **(impostazione predefinita) aws/rds**: il numero di account e l'ID della AWS KMS chiave vengono elencati dopo questa opzione. + **< some-key-name >** - Se hai creato una chiave, questa viene elencata e puoi sceglierla. + **Inserisci una chiave ARN**: nella casella **ARN**, inserisci l'Amazon Resource Name (ARN) per la tua chiave. AWS KMS Il formato dell'ARN è `arn:aws:kms:::key/ `. 1. Per eseguire una copia della snapshot selezionata, scegliere **Copy snapshot (Copia snapshot)**. In alternativa, puoi scegliere **Annulla** per non creare una copia dello snapshot. ------ #### [ Using the AWS CLI ] Per creare una copia di un'istantanea del cluster non crittografata utilizzando il AWS CLI, utilizzate l'`copy-db-cluster-snapshot`operazione con i seguenti parametri. Se stai copiando l'istantanea su un'altra Regione AWS, esegui il comando in cui verrà copiata Regione AWS l'istantanea. + **--source-db-cluster-snapshot-identifier**: obbligatorio. L'identificatore della snapshot del cluster di cui eseguire una copia. Una snapshot del cluster con questo nome deve esistere ed essere disponibile. Se si copia lo snapshot su un altro Regione AWS o se si copia uno snapshot del cluster condiviso, questo identificatore deve essere nel formato ARN dello snapshot del cluster di origine. Questo parametro non distingue tra maiuscole e minuscole. + **--target-db-cluster-snapshot-identifier**: obbligatorio. L'identificatore della nuova snapshot del cluster da creare dalla snapshot del cluster di origine. Questo parametro non distingue tra maiuscole e minuscole. Vincoli per la denominazione di 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. + Deve essere unico per tutti i cluster di Amazon RDS, Neptune e Amazon DocumentDB per regione. Account AWS + **--source-region**— Se stai copiando lo snapshot su un altro Regione AWS, specifica da dove verrà copiato lo snapshot del Regione AWS cluster crittografato. Se stai copiando lo snapshot su un altro Regione AWS e non lo specifichi`--source-region`, devi invece specificare l'opzione. `pre-signed-url` Il `pre-signed-url` valore deve essere un URL che contiene una richiesta firmata Signature Version 4 per `CopyDBClusterSnapshot` richiamare l'azione nell'origine da Regione AWS cui viene copiata lo snapshot del cluster. Per ulteriori informazioni su`pre-signed-url`, consulta [Copy DBCluster](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_CopyDBClusterSnapshot.html) Snapshot. + **--kms-key-id**— L'identificatore della chiave KMS per la chiave da utilizzare per crittografare la copia dello snapshot del cluster. Se si copia un'istantanea del cluster crittografata su un'altra Regione AWS, questo parametro è obbligatorio. È necessario specificare una chiave KMS per la destinazione. Regione AWS Se si copia un'istantanea del cluster crittografata nello stesso Regione AWS, il parametro AWS KMS chiave è facoltativo. La copia dell'istantanea del cluster viene crittografata con la stessa AWS KMS chiave dell'istantanea del cluster di origine. Se si desidera specificare una nuova chiave di AWS KMS crittografia da utilizzare per crittografare la copia, è possibile farlo utilizzando questo parametro. + **--copy-tags**— Facoltativo. I tag e i valori da copiare. **Per annullare un'operazione di copia una volta che è in corso, è possibile eliminare lo snapshot del cluster di destinazione identificato da `--target-db-cluster-snapshot-identifier` o `TargetDBClusterSnapshotIdentifier` mentre lo snapshot del cluster è in stato di copia.** **Example** **Esempio 1: copiare un'istantanea non crittografata nella stessa regione** L' AWS CLI esempio seguente crea una copia di `sample-cluster-snapshot` named `sample-cluster-snapshot-copy` nella stessa dello snapshot Regione AWS di origine. Quando viene creata la copia, tutti i tag della snapshot originale vengono copiati nella copia della snapshot. Per Linux, macOS o Unix: ``` aws docdb copy-db-cluster-snapshot \ --source-db-cluster-snapshot-identifier sample-cluster-snapshot \ --target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy \ --copy-tags ``` Per Windows: ``` aws docdb copy-db-cluster-snapshot ^ --source-db-cluster-snapshot-identifier sample-cluster-snapshot ^ --target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy ^ --copy-tags ``` L'aspetto dell'output di questa operazione è simile al seguente. ``` { "DBClusterSnapshot": { "AvailabilityZones": [ "us-east-1a", "us-east-1b", "us-east-1c" ], "DBClusterSnapshotIdentifier": "sample-cluster-snapshot-copy", "DBClusterIdentifier": "sample-cluster", "SnapshotCreateTime": "2020-03-27T08:40:24.805Z", "Engine": "docdb", "Status": "copying", "Port": 0, "VpcId": "vpc-abcd0123", "ClusterCreateTime": "2020-01-10T22:13:38.261Z", "MasterUsername": "master-user", "EngineVersion": "4.0.0", "SnapshotType": "manual", "PercentProgress": 0, "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1:111122223333:key/sample-key-id", "DBClusterSnapshotArn": "arn:aws:rds:us-east-1:111122223333:cluster-snapshot:sample-cluster-snapshot-copy", "SourceDBClusterSnapshotArn": "arn:aws:rds:us-east-1:111122223333:cluster-snapshot:sample-cluster-snapshot" } } ``` **Example** **Esempio 2: Copiare un'istantanea non crittografata Regioni AWS** L' AWS CLI esempio seguente crea una copia di`sample-cluster-snapshot`, che ha l'ARN`arn:aws:rds:us-east-1:123456789012:cluster-snapshot:sample-cluster-snapshot`. Questa copia è denominata named `sample-cluster-snapshot-copy` e si trova nella cartella Regione AWS in cui viene eseguito il comando. Per Linux, macOS o Unix: ``` aws docdb copy-db-cluster-snapshot \ --source-db-cluster-snapshot-identifier arn:aws:rds:us-east-1:123456789012:cluster-snapshot:sample-cluster-snapshot \ --target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy ``` Per Windows: ``` aws docdb copy-db-cluster-snapshot ^ --source-db-cluster-snapshot-identifier arn:aws:rds:us-east-1:123456789012:cluster-snapshot:sample-cluster-snapshot ^ --target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy ``` L'aspetto dell'output di questa operazione è simile al seguente. ``` { "DBClusterSnapshot": { "AvailabilityZones": [ "us-east-1a", "us-east-1b", "us-east-1c" ], "DBClusterSnapshotIdentifier": "sample-cluster-snapshot-copy", "DBClusterIdentifier": "sample-cluster", "SnapshotCreateTime": "2020-04-29T16:45:51.239Z", "Engine": "docdb", "AllocatedStorage": 0, "Status": "copying", "Port": 0, "VpcId": "vpc-abc0123", "ClusterCreateTime": "2020-04-28T16:43:00.294Z", "MasterUsername": "master-user", "EngineVersion": "4.0.0", "LicenseModel": "docdb", "SnapshotType": "manual", "PercentProgress": 0, "StorageEncrypted": false, "DBClusterSnapshotArn": "arn:aws:rds:us-east-1:123456789012:cluster-snapshot:sample-cluster-snapshot-copy", "SourceDBClusterSnapshotArn": "arn:aws:rds:us-east-1:123456789012:cluster-snapshot:sample-cluster-snapshot", } } ``` **Example** **Esempio 3: Copiare un'istantanea crittografata su Regioni AWS** L' AWS CLI esempio seguente crea una copia di `sample-cluster-snapshot` dalla regione us-west-2 alla regione us-east-1. Questo comando viene chiamato nella regione us-east-1. Per Linux, macOS o Unix: ``` aws docdb copy-db-cluster-snapshot \ --source-db-cluster-snapshot-identifier arn:aws:rds:us-west-2:123456789012:cluster-snapshot:sample-cluster-snapshot \ --target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy \ --source-region us-west-2 \ --kms-key-id sample-us-east-1-key ``` Per Windows: ``` aws docdb copy-db-cluster-snapshot ^ --source-db-cluster-snapshot-identifier arn:aws:rds:us-west-2:123456789012:cluster-snapshot:sample-cluster-snapshot ^ --target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy ^ --source-region us-west-2 ^ --kms-key-id sample-us-east-1-key ``` L'aspetto dell'output di questa operazione è simile al seguente. ``` { "DBClusterSnapshot": { "AvailabilityZones": [], "DBClusterSnapshotIdentifier": "sample-cluster-snapshot-copy", "DBClusterIdentifier": "sample-cluster", "SnapshotCreateTime": "2020-04-29T16:45:53.159Z", "Engine": "docdb", "AllocatedStorage": 0, "Status": "copying", "Port": 0, "ClusterCreateTime": "2020-04-28T16:43:07.129Z", "MasterUsername": "chimera", "EngineVersion": "4.0.0", "LicenseModel": "docdb", "SnapshotType": "manual", "PercentProgress": 0, "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/0846496a-d48e-41c4-9353-86d8301d7e35", "DBClusterSnapshotArn": "arn:aws:rds:us-east-1:123456789012:cluster-snapshot:sample-cluster-snapshot-copy", "SourceDBClusterSnapshotArn": "arn:aws:rds:us-west-2:123456789012:cluster-snapshot:sample-cluster-snapshot", } } ``` **Example** **Esempio 4: copia un'istantanea condivisa non crittografata su Regioni AWS** L' AWS CLI esempio seguente, account -`123456789012`, crea una copia di un'istantanea del cluster non crittografata `sample-cluster-snapshot` condivisa dall'account, `999999999999` dalla regione us-east-1 alla regione us-west-2. Questo comando viene chiamato nella regione us-west-2. Per ulteriori informazioni sugli snapshot di condivisione, consulta [Condivisione di uno snapshot](backup_restore-share_cluster_snapshots.md#backup_restore-share_snapshots). Per Linux, macOS o Unix: ``` aws docdb copy-db-cluster-snapshot \ --region us-west-2 \ --source-db-cluster-snapshot-identifier arn:aws:rds:us-east-1:999999999999:cluster-snapshot:sample-cluster-snapshot \ --target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy ``` Per Windows: ``` aws docdb copy-db-cluster-snapshot ^ --region us-west-2 ^ --source-db-cluster-snapshot-identifier arn:aws:rds:us-east-1:999999999999:cluster-snapshot:sample-cluster-snapshot ^ --target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy ``` L'aspetto dell'output di questa operazione è simile al seguente. ``` { "DBClusterSnapshots": [ { "AvailabilityZones": [], "DBClusterSnapshotIdentifier": "sample-cluster-snapshot-copy", "DBClusterIdentifier": "sample-cluster", "SnapshotCreateTime": "2025-08-22T11:27:00.497000+00:00", "Engine": "docdb", "Status": "copying", "Port": 0, "ClusterCreateTime": "2024-07-02T16:44:50.246000+00:00", "MasterUsername": "master-user", "EngineVersion": "5.0.0", "SnapshotType": "manual", "PercentProgress": 0, "StorageEncrypted": false, "DBClusterSnapshotArn": "arn:aws:rds:us-west-2:123456789012:cluster-snapshot:sample-cluster-snapshot-copy", "SourceDBClusterSnapshotArn": "arn:aws:rds:us-east-1:999999999999:cluster-snapshot:sample-cluster-snapshot" } ] } ``` **Example** **Esempio 5: copia un'istantanea condivisa crittografata su Regioni AWS** L' AWS CLI esempio seguente, account - `123456789012` crea una copia di un'istantanea del cluster crittografata `sample-cluster-snapshot` condivisa dall'account - `999999999999` dalla regione us-east-1 alla regione us-west-2. L'istantanea di destinazione è crittografata con una chiave KMS gestita dal cliente -. `arn:aws:kms:us-west-2:123456789012:key/6c1f3264-1797-472b-ba37-03011e682d28` Questo comando viene chiamato nella regione us-west-2. Per ulteriori informazioni sugli snapshot di condivisione, consulta [Condivisione di uno snapshot](backup_restore-share_cluster_snapshots.md#backup_restore-share_snapshots). Per Linux, macOS o Unix: ``` aws docdb copy-db-cluster-snapshot \ --region us-west-2 \ --source-db-cluster-snapshot-identifier arn:aws:rds:us-east-1:999999999999:cluster-snapshot:sample-cluster-snapshot \ --target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy \ --kms-key-id arn:aws:kms:us-west-2:123456789012:key/6c1f3264-1797-472b-ba37-03011e682d28 ``` Per Windows: ``` aws docdb copy-db-cluster-snapshot ^ --region us-west-2 ^ --source-db-cluster-snapshot-identifier arn:aws:rds:us-east-1:999999999999:cluster-snapshot:sample-cluster-snapshot ^ --target-db-cluster-snapshot-identifier sample-cluster-snapshot-copy ^ --kms-key-id arn:aws:kms:us-west-2:123456789012:key/6c1f3264-1797-472b-ba37-03011e682d28 ``` L'aspetto dell'output di questa operazione è simile al seguente. ``` { "DBClusterSnapshots": [ { "AvailabilityZones": [], "DBClusterSnapshotIdentifier": "sample-cluster-snapshot-copy", "DBClusterIdentifier": "sample-cluster", "SnapshotCreateTime": "2025-08-22T11:27:00.497000+00:00", "Engine": "docdb", "Status": "copying", "Port": 0, "ClusterCreateTime": "2024-07-02T16:44:50.246000+00:00", "MasterUsername": "master-user", "EngineVersion": "5.0.0", "SnapshotType": "manual", "PercentProgress": 0, "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/6c1f3264-1797-472b-ba37-03011e682d28", "DBClusterSnapshotArn": "arn:aws:rds:us-west-2:123456789012:cluster-snapshot:sample-cluster-snapshot-copy", "SourceDBClusterSnapshotArn": "arn:aws:rds:us-east-1:999999999999:cluster-snapshot:sample-cluster-snapshot" } ] } ``` **Nota** Per ulteriori informazioni sulla crittografia delle copie degli snapshot, vedere. [Copia la crittografia delle istantanee del cluster](backup_restore-cluster_snapshot_considerations.md#backup_restore-encryption) Per ulteriori informazioni sulla crittografia dei dati inattivi, consultare [Crittografia dei dati di Amazon DocumentDB a riposo](encryption-at-rest.md). ------ # Condivisione di istantanee del cluster Amazon DocumentDB Utilizzando Amazon DocumentDB, puoi condividere uno snapshot manuale del cluster nei seguenti modi: + La condivisione manuale di uno snapshot del cluster, crittografato o meno, consente agli AWS account autorizzati di copiare lo snapshot. + La condivisione manuale di un'istantanea del cluster, crittografata o non crittografata, consente agli AWS account autorizzati di ripristinare direttamente un cluster dall'istantanea anziché prenderne una copia e ripristinarlo da quella. **Nota** Per condividere un'istantanea automatica del cluster, crea un'istantanea manuale del cluster copiando l'istantanea automatica, quindi condividi quella copia. Questo processo si applica anche alle risorse AWS generate dal backup. È possibile condividere un'istantanea manuale con un massimo di 20 altre persone. Account AWS Puoi anche condividere uno snapshot manuale non crittografato come pubblico, per renderlo disponibile a tutti gli account . Quando si condivide uno snapshot come pubblico, assicurarsi che non siano incluse informazioni personali. Quando condividi snapshot manuali con altri Account AWS e ripristini un cluster da uno snapshot condiviso utilizzando l'API Amazon DocumentDB, devi specificare l'Amazon Resource Name (ARN) dello snapshot condiviso come AWS CLI identificatore dello snapshot. ## Condivisione di uno snapshot crittografato Per la condivisione di snapshot crittografati vigono le seguenti restrizioni: + Non puoi condividere snapshot crittografati come pubblici. + Non puoi condividere uno snapshot che è stato crittografato utilizzando la chiave di AWS KMS crittografia predefinita dell'account che ha condiviso lo snapshot. Per condividere snapshot crittografati, attieniti alla seguente procedura. 1. Condividi la chiave di crittografia AWS Key Management Service (AWS KMS) utilizzata per crittografare l'istantanea con tutti gli account a cui desideri accedere all'istantanea. Puoi condividere le chiavi di AWS KMS crittografia con altri AWS account aggiungendo gli altri account alla politica delle AWS KMS chiavi. Per i dettagli sull'aggiornamento di una politica chiave, consulta [Uso delle politiche chiave in AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/key-policies.html) nella *Guida per gli AWS Key Management Service sviluppatori*. Per un esempio di creazione di una policy delle chiavi, consulta [Creazione di una policy IAM per abilitare la copia di una snapshot crittografata](#backup_restore-share_encrypted_snapshots-create_key_policy) più avanti in questo argomento. 1. Utilizza AWS CLI, [come illustrato di seguito](#backup_restore-share_snapshots), per condividere l'istantanea crittografata con gli altri account. ### Consentire l'accesso a una chiave di AWS KMS crittografia Affinché un altro Account AWS utente possa copiare un'istantanea crittografata condivisa dal tuo account, l'account con cui condividi l'istantanea deve avere accesso alla AWS KMS chiave che ha crittografato l'istantanea. Per consentire a un altro account di accedere a una AWS KMS chiave, aggiorna la politica della AWS KMS chiave con l'ARN dell'account con cui stai condividendo come principale nella politica AWS KMS chiave. Successivamente, autorizza l'operazione `kms:CreateGrant`. Dopo aver concesso a un account l'accesso alla tua chiave di AWS KMS crittografia, per copiare lo snapshot crittografato, tale account deve creare un utente AWS Identity and Access Management (IAM) se non ne ha già uno. Inoltre, quell'account deve anche allegare una policy IAM a quell'utente IAM che consenta all'utente di copiare uno snapshot crittografato utilizzando la tua AWS KMS chiave. L'account deve essere un utente IAM e non può essere un' Account AWS identità root a causa di restrizioni AWS KMS di sicurezza. Nel seguente esempio di policy chiave, l'utente 123451234512 è il proprietario della chiave di crittografia. AWS KMS L'utente 123456789012 corrisponde all'account con cui è stata condivisa la chiave. Questa politica delle chiavi aggiornata consente all'account di accedere alla chiave. AWS KMS A tale scopo include l'ARN per l' Account AWS identità root dell'utente 123456789012 come principale della policy e consente l'azione. `kms:CreateGrant` ------ #### [ JSON ] **** ``` { "Id": "key-policy-1", "Version":"2012-10-17", "Statement": [ { "Sid": "Allow use of the key", "Effect": "Allow", "Principal": {"AWS": [ "arn:aws:iam::123451234512:user/KeyUser", "arn:aws:iam::123456789012:root" ]}, "Action": [ "kms:CreateGrant", "kms:Encrypt", "kms:Decrypt", "kms:ReEncrypt*", "kms:GenerateDataKey*", "kms:DescribeKey" ], "Resource": "*"}, { "Sid": "Allow attachment of persistent resources", "Effect": "Allow", "Principal": {"AWS": [ "arn:aws:iam::123451234512:user/KeyUser", "arn:aws:iam::123456789012:root" ]}, "Action": [ "kms:CreateGrant", "kms:ListGrants", "kms:RevokeGrant" ], "Resource": "*", "Condition": {"Bool": {"kms:GrantIsForAWSResource": true}} } ] } ``` ------ ### Creazione di una policy IAM per abilitare la copia di una snapshot crittografata Quando l'esterno Account AWS ha accesso alla tua AWS KMS chiave, il proprietario di quell'account può creare una policy per consentire a un utente IAM creato per l'account di copiare un'istantanea crittografata crittografata con quella chiave. AWS KMS L'esempio seguente mostra una policy che può essere associata a un utente IAM per Account AWS 123456789012. La policy consente all'utente IAM di copiare un'istantanea condivisa dall'account 123451234512 che è stata crittografata con la chiave AWS KMS nella `c989c1dd-a3f2-4a5d-8d96-e793d082ab26` regione us-west-2. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "AllowUseOfTheKey", "Effect": "Allow", "Action": [ "kms:Encrypt", "kms:Decrypt", "kms:ReEncrypt*", "kms:GenerateDataKey*", "kms:DescribeKey", "kms:CreateGrant", "kms:RetireGrant" ], "Resource": ["arn:aws:kms:us-west-2:123451234512:key/c989c1dd-a3f2-4a5d-8d96-e793d082ab26"] }, { "Sid": "AllowAttachmentOfPersistentResources", "Effect": "Allow", "Action": [ "kms:CreateGrant", "kms:ListGrants", "kms:RevokeGrant" ], "Resource": ["arn:aws:kms:us-west-2:123451234512:key/c989c1dd-a3f2-4a5d-8d96-e793d082ab26"], "Condition": { "Bool": { "kms:GrantIsForAWSResource": true } } } ] } ``` ------ *Per i dettagli sull'aggiornamento di una policy chiave, consulta Using Key Policies nella [Developer Guide](https://docs.aws.amazon.com/kms/latest/developerguide/key-policies.html). AWS KMSAWS Key Management Service * ## Condivisione di uno snapshot Puoi condividere uno snapshot manuale del cluster Amazon DocumentDB (o una copia di uno snapshot automatizzato) utilizzando o: Console di gestione AWS AWS CLI ------ #### [ Using the Console di gestione AWS ] Per condividere uno snapshot utilizzando Console di gestione AWS, completa i seguenti passaggi: 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 riquadro di navigazione, selezionare **Snapshots (Snapshot)**. 1. Selezionare lo snapshot manuale da condividere. 1. Nel menu a discesa **Azioni**, scegli Condividi. 1. Scegli una delle seguenti opzioni per la visibilità delle **istantanee DB**: + Se l'origine non è crittografata, scegli **Pubblica** per consentire a tutti gli AWS account di ripristinare un cluster dall'istantanea manuale. Oppure scegli **Privato** per consentire solo AWS agli account da te specificati di ripristinare un cluster dall'istantanea manuale. **avvertimento** Se imposti la **visibilità dello snapshot DB** su **Pubblico**, tutti AWS gli account possono ripristinare un cluster dall'istantanea manuale e avere accesso ai tuoi dati. **Non condividete come pubbliche le istantanee manuali del cluster che contengono informazioni private.** + Se l'origine è crittografata, l'opzione **DB snapshot visibility (Visibilità snapshot DB)** è impostata su **Private (Privato)**, perché gli snapshot crittografati non possono essere condivisi come pubblici. **Nota** Le istantanee che sono state crittografate con l'impostazione predefinita non AWS KMS key possono essere condivise. 1. **Per **AWS Account ID**, inserisci l' AWS identificatore dell'account a cui desideri consentire il ripristino di un cluster dall'istantanea manuale, quindi scegli Aggiungi.** Ripeti l'operazione per includere identificatori di AWS account aggiuntivi, fino a 20 account. AWS Se commetti un errore durante l'aggiunta di un identificatore di AWS account all'elenco degli account consentiti, puoi eliminarlo dall'elenco selezionando **Elimina** a destra dell'identificatore di AWS account errato. ![\[Diagramma: condividi le preferenze relative alle istantanee\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/share-snapshot.png) 1. Dopo aver aggiunto gli identificatori per tutti gli AWS account a cui desideri consentire il ripristino dell'istantanea manuale, scegli **Salva per salvare** le modifiche. ------ #### [ Using the AWS CLI ] Per condividere uno snapshot utilizzando AWS CLI, utilizza l'operazione Amazon `modify-db-snapshot-attribute` DocumentDB. Utilizza il `--values-to-add` parametro per aggiungere un elenco degli IDs utenti autorizzati a ripristinare lo snapshot manuale. Account AWS L'esempio seguente consente a due Account AWS identificatori, 123451234512 e 123456789012, di ripristinare l'istantanea denominata. `manual-snapshot1` Inoltre, rimuove il valore dell'attributo `all` per contrassegnare lo snapshot come privato. Per Linux, macOS o Unix: ``` aws docdb modify-db-cluster-snapshot-attribute \ --db-cluster-snapshot-identifier sample-cluster-snapshot \ --attribute-name restore \ --values-to-add '["123451234512","123456789012"]' ``` Per Windows: ``` aws docdb modify-db-cluster-snapshot-attribute ^ --db-cluster-snapshot-identifier sample-cluster-snapshot ^ --attribute-name restore ^ --values-to-add '["123451234512","123456789012"]' ``` L'aspetto dell'output di questa operazione è simile al seguente. ``` { "DBClusterSnapshotAttributesResult": { "DBClusterSnapshotIdentifier": "sample-cluster-snapshot", "DBClusterSnapshotAttributes": [ { "AttributeName": "restore", "AttributeValues": [ "123451234512", "123456789012" ] } ] } } ``` Per rimuovere un identificatore dall'elenco, utilizzare il parametro. Account AWS `--values-to-remove` L'esempio seguente impedisce all' Account AWS ID 123456789012 di ripristinare l'istantanea. Per Linux, macOS o Unix: ``` aws docdb modify-db-cluster-snapshot-attribute \ --db-cluster-snapshot-identifier sample-cluster-snapshot \ --attribute-name restore \ --values-to-remove '["123456789012"]' ``` Per Windows: ``` aws docdb modify-db-cluster-snapshot-attribute ^ --db-cluster-snapshot-identifier sample-cluster-snapshot ^ --attribute-name restore ^ --values-to-remove '["123456789012"]' ``` L'aspetto dell'output di questa operazione è simile al seguente. ``` { "DBClusterSnapshotAttributesResult": { "DBClusterSnapshotIdentifier": "sample-cluster-snapshot", "DBClusterSnapshotAttributes": [ { "AttributeName": "restore", "AttributeValues": [ "123451234512" ] } ] } } ``` ------ # Ripristino da un'istantanea del cluster Amazon DocumentDB (con compatibilità MongoDB) crea uno snapshot del cluster del volume di storage. Puoi creare un nuovo cluster ripristinandolo da una snapshot del cluster. Quando ripristini il cluster, devi fornire il nome della snapshot del cluster da cui effettuare il ripristino e il nome del nuovo cluster creato dal ripristino. Non puoi eseguire il ripristino da una snapshot in un cluster esistente poiché al momento del ripristino viene creato un nuovo cluster. Quando ripristini un cluster da una snapshot del cluster: + Questa operazione ripristina solo il cluster, non le istanze del cluster. Devi utilizzare l'operazione `create-db-instance` per creare le istanze per il cluster ripristinato, specificandone l'identificatore in `--db-cluster-identifier`. Puoi creare le istanze solo dopo che il cluster è *disponibile*. + Non puoi ripristinare una snapshot crittografata in un cluster non crittografato. Tuttavia, puoi ripristinare un'istantanea non crittografata in un cluster crittografato specificando la chiave. AWS KMS + Per ripristinare un cluster da un'istantanea crittografata, è necessario avere accesso alla chiave. AWS KMS **Nota** Non è possibile ripristinare un cluster 3.6 su un cluster 4.0 ma è possibile migrare da una versione del cluster a un'altra. Per ulteriori informazioni, consulta [Migrazione ad Amazon DocumentDB](docdb-migration.md). ------ #### [ Using the Console di gestione AWS ] La procedura seguente mostra come ripristinare un cluster Amazon DocumentDB da uno snapshot del cluster utilizzando la console di gestione 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 riquadro di navigazione scegli **Snapshots (Snapshot)** e seleziona il pulsante a sinistra della snapshot che desideri usare per ripristinare un 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. Dal menu **Actions (Operazioni)** scegli **Restore (Ripristina)**. 1. Nella pagina **Restore snapshot (Ripristina snapshot)** completa la sezione **Configuration (Configurazione)**. 1. **Identificatore del cluster**: il nome del nuovo cluster. Puoi accettare il nome fornito da Amazon DocumentDB o digitare un nome che preferisci. Il DBsupplied nome del documento Amazon ha il formato `docdb-` più un timestamp UTC; ad esempio,. `docdb-yyyy-mm-dd-hh-mm-ss` 1. **Classe di istanza**: la classe di istanza per il nuovo cluster. Puoi accettare la classe di istanza predefinita o scegliere una classe di istanza dall'elenco a discesa. 1. **Numero di istanze**: il numero di istanze che si desidera creare con questo cluster. Puoi accettare il valore predefinito di 3 istanze (1 replica principale read/write e 2 repliche di sola lettura) o scegliere il numero di istanze dall'elenco a discesa. 1. Per la configurazione dello storage in **cluster, scegli un'opzione di archiviazione**. **Nota** La configurazione di storage **ottimizzata per l'I/O di Amazon DocumentDB** è disponibile solo nelle versioni del motore Amazon DocumentDB 5.0 e 8.0. 1. Se si è soddisfatti della configurazione del cluster, scegliere **Restore cluster (Ripristina cluster)** e attendere il ripristino del cluster. 1. Se preferisci modificare alcune configurazioni, ad esempio specificare un Amazon VPC o un gruppo di sicurezza non predefinito, **scegli Mostra impostazioni avanzate** nella parte inferiore sinistra della pagina, quindi continua con i passaggi seguenti. 1. Completa la sezione **Network settings (Impostazioni di rete)**. + **Virtual Private Cloud (VPC)**: accetta il VPC corrente o scegli un VPC dall'elenco a discesa. + Gruppo di **sottoreti: accetta il gruppo** di `default` sottoreti o scegline uno dall'elenco a discesa. + **Gruppi di sicurezza VPC**: accetta il gruppo `default (VPC)` di sicurezza o scegline uno dall'elenco. 1. Completa la sezione **Cluster options (Opzioni cluster)**. + **Porta del database**: accetta la porta predefinita o utilizza la freccia su o giù per impostare la porta che desideri utilizzare per le connessioni alle applicazioni. `27017` 1. Completa la sezione **Encryption (Crittografia)**. + **Crittografia a riposo**: se l'istantanea è crittografata, queste opzioni non sono disponibili. Se non è crittografata, puoi scegliere una delle seguenti opzioni: + **Per crittografare tutti i dati del cluster, scegli Abilita. encryption-at-rest** Se scegli questa opzione, devi designare una chiave KMS. + **Per non crittografare i dati del cluster, scegli Disabilita. encryption-at-rest** Se scegli questa opzione, hai terminato con la sezione relativa alla crittografia. + **AWS KMS Chiave**: scegli una delle seguenti opzioni dall'elenco a discesa: + **(impostazione predefinita) aws/rds**: il numero di account e l'ID della AWS KMS chiave vengono elencati dopo questa opzione. + **Chiave gestita dal cliente**: questa opzione è disponibile solo se hai creato una chiave di crittografia IAM nella console (IAM). AWS Identity and Access Management Puoi scegliere la chiave per eseguire la crittografia del cluster. + **Inserisci una chiave ARN**: nella casella **ARN**, inserisci l'Amazon Resource Name (ARN) per la tua chiave. AWS KMS Il formato dell'ARN è `arn:aws:kms:::key/`. 1. Compila la sezione **Log exports (Esportazioni di log)**. + **Seleziona i tipi di log su cui pubblicare CloudWatch**: scegli una delle seguenti opzioni: + **Abilitato**: consente al cluster di esportare i log DDL in Amazon CloudWatch Logs. + **Disabilitato**: impedisce al cluster di esportare i log DDL in Amazon Logs. CloudWatch L'opzione predefinita è **Disabled (Disabilitato)**. + **Ruolo IAM***: dall'elenco, scegli RDS Service Linked Role.* 1. Completa la sezione **Tag** . + **Aggiungi tag**: nella casella *Chiave*, inserisci il nome del tag per il tuo cluster. Nella casella *Value (Valore)* immetti facoltativamente il valore del tag. I tag vengono utilizzati con le policy AWS Identity and Access Management (IAM) per gestire l'accesso alle risorse di Amazon DocumentDB e per controllare quali azioni possono essere applicate alle risorse. 1. Completa la sezione **Deletion protection (Protezione da eliminazione)** . + **Abilita la protezione da eliminazione**: protegge il cluster dall'eliminazione accidentale. Quando questa opzione è abilitata, non puoi eliminare il cluster. 1. Scegli **Restore cluster (Ripristina cluster)**. ------ #### [ Using the AWS CLI ] Per ripristinare un cluster da un'istantanea utilizzando il AWS CLI, utilizzare l'`restore-db-cluster-from-snapshot`operazione con i seguenti parametri. Per ulteriori informazioni, consulta [RestoreDBClusterFromSnapshot](API_RestoreDBClusterFromSnapshot.md). + **--db-cluster-identifier**: obbligatorio. Il nome del cluster che viene creato dall'operazione. Prima di questa operazione non devono esistere cluster con questo nome. Vincoli per la denominazione del cluster: + La lunghezza è di [1-63] lettere, numeri o trattini. + Il primo carattere deve essere una lettera. + Non può terminare con un trattino o contenere due trattini consecutivi. + Deve essere unico per tutti i cluster di Amazon RDS, Neptune e Amazon DocumentDB per regione. Account AWS + **--snapshot-identifier**: obbligatorio. Il nome della snapshot utilizzata per eseguire il ripristino. Una snapshot con questo nome deve esistere ed essere *disponibile*. + **--engine**: obbligatorio. Deve essere `docdb`. + **--storage-type standard \$1 iopt1**— Facoltativo. Default: `standard`. + **--kms-key-id**— Facoltativo. L'ARN dell'identificatore di AWS KMS chiave da utilizzare per il ripristino di un'istantanea crittografata o per la crittografia di un cluster durante il ripristino da un'istantanea non crittografata. Fornendo l'ID della AWS KMS chiave, il cluster ripristinato viene crittografato con la chiave, indipendentemente dal fatto che l'istantanea sia stata crittografata o AWS KMS meno. Il formato di `--kms-key-id` è `arn:aws:kms:::key/`. Se non specifichi un valore per il parametro `--kms-key-id`, avviene quanto segue: + Se l'istantanea in ingresso `--snapshot-identifier` è crittografata, il cluster ripristinato viene crittografato utilizzando la stessa AWS KMS chiave utilizzata per crittografare l'istantanea. + Se la snapshot in `--snapshot-identifier` non è crittografata, il cluster ripristinato non è crittografato. Per Linux, macOS o Unix: ``` aws docdb restore-db-cluster-from-snapshot \ --db-cluster-identifier sample-cluster-restore \ --snapshot-identifier sample-cluster-snapshot \ --engine docdb \ --kms-key-id arn:aws:kms:us-east-1:123456789012:key/SAMPLE-KMS-KEY-ID ``` Per Windows: ``` aws docdb restore-db-cluster-from-snapshot ^ --db-cluster-identifier sample-cluster-restore ^ --snapshot-identifier sample-cluster-snapshot ^ --engine docdb ^ --kms-key-id arn:aws:kms:us-east-1:123456789012:key/SAMPLE-KMS-KEY-ID ``` L'aspetto dell'output di questa operazione è simile al seguente. ``` { "DBCluster": { "AvailabilityZones": [ "us-east-1c", "us-east-1b", "us-east-1a" ], "BackupRetentionPeriod": 1, "DBClusterIdentifier": "sample-cluster-restore", "DBClusterParameterGroup": "default.docdb4.0", "DBSubnetGroup": "default", "Status": "creating", "Endpoint": "sample-cluster-restore.cluster-node.us-east-1.docdb.amazonaws.com", "ReaderEndpoint": "sample-cluster-restore.cluster-node.us-east-1.docdb.amazonaws.com", "MultiAZ": false, "Engine": "docdb", "EngineVersion": "4.0.0", "Port": 27017, "MasterUsername": "", "PreferredBackupWindow": "02:00-02:30", "PreferredMaintenanceWindow": "tue:09:50-tue:10:20", "DBClusterMembers": [], "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-abcdefgh", "Status": "active" } ], "HostedZoneId": "ABCDEFGHIJKLM", "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1::key/", "DbClusterResourceId": "cluster-ABCDEFGHIJKLMNOPQRSTUVWXYZ", "DBClusterArn": "arn:aws:rds:us-east-1::cluster:sample-cluster-restore", "AssociatedRoles": [], "ClusterCreateTime": "2020-04-01T01:43:40.871Z", "DeletionProtection": true } } ``` Dopo che lo stato del cluster è *disponibile*, crea almeno un'istanza per il cluster. Per Linux, macOS o Unix: ``` aws docdb create-db-instance \ --db-cluster-identifier sample-cluster-restore \ --db-instance-identifier sample-cluster-restore-instance \ --availability-zone us-east-1b \ --promotion-tier 2 \ --db-instance-class db.r5.large \ --engine docdb ``` Per Windows: ``` aws docdb create-db-instance ^ --db-cluster-identifier sample-cluster-restore ^ --db-instance-identifier sample-cluster-restore-instance ^ --availability-zone us-east-1b ^ --promotion-tier 2 ^ --db-instance-class db.r5.large ^ --engine docdb ``` L'aspetto dell'output di questa operazione è simile al seguente. ``` { "DBInstance": { "DBInstanceIdentifier": "sample-cluster-restore-instance", "DBInstanceClass": "db.r5.large", "Engine": "docdb", "DBInstanceStatus": "creating", "PreferredBackupWindow": "02:00-02:30", "BackupRetentionPeriod": 1, "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-abcdefgh", "Status": "active" } ], "AvailabilityZone": "us-west-2b", "DBSubnetGroup": { "DBSubnetGroupName": "default", "DBSubnetGroupDescription": "default", "VpcId": "vpc-6242c31a", "SubnetGroupStatus": "Complete", "Subnets": [ { "SubnetIdentifier": "subnet-abcdefgh", "SubnetAvailabilityZone": { "Name": "us-west-2a" }, "SubnetStatus": "Active" }, { ... } ] }, "PreferredMaintenanceWindow": "fri:09:43-fri:10:13", "PendingModifiedValues": {}, "EngineVersion": "4.0.0", "AutoMinorVersionUpgrade": true, "PubliclyAccessible": false, "DBClusterIdentifier": "sample-cluster-restore", "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1::key/", "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ", "CACertificateIdentifier": "rds-ca-2019", "PromotionTier": 2, "DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-cluster-restore-instance" } } ``` ------ # Ripristino in un determinato momento È possibile ripristinare un cluster in qualsiasi momento che rientri nel periodo di conservazione del backup del cluster utilizzando Console di gestione AWS o AWS Command Line Interface (AWS CLI). **Nota** Non è possibile eseguire un point-in-time ripristino di un cluster 3.6 su un cluster 4.0, ma è possibile migrare da una versione del cluster a un'altra. Per ulteriori informazioni, consulta [Migrazione ad Amazon DocumentDB](docdb-migration.md). Tieni presente quanto segue quando ripristini un cluster a un punto temporale specifico. + Il nuovo cluster viene creato con la stessa configurazione del cluster di origine, ma utilizza il gruppo di parametri predefinito. Per impostare il gruppo di parametri del nuovo cluster su quello del cluster di origine, occorre modificare il cluster appena risulta *disponibile*. Per ulteriori informazioni sulla modifica di un cluster, consulta [Modifica di un cluster Amazon DocumentDB](db-cluster-modify.md). ------ #### [ Using the Console di gestione AWS ] È possibile ripristinare un cluster point-in-time entro il relativo periodo di conservazione dei backup completando le seguenti operazioni utilizzando il. Console di gestione AWS 1. [Accedi a e apri Console di gestione AWS la console Amazon DocumentDB all'indirizzo https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb) 1. Nel pannello di navigazione scegliere **Cluster**. Dall'elenco di cluster scegliere il pulsante a sinistra del cluster che si desidera ripristinare. **Suggerimento** Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina. 1. Nel menu **Actions (Operazioni)** scegliere **Restore to point in time (Esegui ripristino point in time)**. 1. Completare la sezione **Restore time (Ora ripristino)**, in cui si specificano data e ora per il ripristino. 1. **Data di ripristino****: scegli o inserisci una data compresa tra la **prima ora di ripristino e l'ora di ripristino più** recente.** 1. **Ora di ripristino**: scegli o inserisci l'ora, i minuti e i secondi compresi tra l'ora di **ripristino più recente e l'ora** di **ripristino più recente**. 1. Completare la sezione **Configurazione**. 1. **Identificatore del cluster**: accetta l'identificatore predefinito o inserisci un identificatore che preferisci. Vincoli per la denominazione del cluster: + La lunghezza è di [1—63] lettere, numeri o trattini. + Il primo carattere deve essere una lettera. + Non può terminare con un trattino o contenere due trattini consecutivi. + Deve essere unico per tutti i cluster di Amazon RDS, Neptune e Amazon DocumentDB per regione. Account AWS 1. **Classe di istanza**: dall'elenco a discesa, scegli la classe di istanza che desideri per le istanze del cluster. 1. **Numero di istanze**: dall'elenco a discesa, scegli il numero di istanze che desideri creare quando il cluster viene ripristinato. 1. Per la **configurazione dello storage del cluster**, scegli un'opzione di archiviazione. **Nota** La configurazione di storage **ottimizzata per l'I/O di Amazon DocumentDB** è disponibile solo nelle versioni del motore Amazon DocumentDB 5.0 e 8.0. 1. Opzionale. Per configurare le impostazioni di rete, le opzioni del cluster e abilitare le esportazioni dei log, scegliere **Show advanced settings (Mostra impostazioni avanzate)** e completare le sezioni seguenti. In alternativa, passare alla fase successiva. + **Impostazioni di rete** 1. **Virtual Private Cloud (VPC)**: dall'elenco a discesa, scegli il VPC che desideri utilizzare per questo cluster. 1. **Gruppo di sottoreti**: dall'elenco a discesa, scegli il gruppo di sottoreti per questo cluster. 1. **Gruppi di sicurezza VPC**: dall'elenco a discesa, scegli i gruppi di sicurezza VPC per questo cluster.   + **Cluster options (Opzioni cluster)** 1. **Porta**: accetta la porta predefinita (27017) o utilizza le frecce su e giù per impostare la porta per la comunicazione con questo cluster.   + **Log exports (Esportazioni log)** 1. **Registri di controllo**: seleziona questa opzione per abilitare l'esportazione dei log di controllo in Amazon Logs. CloudWatch Se selezioni questa opzione, devi abilitare `audit_logs` nel gruppo personalizzato dei parametri del cluster. Per ulteriori informazioni, consulta [Controllo degli eventi di Amazon DocumentDB](event-auditing.md). 1. **Registri del profiler: seleziona questa opzione per abilitare l'esportazione dei log** del profiler operativo su Amazon Logs. CloudWatch Se selezioni questa opzione, devi anche modificare i seguenti parametri nel gruppo personalizzato dei parametri del cluster: + `profiler`— `enabled` Impostato su. + `profiler_threshold_ms`— Impostato su un valore `[0-INT_MAX]` per impostare la soglia per le operazioni di profilazione. + `profiler_sampling_rate`— Impostare su un valore `[0.0-1.0]` per impostare la percentuale di operazioni lente da profilare. Per ulteriori informazioni, consulta [Profilazione delle operazioni di Amazon DocumentDB](profiling.md). 1. **Registri del profiler: esporta i log** del profiler su Amazon CloudWatch 1. **Ruolo IAM***: dall'elenco a discesa, scegli RDS Service Linked Role.* + **Tag** 1. **Aggiungi tag**: nella casella *Chiave*, inserisci il nome del tag per il tuo cluster. Nella casella *Value (Valore)* immetti facoltativamente il valore del tag. I tag vengono utilizzati con le policy AWS Identity and Access Management (IAM) per gestire l'accesso alle risorse di Amazon DocumentDB e per controllare quali azioni possono essere applicate alle risorse. + **Deletion protection (Protezione da eliminazione)** 1. **Abilita la protezione da eliminazione**: protegge il cluster dall'eliminazione accidentale. Quando questa opzione è abilitata, non puoi eliminare il cluster. 1. Per ripristinare il cluster, scegliere **Create cluster (Crea cluster)**. In alternativa, è possibile scegliere **Cancel (Annulla)** per annullare l'operazione. ------ #### [ Using the AWS CLI ] Per ripristinare un cluster a un punto temporale specifico con il periodo di retention dei backup della snapshot, utilizza l'operazione `restore-db-cluster-to-point-in-time` con i parametri seguenti. + **--db-cluster-identifier**— Obbligatorio. Il nome del nuovo cluster da creare. Questo cluster non può esistere prima di questa operazione. Il valore del parametro deve soddisfare i seguenti vincoli. Vincoli per la denominazione del cluster: + La lunghezza è di [1—63] lettere, numeri o trattini. + Il primo carattere deve essere una lettera. + Non può terminare con un trattino o contenere due trattini consecutivi. + Deve essere unico per tutti i cluster di Amazon RDS, Neptune e Amazon DocumentDB per regione. Account AWS + **--restore-to-time**— La data e l'ora UTC a cui ripristinare il cluster. Ad esempio, `2018-06-07T23:45:00Z`. Vincoli temporali: + Deve essere prima dell'ultimo orario di ripristino per il cluster. + Deve essere specificato se il parametro `--use-latest-restorable-time` non viene fornito. + Non può essere specificato se il parametro `--use-latest-restorable-time` è `true`. + Non può essere specificato se il valore del parametro `--restore-type` è `copy-on-write`. + **--source-db-cluster-identifier**— Il nome del cluster di origine da cui eseguire il ripristino. Questo cluster deve esistere ed essere disponibile. + **--use-latest-restorable-time**oppure **--no-use-latest-restorable-time** — Se ripristinare l'ultima data di backup ripristinabile. Non può essere specificato se il parametro `--restore-to-time` viene fornito. + **--storage-type standard \$1 iopt1**— Facoltativo. Default: `standard`. L' AWS CLI operazione ripristina `restore-db-cluster-to-point-in-time` solo il cluster, non le relative istanze. È necessario utilizzare l'operazione `create-db-instance` per creare le istanze per il cluster ripristinato, specificandone l'identificatore in `--db-cluster-identifier`. Puoi creare le istanze solo dopo che l'operazione `restore-db-cluster-to-point-in-time` è terminata e il cluster ripristinato è *disponibile*. **Example** L'esempio seguente crea `sample-cluster-restored` dallo snapshot `sample-cluster-snapshot` all'ultimo orario di ripristino. Per Linux, macOS o Unix: ``` aws docdb restore-db-cluster-to-point-in-time \ --db-cluster-identifier sample-cluster-restored \ --source-db-cluster-identifier sample-cluster-snapshot \ --use-latest-restorable-time ``` Per Windows: ``` aws docdb restore-db-cluster-to-point-in-time ^ --db-cluster-identifier sample-cluster-restored ^ --source-db-cluster-identifier sample-cluster-snapshot ^ --use-latest-restorable-time ``` **Example** Nell'esempio seguente viene creato `sample-cluster-restored` dallo snapshot `sample-cluster-snapshot` delle 3:15 dell'11 dicembre 2018 (UTC), ovvero un orario incluso nel periodo di retention dei backup di `sample-cluster`. Per Linux, macOS o Unix: ``` aws docdb restore-db-cluster-to-point-in-time \ --db-cluster-identifier sample-cluster-restore \ --source-db-cluster-identifier sample-cluster \ --restore-to-time 2020-05-12T03:15:00Z ``` Per Windows: ``` aws docdb restore-db-cluster-to-point-in-time ^ --db-cluster-identifier sample-cluster-restore ^ --source-db-cluster-identifier sample-cluster ^ --restore-to-time 2020-05-12T03:15:00Z ``` L'aspetto dell'output di questa operazione è simile al seguente. ``` { "DBCluster": { "AvailabilityZones": [ "us-east-1c", "us-west-2b", "us-west-2a" ], "BackupRetentionPeriod": 1, "DBClusterIdentifier": "sample-cluster-restored", "DBClusterParameterGroup": "sample-parameter-group", "DBSubnetGroup": "default", "Status": "creating", "Endpoint": "sample-cluster-restored.node.us-east-1.docdb.amazonaws.com", "ReaderEndpoint": "sample-cluster-restored.node.us-east-1.docdb.amazonaws.com", "MultiAZ": false, "Engine": "docdb", "EngineVersion": "4.0.0", "Port": 27017, "MasterUsername": "master-user", "PreferredBackupWindow": "02:00-02:30", "PreferredMaintenanceWindow": "tue:09:50-tue:10:20", "DBClusterMembers": [], "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-abc0123", "Status": "active" } ], "HostedZoneId": "ABCDEFGHIJKLM", "StorageEncrypted": true, "KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key", "DbClusterResourceId": "cluster-ABCDEFGHIJKLMNOPQRSTUVWXYZ", "DBClusterArn": "arn:aws:rds:us-east-1::cluster:sample-cluster-restored", "AssociatedRoles": [], "ClusterCreateTime": "2020-04-24T20:14:36.713Z", "DeletionProtection": false } } ``` ------ # Eliminazione di un'istantanea del cluster Uno snapshot manuale è un backup completo che viene eliminato solo quando viene eliminato manualmente utilizzando o. Console di gestione AWS AWS CLI Non è possibile eliminare manualmente una snapshot automatica, in quanto le snapshot automatiche vengono eliminate solo quando il periodo di retention delle snapshot scade o quando si elimina il rispettivo cluster. ------ #### [ Using the Console di gestione AWS ] Per eliminare un'istantanea manuale del cluster utilizzando il Console di gestione AWS, completare la procedura seguente. 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, selezionare **Snapshots (Snapshot)**. **Suggerimento** Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/it_it/documentdb/latest/developerguide/images/docdb-menu-icon.png)) nell'angolo in alto a sinistra della pagina. 1. Nell'elenco delle snapshot scegli il pulsante a sinistra della snapshot da eliminare. Il tipo di snapshot deve essere **manuale**. 1. È possibile verificare che il tipo di snapshot sia **manual (manuale)** controllando se è elencato come `manual` o `automatic` sotto la colonna **Type (Tipo)**. 1. Nel menu **Actions (Operazioni)** selezionare **Delete (Elimina)**. Se l'opzione **Delete (Elimina)** non è disponibile, probabilmente hai scelto una snapshot automatica. 1. Nella schermata di conferma dell'eliminazione, scegli **Delete (Elimina)** per eliminare la snapshot. Per mantenere la snapshot, scegli **Cancel (Annulla)**. ------ #### [ Using the AWS CLI ] Uno snapshot manuale del cluster di Amazon DocumentDB è un backup completo che puoi eliminare manualmente utilizzando. AWS CLI Non puoi eliminare manualmente una snapshot automatica. Per eliminare uno snapshot manuale del cluster utilizzando il AWS CLI, utilizza l'`delete-db-cluster-snapshot`operazione con i seguenti parametri. **Parameters** + **--db-cluster-snapshot-identifier**: obbligatorio. Il nome della snapshot manuale da eliminare. L'esempio seguente elimina la snapshot del cluster `sample-cluster-snapshot`. Per Linux, macOS o Unix: ``` aws docdb delete-db-cluster-snapshot \ --db-cluster-snapshot-identifier sample-cluster-snapshot ``` Per Windows: ``` aws docdb delete-db-cluster-snapshot ^ --db-cluster-snapshot-identifier sample-cluster-snapshot ``` L'output di questa operazione elenca i dettagli dello snapshot del cluster eliminato. ------