# Actualización de la versión de una instancia de base de datos de RDS para Oracle
<a name="USER_UpgradeDBInstance.Oracle.Upgrading"></a>



Para actualizar manualmente la versión del motor de base de datos de una instancia de base de datos de RDS para Oracle, puede utilizar la Consola de administración de AWS, la AWS CLI o la API de RDS. Para obtener información general acerca de las actualizaciones de bases de datos, consulte [Actualización de la versión de una instancia de base de datos de RDS para Oracle](#USER_UpgradeDBInstance.Oracle.Upgrading). Para obtener objetivos de actualización válidos, utilice el comando [describe-db-engine-versions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-engine-versions.html) de la AWS CLI.

## Consola
<a name="USER_UpgradeDBInstance.Oracle.Upgrading.Manual.Console"></a>

**Actualización de la versión del motor de una instancia de base de datos de RDS para Oracle con la consola**

1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon RDS en [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. En el panel de navegación, elija **Databases (Bases de datos)** y, a continuación, elija la instancia de base de datos que desea actualizar. 

1. Elija **Modify**.

1. Para **la versión del motor de base de datos**, elija una versión de base de datos superior.

1. Elija **Continue** (Continuar) y consulte el resumen de las modificaciones. Asegúrese de entender las implicaciones de actualizar una versión de base de datos. No puede convertir una instancia de base de datos actualizada a la versión anterior. Asegúrese de haber probado la base de datos y la aplicación con la nueva versión antes de continuar. 

1. Decida cuándo programar la actualización de la instancia de base de datos. Para aplicar los cambios inmediatamente, elija **Apply immediately**. Si se selecciona esta opción, puede producirse una interrupción en algunos casos. Para obtener más información, consulte [Uso de la configuración de la programación de modificaciones](USER_ModifyInstance.ApplyImmediately.md). 

1. En la página de confirmación, revise los cambios. Si son correctos, elija **Modify DB instance (Modificar instancia de base de datos)** para guardar los cambios. 

   O bien, elija **Back** para editar los cambios o **Cancel** para cancelarlos. 

## AWS CLI
<a name="USER_UpgradeDBInstance.Oracle.Upgrading.Manual.CLI"></a>

Para actualizar la versión del motor de una instancia de base de datos de RDS para Oracle, puede utilizar el comando [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) de la CLI. Especifique los siguientes parámetros: 
+ `--db-instance-identifier`: el nombre de la instancia de base de datos de RDS para Oracle. 
+ `--engine-version`: número de versión del motor de base de datos al que se va a actualizar. 

  Para obtener información sobre versiones de motores válidas, utilice el comando [ describe-db-engine-versions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-engine-versions.html) de la AWS CLI.
+ `--allow-major-version-upgrade`: para actualizar la versión del motor de base de datos. 
+ `--no-apply-immediately`–: para aplicar los cambios en el siguiente periodo de mantenimiento. Para aplicar los cambios inmediatamente, use `--apply-immediately`. 

**Example**  
En el siguiente ejemplo, se actualiza una instancia de CDB nombrada `myorainst` de su versión actual de `19.0.0.0.ru-2024-01.rur-2024-01.r1` a la versión `21.0.0.0.ru-2024-04.rur-2024-04.r1`.  
Para Linux, macOS o 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 de RDS
<a name="USER_UpgradeDBInstance.Oracle.Upgrading.Manual.API"></a>

Para actualizar una instancia de base de datos de RDS para Oracle, utilice la acción [ModifyDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html). Especifique los siguientes parámetros: 
+ `DBInstanceIdentifier` – nombre de la instancia de base de datos, por ejemplo *`myorainst`*. 
+ `EngineVersion`: número de versión del motor de base de datos al que se va a actualizar. Para obtener información sobre versiones de motores válidas, utilice la operación [DescribeDBEngineVersions](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBEngineVersions.html).
+ `AllowMajorVersionUpgrade`: si se permite una actualización de versión principal. Para ello, defina el valor en `true`. 
+ `ApplyImmediately`: indica si se deben aplicar los cambios inmediatamente o en la siguiente ventana de mantenimiento. Para aplicar los cambios inmediatamente, establezca el valor en `true`. Para aplicar los cambios en el siguiente periodo de mantenimiento, establezca el valor en `false`.