# Conmutación por error de un clúster de base de datos de Amazon Aurora
<a name="aurora-failover"></a>

Puede realizar una conmutación por error manual de un clúster de base de datos Aurora, por ejemplo, cuando desee sustituir una instancia de base de datos de escritura aprovisionada por una instancia de escritor Aurora Serverless v2.

Aurora conmuta por error a una nueva instancia de base de datos principal de una de las dos formas siguientes:
+ Promocionando una instancia de base de datos de lectura existente como nueva instancia principal
+ Creando una nueva instancia principal

Si el clúster de base de datos tiene una o varias instancias de lectura, se promociona una lectura a instancia principal durante un evento de error. Para aumentar la disponibilidad de su clúster de base de datos, es recomendable que cree al menos una o varias instancias de lectura en dos o más zonas de disponibilidad diferentes. Para obtener información sobre el mecanismo de conmutación por error, consulte [Tolerancia a errores para un clúster de base de datos de Aurora](Concepts.AuroraHighAvailability.md#Aurora.Managing.FaultTolerance).

Puede usar la Consola de administración de AWS, la AWS CLI o la API de RDS para realizar una conmutación por error manual.

## Consola
<a name="aurora-failover.CON"></a>

**Conmutación por error de un clúster de base de datos**

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 **Bases de datos** y, a continuación, seleccione la instancia de base de datos en el clúster de base de datos donde desea realizar la conmutación por error.

1. En **Actions** (Acciones), elija **Failover** (conmutación por error).

   Aparece una página de confirmación.

1. Elija **Failover** (Conmutación por error).

   En la página **Bases de datos**, se puede ver que el estado del clúster de base de datos es **Conmutación por error**. El estado vuelve a **Disponible** cuando se completa la conmutación por error y se muestran los roles de las instancias de base de datos principales nuevas y anteriores.

## AWS CLI
<a name="aurora-failover.CLI"></a>

Para llevar a cabo una conmutación por error de un clúster de base de datos con la AWS CLI, llame al comando [failover-db-clúster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/failover-db-cluster.html). Especifique los siguientes parámetros:
+ `--db-cluster-identifier`: el clúster de base de datos que desea conmutar por error.
+ `--target-db-instance-identifier`: el nombre de la instancia de base de datos que se va a promocionar a instancia de base de datos principal.

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

```
aws rds failover-db-cluster \
    --db-cluster-identifier mydbcluster \
    --target-db-instance-identifier mydbcluster-instance-2
```
En:Windows  

```
aws rds failover-db-cluster ^
    --db-cluster-identifier mydbcluster ^
    --target-db-instance-identifier mydbcluster-instance-2
```

## API de RDS
<a name="aurora-failover.API"></a>

Para modificar un clúster de base de datos mediante la API de Amazon RDS, llame a la operación [FailoverDBclúster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_FailoverDBCluster.html). Especifique los siguientes parámetros:
+ DBclústerIdentifier
+ TargetDBInstanceIdentifier