Diminution du nombre de réplicas dans une partition - Amazon ElastiCache
En utilisant le AWS Management ConsoleEn utilisant le AWS CLIEn utilisant le ElastiCache API

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Diminution du nombre de réplicas dans une partition

Vous pouvez réduire le nombre de répliques dans une partition pour Valkey ou Redis OSS (mode cluster activé), ou dans un groupe de réplication pour Valkey ou Redis OSS (mode cluster désactivé) :

  • Pour Valkey ou Redis OSS (mode cluster désactivé), vous pouvez réduire le nombre de répliques à un si le mode multi-AZ est activé, et à zéro s'il n'est pas activé.

  • Pour Valkey ou Redis OSS (mode cluster activé), vous pouvez réduire le nombre de répliques à zéro. Cependant, vous ne pouvez pas basculer vers un réplica en cas d'échec du nœud principal.

Vous pouvez utiliser le AWS Management Console, le AWS CLI ou le ElastiCache API pour diminuer le nombre de répliques dans un groupe de nœuds (partition) ou un groupe de réplication.

En utilisant le AWS Management Console

La procédure suivante utilise la console pour diminuer le nombre de répliques dans un groupe de réplication Valkey ou Redis OSS (mode cluster activé).

Pour réduire le nombre de répliques dans une partition Valkey ou Redis OSS

  1. Connectez-vous à la ElastiCache console AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/elasticache/.

  2. Dans le volet de navigation, choisissez Valkey ou Redis OSS, puis le nom du groupe de réplication dont vous souhaitez supprimer les répliques.

  3. Cochez la case correspondant à chaque partition dont vous souhaitez supprimer un nœud de réplica.

  4. Choisissez Delete replicas (Supprimer des réplicas).

  5. Renseignez la page Delete Replicas from Shards (Supprimer des réplicas de partitions) :

    1. Dans New number of replicas/shard (Nouveau nombre de réplicas par partition), saisissez le nombre de réplicas que doivent avoir chacune des partitions sélectionnées. Cette valeur doit être supérieure ou égale à 1. Nous vous recommandons d'utiliser au moins deux réplicas par partition.

    2. Choisissez Delete (Supprimer) pour supprimer les réplicas ou Cancel (Annuler) pour annuler l'opération.

Important

  • Si vous ne spécifiez pas les nœuds de réplication à supprimer, ElastiCache (RedisOSS) sélectionne automatiquement les nœuds de réplication à supprimer. Ce faisant, ElastiCache (RedisOSS) essaie de conserver l'architecture multi-AZ de votre groupe de réplication, puis de conserver les répliques avec un délai de réplication minimal par rapport au principal.

  • Vous ne pouvez pas supprimer le nœud primaire ou le nœud maître dans un groupe de réplication. Si vous spécifiez un nœud principal afin qu'il soit supprimé, l'opération échoue et une erreur indique que le nœud principal a été sélectionné pour être supprimé.

En utilisant le AWS CLI

