

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Promoción de una réplica de lectura a principal para grupos de replicación de Valkey o Redis OSS (modo de clúster deshabilitado)
<a name="Replication.PromoteReplica"></a>

La información del siguiente tema solo se aplica solo a los grupos de replicación de Valkey o Redis OSS (modo de clúster deshabilitado).

Puede promover una réplica de lectura de Valkey o Redis OSS (modo de clúster deshabilitado) a un nodo principal mediante la Consola de administración de AWS, la AWS CLI o la API de ElastiCache. No se puede promocionar una réplica de lectura a principal mientras estén habilitadas múltiples zonas de disponibilidad con conmutación por error automática en el grupo de replicación de . Para promocionar una réplica de Valkey o Redis OSS (modo de clúster deshabilitado) a nodo principal en un grupo de replicación con multi-AZ habilitado, realice lo siguiente:

1. Modifique el grupo de reproducción para deshabilitar las Multi-AZ (esto no requiere que todos los clústeres estén en la misma zona de disponibilidad). Para obtener más información, consulte [Modificación de un grupo de reproducción](Replication.Modify.md).

1. Promocione la réplica de lectura a principal.

1. Modifique el grupo de reproducción para volver a habilitar Multi-AZ.

Multi-AZ no está disponible en grupos de replicación que ejecutan Redis OSS 2.6.13 o versiones anteriores.

## Uso de Consola de administración de AWS
<a name="Replication.PromoteReplica.CON"></a>

El siguiente procedimiento utiliza la consola para promocionar un nodo de réplica a principal. 

**Para promocionar una réplica de lectura a nodo primario (consola)**

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

1. Si la réplica que desea promocionar es miembro de un grupo de replicación de Valkey o Redis OSS (modo de clúster deshabilitado) con multi-AZ habilitado, debe modificar dicho grupo para deshabilitar multi-AZ antes de continuar. Para obtener más información, consulte [Modificación de un grupo de reproducción](Replication.Modify.md).

1. Elija **Valkey** o **Redis OSS** y, a continuación, en la lista de clústeres, elija el grupo de replicación que desea modificar. Este grupo de reproducción debe ejecutar el motor "Redis", no el motor "Redis en clúster", y debe tener al menos dos nodos.

1. En la lista de nodos, elija el nodo de réplica que desea promocionar a principal y, a continuación, en **Actions (Acciones)**, elija **Promote (Promocionar)**.

1. En el cuadro de diálogo **Promote Read Replica (Promocionar réplica de lectura)**, haga lo siguiente:

   1. En **Apply Immediately (Aplicar inmediatamente)**, elija **Yes (Sí)** para promocionar la réplica de lectura inmediatamente, o **No** para promocionarla en el próximo periodo de mantenimiento del clúster.

   1. Elija **Promote** para promocionar la réplica de lectura o **Cancel** para cancelar la operación.

1. Si el clúster tenía Multi-AZ habilitadas antes de comenzar el proceso de promoción, espere hasta que el estado del grupo de reproducción sea **available (disponible)** y, a continuación, modifique el clúster para volver a habilitar las Multi-AZ. Para obtener más información, consulte [Modificación de un grupo de reproducción](Replication.Modify.md).

## Mediante AWS CLI
<a name="Replication.PromoteReplica.CLI"></a>

No puede promocionar una réplica de lectura a principal si el grupo de reproducción tiene Multi-AZ habilitadas. En algunos casos, la réplica que se desea promocionar puede ser miembro de un grupo de reproducción con Multi-AZ habilitadas. En estos casos, debe modificar el grupo de reproducción para deshabilitar la característica Multi-AZ antes de continuar. Esto no requiere que todos los clústeres estén en la misma zona de disponibilidad. Para obtener más información acerca de cómo modificar un grupo de reproducción, consulte [Modificación de un grupo de reproducción](Replication.Modify.md).

El siguiente comando de la AWS CLI modifica el grupo de reproducción `sample-repl-group`, lo que hace que la réplica `my-replica-1` sea la principal en el grupo de reproducción.

Para Linux, macOS o Unix:

```
aws elasticache modify-replication-group \
   --replication-group-id sample-repl-group \
   --primary-cluster-id my-replica-1
```

Para Windows:

```
aws elasticache modify-replication-group ^
   --replication-group-id sample-repl-group ^
   --primary-cluster-id my-replica-1
```

Para obtener más información sobre la modificación de un grupo de reproducción, consulte [modify-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group.html) en la *Referencia de línea de comandos de Amazon ElastiCache.*

## Uso de la API de ElastiCache
<a name="Replication.PromoteReplica.API"></a>

No puede promocionar una réplica de lectura a principal si el grupo de reproducción tiene Multi-AZ habilitadas. En algunos casos, la réplica que se desea promocionar puede ser miembro de un grupo de reproducción con Multi-AZ habilitadas. En estos casos, debe modificar el grupo de reproducción para deshabilitar la característica Multi-AZ antes de continuar. Esto no requiere que todos los clústeres estén en la misma zona de disponibilidad. Para obtener más información acerca de cómo modificar un grupo de reproducción, consulte [Modificación de un grupo de reproducción](Replication.Modify.md).

La siguiente acción de la API de ElastiCache modifica el grupo de reproducción `myReplGroup`, lo que hace que la réplica de lectura `myReplica-1` sea el primario en el grupo de reproducción.

```
https://elasticache.us-west-2.amazonaws.com/
   ?Action=ModifyReplicationGroup
   &ReplicationGroupId=myReplGroup
   &PrimaryClusterId=myReplica-1  
   &Version=2014-12-01
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20141201T220302Z
   &X-Amz-Algorithm=&AWS;4-HMAC-SHA256
   &X-Amz-Date=20141201T220302Z
   &X-Amz-SignedHeaders=Host
   &X-Amz-Expires=20141201T220302Z
   &X-Amz-Credential=<credential>
   &X-Amz-Signature=<signature>
```

Para obtener más información sobre la modificación de un grupo de reproducción, consulte [ModifyReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroup.html) en la *Referencia de la API de Amazon ElastiCache.*