# Atualizar a versão de uma instância de banco de dados do RDS para Oracle
Para atualizar manualmente a versão do mecanismo de banco de dados de uma instância de banco de dados do RDS para Oracle, use o Console de gerenciamento da AWS, a AWS CLI ou a API do RDS. Para ter informações gerais sobre atualizações de bancos de dados, consulte [Atualizar a versão de uma instância de banco de dados do RDS para Oracle](#USER_UpgradeDBInstance.Oracle.Upgrading). Para ter destinos de atualização válidos, use o comando [describe-db-engine-versions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-engine-versions.html) da AWS CLI.
## Console
**Como atualizar a versão do mecanismo de uma instância de banco de dados do RDS para Oracle usando o console**
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, escolha **Databases (Bancos de dados)** e a instância de banco de dados que você deseja atualizar.
1. Selecione **Modify**.
1. Em **Versão do mecanismo de banco de dados**, escolha uma versão posterior do banco de dados.
1. Escolha **Continuar** e verifique o resumo de modificações. Entenda as implicações de uma atualização de versão de banco de dados. Não é possível converter uma instância de banco de dados atualizada na versão anterior. Antes de continuar, não se esqueça de testar o banco de dados e a aplicação com a nova versão.
1. Decida quando agendar a atualização da instância de banco de dados. Para aplicar as alterações imediatamente, escolha **Apply immediately**. Escolher essa opção pode causar uma interrupção em alguns casos. Para ter mais informações, consulte [Usar a configuração de programação de modificações](USER_ModifyInstance.ApplyImmediately.md).
1. Na página de confirmação, revise suas alterações. Se estiverem corretas, escolha **Modify DB Instance (Modificar instância de banco de dados)** para salvar suas alterações.
Como alternativa, escolha **Back (Voltar)** para editar suas alterações ou escolha **Cancel (Cancelar)** para cancelar as alterações.
## AWS CLI
Para atualizar a versão do mecanismo de uma instância de banco de dados do RDS para Oracle, use o comando [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) da CLI. Especifique os seguintes parâmetros:
+ `--db-instance-identifier`: o nome da instância de banco de dados do RDS para Oracle.
+ `--engine-version` – o número da versão do mecanismo de banco de dados para a qual será feita a atualização.
Para obter informações sobre versões de mecanismo válidas, use o comando AWS CLI [ describe-db-engine-versions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-engine-versions.html).
+ `--allow-major-version-upgrade`: para atualizar a versão do mecanismo de banco de dados.
+ `--no-apply-immediately` – para aplicar alterações durante a próxima janela de manutenção. Para aplicar as alterações imediatamente, use `--apply-immediately`.
**Example**
O exemplo a seguir atualiza uma instância do CDB denominada `myorainst` da versão atual de `19.0.0.0.ru-2024-01.rur-2024-01.r1` para a versão `21.0.0.0.ru-2024-04.rur-2024-04.r1`.
Para Linux, macOS ou Unix:
```
1. aws rds modify-db-instance \
2. --db-instance-identifier myorainst \
3. --engine-version 21.0.0.0.ru-2024-04.rur-2024-04.r1 \
4. --allow-major-version-upgrade \
5. --no-apply-immediately
```
Para Windows:
```
1. aws rds modify-db-instance ^
2. --db-instance-identifier myorainst ^
3. --engine-version 21.0.0.0.ru-2024-04.rur-2024-04.r1 ^
4. --allow-major-version-upgrade ^
5. --no-apply-immediately
```
## API do RDS
Para atualizar uma instância de banco de dados do RDS para Oracle, use a ação [ModifyDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html). Especifique os seguintes parâmetros:
+ `DBInstanceIdentifier` – o nome da instância de banco de dados. Por exemplo *`myorainst`*.
+ `EngineVersion` – o número da versão do mecanismo de banco de dados para a qual será feita a atualização. Para obter informações sobre versões de mecanismo válidas, use a operação [ DescribeDBEngineVersions](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBEngineVersions.html).
+ `AllowMajorVersionUpgrade` – para permitir ou não uma atualização de versão principal. Para isso, defina o valor como `true`.
+ `ApplyImmediately` – se desejar aplicar as alterações imediatamente ou durante a próxima janela de manutenção. Para aplicar as alterações imediatamente, defina o valor como `true`. Para aplicar alterações durante a próxima janela de manutenção, defina o valor como `false`.