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á.
# Backup e restauração no Amazon DocumentDB
O Amazon DocumentDB (compativel com MongoDB) O faz backup contínuo de dados no Amazon Simple Storage Service (Amazon S3) por 1 a 35 dias para que você possa restaurar rapidamente de qualquer ponto dentro do período de retenção de backup. O Amazon DocumentDB também tira snapshots automáticos dos seus dados como parte desse processo de backup contínuo.
**nota**
Esses são buckets do Amazon S3 gerenciados por serviços e você não terá acesso aos arquivos de backup. Se quiser controlar seus próprios backups, siga as instruções sobre [Descarga, restauração, importação e exportação de dados](https://docs.aws.amazon.com/documentdb/latest/developerguide/backup_restore-dump_restore_import_export_data.html).
Você também pode reter os dados de backup além do período de retenção de backup, criando um snapshot manual dos dados do cluster. O processo de backup não afeta o desempenho do cluster.
Esta seção aborda os casos de uso para os recursos de backup no Amazon DocumentDB e mostra como gerenciar backups para os clusters do Amazon DocumentDB.
**Topics**
+ [Backup e restauração: conceitos](backup_restore-nouns_verbs.md)
+ [Noções básicas do uso do armazenamento de backup do](backup_restore-understanding_backup_storage_usage.md)
+ [Despejo, restauração, importação e exportação de dados](backup_restore-dump_restore_import_export_data.md)
+ [Considerações sobre snapshot de cluster](backup_restore-cluster_snapshot_considerations.md)
+ [Comparação dos snapshots automáticos e manuais](backup_restore-compare_automatic_manual_snapshots.md)
+ [Criação de um snapshot manual de cluster](backup_restore-create_manual_cluster_snapshot.md)
+ [Cópia de um snapshot de cluster](backup_restore-copy_cluster_snapshot.md)
+ [Compartilhamento de um snapshot de cluster](backup_restore-share_cluster_snapshots.md)
+ [Restauração de um snapshot de cluster](backup_restore-restore_from_snapshot.md)
+ [Restauração para um ponto no tempo](backup_restore-point_in_time_recovery.md)
+ [Exclusão de um snapshot de cluster](backup_restore-delete_cluster_snapshot.md)
# Backup e restauração: conceitos
| Substantivo | Description | APIs (Verbos) |
| --- | --- | --- |
| Período de retenção de backup | Um período de tempo entre 1 e 35 dias durante o qual você pode realizar uma point-in-time restauração. | `create-db-cluster` `modify-db-cluster` `restore-db-cluster-to-point-in-time` |
| Volume de armazenamento do Amazon DocumentDB | O volume de armazenamento resiliente de alta disponibilidade que replica dados de seis maneiras em três zonas de disponibilidade. Um cluster do Amazon DocumentDB é resiliente, independentemente do número de instâncias no cluster. | `create-db-cluster` `delete-db-cluster` |
| Janela de backup | Período no dia em que os snapshots automáticos são obtidos. | `create-db-cluster` `describe-db-cluster` `modify-db-cluster` |
| Snapshot automático | Snapshots diários que são backups completos do cluster e são criados automaticamente pelo processo de backup contínuo no Amazon DocumentDB. | `restore-db-cluster-from-snapshot` `describe-db-cluster-snapshot-attributes` `describe-db-cluster-snapshots` |
| Snapshot manual | Os snapshots que você cria manualmente para reter backups completos de um cluster além do período de 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` |
# Noções básicas do uso do armazenamento de backup do
O armazenamento de backup do Amazon DocumentDB consiste em backups contínuos dentro do período de retenção de backup e snapshots manuais fora do período de retenção. Para controlar o uso de armazenamento de backup, reduza o intervalo de retenção de backup, remova snapshots manuais antigos quando eles não forem mais necessários, ou ambos. Para obter informações gerais sobre backups do Amazon DocumentDB, consulte [Backup e restauração no Amazon DocumentDB](backup_restore.md). Para obter informações sobre a definição de preço do armazenamento de backup do Amazon DocumentDB, consulte a página da web [Definição de preço do Amazon DocumentDB](https://aws.amazon.com/documentdb/pricing/).
Para controlar os custos, monitore a quantidade de armazenamento consumido por backups contínuos e snapshots manuais que persistem além do período de retenção. Em seguida, é possível reduzir o intervalo de retenção de backup e remover snapshots manuais quando eles não forem mais necessários.
Você pode usar as CloudWatch métricas da Amazon`TotalBackupStorageBilled`,`SnapshotStorageUsed`, e `BackupRetentionPeriodStorageUsed` para revisar e monitorar a quantidade de armazenamento usada pelos seus backups do Amazon DocumentDB, da seguinte forma:
+ `BackupRetentionPeriodStorageUsed` representa a quantidade de armazenamento de backup usado para armazenar backups contínuos na hora atual. Esse valor da métrica depende do tamanho do volume do cluster e do número de alterações feitas durante o período de retenção. No entanto, para fins de faturamento a métrica não excede o tamanho cumulativo do volume do cluster durante o período de retenção. Por exemplo, se o tamanho do cluster for 100 GiB e o período de retenção for de dois dias, o valor máximo de `BackRetentionPeriodStorageUsed` será 200 GiB (100 GiB \$1 100 GiB).
+ `SnapshotStorageUsed` representa a quantidade de armazenamento de backup usado para armazenar snapshots manuais além do período de retenção de backup. Os snapshots manuais tirados dentro do período de retenção não são contados no armazenamento de backup. Da mesma forma, snapshots automáticos não são contados no armazenamento de backup. O tamanho de cada snapshot é o tamanho do volume do cluster no momento em que você faz o snapshot. O valor `SnapshotStorageUsed` depende do número de snapshots que você mantém e do tamanho de cada snapshot. Por exemplo, suponha que você tenha um snapshot fora do período de retenção e o tamanho do volume de cluster tenha sido 100 GiB quando esse snapshot foi feito. A quantidade de `SnapshotStorageUsed` será 100 GiB.
+ `TotalBackupStorageBilled` representa a soma de `BackupRetentionPeriodStorageUsed` e `SnapshotStorageUsed`, menos uma quantidade de armazenamento de backup grátis igual ao tamanho do volume do cluster para um dia. Por exemplo, se o tamanho do cluster for 100 GiB, e você tiver um dia de retenção e um snapshot fora do período de retenção, o `TotalBackupStorageBilled` será 100 GiB (100 GiB \$1 100 GiB - 100 GiB).
+ Essas métricas são calculadas de maneira independente para cada cluster do Amazon DocumentDB.
[Você pode monitorar seus clusters do Amazon DocumentDB e criar relatórios usando CloudWatch métricas por meio do CloudWatch console.](https://console.aws.amazon.com/cloudwatch) Para obter mais informações sobre como usar CloudWatch métricas, consulte[Monitoramento do Amazon DocumentDB](monitoring_docdb.md).
# Despejo, restauração, importação e exportação de dados
É possível usar os utilitários `mongodump`, `mongorestore`, `mongoexport` e `mongoimport` para mover dados para dentro e para fora do cluster do Amazon DocumentDB. Esta seção discute o propósito de cada uma dessas ferramentas e configurações para ajudar você a obter um melhor desempenho.
**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`
O utilitário `mongodump` cria um backup binário (BSON) de um banco de dados MongoDB. A ferramenta `mongodump` é o método preferencial de despejo de dados da implantação MongoDB de origem visando restaurá-los no cluster do Amazon DocumentDB devido às eficiências de tamanho obtidas armazenando os dados em um formato binário.
Dependendo dos recursos disponíveis na instância ou máquina que você está usando para executar o comando, é possível acelerar seu `mongodump` aumentando o número de conexões paralelas despejadas do padrão 1 usando a opção `--numParallelCollections`. Uma boa regra geral é começar com um operador por vCPU na instância principal do cluster do Amazon DocumentDB.
**nota**
Recomendamos o MongoDB Database Tools até a versão 100.6.1, inclusive, para o Amazon DocumentDB. É possível acessar os downloads do MongoDB Database Tools [aqui.](https://www.mongodb.com/download-center/database-tools/releases/archive)
### Exemplo de uso
Veja a seguir um exemplo de uso do utilitário `mongodump` no cluster do 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`
O utilitário `mongorestore` permite restaurar um backup binário (BSON) de um banco de dados criado com o utilitário `mongodump`. É possível melhorar o desempenho da restauração aumentando o número de operadores para cada coleção durante a restauração com a opção `--numInsertionWorkersPerCollection` (o padrão é 1). Uma boa regra geral é começar com um operador por vCPU na instância principal do cluster do Amazon DocumentDB.
### Exemplo de uso
Veja a seguir um exemplo de uso do utilitário `mongorestore` no cluster do 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`
A ferramenta `mongoexport` exporta dados no Amazon DocumentDB para os formatos de arquivo JSON, CSV ou TSV. A ferramenta `mongoexport` é o método preferencial para exportar dados que precisam ser legíveis por humanos ou por máquina.
**nota**
`mongoexport` não oferece suporte diretamente a exportações paralelas. No entanto, é possível aumentar o desempenho executando vários trabalhos `mongoexport` simultaneamente para coleções diferentes.
### Exemplo de uso
Veja a seguir um exemplo de uso da ferramenta `mongoexport` no cluster do 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`
A ferramenta `mongoimport` importa o conteúdo de arquivos JSON, CSV ou TSV para um cluster do Amazon DocumentDB. É possível usar o parâmetro `-–numInsertionWorkers` para paralelizar e acelerar a importação (o padrão é 1).
### Exemplo de uso
Veja a seguir um exemplo de uso da ferramenta `mongoimport` no cluster do 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
O tutorial a seguir descreve como usar os utilitários `mongodump`, `mongorestore`, `mongoexport` e `mongoimport` para mover dados para dentro e para fora de um cluster do Amazon DocumentDB.
1. **Pré-requisitos**: antes de começar, verifique se o cluster do Amazon DocumentDB está provisionado e se você tem acesso a uma instância do Amazon EC2 na mesma VPC que o cluster. Para obter mais informações, consulte [Conecte usando o Amazon EC2](connect-ec2.md).
Para poder usar as ferramentas do utilitário mongo, você deve ter o mongodb-org-tools pacote instalado em sua instância do EC2, da seguinte forma.
```
sudo yum install mongodb-org-tools-4.0.18
```
Como o Amazon DocumentDB usa a criptografia Transport Layer Security (TLS) por padrão, também é necessário fazer download do arquivo de autoridade de certificação (CA) do Amazon RDS a fim de usar o shell mongo para se conectar, conforme indicado a seguir.
```
wget https://truststore.pki.rds.amazonaws.com/global/global-bundle.pem
```
1. **Download de exemplos de dados**: para este tutorial, baixe alguns exemplos de dados com informações sobre restaurantes.
```
wget https://raw.githubusercontent.com/ozlerhakan/mongodb-json-files/master/datasets/restaurant.json
```
1. **Importar os exemplos de dados para o Amazon DocumentDB**: como os dados estão em um formato JSON lógico, use o utilitário `mongoimport` a fim de importar os dados para o cluster do 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. **Despejar os dados com `mongodump`**: agora que você tem dados no cluster do Amazon DocumentDB, é possível fazer um despejo binário desses dados usando o utilitário `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. **Descartar a coleção `restaurants`**: antes de restaurar a coleção `restaurants` no banco de dados `business`, descarte a coleção que já existe nesse banco de dados, conforme indicado a seguir.
```
use business
```
```
db.restaurants.drop()
```
1. **Restaurar dados com `mongorestore`**: com o despejo binário dos dados da Etapa 3, agora é possível usar o utilitário `mongorestore` para restaurar seus dados para o cluster do Amazon DocumentDB.
```
mongorestore --ssl \
--host="tutorialCluster.us-east-1.docdb.amazonaws.com:27017" \
--numParallelCollections 4 \
--username= \
--password= \
--sslCAFile global-bundle.pem restaurantDump.bson
```
1. **Exportar dados usando `mongoexport`**: para concluir o tutorial, exporte os dados do cluster no formato de um arquivo JSON, da mesma maneira que o arquivo importado na Etapa 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. **Validação**: é possível validar que a saída da Etapa 5 produz o mesmo resultado que a Etapa 1 com os comandos a seguir.
```
wc -l restaurant.json
```
Saída desse comando:
```
2548 restaurant.json
```
```
wc -l restaurant2.json
```
Saída desse comando:
```
2548 restaurant2.json
```
# Considerações sobre snapshot de cluster
O Amazon DocumentDB cria snapshots automáticos diários do seu cluster durante a janela de backup do seu cluster. O Amazon DocumentDB salva os snapshots automáticos da instância do seu cluster de acordo com o período de retenção de retenção especificado. Se necessário, é possível recuperar seu cluster para qualquer momento determinado durante o período de retenção de backup. Os snapshots automáticos não são obtidos enquanto uma operação de cópia está sendo executada na mesma região para o mesmo cluster.
**Topics**
+ [Armazenamento de backup](#backup_restore-backup_storage)
+ [Janela de backup](#backup_restore-backup_window)
+ [Período de retenção de backup](#backup_restore-backup_retention_period)
+ [Copiar criptografia de snapshot de cluster](#backup_restore-encryption)
Além de snapshots automáticos de cluster, você também pode criar manualmente um snapshot de cluster. É possível copiar os snapshots automáticos e manuais. Para obter mais informações, consulte [Criação de um snapshot manual de cluster](backup_restore-create_manual_cluster_snapshot.md) e [Cópia de snapshots de cluster do Amazon DocumentDB](backup_restore-copy_cluster_snapshot.md).
**nota**
O cluster deve estar no estado *disponível* para que um snapshot automático seja obtido.
Não é possível compartilhar um snapshot de cluster automatizado do Amazon DocumentDB. Como alternativa, crie um snapshot manual copiando o snapshot automatizado e compartilhe essa cópia. Para obter mais informações sobre como copiar um snapshot, consulte [Cópia de snapshots de cluster do Amazon DocumentDB](backup_restore-copy_cluster_snapshot.md). Para obter mais informações sobre a restauração de um cluster com base em um snapshot, consulte [Restauração de um snapshot de cluster](backup_restore-restore_from_snapshot.md).
## Armazenamento de backup
Seu armazenamento de backup do Amazon DocumentDB para cada um Região da AWS é composto pelo armazenamento de backup necessário para seu período de retenção de backup, que inclui snapshots de cluster automáticos e manuais nessa região. O período de retenção de backup padrão é de 1 dia. Para obter mais informações sobre o preço do armazenamento de backup, consulte [Definição de preço do Amazon DocumentDB](https://aws.amazon.com/documentdb/pricing/).
Quando você exclui um cluster, todos os seus snapshots automáticos são excluídos e não podem ser recuperados. No entanto, os snapshots manuais não são excluídos quando você exclui um cluster. Se preferir que o Amazon DocumentDB crie um snapshot final (snapshot manual) antes do cluster ser excluído, poderá usar o snapshot final para recuperar o cluster.
Para obter mais informações sobre snapshots e armazenamento, consulte [Noções básicas do uso do armazenamento de backup do](backup_restore-understanding_backup_storage_usage.md).
## Janela de backup
Os snapshots automáticos são obtidos diariamente durante a janela de backup escolhida. Se o snapshot exigir mais tempo do que o atribuído à janela de backup, o processo de backup continuará até que seja concluído, mesmo que a janela de backup tenha terminado. A janela de backup não pode se sobrepor à janela de manutenção semanal do cluster.
Se você não especificar uma janela de backup preferencial ao criar o cluster, o Amazon DocumentDB atribuirá uma janela de backup padrão de 30 minutos. Essa janela é escolhida aleatoriamente de um bloco de tempo de 8 horas associado à região do cluster. É possível alterar a janela de backup preferencial modificando o cluster. Para obter mais informações, consulte [Modificar um cluster do Amazon DocumentDB](db-cluster-modify.md).
| Nome da região | Região | Bloco de tempo UTC |
| --- | --- | --- |
| Leste dos EUA (Ohio) | us-east-2 | 03:00-11:00 |
| Leste dos EUA (Norte da Virgínia) | us-east-1 | 03:00-11:00 |
| Oeste dos EUA (Oregon) | us-west-2 | 06:00-14:00 |
| África (Cidade do Cabo) | af-south-1 | 03:00-11:00 |
| Ásia-Pacífico (Hong Kong) | ap-east-1 | 06:00-14:00 |
| Ásia-Pacífico (Hyderabad) | ap-south-2 | 06:30–14:30 |
| Ásia-Pacífico (Malásia) | ap-southeast-5 | 13:00-21:00 |
| Ásia-Pacífico (Mumbai) | ap-south-1 | 06:00-14:00 |
| Ásia-Pacífico (Osaka) | ap-northeast-3 | 12:00-20:00 |
| Ásia-Pacífico (Seul) | ap-northeast-2 | 13:00-21:00 |
| Ásia-Pacífico (Singapura) | ap-southeast-1 | 14:00-22:00 |
| Ásia-Pacífico (Sydney) | ap-southeast-2 | 12:00-20:00 |
| Ásia-Pacífico (Jacarta) | ap-southeast-3 | 08:00-16:00 |
| Ásia-Pacífico (Melbourne) | ap-southeast-4 | 11:00-19:00 |
| Ásia-Pacífico (Tailândia) | ap-southeast-7 | 15:00-23:00 |
| Ásia-Pacífico (Tóquio) | ap-northeast-1 | 13:00-21:00 |
| Canadá (Central) | ca-central-1 | 03:00-11:00 |
| China (Pequim) | cn-north-1 | 06:00-14:00 |
| China (Ningxia) | cn-northwest-1 | 06:00-14:00 |
| Europa (Frankfurt) | eu-central-1 | 21:00-05:00 |
| Europa (Zurique) | eu-central-2 | 02:00-10:00 |
| Europa (Irlanda) | eu-west-1 | 22:00-06:00 |
| Europa (Londres) | eu-west-2 | 22:00-06:00 |
| Europa (Milão) | eu-south-1 | 02:00-10:00 |
| Europa (Paris) | eu-west-3 | 23:59-07:29 |
| Europa (Espanha) | eu-south-2 | 02:00-10:00 |
| Europa (Estocolmo) | eu-north-1 | 04:00 — 12:00 |
| México (Central) | mx-central-1 | 03:00-11:00 |
| Oriente Médio (Emirados Árabes Unidos) | me-central-1 | 05:00-13:00 |
| América do Sul (São Paulo) | sa-east-1 | 00:00-08:00 |
| Israel (Tel Aviv) | il-central-1 | 04:00-12:00 |
| AWS GovCloud (Leste dos EUA) | us-gov-east-1 | 17:00-01:00 |
| AWS GovCloud (Oeste dos EUA) | us-gov-west-1 | 06:00-14:00 |
## Período de retenção de backup
O período de retenção de backup é o número de dias que um backup automático é retido antes de ser excluído automaticamente. O Amazon DocumentDB é compatível com um período de retenção de backup de 1 a 35 dias.
É possível definir o período de retenção de backup ao criar um cluster. Se você não definir explicitamente o período de retenção de backup, o período de retenção de backup padrão de 1 dia será atribuído ao cluster. Depois de criar um cluster, você pode modificar o período de retenção de backup modificando o cluster usando o Console de gerenciamento da AWS ou o. AWS CLI Para obter mais informações, consulte [Modificar um cluster do Amazon DocumentDB](db-cluster-modify.md).
## Copiar criptografia de snapshot de cluster
A criptografia de cluster e snapshot é baseada em uma chave de criptografia do KMS. O ID da chave do KMS é o nome do recurso da Amazon (ARN), o identificador da chave do KMS ou o alias da chave do KMS para a chave de criptografia do KMS.
As seguintes diretrizes e limitações são aplicáveis:
+ A criptografia é inferida do cluster ao criar um snapshot. Se o cluster for criptografado, o snapshot do cluster será criptografado com a mesma chave KMS. Se o cluster não for criptografado, o snapshot não será criptografado.
+ Se você copiar um snapshot do cluster criptografado da conta Amazon Web Services, é possível especificar um valor para `KmsKeyId` a fim de criptografar a cópia com uma nova chave de criptografia do KMS. Se você não especificar um valor para `KmsKeyId` , a cópia do snapshot do cluster será criptografada com a mesma chave KMS que o snapshot do cluster de origem.
+ Se você copiar um snapshot de cluster criptografado compartilhado de outra conta Amazon Web Services, deverá especificar um valor para `KmsKeyId`.
+ Para copiar um snapshot de cluster criptografado para outra região Amazon Web Services, configure `KmsKeyId` para o ID da chave KMS que você deseja usar para criptografar a cópia do snapshot de cluster na região de destino. Chaves de criptografia do KMS são específicas da região da Amazon Web Services em que são criadas, e não é possível usar chaves de criptografia de uma região da Amazon Web Services em outra.
+ Se você tentar copiar um snapshot de cluster não criptografado e especificar um valor para o parâmetro `KmsKeyId`, um erro será retornado.
# Comparação dos snapshots automáticos e manuais
A seguir, estão os principais atributos dos snapshots automáticos e manuais do Amazon DocumentDB (compativel com MongoDB).
**Os snapshots automáticos do Amazon DocumentDB têm os recursos principais a seguir:**
+ **Nomeação de snapshots automáticos**: nomes de snapshots automáticos seguem o padrão `rds:-yyyy-mm-dd-hh-mm`, com `yyyy-mm-dd-hh-mm` representando a data e a hora em que o snapshot foi criado.
+ **Criado automaticamente em uma programação**: ao criar ou modificar um cluster, é possível definir o *período de retenção de backup* para um valor inteiro de 1 a 35 dias. Por padrão, os novos clusters têm um período de retenção de backup de 1 dia. O período de retenção de backup define o número de dias que os snapshots automáticos são mantidos antes de serem excluídos automaticamente. Não é possível desabilitar backups automáticos em clusters do Amazon DocumentDB.
Além de definir o período de retenção de backup, você também define a *janela de backup*, a hora do dia durante a qual os snapshots automáticos são criados.
+ **Exclusão de snapshots automáticos**: snapshots automáticos são excluídos quando você exclui o cluster do snapshot automático. Não é possível excluir manualmente um snapshot automático.
+ **Incremental**: durante o período de retenção de backup, as atualizações do banco de dados são registradas para que haja um registro incremental de alterações.
+ **Restauração de um snapshot automático**: é possível restaurar de um snapshot automático usando o Console de gerenciamento da AWS ou a AWS CLI. Ao restaurar a partir de um snapshot usando o AWS CLI, você deve adicionar instâncias separadamente depois que o cluster estiver *disponível*.
+ **Compartilhamento**: não é possível compartilhar um snapshot de cluster automatizado do Amazon DocumentDB. Como alternativa, crie um snapshot manual copiando o snapshot automatizado e compartilhe essa cópia. Para obter mais informações sobre como copiar um snapshot, consulte [Cópia de snapshots de cluster do Amazon DocumentDB](backup_restore-copy_cluster_snapshot.md). Para obter mais informações sobre a restauração de um cluster com base em um snapshot, consulte [Restauração de um snapshot de cluster](backup_restore-restore_from_snapshot.md).
+ **É possível restaurar a partir de qualquer ponto dentro do período de retenção de backup**: como as atualizações de banco de dados são gravadas de forma incremental, é possível restaurar o cluster para qualquer momento determinado dentro do período de retenção de backup.
Ao restaurar a partir de um snapshot automático ou de uma point-in-time restauração usando o AWS CLI, você deve adicionar instâncias separadamente depois que o cluster estiver *disponível*.
**Os snapshots manuais do Amazon DocumentDB têm os principais atributos a seguir:**
+ **Criado sob demanda** — Os snapshots manuais do Amazon DocumentDB são criados sob demanda usando o Amazon DocumentDB Management Console ou. AWS CLI
+ **Exclusão de um snapshot manual**: um snapshot manual é excluído somente quando você o exclui explicitamente usando o console ou a AWS CLI do Amazon DocumentDB. Um snapshot manual não é excluído quando você exclui o cluster.
+ **Backups completos**: quando um snapshot manual é obtido, um backup completo dos dados do cluster é criado e armazenado.
+ **Nomeação manual do snapshot**: você especifica o nome do instantâneo manual. O Amazon DocumentDB não adiciona um selo `datetime` ao nome, então você deve adicionar essas informações se quiser incluí-las no nome.
+ **Restauração de um snapshot manual**: é possível restaurar de um snapshot manual usando o console ou a AWS CLI. Ao restaurar a partir de um snapshot usando o AWS CLI, você deve adicionar instâncias separadamente depois que o cluster estiver *disponível*.
+ **Service Quotas** — Você está limitado a um máximo de 100 instantâneos manuais por. Região da AWS
+ **Compartilhamento**: é possível compartilhar snapshots manuais de cluster, que podem ser copiados por Contas da AWS autorizadas. É possível compartilhar snapshots manuais criptografados ou não criptografados. Para obter mais informações sobre como copiar um snapshot, consulte [Cópia de snapshots de cluster do Amazon DocumentDB](backup_restore-copy_cluster_snapshot.md).
+ **Você restaura para o momento em que o snapshot manual foi obtido**: ao restaurar de um snapshot manual, você restaura para o momento em que o snapshot manual foi obtido.
Ao restaurar a partir de um snapshot usando o AWS CLI, você deve adicionar instâncias separadamente depois que o cluster estiver *disponível*.
# Criação de um snapshot manual de cluster
Você pode criar um instantâneo manual usando o Console de gerenciamento da AWS ou AWS CLI. O tempo necessário para criar um snapshot varia com o tamanho dos bancos de dados. Ao criar um snapshot, faça o seguinte:
1. Identifique o cluster para fazer backup.
1. Atribua um nome ao snapshot. Isso permite que faça restaurações a partir dele mais tarde.
------
#### [ Using the Console de gerenciamento da AWS ]
Para criar um instantâneo manual usando o Console de gerenciamento da AWS, você pode seguir um dos métodos abaixo.
1. **Método 1:**
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**.
**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. Na página **Snapshots**, selecione **Create (Criar)**.
1. Na página **Criar snapshot do cluster**:
1. **Identificador de cluster**: na lista suspensa de clusters, escolha o cluster do qual deseja criar um snapshot.
1. **Identificador de instantâneo**: insira um nome para seu snapshot.
Restrições de nomenclatura do snapshot:
+ O comprimento é de [1 a 255] 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, Amazon Neptune e Amazon DocumentDB) por conta AWS , por região.
1. Escolha **Criar**.
1. **Método 2:**
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 **Clusters**.
**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. Na página **Clusters**, escolha o botão à esquerda do cluster que pretende gerar snapshots.
1. No menu **Ações**, escolha **Tirar snapshot**.
1. Na página **Create cluster snapshot (Criar snapshot de cluster)**:
1. **Identificador de instantâneo**: insira um nome para seu snapshot.
Restrições de nomenclatura do snapshot:
+ 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, Amazon Neptune e Amazon DocumentDB) por conta AWS , por região.
1. Escolha **Criar**.
------
#### [ Using the AWS CLI ]
Para criar um snapshot de cluster usando o AWS CLI, use a `create-db-cluster-snapshot` operação com os parâmetros a seguir.
**Parâmetros**
+ **--db-cluster-identifier** — Obrigatório. O nome do cluster do qual você está tirando um snapshot. Esse cluster deve existir e estar *disponível*.
+ **--db-cluster-snapshot-identifier** — Obrigatório. O nome do snapshot manual que você está criando.
O exemplo a seguir cria um snapshot chamado `sample-cluster-snapshot` para um cluster chamado `sample-cluster`.
Para Linux, macOS ou Unix:
```
aws docdb create-db-cluster-snapshot \
--db-cluster-identifier sample-cluster \
--db-cluster-snapshot-identifier sample-cluster-snapshot
```
Para Windows:
```
aws docdb create-db-cluster-snapshot ^
--db-cluster-identifier sample-cluster ^
--db-cluster-snapshot-identifier sample-cluster-snapshot
```
A saída dessa operação é semelhante à seguinte.
```
{
"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"
}
}
```
------
# 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).
------
# Compartilhamento de snapshots de cluster do Amazon DocumentDB
Com o Amazon DocumentDB, é possível compartilhar um snapshot manual do cluster das formas a seguir:
+ Compartilhar um instantâneo manual do cluster, seja criptografado ou não criptografado, permite que AWS contas autorizadas copiem o instantâneo.
+ Compartilhar um snapshot manual do cluster, seja criptografado ou não criptografado, permite que AWS contas autorizadas restaurem diretamente um cluster a partir do snapshot, em vez de fazer uma cópia e restaurar a partir dela.
**nota**
Para compartilhar um snapshot automatizado de cluster, crie um snapshot manual do cluster copiando o snapshot automatizado e, em seguida, compartilhe essa cópia. Esse processo também se aplica aos recursos gerados pelo AWS Backup.
Você pode compartilhar um instantâneo manual com até 20 outros Contas da AWS. Também é possível compartilhar um snapshot manual não criptografado como público, disponibilizando-o para todas as contas da . Ao compartilhar um snapshot como público, verifique se as informações privadas não estão incluídas nos snapshots públicos.
Ao compartilhar snapshots manuais com outras pessoas Contas da AWS e restaurar um cluster a partir de um snapshot compartilhado usando a API do AWS CLI Amazon DocumentDB, você deve especificar o Amazon Resource Name (ARN) do snapshot compartilhado como o identificador do snapshot.
## Compartilhar um snapshot criptografado
As seguintes restrições se aplicam ao compartilhamento de snapshots criptografados:
+ Não é possível compartilhar snapshots criptografados como públicos.
+ Você não pode compartilhar um instantâneo que tenha sido criptografado usando a chave de AWS KMS criptografia padrão da conta que compartilhou o instantâneo.
Siga estas etapas para compartilhar snapshots criptografados.
1. Compartilhe a chave de criptografia AWS Key Management Service (AWS KMS) usada para criptografar o snapshot com todas as contas que você quiser que possam acessar o snapshot.
Você pode compartilhar chaves de AWS KMS criptografia com outras AWS contas adicionando as outras contas à política de AWS KMS chaves. Para obter detalhes sobre a atualização de uma política de chaves, consulte [Usando políticas de chaves no AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/key-policies.html) no *Guia do AWS Key Management Service desenvolvedor*. Para ver um exemplo de como criar uma política de chaves, consulte [Criar uma política do IAM para permitir a cópia do snapshot criptografado](#backup_restore-share_encrypted_snapshots-create_key_policy), mais adiante neste tópico.
1. Use o AWS CLI, [conforme mostrado abaixo](#backup_restore-share_snapshots), para compartilhar o instantâneo criptografado com as outras contas.
### Permitindo acesso a uma chave AWS KMS de criptografia
Para Conta da AWS que outra pessoa copie um instantâneo criptografado compartilhado da sua conta, a conta com a qual você compartilha seu instantâneo deve ter acesso à AWS KMS chave que criptografou o instantâneo. Para permitir que outra conta acesse uma AWS KMS chave, atualize a política de AWS KMS chaves da chave com o ARN da conta com a qual você está compartilhando como principal na política de AWS KMS chaves. Então, permita a ação `kms:CreateGrant`.
Depois de conceder a uma conta acesso à sua chave de AWS KMS criptografia, para copiar seu snapshot criptografado, essa conta deve criar um usuário AWS Identity and Access Management (IAM), caso ainda não tenha um. Além disso, essa conta também deve anexar uma política do IAM a esse usuário do IAM que permita que o usuário copie um snapshot criptografado usando sua AWS KMS chave. A conta deve ser de um usuário do IAM e não pode ser uma Conta da AWS identidade raiz devido a restrições AWS KMS de segurança.
No exemplo de política de chaves a seguir, o usuário 123451234512 é o proprietário da chave de criptografia. AWS KMS O usuário 123456789012 é a conta com a qual a chave está sendo compartilhada. Essa política de chaves atualizada dá à conta acesso à AWS KMS chave. Isso é feito incluindo o ARN da Conta da AWS identidade raiz do usuário 123456789012 como principal da política e permitindo a ação. `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}}
}
]
}
```
------
### Criar uma política do IAM para permitir a cópia do snapshot criptografado
Quando o externo Conta da AWS tem acesso à sua AWS KMS chave, o proprietário dessa conta pode criar uma política para permitir que um usuário do IAM criado para a conta copie um snapshot criptografado com essa AWS KMS chave.
O exemplo a seguir mostra uma política que pode ser anexada a um usuário do IAM para Conta da AWS 123456789012. A política permite que o usuário do IAM copie um snapshot compartilhado da conta 123451234512 que foi criptografado com a chave na região us-west-2. AWS KMS `c989c1dd-a3f2-4a5d-8d96-e793d082ab26`
------
#### [ 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
}
}
}
]
}
```
------
Para obter mais detalhes sobre a atualização de uma política de chaves, consulte [ Políticas de chave no AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/key-policies.html) no *Guia do desenvolvedor do AWS Key Management Service *.
## Compartilhar um snapshot
Você pode compartilhar um snapshot de cluster manual do Amazon DocumentDB (ou uma cópia de um snapshot automático) usando o ou o: Console de gerenciamento da AWS AWS CLI
------
#### [ Using the Console de gerenciamento da AWS ]
Para compartilhar um instantâneo usando o Console de gerenciamento da AWS, conclua as seguintes etapas:
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**.
1. Selecione o snapshot manual que você deseja compartilhar.
1. No menu suspenso **Ações**, escolha Compartilhar.
1. Escolha uma das opções a seguir para **Visibilidade do snapshot de banco de dados**.
+ Se a fonte não estiver criptografada, escolha **Pública** para permitir que todas as AWS contas restaurem um cluster a partir do seu snapshot manual. Ou escolha **Privado** para permitir que somente AWS as contas que você especificar restaurem um cluster a partir do seu snapshot manual.
**Atenção**
Se você definir a **visibilidade do DB snapshot** como **Pública**, todas as AWS contas poderão restaurar um cluster a partir do seu snapshot manual e ter acesso aos seus dados. Não compartilhe nenhum snapshot manual de cluster que contenha informações privadas como **Público**.
+ Se a origem estiver criptografada, **DB snapshot visibility** (Visibilidade do snapshot de banco de dados) será definida como **Private** (Privada) porque os snapshots criptografados não podem ser compartilhados como públicos.
**nota**
Os instantâneos que foram criptografados com o padrão não AWS KMS key podem ser compartilhados.
1. Em **ID da AWS conta**, insira o AWS identificador da conta que você deseja permitir para restaurar um cluster a partir do seu snapshot manual e, em seguida, escolha **Adicionar**. Repita o procedimento para incluir identificadores de AWS conta adicionais, até 20 AWS contas.
Se você cometer um erro ao adicionar um identificador de AWS conta à lista de contas permitidas, poderá excluí-lo da lista escolhendo **Excluir** à direita do identificador de AWS conta incorreto.
![\[Diagrama: compartilhamento de preferências de snapshot\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/share-snapshot.png)
1. Depois de adicionar identificadores para todas as AWS contas que você deseja permitir para restaurar o instantâneo manual, escolha **Salvar para salvar** suas alterações.
------
#### [ Using the AWS CLI ]
Para compartilhar um snapshot usando o AWS CLI, use a operação Amazon `modify-db-snapshot-attribute` DocumentDB. Use o `--values-to-add` parâmetro para adicionar uma lista dos IDs Contas da AWS que estão autorizados a restaurar o instantâneo manual.
O exemplo a seguir permite que dois Conta da AWS identificadores, 123451234512 e 123456789012, restaurem o snapshot chamado. `manual-snapshot1` Ele também remove o valor de atributo `all` para marcar o snapshot como privado.
Para Linux, macOS ou Unix:
```
aws docdb modify-db-cluster-snapshot-attribute \
--db-cluster-snapshot-identifier sample-cluster-snapshot \
--attribute-name restore \
--values-to-add '["123451234512","123456789012"]'
```
Para Windows:
```
aws docdb modify-db-cluster-snapshot-attribute ^
--db-cluster-snapshot-identifier sample-cluster-snapshot ^
--attribute-name restore ^
--values-to-add '["123451234512","123456789012"]'
```
A saída dessa operação é semelhante à seguinte.
```
{
"DBClusterSnapshotAttributesResult": {
"DBClusterSnapshotIdentifier": "sample-cluster-snapshot",
"DBClusterSnapshotAttributes": [
{
"AttributeName": "restore",
"AttributeValues": [
"123451234512",
"123456789012"
]
}
]
}
}
```
Para remover um Conta da AWS identificador da lista, use o `--values-to-remove` parâmetro. O exemplo a seguir impede que a Conta da AWS ID 123456789012 restaure o snapshot.
Para Linux, macOS ou Unix:
```
aws docdb modify-db-cluster-snapshot-attribute \
--db-cluster-snapshot-identifier sample-cluster-snapshot \
--attribute-name restore \
--values-to-remove '["123456789012"]'
```
Para Windows:
```
aws docdb modify-db-cluster-snapshot-attribute ^
--db-cluster-snapshot-identifier sample-cluster-snapshot ^
--attribute-name restore ^
--values-to-remove '["123456789012"]'
```
A saída dessa operação é semelhante à seguinte.
```
{
"DBClusterSnapshotAttributesResult": {
"DBClusterSnapshotIdentifier": "sample-cluster-snapshot",
"DBClusterSnapshotAttributes": [
{
"AttributeName": "restore",
"AttributeValues": [
"123451234512"
]
}
]
}
}
```
------
# Restauração de um snapshot de cluster
O Amazon DocumentDB (compativel com MongoDB) cria um snapshot de cluster do seu volume de armazenamento. É possível criar um novo cluster com a restauração de um snapshot de cluster. Ao restaurar o cluster, você fornece o nome do snapshot do cluster do qual restaurar e um nome para o novo cluster criado pela restauração. Não é possível restaurar de um snapshot para um cluster existente, pois um novo cluster é criado quando você restaura.
Quando você estiver restaurando um cluster a partir de um snapshot de cluster:
+ Essa ação restaura apenas o cluster, e não as instâncias desse cluster. É necessário invocar a ação `create-db-instance` para criar instâncias para o cluster restaurado, especificando o identificador do cluster restaurado em `--db-cluster-identifier`. É possível criar instâncias apenas depois que o cluster estiver *disponível*.
+ Não é possível restaurar um snapshot criptografado para um cluster descriptografado. No entanto, você pode restaurar um snapshot não criptografado em um cluster criptografado especificando a chave. AWS KMS
+ Para restaurar um cluster a partir de um snapshot criptografado, você deve ter acesso à AWS KMS chave.
**nota**
Não é possível restaurar um cluster 3.6 para um 4.0, mas pode migrar de uma versão de cluster para outra. Para obter mais informações, acesse [Migrar para o Amazon DocumentDB](docdb-migration.md).
------
#### [ Using the Console de gerenciamento da AWS ]
O procedimento a seguir mostra como restaurar um cluster do Amazon DocumentDB a partir de um snapshot de cluster usando o console de gerenciamento do Amazon DocumentDB.
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 usar para restaurar o cluster.
**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 **Ações**, selecione **Restaurar**.
1. Na página **Restaurar snapshot**, preencha a seção **Configurações**.
1. **Identificador de cluster**: o nome do novo cluster. É possível aceitar o nome do Amazon DocumentDB fornecido ou digitar o nome que preferir. O DBsupplied nome do documento da Amazon está no formato de `docdb-` mais um carimbo de data/hora UTC; por exemplo,. `docdb-yyyy-mm-dd-hh-mm-ss`
1. **Classe de instância**: a classe de instância do novo cluster. É possível aceitar a classe de instância padrão ou escolher uma classe de instância na lista suspensa.
1. **Número de instâncias**: o número de instâncias criadas com esse cluster. Você pode aceitar o padrão de 3 instâncias (1 réplica primária read/write e 2 réplicas somente para leitura) ou escolher o número de instâncias na lista suspensa.
1. Para **Configuração de armazenamento do cluster**, escolha uma opção de armazenamento.
**nota**
A configuração de armazenamento **otimizada para E/S do Amazon DocumentDB** só está disponível nas versões do mecanismo Amazon DocumentDB 5.0 e 8.0.
1. Se você estiver satisfeito com a configuração de cluster, escolha **Restaurar cluster** e aguarde enquanto o cluster é restaurado.
1. Se preferir alterar algumas configurações, como especificar uma VPC Amazon não padrão ou um grupo de segurança, escolha **Mostrar configurações avançadas** na parte inferior da página e continuar as etapas seguintes.
1. Conclua a seção **Configurações de rede**.
+ **Nuvem privada virtual (VPC)**: aceite a VPC atual ou escolha uma VPC na lista suspensa.
+ **Grupo de sub-redes**: aceite o grupo de sub-redes `default` ou escolha um na lista suspensa.
+ **Grupos de segurança da VPC**: aceite o grupo de segurança `default (VPC)` ou escolha um na lista.
1. Conclua a seção **Opções do cluster**.
+ **Porta do banco de dados**: aceite a porta padrão, `27017`, ou use a seta para cima ou para baixo para definir a porta que você deseja usar para conexões de aplicação.
1. Preencha a seção **Criptografia**.
+ **Criptografia em repouso**: se o seu snapshot é criptografado, essas opções não estão disponíveis para você. Se não estiver criptografado, é possível escolher uma das seguintes ações:
+ Para criptografar todos os dados do seu cluster, escolha **Habilitar encryption-at-rest**. Se escolher essa opção, você deve designar uma chave mestre.
+ Para não criptografar os dados do seu cluster, escolha **Desativar encryption-at-rest**. Se escolher essa opção, você concluiu a seção de criptografia.
+ **AWS KMS Chave** — Escolha uma das seguintes opções na lista suspensa:
+ **(padrão) aws/rds** — O número da conta e o ID da AWS KMS chave estão listados seguindo essa opção.
+ **Chave gerenciada pelo cliente** — Essa opção estará disponível somente se você tiver criado uma chave de criptografia do IAM no console AWS Identity and Access Management (IAM). Você pode escolher a chave para criptografar seu cluster.
+ **Insira um ARN de chave** — Na caixa **ARN**, insira o Amazon Resource Name (ARN) para sua chave. AWS KMS O formato do ARN é `arn:aws:kms:::key/`.
1. Complete a seção **Exportações de log**.
+ **Selecione os tipos de registro nos quais publicar CloudWatch** — Escolha uma das seguintes opções:
+ **Ativado** — Permite que seu cluster exporte registros de DDL para o Amazon CloudWatch Logs.
+ **Desativado** — Impede que seu cluster exporte registros DDL para o Amazon CloudWatch Logs. **Desabilitado** é o padrão.
+ **Perfil do IAM**: na lista, escolha *Perfil vinculado ao serviço RDS*.
1. Complete a seção **Tags**.
+ **Adicionar tag**: na caixa *Chave*, insira o nome da tag do cluster. Na caixa *Valor*, opcionalmente insira o valor da tag. As tags são usadas com políticas AWS Identity and Access Management (IAM) para gerenciar o acesso aos recursos do Amazon DocumentDB e controlar quais ações podem ser aplicadas aos recursos.
1. Complete a seção **Proteção contra exclusão**.
+ **Habilitar proteção contra exclusão**: protege o cluster contra exclusão acidental. Quando essa opção estiver habilitada, não será possível excluir o cluster.
1. Escolha **Restaurar cluster**.
------
#### [ Using the AWS CLI ]
Para restaurar um cluster a partir de um snapshot usando o AWS CLI, use a `restore-db-cluster-from-snapshot` operação com os parâmetros a seguir. Para obter mais informações, consulte [RestoreDBClusterFromSnapshot](API_RestoreDBClusterFromSnapshot.md).
+ **--db-cluster-identifier** — Obrigatório. O nome do cluster que é criado pela operação. Um cluster com este nome não pode existir antes dessa operação.
Restrições de nomeação de cluster:
+ 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
+ **--snapshot-identifier** — Obrigatório. O nome do snapshot usado para restauração. Um snapshot com esse nome deve existir e estar no estado *disponível*.
+ **--engine** — Obrigatório. Deve ser `docdb`.
+ **--storage-type standard \$1 iopt1**: opcional. Padrão: `standard`.
+ **--kms-key-id**: opcional. O ARN do identificador de AWS KMS chave a ser usado ao restaurar um instantâneo criptografado ou criptografar um cluster ao restaurar a partir de um instantâneo não criptografado. O fornecimento da ID da AWS KMS chave faz com que o cluster restaurado seja criptografado com a AWS KMS chave, independentemente de o snapshot ter sido criptografado ou não.
O formato do `--kms-key-id` é `arn:aws:kms:::key/`. Se você não especificar um valor para o parâmetro `--kms-key-id`, ocorrerá o seguinte:
+ Se o snapshot in `--snapshot-identifier` for criptografado, o cluster restaurado será criptografado usando a mesma AWS KMS chave usada para criptografar o snapshot.
+ Se o snapshot em `--snapshot-identifier` não estiver criptografado, o cluster restaurado não será criptografado.
Para Linux, macOS ou 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
```
Para 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
```
A saída dessa operação é semelhante à seguinte.
```
{
"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
}
}
```
Depois que o status do cluster estiver *disponível*, crie pelo menos uma instância para o cluster.
Para Linux, macOS ou 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
```
Para 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
```
A saída dessa operação é semelhante à seguinte.
```
{
"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"
}
}
```
------
# Restauração para um ponto no tempo
Você pode restaurar um cluster em qualquer momento que esteja dentro do período de retenção de backup do cluster usando o Console de gerenciamento da AWS ou AWS Command Line Interface (AWS CLI).
**nota**
Você não pode realizar uma point-in-time restauração de um cluster 3.6 para um 4.0, mas você pode migrar de uma versão de cluster para outra. Para obter mais informações, acesse [Migrar para o Amazon DocumentDB](docdb-migration.md).
Lembre-se do seguinte ao restaurar um cluster para um momento determinado.
+ O novo cluster é criado com a mesma configuração do cluster de origem, exceto pelo fato de que o novo cluster é criado com o grupo de parâmetros padrão. Para definir o grupo de parâmetros do novo cluster como o grupo de parâmetros do cluster de origem, modifique o cluster depois que ele estiver *disponível*. Para obter mais informações sobre como modificar um cluster, consulte [Modificar um cluster do Amazon DocumentDB](db-cluster-modify.md).
------
#### [ Using the Console de gerenciamento da AWS ]
Você pode restaurar um cluster point-in-time dentro do período de retenção de backup preenchendo o seguinte usando Console de gerenciamento da AWS o.
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 **Clusters**. Na lista de clusters, escolha o botão à esquerda do cluster que você deseja restaurar.
**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 **Ações**, escolha **Restaurar para um determinado momento**.
1. Preencha a seção **Hora de restauração**, que especifica a data e a hora da restauração.
1. **Data de restauração**: escolha ou insira uma data entre a **Hora de restauração mais antiga** e a **Hora de restauração mais recente**.
1. **Hora de restauração**: escolha ou insira uma hora, minuto e segundos entre a **Hora de restauração mais antiga** e a **Hora de restauração mais recente**.
1. Preencha a seção **Configuração**.
1. **Identificador de cluster**: aceite o identificador padrão ou insira um identificador que você preferir.
Restrições de nomeação de cluster:
+ 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. **Classe da instância**: na lista suspensa, escolha a classe de instância que você deseja usar para as instâncias do cluster.
1. **Número de instâncias**: na lista suspensa, escolha o número de instâncias que você deseja criar quando o cluster é restaurado.
1. Para **Configuração de armazenamento do cluster**, escolha uma opção de armazenamento.
**nota**
A configuração de armazenamento **otimizada para E/S do Amazon DocumentDB** só está disponível nas versões do mecanismo Amazon DocumentDB 5.0 e 8.0.
1. Opcional. Para definir as configurações de rede e as opções do cluster e ativar exportações de log, escolha **Mostrar configurações avançadas** e preencha as seções a seguir. Caso contrário, siga para a próxima etapa.
+ **Configurações de rede**
1. **Nuvem privada virtual (VPC)** na lista suspensa, escolha a VPC na qual você deseja usar esse cluster.
1. **Grupo de sub-redes**: na lista suspensa, escolha o grupo de sub-redes para esse cluster.
1. **Grupos de segurança da VPC**: na lista suspensa, escolha os grupos de segurança da VPC para esse cluster.
+ **Opções do cluster**
1. **Porta**: aceite a porta padrão (27017) ou use as setas para cima e para baixo para definir a porta de comunicação com esse cluster.
+ **Exportações de log**
1. **Registros de auditoria** — Selecione essa opção para permitir a exportação de registros de auditoria para o Amazon CloudWatch Logs. Se você selecionar essa opção, será necessário habilitar `audit_logs` no grupo de parâmetros personalizado do cluster. Para obter mais informações, consulte [Auditar eventos do Amazon DocumentDB](event-auditing.md).
1. **Registros do profiler — Selecione essa opção para permitir a exportação dos logs** do profiler da operação para o Amazon Logs. CloudWatch Se você selecionar essa opção, também será necessário modificar os seguintes parâmetros no grupo de parâmetros personalizado do cluster:
+ `profiler`: defina como `enabled`.
+ `profiler_threshold_ms` defina como um valor `[0-INT_MAX]` para configurar o limite para operações de criação de perfil.
+ `profiler_sampling_rate`: defina como um valor `[0.0-1.0]` para configurar o percentual de operações lentas para perfilar.
Para obter mais informações, consulte [Definir o perfil das operações do Amazon DocumentDB](profiling.md).
1. **Registros do Profiler — Exporte os registros** do Profiler para a Amazon CloudWatch
1. **Perfil do IAM**: na lista suspensa, escolha *Perfil vinculado ao serviço RDS*.
+ **Tags**
1. **Adicionar tag**: na caixa *Chave*, insira o nome da tag do cluster. Na caixa *Valor*, opcionalmente insira o valor da tag. As tags são usadas com políticas do (IAM) AWS Identity and Access Management para gerenciar acesso aos recursos do Amazon DocumentDB e controlar quais ações podem ser aplicadas aos recursos.
+ **Proteção contra exclusão**
1. **Habilitar proteção contra exclusão**: protege o cluster contra exclusão acidental. Quando essa opção estiver habilitada, não será possível excluir o cluster.
1. Para restaurar o cluster, escolha **Criar cluster**. Como alternativa, escolha **Cancelar** para cancelar a operação.
------
#### [ Using the AWS CLI ]
Para restaurar um cluster para um momento determinado usando o período de retenção de backup do snapshot, use a operação `restore-db-cluster-to-point-in-time` com os parâmetros a seguir.
+ **--db-cluster-identifier**: obrigatório. O nome do novo cluster a ser criado. Esse cluster não pode existir antes da operação. O valor do parâmetro deve atender às seguintes restrições.
Restrições de nomeação de cluster:
+ 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
+ **--restore-to-time**: a data e a hora, em formato UTC, em que o cluster será restaurado. Por exemplo, .`2018-06-07T23:45:00Z`
Restrições de tempo:
+ Devem ser anteriores ao último momento restaurável do cluster.
+ Devem ser especificadas se o parâmetro `--use-latest-restorable-time` não for especificado.
+ Não podem ser especificadas se o parâmetro `--use-latest-restorable-time` for `true`.
+ Não podem ser especificadas se o valor do parâmetro `--restore-type` for `copy-on-write`.
+ **--source-db-cluster-identifier**: o nome do cluster de origem a partir do qual restaurar. Esse cluster deve existir e estar disponível.
+ **--use-latest-restorable-time** ou **--no-use-latest-restorable-time**: se deseja restaurar para a última hora de backup restaurável. Não pode ser especificado se o parâmetro `--restore-to-time` não for especificado.
+ **--storage-type standard \$1 iopt1**: opcional. Padrão: `standard`.
A AWS CLI operação restaura `restore-db-cluster-to-point-in-time` somente o cluster, não as instâncias desse cluster. É necessário invocar a operação `create-db-instance` para criar instâncias para o cluster restaurado, especificando o identificador do cluster restaurado em `--db-cluster-identifier`. Você só pode criar instâncias após a conclusão da operação `restore-db-cluster-to-point-in-time` e com o cluster restaurado em estado *disponível*.
**Example**
O exemplo a seguir cria o `sample-cluster-restored` do snapshot `sample-cluster-snapshot` para o último momento restaurável.
Para Linux, macOS ou 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
```
Para 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**
O exemplo a seguir cria o `sample-cluster-restored` do snapshot `sample-cluster-snapshot` para 03:15 de 11 de dezembro de 2018 (UTC), que está dentro do período de retenção de backup de `sample-cluster`.
Para Linux, macOS ou 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
```
Para 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
```
A saída dessa operação é semelhante à seguinte.
```
{
"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
}
}
```
------
# Exclusão de um snapshot de cluster
Um instantâneo manual é um backup completo que é excluído somente quando você o exclui manualmente usando o Console de gerenciamento da AWS ou AWS CLI. Não é possível excluir manualmente um snapshot automático porque os snapshots automáticos são excluídos apenas quando o período de retenção do snapshot expira ou quando você exclui o cluster do snapshot.
------
#### [ Using the Console de gerenciamento da AWS ]
Para excluir um snapshot manual do cluster usando o Console de gerenciamento da AWS, conclua as etapas a seguir.
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**.
**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. Na lista de snapshots, escolha o botão à esquerda do snapshot que você deseja excluir. O tipo do snapshot deve ser **manual**.
1. É possível verificar se o tipo do snapshot é **manual** verificando se ele está listado como `manual` ou `automatic` na coluna **Tipo**.
1. No menu **Ações**, escolha **Excluir**. Se a opção **Excluir** estiver indisponível, você provavelmente escolheu um snapshot automático.
1. Na tela de confirmação de exclusão, para eliminar o snapshot, escolha **Excluir**. Para manter o snapshot, escolha **Cancelar**.
------
#### [ Using the AWS CLI ]
Um snapshot de cluster manual do Amazon DocumentDB é um backup completo que é possível excluir manualmente usando a AWS CLI. Não é possível excluir manualmente um snapshot automático.
Para excluir um snapshot manual do cluster usando o AWS CLI, use a `delete-db-cluster-snapshot` operação com os parâmetros a seguir.
**Parâmetros**
+ **--db-cluster-snapshot-identifier** — Obrigatório. O nome do snapshot manual a ser excluído.
O exemplo a seguir exclui o snapshot de cluster `sample-cluster-snapshot`.
Para Linux, macOS ou Unix:
```
aws docdb delete-db-cluster-snapshot \
--db-cluster-snapshot-identifier sample-cluster-snapshot
```
Para Windows:
```
aws docdb delete-db-cluster-snapshot ^
--db-cluster-snapshot-identifier sample-cluster-snapshot
```
A saída desta operação lista os detalhes do snapshot do cluster excluído.
------