

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.

# Cambio del número de réplicas
<a name="increase-decrease-replica-count"></a>

Puede aumentar o disminuir de forma dinámica el número de réplicas de lectura del grupo de replicación de Valkey o Redis OSS mediante la Consola de administración de AWS, la AWS CLI o la API de ElastiCache. Si el grupo de replicación es un grupo de replicación de Valkey o Redis OSS (modo de clúster habilitado), puede elegir en qué particiones (grupos de nodos) va a aumentar o disminuir el número de réplicas.

Para cambiar dinámicamente el número de réplicas del grupo de replicación, elija en la tabla siguiente la operación que mejor se ajuste a sus necesidades.


| Para hacer esto | Para Valkey o Redis OSS (modo de clúster habilitado) | Para Valkey o Redis OSS (modo de clúster deshabilitado) | 
| --- | --- | --- | 
|  Añadir réplicas  |  [Aumento del número de réplicas de una partición](increase-replica-count.md)  |  [Aumento del número de réplicas de una partición](increase-replica-count.md) [Adición de una réplica de lectura para Valkey o Redis OSS (modo de clúster deshabilitado)](Replication.AddReadReplica.md)  | 
|  Eliminar réplicas  |  [Reducción del número de réplicas de una partición](decrease-replica-count.md)  |  [Reducción del número de réplicas de una partición](decrease-replica-count.md) [Eliminación de una réplica de lectura para Valkey o Redis OSS (modo de clúster deshabilitado)](Replication.RemoveReadReplica.md)  | 

# Aumento del número de réplicas de una partición
<a name="increase-replica-count"></a>

Puede aumentar el número de réplicas en una partición de Valkey o Redis OSS (modo de clúster habilitado) o en un grupo de replicación de Valkey o Redis OSS (modo de clúster deshabilitado) hasta un máximo de cinco. Para ello, utilice la Consola de administración de AWS, la AWS CLI o la API de ElastiCache.