Pour réduire le nombre de répliques dans une partition Valkey ou RedisOSS, utilisez la decrease-replica-count commande avec les paramètres suivants :

  • --replication-group-id – Obligatoire. Identifie le groupe de réplication dans lequel vous souhaitez diminuer le nombre de réplicas.

  • --apply-immediately ou --no-apply-immediately : obligatoire. Spécifie si le nombre de réplicas doit être diminué immédiatement (--apply-immediately) ou lors du prochain créneau de maintenance (--no-apply-immediately). Actuellement, --no-apply-immediately n'est pas pris en charge.

  • --new-replica-count : facultatif. Spécifie le nombre de nœuds de réplica souhaité. La valeur de --new-replica-count doit être une valeur valide inférieure au nombre de réplicas actuel dans les groupes de nœuds. Pour consulter les valeurs minimum autorisées, consultez Diminution du nombre de réplicas dans une partition. Si la valeur de --new-replica-count ne répond pas à cette exigence, l'appel échoue.

  • --replicas-to-remove – Facultatif. Contient une liste de nœuds IDs spécifiant les nœuds répliques à supprimer.

  • --replica-configuration – Facultatif. Vous permet de définir le nombre de réplicas et de zones de disponibilité pour chaque groupe de nœuds indépendamment. Utilisez ce paramètre pour les groupes Valkey ou Redis OSS (mode cluster activé) dans lesquels vous souhaitez configurer chaque groupe de nœuds indépendamment.

    --replica-configuration comporte trois chiffre facultatifs :

    • NodeGroupId : ID de quatre chiffres pour le groupe de nœud que vous configurez. Pour les groupes de réplication Valkey ou Redis OSS (mode cluster désactivé), l'ID de partition est toujours. 0001 Pour trouver l'ID d'un groupe de nœuds OSS (partition) Valkey ou Redis (mode cluster activé), consultez. Recherche de l'ID d'une partition

    • NewReplicaCount : paramètre facultatif qui spécifie le nombre de nœuds de réplica souhaité. La valeur de NewReplicaCount doit être une valeur valide inférieure au nombre de réplicas actuel dans les groupes de nœuds. Pour consulter les valeurs minimum autorisées, consultez Diminution du nombre de réplicas dans une partition. Si la valeur de NewReplicaCount ne répond pas à cette exigence, l'appel échoue.

    • PreferredAvailabilityZones : liste de chaînes PreferredAvailabilityZone qui spécifie dans quelles zones de disponibilité les nœuds des groupes de réplication doivent se trouver. Le nombre de valeurs PreferredAvailabilityZone doit être égal à la valeur de NewReplicaCount plus 1 afin de prendre en compte le nœud principal. Si ce membre de --replica-configuration est omis, ElastiCache (RedisOSS) choisit la zone de disponibilité pour chacune des nouvelles répliques.

Important

Vous devez uniquement inclure l'un des paramètres suivants : --new-replica-count, --replicas-to-remove ou --replica-configuration.

L'exemple suivant utilise --new-replica-count pour abaisser à 1 le nombre de réplicas du groupe de réplication sample-repl-group. À la fin de cet exemple, il y a un réplica dans chaque groupe de nœuds. Ce numéro s'applique qu'il s'agisse d'un groupe Valkey ou Redis OSS (mode cluster désactivé) avec un seul groupe de nœuds ou d'un groupe Valkey ou Redis OSS (mode cluster activé) avec plusieurs groupes de nœuds.

Pour Linux, macOS ou Unix :

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

Pour Windows :

aws elasticache decrease-replica-count ^
    --replication-group-id sample-repl-group ^
    --new-replica-count 1 ^
    --apply-immediately

L'exemple suivant diminue le nombre de réplicas du groupe de réplication sample-repl-group en supprimant deux réplicas spécifiés (0001 et 0003) du groupe de nœuds.

Pour Linux, macOS ou Unix :

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

Pour Windows :

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

L'exemple suivant utilise --replica-configuration pour diminuer le nombre de réplicas du groupe de réplication sample-repl-group à la valeur spécifiée pour les deux groupes de nœuds spécifiés. Étant donné qu'il existe plusieurs groupes de nœuds, il s'agit d'un groupe de réplication Valkey ou Redis OSS (mode cluster activé). Lorsque vous spécifiez le paramètre PreferredAvailabilityZones facultatif, le nombre de zones de disponibilité indiqué doit correspondre à la valeur de NewReplicaCount plus 1. Cette approche prend en compte le nœud principal pour le groupe identifié par NodeGroupId.

Pour Linux, macOS ou 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

Pour 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

Pour plus d'informations sur la réduction du nombre de répliques à l'aide duCLI, consultez le decrease-replica-countmanuel Amazon ElastiCache Command Line Reference.

En utilisant le ElastiCache API

