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