**Topics**
+ [Uso de Consola de administración de AWS](#increase-replica-count-con)
+ [Uso de AWS CLI](#increase-replica-count-cli)
+ [Uso de la API de ElastiCache](#increase-replica-count-api)

## Uso de Consola de administración de AWS
<a name="increase-replica-count-con"></a>

El siguiente procedimiento utiliza la consola para aumentar el número de réplicas de un grupo de replicación de Valkey o Redis OSS (modo de clúster habilitado).

**Aumento del número de réplicas en las particiones**

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. En el panel de navegación, elija **Valkey** o **Redis OSS** y, a continuación, elija el nombre del grupo de replicación al que desea añadir las réplicas.

1. Elija el cuadro correspondiente a cada fragmento al que desea agregar réplicas.

1. Elija **Add replicas (Agregar réplicas)**.

1. Complete la página **Add Replicas to Shards** (Agregar réplicas a las particiones):
   + En **New number of replicas/shard (Nuevo número de réplicas por partición)**, introduzca el número de réplicas que desea que tengan todos los fragmentos seleccionados. Este valor debe ser mayor o igual que **Current Number of Replicas per shard (Número actual de réplicas por fragmento)** y menor o igual que cinco. Recomendamos dos réplicas como mínimo.
   + En **Availability Zones** (Zonas de disponibilidad), elija **No preference** (Sin preferencia) a fin de que ElastiCache elija una zona de disponibilidad para cada réplica nueva, o **Specify Availability Zones** (Especificar las zonas de disponibilidad) si desea elegir una zona de disponibilidad para cada réplica nueva.

     Si elige **Specify Availability Zones (Especificar las zonas de disponibilidad)**, utilice la lista para especificar una zona de disponibilidad para cada réplica nueva.

1. Elija **Add** (Agregar) para agregar las réplicas o **Cancel** (Cancelar) para cancelar la operación.

## Uso de AWS CLI
<a name="increase-replica-count-cli"></a>

Para aumentar el número de réplicas de una partición de Valkey o Redis OSS, utilice el comando `increase-replica-count` con los parámetros siguientes:
+ `--replication-group-id`: obligatorio. Identifica el grupo de replicación en el que desea aumentar el número de réplicas.
+ `--apply-immediately` o `--no-apply-immediately`: obligatorios. Especifica si se debe aumentar el número de réplicas inmediatamente (`--apply-immediately`) o en el periodo de mantenimiento siguiente (`--no-apply-immediately`). Actualmente, no se admite `--no-apply-immediately`.
+ `--new-replica-count`: opcional. Especifica el número de nodos de réplica que se desea al terminar, hasta un máximo de cinco. Utilice este parámetro en los grupos de replicación de Valkey o Redis OSS (modo de clúster deshabilitado) en los que solo haya un grupo de nodos o un grupo de Valkey o Redis OSS (modo de clúster habilitado), o en aquellos en los que desee que todos los grupos de nodos tengan el mismo número de réplicas. Si este valor no es superior al número actual de réplicas del grupo de nodos, la llamada produce una excepción.
+ `--replica-configuration`: opcional. Le permite establecer el número de réplicas y de zonas de disponibilidad para cada grupo de nodos de forma independiente. Utilice este parámetro en los grupos de Valkey o Redis OSS (modo de clúster habilitado) en los que desee configurar cada grupo de nodos por separado. 

  `--replica-configuration` tiene tres miembros opcionales:
  + `NodeGroupId`: el ID de cuatro dígitos del grupo de nodos que está configurando. El ID de partición de los grupos de replicación de Valkey o Redis OSS (modo de clúster deshabilitado) es siempre `0001`. Para buscar un ID de un grupo de nodos (particiones) de Valkey o Redis OSS (modo de clúster habilitado), consulte [Búsqueda del ID de una partición](Shards.md#shard-find-id).
  + `NewReplicaCount`: el número de réplicas que desea incluir en este grupo de nodos al final de la operación. El valor debe ser superior al número actual de réplicas, hasta un máximo de cinco. Si este valor no es superior al número actual de réplicas del grupo de nodos, la llamada produce una excepción.
  + `PreferredAvailabilityZones`: una lista de cadenas `PreferredAvailabilityZone` que especifica en qué zonas de disponibilidad se encuentran los nodos del grupo de reproducción. El número de valores `PreferredAvailabilityZone` debe ser igual al valor de `NewReplicaCount` más 1 para incluir el nodo principal. Si se omite este miembro de `--replica-configuration`, ElastiCache para Redis OSS elegirá la zona de disponibilidad para cada una de las réplicas nuevas.

**importante**  
En la llamada, debe incluir el parámetro `--new-replica-count` o `--replica-configuration`, pero no ambos.

**Example**  
En el siguiente ejemplo, se aumenta el número de réplicas del grupo de reproducción `sample-repl-group` a tres. Al finalizar el ejemplo, existirán tres réplicas en cada grupo de nodos. Este número se aplica tanto si este es un grupo de Valkey o Redis OSS (modo de clúster deshabilitado) con un único grupo de nodos, como si es un grupo de Valkey o Redis OSS (modo de clúster habilitado) con varios grupos de nodos.  
Para Linux, macOS o Unix:  

```
aws elasticache increase-replica-count \
    --replication-group-id sample-repl-group \
    --new-replica-count 3 \
    --apply-immediately
```
Para Windows:  

```
aws elasticache increase-replica-count ^
    --replication-group-id sample-repl-group ^
    --new-replica-count 3 ^
    --apply-immediately
```
En el siguiente ejemplo, se aumenta el número de réplicas del grupo de replicación `sample-repl-group` al valor indicado para los dos grupos de nodos especificados. Dado que hay varios grupos de nodos, este es un grupo de replicación de Valkey o Redis OSS (modo de clúster habilitado). Al especificar el valor opcional `PreferredAvailabilityZones`, el número de zonas de disponibilidad indicadas debe ser igual al valor de `NewReplicaCount` más 1. Este enfoque incluye el nodo principal del grupo identificado por `NodeGroupId`.  
Para Linux, macOS o Unix:  

```
aws elasticache increase-replica-count \
    --replication-group-id sample-repl-group \
    --replica-configuration \
        NodeGroupId=0001,NewReplicaCount=2,PreferredAvailabilityZones=us-east-1a,us-east-1c,us-east-1b \
        NodeGroupId=0003,NewReplicaCount=3,PreferredAvailabilityZones=us-east-1a,us-east-1b,us-east-1c,us-east-1c \
    --apply-immediately
```
Para Windows:  

```
aws elasticache increase-replica-count ^
    --replication-group-id sample-repl-group ^
    --replica-configuration ^
        NodeGroupId=0001,NewReplicaCount=2,PreferredAvailabilityZones=us-east-1a,us-east-1c,us-east-1b ^
        NodeGroupId=0003,NewReplicaCount=3,PreferredAvailabilityZones=us-east-1a,us-east-1b,us-east-1c,us-east-1c \
    --apply-immediately
```

Para obtener más información sobre cómo aumentar el número de réplicas mediante la CLI, consulte [increase-replica-count](https://docs.aws.amazon.com/cli/latest/reference/elasticache/increase-replica-count.html) en la *Referencia de línea de comandos de Amazon ElastiCache.*

## Uso de la API de ElastiCache
<a name="increase-replica-count-api"></a>

Para aumentar el número de réplicas de una partición de Valkey o Redis OSS, utilice la acción `IncreaseReplicaCount` con los parámetros siguientes:
+ `ReplicationGroupId`: obligatorio. Identifica el grupo de replicación en el que desea aumentar el número de réplicas.
+ `ApplyImmediately`: obligatorio. Especifica si se debe aumentar el número de réplicas inmediatamente (`ApplyImmediately=True`) o en el periodo de mantenimiento siguiente (`ApplyImmediately=False`). Actualmente, no se admite `ApplyImmediately=False`.
+ `NewReplicaCount`: opcional. Especifica el número de nodos de réplica que se desea al terminar, hasta un máximo de cinco. Utilice este parámetro en los grupos de replicación de Valkey o Redis OSS (modo de clúster deshabilitado) en los que solo haya un grupo de nodos, o bien grupos de Valkey o Redis OSS (modo de clúster habilitado) en los que desee que todos los grupos de nodos tengan el mismo número de réplicas. Si este valor no es superior al número actual de réplicas del grupo de nodos, la llamada produce una excepción.
+ `ReplicaConfiguration`: opcional. Le permite establecer el número de réplicas y de zonas de disponibilidad para cada grupo de nodos de forma independiente. Utilice este parámetro en los grupos de Valkey o Redis OSS (modo de clúster habilitado) en los que desee configurar cada grupo de nodos por separado. 

  `ReplicaConfiguraion` tiene tres miembros opcionales:
  + `NodeGroupId`: el ID de cuatro dígitos del grupo de nodos que está configurando. Para grupos de replicación de Valkey o Redis OSS (modo de clúster deshabilitado), el ID del grupo de nodos (partición) siempre es `0001`. Para buscar un ID de un grupo de nodos (particiones) de Valkey o Redis OSS (modo de clúster habilitado), consulte [Búsqueda del ID de una partición](Shards.md#shard-find-id).
  + `NewReplicaCount`: el número de réplicas que desea incluir en este grupo de nodos al final de la operación. El valor debe ser superior al número actual de réplicas, hasta un máximo de cinco. Si este valor no es superior al número actual de réplicas del grupo de nodos, la llamada produce una excepción.
  + `PreferredAvailabilityZones`: una lista de cadenas `PreferredAvailabilityZone` que especifica en qué zonas de disponibilidad se encuentran los nodos del grupo de reproducción. El número de valores `PreferredAvailabilityZone` debe ser igual al valor de `NewReplicaCount` más 1 para incluir el nodo principal. Si se omite este miembro de `ReplicaConfiguration`, ElastiCache para Redis OSS elegirá la zona de disponibilidad para cada una de las réplicas nuevas.

**importante**  
En la llamada, debe incluir el parámetro `NewReplicaCount` o `ReplicaConfiguration`, pero no ambos.

**Example**  
En el siguiente ejemplo, se aumenta el número de réplicas del grupo de reproducción `sample-repl-group` a tres. Al finalizar el ejemplo, existirán tres réplicas en cada grupo de nodos. Este número se aplica tanto si este es un grupo de Valkey o Redis OSS (modo de clúster deshabilitado) con un único grupo de nodos, como si es un grupo de Valkey o Redis OSS (modo de clúster habilitado) con varios grupos de nodos.  

```
https://elasticache.us-west-2.amazonaws.com/
      ?Action=IncreaseReplicaCount
      &ApplyImmediately=True
      &NewReplicaCount=3
      &ReplicationGroupId=sample-repl-group
      &Version=2015-02-02
      &SignatureVersion=4
      &SignatureMethod=HmacSHA256
      &Timestamp=20150202T192317Z
      &X-Amz-Credential=<credential>
```
En el siguiente ejemplo, se aumenta el número de réplicas del grupo de replicación `sample-repl-group` al valor indicado para los dos grupos de nodos especificados. Dado que hay varios grupos de nodos, este es un grupo de replicación de Valkey o Redis OSS (modo de clúster habilitado). Al especificar el valor opcional `PreferredAvailabilityZones`, el número de zonas de disponibilidad indicadas debe ser igual al valor de `NewReplicaCount` más 1. Este enfoque incluye el nodo principal del grupo identificado por `NodeGroupId`.  

```
https://elasticache.us-west-2.amazonaws.com/
      ?Action=IncreaseReplicaCount
      &ApplyImmediately=True
      &ReplicaConfiguration.ConfigureShard.1.NodeGroupId=0001
      &ReplicaConfiguration.ConfigureShard.1.NewReplicaCount=2
      &ReplicaConfiguration.ConfigureShard.1.PreferredAvailabilityZones.PreferredAvailabilityZone.1=us-east-1a
      &ReplicaConfiguration.ConfigureShard.1.PreferredAvailabilityZones.PreferredAvailabilityZone.2=us-east-1c
      &ReplicaConfiguration.ConfigureShard.1.PreferredAvailabilityZones.PreferredAvailabilityZone.3=us-east-1b
      &ReplicaConfiguration.ConfigureShard.2.NodeGroupId=0003
      &ReplicaConfiguration.ConfigureShard.2.NewReplicaCount=3
      &ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.1=us-east-1a
      &ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.2=us-east-1b
      &ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.3=us-east-1c
      &ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.4=us-east-1c
      &ReplicationGroupId=sample-repl-group
      &Version=2015-02-02
      &SignatureVersion=4
      &SignatureMethod=HmacSHA256
      &Timestamp=20150202T192317Z
      &X-Amz-Credential=<credential>
```

Para obtener más información sobre cómo aumentar el número de réplicas mediante la API, consulte [IncreaseReplicaCount](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_IncreaseReplicaCount.html) en la *Referencia de la API de Amazon ElastiCache.*

# Reducción del número de réplicas de una partición
<a name="decrease-replica-count"></a>

Puede reducir el número de réplicas de una partición de Valkey o Redis OSS (modo de clúster habilitado) o en un grupo de replicación de Valkey o Redis OSS (modo de clúster deshabilitado):
+ En Valkey o Redis OSS (modo de clúster deshabilitado), puede reducir el número de réplicas a una si multi-AZ se encuentra habilitado, y a cero, si multi-AZ no se encuentra habilitado.
+ En Valkey o Redis OSS (modo de clúster habilitado), puede reducir el número de réplicas a cero. Sin embargo, no es posible realizar la conmutación por error a una réplica si se produce un error en el nodo principal.

Puede utilizar la Consola de administración de AWS, la AWS CLI o la API de ElastiCache para reducir el número de réplicas de un grupo de nodos (partición) o un grupo de reproducción.

**Topics**
+ [Uso de Consola de administración de AWS](#decrease-replica-count-con)
+ [Uso de AWS CLI](#decrease-replica-count-cli)
+ [Uso de la API de ElastiCache](#decrease-replica-count-api)

## Uso de Consola de administración de AWS
<a name="decrease-replica-count-con"></a>

El siguiente procedimiento utiliza la consola para reducir el número de réplicas de un grupo de replicación de Valkey o Redis OSS (modo de clúster habilitado).

**Reducción del número de réplicas en una partición de Valkey o Redis OSS**

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. En el panel de navegación, elija **Valkey** o **Redis OSS** y, a continuación, elija el nombre del grupo de replicación del que desea eliminar las réplicas.

1. Elija el cuadro correspondiente a cada fragmento del que desea eliminar un nodo de réplica.

1. Elija **Delete replicas (Eliminar réplicas)**.

1. Complete la página **Delete Replicas from Shards (Eliminar réplicas de particiones)**:

   1. En **New number of replicas/shard (Nuevo número de réplicas por partición)**, introduzca el número de réplicas que desea que tengan los fragmentos seleccionados. Este número debe ser mayor o igual que 1. Recomendamos dos réplicas por fragmento como mínimo.

   1. Elija **Delete (Eliminar)** para eliminar las réplicas o **Cancel (Cancelar)** para cancelar la operación.

**importante**  
Si no especifica los nodos de réplica que se deben eliminar, ElastiCache para Redis OSS los seleccionará de forma automática para eliminarlos. Al hacerlo, ElastiCache para Redis OSS intenta retener la arquitectura de Multi-AZ para el grupo de replicación y mantener las réplicas con un mínimo retraso de replicación con el nodo principal.
No puede eliminar los nodos primarios o el nodo primario de un grupo de reproducción. Si especifica la eliminación del nodo principal, la operación producirá un error con un evento que indica que el nodo principal se ha seleccionado para su eliminación. 

## Uso de AWS CLI
<a name="decrease-replica-count-cli"></a>

Para reducir el número de réplicas de una partición de Valkey o Redis OSS, utilice el comando `decrease-replica-count` con los parámetros siguientes:
+ `--replication-group-id`: obligatorio. Identifica el grupo de replicación en el que se desea reducir el número de réplicas.
+ `--apply-immediately` o `--no-apply-immediately`: obligatorios. Especifica si se debe reducir el número de réplicas inmediatamente (`--apply-immediately`) o en el periodo de mantenimiento siguiente (`--no-apply-immediately`). Actualmente, no se admite `--no-apply-immediately`.
+ `--new-replica-count`: opcional. Especifica el número de nodos de réplica que se desean. El valor de `--new-replica-count` debe ser un valor válido inferior al número actual de réplicas de los grupos de nodos. Para conocer los valores mínimos permitidos, consulte [Reducción del número de réplicas de una partición](#decrease-replica-count). Si el valor de `--new-replica-count` no cumple este requisito, la llamada produce un error.
+ `--replicas-to-remove`: opcional. Contiene una lista de los ID de nodo que especifican los nodos de réplica que se van a eliminar.
+ `--replica-configuration`: opcional. Le permite establecer el número de réplicas y de zonas de disponibilidad para cada grupo de nodos de forma independiente. Utilice este parámetro en los grupos de Valkey o Redis OSS (modo de clúster habilitado) en los que desee configurar cada grupo de nodos por separado. 

  `--replica-configuration` tiene tres miembros opcionales:
  + `NodeGroupId`: el ID de cuatro dígitos del grupo de nodos que está configurando. El ID de partición de los grupos de replicación de Valkey o Redis OSS (modo de clúster deshabilitado) es siempre `0001`. Para buscar un ID de un grupo de nodos (particiones) de Valkey o Redis OSS (modo de clúster habilitado), consulte [Búsqueda del ID de una partición](Shards.md#shard-find-id).
  + `NewReplicaCount`: un parámetro opcional que especifica el número de nodos de réplica que desea. El valor de `NewReplicaCount` debe ser un valor válido inferior al número actual de réplicas de los grupos de nodos. Para conocer los valores mínimos permitidos, consulte [Reducción del número de réplicas de una partición](#decrease-replica-count). Si el valor de `NewReplicaCount` no cumple este requisito, la llamada produce un error.
  + `PreferredAvailabilityZones`: una lista de cadenas `PreferredAvailabilityZone` que especifica en qué zonas de disponibilidad se encuentran los nodos del grupo de reproducción. El número de valores `PreferredAvailabilityZone` debe ser igual al valor de `NewReplicaCount` más 1 para incluir el nodo principal. Si se omite este miembro de `--replica-configuration`, ElastiCache para Redis OSS elegirá la zona de disponibilidad para cada una de las réplicas nuevas.

**importante**  
Debe incluir únicamente uno de los parámetros `--new-replica-count`, `--replicas-to-remove` o `--replica-configuration`.

**Example**  
En el siguiente ejemplo, se utiliza `--new-replica-count` para reducir el número de réplicas del grupo de reproducción `sample-repl-group` a una. Al finalizar el ejemplo, existirá una réplica en cada grupo de nodos. Este número se aplica tanto si este es un grupo de Valkey o Redis OSS (modo de clúster deshabilitado) con un único grupo de nodos, como si es un grupo de Valkey o Redis OSS (modo de clúster habilitado) con varios grupos de nodos.  
Para Linux, macOS o Unix:  

```
aws elasticache decrease-replica-count
    --replication-group-id sample-repl-group \
    --new-replica-count 1 \
    --apply-immediately
```
Para Windows:  

```
aws elasticache decrease-replica-count ^
    --replication-group-id sample-repl-group ^
    --new-replica-count 1 ^
    --apply-immediately
```
En el siguiente ejemplo, se reduce el número de réplicas del grupo de reproducción `sample-repl-group` eliminando dos réplicas especificadas (`0001` y `0003`) del grupo de nodos.  
Para Linux, macOS o Unix:  

```
aws elasticache decrease-replica-count \
    --replication-group-id sample-repl-group \
    --replicas-to-remove 0001,0003 \
    --apply-immediately
```
Para Windows:  

```
aws elasticache decrease-replica-count ^
    --replication-group-id sample-repl-group ^
    --replicas-to-remove 0001,0003 \
    --apply-immediately
```
En el siguiente ejemplo, se utiliza `--replica-configuration` para reducir el número de réplicas del grupo de reproducción `sample-repl-group` al valor indicado para los dos grupos de nodos especificados. Dado que hay varios grupos de nodos, este es un grupo de replicación de Valkey o Redis OSS (modo de clúster habilitado). Al especificar el valor opcional `PreferredAvailabilityZones`, el número de zonas de disponibilidad indicadas debe ser igual al valor de `NewReplicaCount` más 1. Este enfoque incluye el nodo principal del grupo identificado por `NodeGroupId`.  
Para Linux, macOS o Unix:  

```
aws elasticache decrease-replica-count \
    --replication-group-id sample-repl-group \
    --replica-configuration \
        NodeGroupId=0001,NewReplicaCount=1,PreferredAvailabilityZones=us-east-1a,us-east-1c \
        NodeGroupId=0003,NewReplicaCount=2,PreferredAvailabilityZones=us-east-1a,us-east-1b,us-east-1c \
    --apply-immediately
```
Para Windows:  

```
aws elasticache decrease-replica-count ^
    --replication-group-id sample-repl-group ^
    --replica-configuration ^
        NodeGroupId=0001,NewReplicaCount=2,PreferredAvailabilityZones=us-east-1a,us-east-1c ^
        NodeGroupId=0003,NewReplicaCount=3,PreferredAvailabilityZones=us-east-1a,us-east-1b,us-east-1c \
    --apply-immediately
```

Para obtener más información sobre cómo reducir el número de réplicas mediante la CLI, consulte [decrease-replica-count](https://docs.aws.amazon.com/cli/latest/reference/elasticache/decrease-replica-count.html) en la *Referencia de línea de comandos de Amazon ElastiCache.*

## Uso de la API de ElastiCache
<a name="decrease-replica-count-api"></a>

Para reducir el número de réplicas de una partición de Valkey o Redis OSS, utilice la acción `DecreaseReplicaCount` con los parámetros siguientes:
+ `ReplicationGroupId`: obligatorio. Identifica el grupo de replicación en el que se desea reducir el número de réplicas.
+ `ApplyImmediately`: obligatorio. Especifica si se debe reducir el número de réplicas inmediatamente (`ApplyImmediately=True`) o en el periodo de mantenimiento siguiente (`ApplyImmediately=False`). Actualmente, no se admite `ApplyImmediately=False`.
+ `NewReplicaCount`: opcional. Especifica el número de nodos de réplica que se desean. El valor de `NewReplicaCount` debe ser un valor válido inferior al número actual de réplicas de los grupos de nodos. Para conocer los valores mínimos permitidos, consulte [Reducción del número de réplicas de una partición](#decrease-replica-count). Si el valor de `--new-replica-count` no cumple este requisito, la llamada produce un error.
+ `ReplicasToRemove`: opcional. Contiene una lista de los ID de nodo que especifican los nodos de réplica que se van a eliminar.
+ `ReplicaConfiguration`: opcional. Contiene una lista de grupos de nodos que permite establecer el número de réplicas y de zonas de disponibilidad para cada grupo de nodos de forma independiente. Utilice este parámetro en los grupos de Valkey o Redis OSS (modo de clúster habilitado) en los que desee configurar cada grupo de nodos por separado. 

  `ReplicaConfiguraion` tiene tres miembros opcionales:
  + `NodeGroupId`: el ID de cuatro dígitos del grupo de nodos que está configurando. Para grupos de replicación de Valkey o Redis OSS (modo de clúster deshabilitado), el ID del grupo de nodos siempre es `0001`. Para buscar un ID de un grupo de nodos (particiones) de Valkey o Redis OSS (modo de clúster habilitado), consulte [Búsqueda del ID de una partición](Shards.md#shard-find-id).
  + `NewReplicaCount`: el número de réplicas que desea incluir en este grupo de nodos al final de la operación. El valor debe ser inferior al número actual de réplicas hasta un mínimo de 1 si se ha habilitado Multi-AZ o de 0 si Multi-AZ con conmutación por error automática no está habilitado. Si este valor no es menor que el número actual de réplicas del grupo de nodos, la llamada produce una excepción.
  + `PreferredAvailabilityZones`: una lista de cadenas `PreferredAvailabilityZone` que especifica en qué zonas de disponibilidad se encuentran los nodos del grupo de reproducción. El número de valores `PreferredAvailabilityZone` debe ser igual al valor de `NewReplicaCount` más 1 para incluir el nodo principal. Si se omite este miembro de `ReplicaConfiguration`, ElastiCache para Redis OSS elegirá la zona de disponibilidad para cada una de las réplicas nuevas.

**importante**  
Debe incluir únicamente uno de los parámetros `NewReplicaCount`, `ReplicasToRemove` o `ReplicaConfiguration`.

**Example**  
En el siguiente ejemplo, se utiliza `NewReplicaCount` para reducir el número de réplicas del grupo de reproducción `sample-repl-group` a una. Al finalizar el ejemplo, existirá una réplica en cada grupo de nodos. Este número se aplica tanto si este es un grupo de Valkey o Redis OSS (modo de clúster deshabilitado) con un único grupo de nodos, como si es un grupo de Valkey o Redis OSS (modo de clúster habilitado) con varios grupos de nodos.  

```
https://elasticache.us-west-2.amazonaws.com/
      ?Action=DecreaseReplicaCount
      &ApplyImmediately=True
      &NewReplicaCount=1
      &ReplicationGroupId=sample-repl-group
      &Version=2015-02-02
      &SignatureVersion=4
      &SignatureMethod=HmacSHA256
      &Timestamp=20150202T192317Z
      &X-Amz-Credential=<credential>
```
En el siguiente ejemplo, se reduce el número de réplicas del grupo de reproducción `sample-repl-group` eliminando dos réplicas especificadas (`0001` y `0003`) del grupo de nodos.  

```
https://elasticache.us-west-2.amazonaws.com/
      ?Action=DecreaseReplicaCount
      &ApplyImmediately=True
      &ReplicasToRemove.ReplicaToRemove.1=0001
      &ReplicasToRemove.ReplicaToRemove.2=0003
      &ReplicationGroupId=sample-repl-group
      &Version=2015-02-02
      &SignatureVersion=4
      &SignatureMethod=HmacSHA256
      &Timestamp=20150202T192317Z
      &X-Amz-Credential=<credential>
```
En el siguiente ejemplo, se utiliza `ReplicaConfiguration` para reducir el número de réplicas del grupo de reproducción `sample-repl-group` al valor indicado para los dos grupos de nodos especificados. Dado que hay varios grupos de nodos, este es un grupo de replicación de Valkey o Redis OSS (modo de clúster habilitado). Al especificar el valor opcional `PreferredAvailabilityZones`, el número de zonas de disponibilidad indicadas debe ser igual al valor de `NewReplicaCount` más 1. Este enfoque incluye el nodo principal del grupo identificado por `NodeGroupId`.  

```
https://elasticache.us-west-2.amazonaws.com/
      ?Action=DecreaseReplicaCount
      &ApplyImmediately=True
      &ReplicaConfiguration.ConfigureShard.1.NodeGroupId=0001
      &ReplicaConfiguration.ConfigureShard.1.NewReplicaCount=1
      &ReplicaConfiguration.ConfigureShard.1.PreferredAvailabilityZones.PreferredAvailabilityZone.1=us-east-1a
      &ReplicaConfiguration.ConfigureShard.1.PreferredAvailabilityZones.PreferredAvailabilityZone.2=us-east-1c
      &ReplicaConfiguration.ConfigureShard.2.NodeGroupId=0003
      &ReplicaConfiguration.ConfigureShard.2.NewReplicaCount=2
      &ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.1=us-east-1a
      &ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.2=us-east-1b
      &ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.4=us-east-1c
      &ReplicationGroupId=sample-repl-group
      &Version=2015-02-02
      &SignatureVersion=4
      &SignatureMethod=HmacSHA256
      &Timestamp=20150202T192317Z
      &X-Amz-Credential=<credential>
```

Para obtener más información sobre cómo reducir el número de réplicas mediante la API, consulte [DecreaseReplicaCount](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DecreaseReplicaCount.html) en la Referencia de la API de Amazon ElastiCache*.*

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

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

A medida que aumentan las operaciones de lectura, es recomendable que las distribuya entre más nodos para reducir así la presión de lectura en estos. En este tema, aprenderá a añadir una réplica de lectura a un clúster de Valkey o Redis OSS (modo de clúster deshabilitado). 

Un grupo de replicación de Valkey o Redis OSS (modo de clúster deshabilitado) puede tener un máximo de cinco réplicas de lectura. Si intenta agregar una réplica de lectura a un grupo de reproducción que ya tenga cinco réplicas de lectura, la operación produce un error.

Para obtener más información sobre la adición de réplicas a un grupo de replicación de Valkey o Redis OSS (modo de clúster habilitado), consulte los siguientes temas:
+ [Escalado de clústeres de Valkey o Redis OSS (modo de clúster habilitado)](scaling-redis-cluster-mode-enabled.md)
+ [Aumento del número de réplicas de una partición](increase-replica-count.md)

Puede añadir una réplica de lectura a un clúster de Valkey o Redis OSS (modo de clúster deshabilitado) mediante la consola de ElastiCache, la AWS CLI o la API de ElastiCache.

**Temas relacionados**
+ [Añadir nodos a un ElastiCache clúster](Clusters.AddNode.md)
+ [Adición de una réplica de lectura a un grupo de reproducción (AWS CLI)](#Replication.AddReadReplica.CLI)
+ [Adición de una réplica de lectura a un grupo de reproducción mediante la API](#Replication.AddReadReplica.API)

## Adición de una réplica de lectura a un grupo de reproducción (AWS CLI)
<a name="Replication.AddReadReplica.CLI"></a>

Para añadir una réplica de lectura a un grupo de replicación de Valkey o Redis OSS (modo de clúster deshabilitado), utilice el comando `create-cache-cluster` de la AWS CLI, con el parámetro `--replication-group-id` para especificar a qué grupo de replicación añadir el clúster (nodo).

El siguiente ejemplo crea el clúster `my-read replica` y lo añade al grupo de replicación `my-replication-group`. Los tipos de nodos, grupos de parámetros, grupos de seguridad, periodos de mantenimiento y otros ajustes de la réplica de lectura serán los mismos que los de los demás nodos de `my-replication-group`. 

Para Linux, macOS o Unix:

```
aws elasticache create-cache-cluster \
      --cache-cluster-id my-read-replica \
      --replication-group-id my-replication-group
```

Para Windows:

```
aws elasticache create-cache-cluster ^
      --cache-cluster-id my-read-replica ^
      --replication-group-id my-replication-group
```

Para obtener más información sobre cómo agregar una réplica de lectura mediante la CLI, consulte [create-cache-cluster](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-cache-cluster.html) en la *Referencia de línea de comandos de Amazon ElastiCache.*

## Adición de una réplica de lectura a un grupo de reproducción mediante la API
<a name="Replication.AddReadReplica.API"></a>

Para añadir una réplica de lectura a un grupo de replicación de Valkey o Redis OSS (modo de clúster deshabilitado), utilice la operación `CreateCacheCluster` de ElastiCache, con el parámetro `ReplicationGroupId` para especificar a qué grupo de replicación añadir el clúster (nodo).

El siguiente ejemplo crea el clúster `myReadReplica` y lo añade al grupo de replicación `myReplicationGroup`. Los tipos de nodos, grupos de parámetros, grupos de seguridad, periodos de mantenimiento y otros ajustes de la réplica de lectura serán los mismos que los de los demás nodos de `myReplicationGroup`.

```
https://elasticache.us-west-2.amazonaws.com/
      ?Action=CreateCacheCluster
      &CacheClusterId=myReadReplica
      &ReplicationGroupId=myReplicationGroup
      &Version=2015-02-02
      &SignatureVersion=4
      &SignatureMethod=HmacSHA256
      &Timestamp=20150202T192317Z
      &X-Amz-Credential=<credential>
```

Para obtener más información sobre cómo agregar una réplica de lectura mediante la API, consulte [CreateCacheCluster](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateCacheCluster.html) en la *Referencia de la API de Amazon ElastiCache.*

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

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

A medida que el tráfico del grupo de replicación de Valkey o Redis OSS cambie, puede que desee añadir o eliminar réplicas de lectura. Eliminar un nodo de un grupo de replicación de es igual que eliminar un clúster, aunque existen algunas restricciones:
+ No puede eliminar el nodo principal de un grupo de reproducción. Si desea eliminar el nodo principal, haga lo siguiente:

  1. Promocione una réplica de lectura a principal. Para obtener más información acerca de cómo promocionar una réplica de lectura a principal, consulte [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)](Replication.PromoteReplica.md).

  1. Elimine el principal anterior. Consulte el siguiente punto para conocer una restricción de este método.
+ Si se ha habilitado Multi-AZ en un grupo de reproducción, no se puede eliminar la última réplica de lectura del grupo de reproducción. En este caso, haga lo siguiente:

  1. Modifique el grupo de reproducción deshabilitando las Multi-AZ. Para obtener más información, consulte [Modificación de un grupo de reproducción](Replication.Modify.md).

  1. Elimine la réplica de lectura.

Puede eliminar una réplica de lectura de un grupo de replicación de Valkey o Redis OSS (modo de clúster deshabilitado) mediante la consola de ElastiCache, la AWS CLI para ElastiCache o la API de ElastiCache.

Para obtener más información sobre cómo eliminar un clúster de un grupo de replicación de Valkey o Redis OSS, consulte los temas siguientes:
+ [Usando el Consola de administración de AWS](Clusters.Delete.md#Clusters.Delete.CON)
+ [Utilización de AWS CLI para eliminar un ElastiCache clúster](Clusters.Delete.md#Clusters.Delete.CLI)
+ [Uso de la ElastiCache API](Clusters.Delete.md#Clusters.Delete.API)
+ [Escalado de clústeres de Valkey o Redis OSS (modo de clúster habilitado)](scaling-redis-cluster-mode-enabled.md)
+ [Reducción del número de réplicas de una partición](decrease-replica-count.md)