Reducción del número de réplicas de una partición - Amazon ElastiCache
Usando la Consola de administración de AWSUsando el AWS CLIUso de la API ElastiCache

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.

Reducción del número de réplicas de una partición

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 usar la Consola de administración de AWS, la AWS CLI o la ElastiCache API para reducir el número de réplicas en un grupo de nodos (fragmento) o grupo de replicaciones.

Usando la Consola de administración de AWS

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 Consola de administración de AWS y abra la ElastiCache consola en https://console.aws.amazon.com/elasticache/.

  2. 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.

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

  4. Elija Delete replicas (Eliminar réplicas).

  5. 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.

    2. 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 van a eliminar, ElastiCache Redis OSS seleccionará automáticamente los nodos de réplica para eliminarlos. Al hacerlo, en el caso de Redis, ElastiCache el OSS intenta conservar la arquitectura Multi-AZ para su grupo de replicación y, a continuación, conservar las réplicas con un retraso de replicación mínimo con respecto al 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.

Usando el AWS CLI

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. Si el valor de --new-replica-count no cumple este requisito, la llamada produce un error.

  • --replicas-to-remove: opcional. Contiene una lista de nodos que IDs especifica 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.

    • 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. 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 --replica-configuration se omite este miembro de, en el caso de Redis, ElastiCache OSS elige la zona de disponibilidad para cada una de las nuevas réplicas.

importante

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

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-countla Amazon ElastiCache Command Line Reference.

Uso de la API ElastiCache

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. Si el valor de --new-replica-count no cumple este requisito, la llamada produce un error.

  • ReplicasToRemove: opcional. Contiene una lista de nodos que IDs especifica 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.

    • 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 ReplicaConfiguration se omite este miembro de, en el caso de Redis, ElastiCache OSS elige la zona de disponibilidad para cada una de las nuevas réplicas.

importante

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

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 que utilizan la API, consulta la referencia DecreaseReplicaCountde la ElastiCache API de Amazon.