# Inicio de la conmutación de Oracle Data Guard
<a name="oracle-switchover.initiating"></a>

Puede cambiar una réplica de lectura de RDS para Oracle al rol principal y la anterior instancia de base de datos principal a un rol de réplica.

## Consola
<a name="USER_ReadRepl.Promote.Console"></a>

**Para cambiar una réplica de lectura de Oracle al rol de la base de datos principal**

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 la consola de Amazon RDS, seleccione **Databases (Bases de datos)**.

   Aparece el panel **Databases (Bases de datos)**. Cada réplica de lectura muestra **Replica (Réplica)** en la columna **Role (Rol)**.

1. Elija la réplica de lectura que desea cambiar al rol principal.

1. En **Actions** (Acciones), elija **Switch over replica** (Réplica de conmutación).

1. Elija **I acknowledge** (Confirmo). A continuación, elija **Switch over replica** (Réplica de conmutación).

1. En la página **Databases** (Bases de datos), supervise el progreso de la conmutación.  
![\[Supervise el progreso de la conmutación de Oracle Data Guard.\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/oracle-switchover-progress.png)

   Cuando se complete la conmutación, el rol del objetivo de la conmutación cambiará de **Replica** (Réplica) a **Primary** (Principal).  
![\[Las bases de datos de origen y de réplica cambian de rol.\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/UserGuide/images/oracle-switchover-complete.png)

## AWS CLI
<a name="USER_ReadRepl.Promote.CLI"></a>

Para cambiar una réplica de Oracle al rol de la base de datos principal, utilice el comando [https://docs.aws.amazon.com/cli/latest/reference/rds/switchover-read-replica.html](https://docs.aws.amazon.com/cli/latest/reference/rds/switchover-read-replica.html) de la AWS CLI. Los siguientes ejemplos hacen que la réplica de Oracle se llame *replica-to-be-made-primary* en la nueva base de datos principal.

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

```
aws rds switchover-read-replica \
    --db-instance-identifier replica-to-be-made-primary
```
En:Windows  

```
aws rds switchover-read-replica ^
    --db-instance-identifier replica-to-be-made-primary
```

## API de RDS
<a name="USER_ReadRepl.Promote.API"></a>

Para cambiar una réplica de Oracle al rol de base de datos principal, llame a la operación [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_SwitchoverReadReplica.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_SwitchoverReadReplica.html) de la API de Amazon RDS con el parámetro requerido `DBInstanceIdentifier`. Este parámetro especifica el nombre de la réplica de Oracle que desea que asuma el rol de base de datos principal.