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á.
# 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**
Não é possível restaurar um ponto no tempo de 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).
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 ]
É possível restaurar um cluster para um point-in-time que esteja dentro do período de retenção de backup concluindo o seguinte usando o Console de gerenciamento da AWS.
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 () 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 I/O-Optimized armazenamento do **Amazon DocumentDB** está disponível somente 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 \| 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
}
}
```
------