# Atualizar uma versão do mecanismo de snapshot de banco de dados PostgreSQL
<a name="USER_UpgradeDBSnapshot.PostgreSQL"></a>

Com o Amazon RDS, você pode criar um snapshot de banco de dados do volume de armazenamento de sua instância de banco de dados PostgreSQL. Quando você cria um snapshot de banco de dados, ele é baseado na versão do mecanismo usada pela instância do Amazon RDS. É possível fazer a atualização da versão do mecanismo para os snapshots de banco de dados. 

Após restaurar um snapshot de banco de dados atualizado para uma nova versão do mecanismo, certifique-se de testar se a atualização foi bem-sucedida. Para obter mais informações sobre uma atualização de versão principal, consulte [Atualizações do mecanismo de banco de dados do RDS para PostgreSQL](USER_UpgradeDBInstance.PostgreSQL.md). Para saber como restaurar um snapshot de banco de dados, consulte [Restaurar uma instância de banco de dados](USER_RestoreFromSnapshot.md).

Você pode atualizar snapshots de banco de dados manuais criptografados ou não. 

Para visualizar as versões de mecanismo disponíveis para o snapshot de banco de dados do RDS para PostgreSQL, use o exemplo da AWS CLI a seguir. 

```
aws rds describe-db-engine-versions --engine postgres  --engine-version example-engine-version --query "DBEngineVersions[*].ValidUpgradeTarget[*].{EngineVersion:EngineVersion}" --output text --include-all
```

Consulte mais informações sobre as versões de mecanismo disponíveis para snapshots de banco de dados do RDS para PostgreSQL em [Escolher uma versão principal para uma atualização do RDS para PostgreSQL](USER_UpgradeDBInstance.PostgreSQL.MajorVersion.md).

**nota**  
Não é possível atualizar snapshots de banco de dados automatizados criados durante o processo de backup automatizado.

## Console
<a name="USER_UpgradeDBSnapshot.PostgreSQL.Console"></a>

**Para atualizar um snapshot de banco de dados**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. No painel de navegação, selecione **Snapshots**.

1. Escolha o snapshot que você deseja atualizar. 

1. Em **Actions (Ações)**, selecione **Upgrade snapshot (Atualizar snapshot)**. A página **Upgrade snapshot (Atualizar snapshot)** é exibida. 

1. Escolha a opção **New engine version (Nova versão de mecanismo)** para a qual atualizar.

1. Escolha **Save changes (Salvar alterações)** para atualizar o snapshot.

   Durante o processo de atualização, todas as ações do snapshot serão desabilitadas para esse snapshot de banco de dados. Além disso, o status do snapshot de banco de dados muda de **available (disponível)** para **upgrading (atualizando)** e muda para **active (ativo)** após a conclusão. Se não for possível atualizar o snapshot de banco de dados devido a problemas de corrupção do snapshot, o status mudará para **unavailable (indisponível)**. Não é possível recuperar o snapshot desse estado. 
**nota**  
Se a atualização do snapshot de banco de dados falhar, o snapshot será revertido para o estado original com a versão original.

## AWS CLI
<a name="USER_UpgradeDBSnapshot.PostgreSQL.CLI"></a>

Para atualizar um snapshot de banco de dados para uma nova versão do mecanismo de banco de dados, use o comando [modify-db-snapshot](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-snapshot.html) da AWS CLI. 

**Parâmetros**
+ `--db-snapshot-identifier` – o identificador do snapshot de banco de dados a ser atualizado. O identificador deve ser um nome de recurso da Amazon (ARN) exclusivo. Para obter mais informações, consulte [Nomes de recurso da Amazon (ARNs) no Amazon RDS](USER_Tagging.ARN.md).
+ `--engine-version` – a versão do mecanismo para a qual será feita a atualização do snapshot de banco de dados.

**Example**  
Para Linux, macOS ou Unix:  

```
1. aws rds modify-db-snapshot \
2.     --db-snapshot-identifier my_db_snapshot \
3.     --engine-version new_version
```
Para Windows:  

```
1. aws rds modify-db-snapshot ^
2.     --db-snapshot-identifier my_db_snapshot ^
3.     --engine-version new_version
```

## API do RDS
<a name="USER_UpgradeDBSnapshot.PostgreSQL.API"></a>

Para atualizar um snapshot de banco de dados para uma nova versão do mecanismo de banco de dados, chame a operação [ModifyDBSnapshot](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBSnapshot.html) da API do Amazon RDS. 
+ `DBSnapshotIdentifier` – o identificador do snapshot de banco de dados a ser atualizado. O identificador deve ser um nome de recurso da Amazon (ARN) exclusivo. Para obter mais informações, consulte [Nomes de recurso da Amazon (ARNs) no Amazon RDS](USER_Tagging.ARN.md). 
+ `EngineVersion` – a versão do mecanismo para a qual será feita a atualização do snapshot de banco de dados.