

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 convertir una réplica de lectura de Valkey o Redis OSS (modo clúster desactivado) en la versión principal mediante la API Consola de administración de AWS AWS CLI, la o la ElastiCache API. No puede convertir una réplica de lectura en principal mientras Multi-AZ la conmutación por error automática esté habilitada en el grupo de replicación. Para convertir una réplica de Valkey o Redis OSS (modo clúster desactivado) a la posición principal en un grupo de replicación Multi-AZ habilitado, haga lo siguiente:

1. Modifique el grupo de replicación para deshabilitarlo Multi-AZ (para ello no es necesario 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 replicación para volver a habilitarlo. Multi-AZ

## 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 Consola de administración de AWS y abra la ElastiCache consola 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 desactivado) donde Multi-AZ está habilitado, modifique el grupo de replicación para deshabilitarlo 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 estaba Multi-AZ habilitado antes de iniciar el proceso de promoción, espere hasta que el estado del grupo de replicación esté ** disponible y, a continuación**, modifique el clúster para volver a habilitarlo. Multi-AZ Para obtener más información, consulte [Modificación de un grupo de reproducción](Replication.Modify.md).

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

No puede convertir una réplica de lectura en principal si el grupo de replicación está Multi-AZ habilitado. En algunos casos, la réplica que desea promover puede ser miembro de un grupo de replicación si Multi-AZ está habilitada. En estos casos, debe modificar el grupo de replicación para deshabilitarlo 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 AWS CLI comando modifica el grupo `sample-repl-group` de replicación y convierte a la réplica de lectura en `my-replica-1` la principal del grupo de replicació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 replicación, consulte [modify-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group.html) la referencia de línea de ElastiCache comandos de * Amazon. *

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

No puede convertir una réplica de lectura en principal si el grupo de replicación está Multi-AZ habilitado. En algunos casos, la réplica que desea promover puede ser miembro de un grupo de replicación si Multi-AZ está habilitada. En estos casos, debe modificar el grupo de replicación para deshabilitarlo 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 ElastiCache API modifica el grupo `myReplGroup` de replicación y convierte a la réplica de lectura en `myReplica-1` la principal del grupo de replicació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 replicación, consulte la referencia [ModifyReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroup.html) de la ElastiCache API de * Amazon. *