As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Cópia de snapshots de cluster do Amazon DocumentDB
No Amazon DocumentDB, você pode copiar snapshots dentro do mesmo Região da AWS ou para um diferente. Região da AWS Você também pode copiar instantâneos compartilhados para sua conta na mesma Região da AWS ou em outra Região da AWS. Para obter mais informações sobre o compartilhamento de snapshots, consulte [Compartilhamento de snapshots de cluster do Amazon DocumentDB](backup_restore-share_cluster_snapshots.md).
**nota**
O Amazon DocumentDB cobra com base na quantidade de dados de backup e snapshot do e no período em que você os mantém. Para obter informações sobre o armazenamento associado a backups e snapshots do Amazon DocumentDB, consulte [Noções básicas do uso do armazenamento de backup do](backup_restore-understanding_backup_storage_usage.md). Para obter informações sobre a definição de preço do armazenamento do Amazon DocumentDB, consulte a página da web [Definição de preço do Amazon DocumentDB](https://aws.amazon.com/documentdb/pricing/).
**Topics**
+ [Copiar snapshots compartilhados](#backup_restore-copy_shared_cluster_snapshot)
+ [Copiando instantâneos entre Regiões da AWS](#backup_restore-copy_snapshot_across_regions)
+ [Limitações](#backup_restore-copy_cluster_snapshot-limitations)
+ [Lidar com a criptografia](#backup_restore-copy_cluster_snapshot-handle_encryption)
+ [Considerações de grupos de parâmetros](#backup_restore-copy_cluster_snapshot-parameter_group_considerations)
+ [Cópia de um snapshot de cluster](#backup_restore-copy_a_cluster_snapshot)
## Copiar snapshots compartilhados
Você pode copiar instantâneos compartilhados com você por outras AWS contas. Se você estiver copiando um instantâneo criptografado que foi compartilhado de outra AWS conta, deverá ter acesso à chave de AWS KMS criptografia usada para criptografar o instantâneo. Para obter mais informações, consulte [Lidar com a criptografia](#backup_restore-copy_cluster_snapshot-handle_encryption).
## Copiando instantâneos entre Regiões da AWS
Quando você copia um instantâneo para um Região da AWS que é diferente do instantâneo de origem Região da AWS, cada cópia é um instantâneo completo. Uma cópia completa de snapshot contém todos os dados e metadados necessários para restaurar o cluster do Amazon DocumentDB.
## Limitações
Algumas limitações ao copiar snapshots:
+ Se você excluir um snapshot de origem antes que o snapshot de destino fique disponível, a cópia do snapshot poderá falhar. Verifique se o snapshot de destino possui um status `AVAILABLE` antes de excluir um snapshot de origem.
+ É possível ter até cinco solicitações de cópia de snapshot em andamento para uma única região de destino por conta.
+ Dependendo do Regiões da AWS envolvido e da quantidade de dados a serem copiados, uma cópia instantânea entre regiões pode levar horas para ser concluída. Em alguns casos, pode haver um grande número de solicitações de cópia de snapshot entre regiões de determinada Região da AWS de origem. Nesses casos, o Amazon DocumentDB pode colocar novas solicitações de cópia entre regiões dessa fonte Região da AWS em uma fila até que algumas cópias em andamento sejam concluídas. Nenhuma informação de andamento é exibida sobre solicitações de cópia enquanto elas estão na fila. As informações sobre o andamento são exibidas quando a cópia é iniciada.
## Lidar com a criptografia
É possível copiar um snapshot que foi criptografado usando uma chave de criptografia do AWS KMS . Se você copiar um snapshot criptografado, a cópia desse snapshot também deverá ser criptografada. Se você copiar um instantâneo criptografado dentro do mesmo Região da AWS, poderá criptografar a cópia com a mesma chave de AWS KMS criptografia do instantâneo original ou especificar uma chave de criptografia diferente AWS KMS . Se você copiar um instantâneo criptografado entre regiões, não poderá usar a mesma chave de AWS KMS criptografia para a cópia usada para o instantâneo de origem, pois AWS KMS as chaves são específicas da região. Em vez disso, você deve especificar uma AWS KMS chave válida no destino Região da AWS n.
O snapshot de origem permanece criptografado ao longo do processo de cópia. Para obter mais informações, consulte [Proteção de dados no Amazon DocumentDB](security.data-protection.md).
**nota**
Para snapshots de cluster do Amazon DocumentDB, você não pode criptografar um snapshot de cluster não criptografado quando você copia o snapshot.
## Considerações de grupos de parâmetros
Ao copiar um snapshot entre regiões, a cópia não inclui o grupo de parâmetros usado pelo cluster original do Amazon DocumentDB. Quando você restaura um snapshot para criar um novo cluster, esse cluster obtém o grupo de parâmetros padrão para o qual Região da AWS foi criado. Para dar ao novo cluster os mesmos parâmetros que o original, você deve fazer o seguinte:
1. No destino Região da AWS, [crie um grupo de parâmetros de cluster do Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/cluster_parameter_groups-create.html) com as mesmas configurações do cluster original. Se já existir um no novo Região da AWS, você pode usá-lo.
1. Depois de restaurar o snapshot no destino Região da AWS, modifique o novo cluster Amazon DocumentDB e adicione o grupo de parâmetros novo ou existente da etapa anterior. Para obter mais informações, consulte [Modificar um cluster do Amazon DocumentDB](db-cluster-modify.md).
## Cópia de um snapshot de cluster
Você pode copiar um cluster do Amazon DocumentDB usando o Console de gerenciamento da AWS ou o AWS CLI, da seguinte forma.
------
#### [ Using the Console de gerenciamento da AWS ]
Para fazer uma cópia de um snapshot de cluster usando o Console de gerenciamento da AWS, conclua as etapas a seguir. Esse procedimento funciona para copiar instantâneos de cluster criptografados ou não criptografados, na mesma região Região da AWS ou entre regiões.
1. [Faça login no e abra Console de gerenciamento da AWS o console do Amazon DocumentDB em https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
1. No painel de navegação, escolha **Snapshots** e, em seguida, escolha o botão à esquerda do snapshot que você deseja copiar.
**dica**
Caso não visualize o painel de navegação à esquerda da tela, selecione o ícone do menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/docdb-menu-icon.png)) no canto superior esquerdo da página.
1. No menu **Actions**, escolha **Copy**.
1. Na página **Fazer cópia do snapshot do cluster** resultante, preencha a seção **Configurações**.
1. **Região de destino:** opcional. Para copiar o snapshot do cluster para um diferente Região da AWS, escolha aquele Região da AWS para **Região de destino**.
1. **Identificador do novo snapshot**: digite um nome para o novo snapshot.
Restrições de nomenclatura do snapshot de destino:
+ Não pode ser o nome de um snapshot existente.
+ O comprimento é de [1 a 63] letras, números ou hífens.
+ O primeiro caractere deve ser uma letra.
+ Não pode terminar com um hífen ou conter dois hifens consecutivos.
+ Deve ser exclusivo para todos os clusters no Amazon RDS, Neptune e Amazon DocumentDB por região. Conta da AWS
1. **Copiar tags**: para copiar as tags existentes no snapshot de origem para a sua cópia do snapshot, escolha **Copiar tags**.
1. Complete **a ncryption-at-rest seção E.**
1. **Criptografia em repouso**: se o snapshot não estiver criptografado, essas opções não estarão disponíveis para você, pois não é possível criar uma cópia criptografada a partir de um snapshot não criptografado. Se seu snapshot estiver criptografado, você poderá alterar o AWS KMS key usado durante a criptografia em repouso.
Para obter mais informações sobre criptografia de cópias de snapshot, consulte [Copiar criptografia de snapshot de cluster](backup_restore-cluster_snapshot_considerations.md#backup_restore-encryption).
Para obter mais informações sobre criptografia em repouso, consulte [Criptografar dados em repouso do Amazon DocumentDB](encryption-at-rest.md).
1. **AWS KMS Chave** — Na lista suspensa, escolha uma das seguintes opções:
+ **(padrão) aws/rds** — O número da conta e o ID da AWS KMS chave estão listados seguindo essa opção.
+ **< some-key-name >** — Se você criou uma chave, ela está listada e está disponível para você escolher.
+ **Inserir o ARN da chave**: na caixa **ARN**, insira nome do recurso da Amazon (ARN) para a chave do AWS KMS . O formato do ARN é `arn:aws:kms:::key/ `.
1. Para criar uma cópia do snapshot selecionado, escolha **Copiar snapshot**. Como alternativa, é possível escolher **Cancelar** para não criar uma cópia do snapshot.
------
#### [ Using the AWS CLI ]
Para fazer uma cópia de um snapshot não criptografado de cluster usando o AWS CLI, use a operação `copy-db-cluster-snapshot` com os parâmetros a seguir. Se você estiver copiando o instantâneo para outro Região da AWS, execute o comando no qual Região da AWS o instantâneo será copiado.
+ **--source-db-cluster-snapshot-identifier** — Obrigatório. O identificador do snapshot de cluster a ser copiado. O snapshot do cluster deve existir e estar no estado disponível. Se você estiver copiando o snapshot para outro Região da AWS ou se estiver copiando um snapshot de cluster compartilhado, esse identificador deverá estar no formato ARN do snapshot do cluster de origem. Esse parâmetro não diferencia maiúsculas de minúsculas.
+ **--target-db-cluster-snapshot-identifier** — Obrigatório. O identificador do novo snapshot de cluster a ser criado a partir do snapshot de cluster de origem. Esse parâmetro não diferencia maiúsculas de minúsculas.
Restrições de nomenclatura do snapshot de destino:
+ Não pode ser o nome de um snapshot existente.
+ O comprimento é de [1 a 63] letras, números ou hífens.
+ O primeiro caractere deve ser uma letra.
+ Não pode terminar com um hífen ou conter dois hifens consecutivos.
+ Deve ser exclusivo para todos os clusters no Amazon RDS, Neptune e Amazon DocumentDB por região. Conta da AWS
+ **--source-region**— Se você estiver copiando o snapshot para outro Região da AWS, especifique o do qual Região da AWS o snapshot criptografado do cluster será copiado.
Se estiver copiando o snapshot para outra Região da AWS e não especificar `--source-region`, deverá especificar o parâmetro `pre-signed-url` em vez disso. O `pre-signed-url` valor deve ser uma URL que contenha uma solicitação assinada do Signature Version 4 para que a `CopyDBClusterSnapshot` ação seja chamada na origem da Região da AWS qual o snapshot do cluster é copiado. Para saber mais sobre o`pre-signed-url`, consulte [Copiar DBCluster instantâneo](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_CopyDBClusterSnapshot.html).
+ **--kms-key-id**: o identificador da chave do KMS da chave a ser usada para criptografar a cópia do snapshot do cluster.
Se você estiver copiando um snapshot de cluster criptografado para outro Região da AWS, esse parâmetro será obrigatório. Você deve especificar uma chave KMS para o destino Região da AWS.
Se você estiver copiando um snapshot de cluster criptografado no mesmo Região da AWS, o parâmetro AWS KMS chave é opcional. A cópia do snapshot do cluster é criptografada com a mesma AWS KMS chave do snapshot do cluster de origem. Se quiser especificar uma nova chave de AWS KMS criptografia a ser usada para criptografar a cópia, você pode fazer isso usando esse parâmetro.
+ **--copy-tags**: opcional. As tags e os valores a serem copiados.
Para cancelar uma operação de cópia quando ela estiver em andamento, é possível excluir o snapshot do cluster de destino identificado por `--target-db-cluster-snapshot-identifier` ou `TargetDBClusterSnapshotIdentifier` enquanto ele estiver no status **copiando**.
**Example**
**Exemplo 1: copiar um snapshot não criptografado para a mesma região**
O AWS CLI exemplo a seguir cria uma cópia de `sample-cluster-snapshot` named `sample-cluster-snapshot-copy` in da Região da AWS mesma forma que o snapshot de origem. Quando a cópia é feita, todas as tags do snapshot original são copiadas para a cópia do snapshot.
Para Linux, macOS ou 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
```
Para 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
```
A saída dessa operação é semelhante à seguinte.
```
{
"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**
**Exemplo 2: Copiar um snapshot não criptografado em Regiões da AWS**
O AWS CLI exemplo a seguir cria uma cópia de`sample-cluster-snapshot`, que tem o ARN`arn:aws:rds:us-east-1:123456789012:cluster-snapshot:sample-cluster-snapshot`. Essa cópia é nomeada `sample-cluster-snapshot-copy` e está Região da AWS na qual o comando é executado.
Para Linux, macOS ou 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
```
Para 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
```
A saída dessa operação é semelhante à seguinte.
```
{
"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**
**Exemplo 3: Copiar um snapshot criptografado em Regiões da AWS**
O AWS CLI exemplo a seguir cria uma cópia `sample-cluster-snapshot` da região us-west-2 para a região us-east-1. Este comando é chamado na região us-east-1.
Para Linux, macOS ou 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
```
Para 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
```
A saída dessa operação é semelhante à seguinte.
```
{
"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**
**Exemplo 4: Copiar um snapshot compartilhado não criptografado em Regiões da AWS**
O AWS CLI exemplo a seguir, account -`123456789012`, cria uma cópia de um snapshot de cluster não criptografado `sample-cluster-snapshot` compartilhado por conta - `999999999999` da região us-east-1 para a região us-west-2. Esse comando é chamado na região us-east-2. Para obter mais informações sobre o compartilhamento de snapshots, consulte [Compartilhar um snapshot](backup_restore-share_cluster_snapshots.md#backup_restore-share_snapshots).
Para Linux, macOS ou 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
```
Para 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
```
A saída dessa operação é semelhante à seguinte.
```
{
"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**
**Exemplo 5: Copiar um snapshot compartilhado criptografado em Regiões da AWS**
O AWS CLI exemplo a seguir, account - `123456789012` cria uma cópia de um snapshot de cluster criptografado `sample-cluster-snapshot` compartilhado por conta - `999999999999` da região us-east-1 para a região us-west-2. O snapshot de destino é criptografado com uma chave do KMS gerenciada pelo cliente - `arn:aws:kms:us-west-2:123456789012:key/6c1f3264-1797-472b-ba37-03011e682d28`. Esse comando é chamado na região us-east-2. Para obter mais informações sobre o compartilhamento de snapshots, consulte [Compartilhar um snapshot](backup_restore-share_cluster_snapshots.md#backup_restore-share_snapshots).
Para Linux, macOS ou 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
```
Para 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
```
A saída dessa operação é semelhante à seguinte.
```
{
"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**
Para obter mais informações sobre criptografia de cópias de snapshot, consulte [Copiar criptografia de snapshot de cluster](backup_restore-cluster_snapshot_considerations.md#backup_restore-encryption).
Para obter mais informações sobre criptografia em repouso, consulte [Criptografar dados em repouso do Amazon DocumentDB](encryption-at-rest.md).
------