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

# Restaurar um cluster do DocumentDB
<a name="restoring-docdb"></a>

## Use o AWS Backup console para restaurar os pontos de recuperação do Amazon DocumentDB
<a name="docdb-restore-console"></a>

A restauração de um cluster do Amazon DocumentDB exige a especificação de várias opções de restauração. Para obter informações sobre essas opções, consulte [Restaurar a partir de um snapshot de cluster](https://docs.aws.amazon.com/documentdb/latest/developerguide/backup_restore-restore_from_snapshot.html) no *Guia do desenvolvedor do Amazon DocumentDB*.

**Como restaurar um cluster do Amazon DocumentDB**

1. Abra o AWS Backup console em [https://console.aws.amazon.com/backup.](https://console.aws.amazon.com/backup)

1. No painel de navegação, escolha **Recursos protegidos** e o ID de recurso do Amazon DocumentDB que deseja restaurar.

1. Na página **Detalhes do recurso** é mostrada uma lista de pontos de recuperação para o ID de recurso selecionado. Para restaurar um recurso, no painel **Backups**, escolha o botão de opção ao lado do ID do ponto de recuperação do recurso. No canto superior direito do painel, escolha **Restaurar**.

1. Verifique se você está na página do console **Restaurar snapshots do cluster do Amazon DocumentDB**.

1. Para **opções de restauração**, você pode configurar o seguinte:
   + **Versão do mecanismo** - Selecione a versão do mecanismo DocumentDB para o cluster restaurado.
**nota**  
A classe da instância e o número de instâncias não podem ser configurados durante o processo de restauração. O cluster restaurado do DocumentDB usará a configuração de instância padrão. Você pode modificar a classe da instância e adicionar ou remover instâncias após a conclusão da restauração usando o console ou a API do Amazon DocumentDB.

1. No painel **Configurações**, insira um nome exclusivo para o identificador do cluster de banco de dados.

   Você pode usar letras, números e hífens, mas não pode usar dois hífens consecutivos nem terminar o nome com um hífen. O nome final deve ser todo em minúsculas.

1. No painel **Opções do banco de dados**, selecione a porta do banco de dados.

   Essa é a TCP/IP porta que a instância de banco de dados ou o cluster usará para conexões de aplicativos. A string de conexão de qualquer aplicação que se conecte à instância ou ao cluster de banco de dados deve especificar seu número de porta. Tanto o grupo de segurança aplicado à instância ou ao cluster de banco de dados quanto os firewalls da organização devem permitir conexões com a porta. Todas as instâncias de banco de dados em um cluster de banco de dados utilizam a mesma porta.

1. Também no painel **Opções de banco de dados**, selecione o grupo de parâmetros do cluster de banco de dados.

   Esse é o grupo de parâmetros associado ao cluster de banco de dados dessa instância. O grupo de parâmetros de cluster de banco de dados atua como um contêiner para os valores de configuração do mecanismo aplicados a cada instância de banco de dados em uma instância de banco de dados no cluster.

1. No painel **Criptografia**, selecione a chave que será usada para criptografar esse volume de banco de dados. O padrão é `aws/rds`. Você também pode usar uma chave gerenciada pelo cliente (CMK).

1. No painel **Exportações de registros**, escolha os tipos de log a serem publicados no Amazon CloudWatch Logs. O **Perfil do IAM** já está definido. 

1. No painel **Perfil de restauração**, escolha o perfil do IAM padrão para o trabalho de restauração ou outro perfil do IAM.

1. No painel de tags de recursos protegidos, você pode optar por copiar as tags do backup para o cluster de banco de dados restaurado.

1. Depois de especificar todas as configurações, escolha **Restore backup (Restaurar backup)**.

   O painel **Tarefas de restauração** será exibido. Uma mensagem na parte superior da página fornece informações sobre o trabalho de restauração.

1. Após a conclusão da restauração, anexe o cluster do restaurado do Amazon DocumentDB a uma instância do Amazon RDS.

## Use a AWS Backup API, a CLI ou o SDK para restaurar os pontos de recuperação do Amazon DocumentDB
<a name="docdb-restore-cli"></a>

Primeiro, restaure o cluster. Use `[StartRestoreJob](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_StartRestoreJob.html)`. É possível especificar os seguintes metadados durante as restaurações do Amazon DocumentDB:

```
availabilityZones
backtrackWindow
copyTagsToSnapshot // Boolean 
databaseName // string 
dbClusterIdentifier // string 
dbClusterParameterGroupName // string 
dbSubnetGroupName // string 
enableCloudwatchLogsExports // string 
enableIAMDatabaseAuthentication // Boolean 
engine // string 
engineMode // string 
engineVersion // string 
kmsKeyId // string 
port // integer 
optionGroupName // string 
scalingConfiguration
vpcSecurityGroupIds // string
```

 Depois, anexe o cluster do Amazon DocumentDB restaurado a uma instância do Amazon RDS usando `create-db-instance`.
+ Para Linux, macOS ou Unix:

  ```
  aws docdb create-db-instance --db-instance-identifier sample-instance / 
                    --db-cluster-identifier sample-cluster --engine docdb --db-instance-class db.r5.large
  ```
+ Para Windows:

  ```
  aws docdb create-db-instance --db-instance-identifier sample-instance ^ 
                    --db-cluster-identifier sample-cluster --engine docdb --db-instance-class db.r5.large
  ```