Pour réduire le nombre de répliques dans une partition Valkey ou RedisOSS, utilisez l'DecreaseReplicaCountaction avec les paramètres suivants :

  • ReplicationGroupId – Obligatoire. Identifie le groupe de réplication dans lequel vous souhaitez diminuer le nombre de réplicas.

  • ApplyImmediately : obligatoire. Spécifie si le nombre de réplicas doit être diminué immédiatement (ApplyImmediately=True) ou lors du prochain créneau de maintenance (ApplyImmediately=False). Actuellement, ApplyImmediately=False n'est pas pris en charge.

  • NewReplicaCount – Facultatif. Spécifie le nombre de nœuds de réplica souhaité. La valeur de NewReplicaCount doit être une valeur valide inférieure au nombre de réplicas actuel dans les groupes de nœuds. Pour consulter les valeurs minimum autorisées, consultez Diminution du nombre de réplicas dans une partition. Si la valeur de --new-replica-count ne répond pas à cette exigence, l'appel échoue.

  • ReplicasToRemove – Facultatif. Contient une liste de nœuds IDs spécifiant les nœuds répliques à supprimer.

  • ReplicaConfiguration – Facultatif. Contient une liste de groupes de nœuds qui vous permet de définir le nombre de réplicas et de zones de disponibilité pour chaque groupe de nœuds indépendamment. Utilisez ce paramètre pour les groupes Valkey ou Redis OSS (mode cluster activé) dans lesquels vous souhaitez configurer chaque groupe de nœuds indépendamment.

    ReplicaConfiguraion comporte trois chiffre facultatifs :

    • NodeGroupId : ID de quatre chiffres pour le groupe de nœud que vous configurez. Pour les groupes de réplication Valkey ou Redis OSS (mode cluster désactivé), l'ID du groupe de nœuds est toujours. 0001 Pour trouver l'ID d'un groupe de nœuds OSS (partition) Valkey ou Redis (mode cluster activé), consultez. Recherche de l'ID d'une partition

    • NewReplicaCount : nombre de réplicas que vous souhaitez dans ce groupe de nœuds à la fin de cette opération. La valeur doit être inférieure au nombre actuel de réplicas et être de 1 minimum si l'option Multi-AZ est activée, ou de 0 si cette option n'est pas activée. Si cette valeur n'est pas inférieure au nombre de réplicas actuel du groupe de nœuds, l'appel échoue avec une exception.

    • PreferredAvailabilityZones : liste de chaînes PreferredAvailabilityZone qui spécifie dans quelles zones de disponibilité les nœuds des groupes de réplication doivent se trouver. Le nombre de valeurs PreferredAvailabilityZone doit être égal à la valeur de NewReplicaCount plus 1 afin de prendre en compte le nœud principal. Si ce membre de ReplicaConfiguration est omis, ElastiCache (RedisOSS) choisit la zone de disponibilité pour chacune des nouvelles répliques.

Important

Vous devez uniquement inclure l'un des paramètres suivants : NewReplicaCount, ReplicasToRemove ou ReplicaConfiguration.

L'exemple suivant utilise NewReplicaCount pour abaisser à 1 le nombre de réplicas du groupe de réplication sample-repl-group. À la fin de cet exemple, il y a un réplica dans chaque groupe de nœuds. Ce numéro s'applique qu'il s'agisse d'un groupe Valkey ou Redis OSS (mode cluster désactivé) avec un seul groupe de nœuds ou d'un groupe Valkey ou Redis OSS (mode cluster activé) avec plusieurs groupes de nœuds.

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>

L'exemple suivant diminue le nombre de réplicas du groupe de réplication sample-repl-group en supprimant deux réplicas spécifiés (0001 et 0003) du groupe de nœuds.

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>

L'exemple suivant utilise ReplicaConfiguration pour diminuer le nombre de réplicas du groupe de réplication sample-repl-group à la valeur spécifiée pour les deux groupes de nœuds spécifiés. Étant donné qu'il existe plusieurs groupes de nœuds, il s'agit d'un groupe de réplication Valkey ou Redis OSS (mode cluster activé). Lorsque vous spécifiez le paramètre PreferredAvailabilityZones facultatif, le nombre de zones de disponibilité indiqué doit correspondre à la valeur de NewReplicaCount plus 1. Cette approche prend en compte le nœud principal pour le groupe identifié par 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>

Pour plus d'informations sur la réduction du nombre de répliques à l'aide duAPI, consultez DecreaseReplicaCountla ElastiCache APIréférence Amazon.