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. # Modification du nombre de réplicas Vous pouvez augmenter ou diminuer dynamiquement le nombre de répliques de lecture dans votre groupe de réplication Valkey ou Redis OSS à l'aide de l'API AWS Management Console, de ou de l' AWS CLI API. ElastiCache Si votre groupe de réplication est un groupe de réplication Valkey ou Redis OSS (mode cluster activé), vous pouvez choisir les partitions (groupes de nœuds) pour augmenter ou diminuer le nombre de répliques. Pour modifier dynamiquement le nombre de répliques dans votre groupe de réplication, choisissez l'opération adaptée à votre situation dans le tableau suivant. | Pour ce faire | Pour Valkey ou Redis OSS (mode cluster activé) | Pour Valkey ou Redis OSS (mode cluster désactivé) | | --- | --- | --- | | Ajouter des réplicas | [Augmentation du nombre de réplicas dans une partition](increase-replica-count.md) | [Augmentation du nombre de réplicas dans une partition](increase-replica-count.md) [Ajouter une réplique de lecture pour Valkey ou Redis OSS (mode cluster désactivé)](Replication.AddReadReplica.md) | | Supprimer des réplicas | [Diminution du nombre de réplicas dans une partition](decrease-replica-count.md) | [Diminution du nombre de réplicas dans une partition](decrease-replica-count.md) [Suppression d'une réplique de lecture pour Valkey ou Redis OSS (mode cluster désactivé)](Replication.RemoveReadReplica.md) | # Augmentation du nombre de réplicas dans une partition Vous pouvez augmenter le nombre de répliques dans une partition Valkey ou Redis OSS (mode cluster activé) ou dans un groupe de réplication Valkey ou Redis OSS (mode cluster désactivé) jusqu'à un maximum de cinq. Vous pouvez le faire à l'aide de AWS Management Console, de AWS CLI, ou de l' ElastiCache API. **Topics** + [À l'aide du AWS Management Console](#increase-replica-count-con) + [À l'aide du AWS CLI](#increase-replica-count-cli) + [Utilisation de l' ElastiCache API](#increase-replica-count-api) ## À l'aide du AWS Management Console La procédure suivante utilise la console pour augmenter le nombre de répliques dans un groupe de réplication Valkey ou Redis OSS (mode cluster activé). **Pour augmenter le nombre de répliques dans les partitions** 1. Connectez-vous à la ElastiCache console AWS Management Console et ouvrez-la à l'adresse [ https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/). 1. Dans le volet de navigation, choisissez **Valkey** ou **Redis OSS**, puis choisissez le nom du groupe de réplication auquel vous souhaitez ajouter des répliques. 1. Cochez la case correspondant à chaque partition à laquelle vous souhaitez ajouter des réplicas. 1. Choisissez **Add replicas (Ajouter des réplicas)**. 1. Renseignez la page **Add Replicas to Shards (Ajouter des réplicas à des partitions)** : + 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 à la valeur de **Current Number of Replicas per shard (Nombre actuel de réplicas par partition)**, et inférieure ou égale à cinq. Nous vous recommandons d'utiliser au moins deux réplicas. + Pour les **zones de disponibilité**, sélectionnez **Aucune préférence** pour avoir ElastiCache choisi une zone de disponibilité pour chaque nouvelle réplique, ou **Spécifier les zones de disponibilité** pour choisir une zone de disponibilité pour chaque nouvelle réplique. Si vous choisissez **Specify Availability Zones (Spécifier les zones de disponibilité)**, spécifiez une zone de disponibilité à l'aide de la liste pour chaque nouveau réplica. 1. Choisissez **Add (Ajouter)** pour ajouter les réplicas ou **Cancel (Annuler)** pour annuler l'opération. ## À l'aide du AWS CLI Pour augmenter le nombre de répliques dans une partition Valkey ou Redis OSS, utilisez la `increase-replica-count` commande avec les paramètres suivants : + `--replication-group-id` – Obligatoire. Identifie le groupe de réplication dans lequel vous souhaitez augmenter le nombre de réplicas. + `--apply-immediately` ou `--no-apply-immediately` – Obligatoire. Spécifie si le nombre de réplicas doit être augmenté 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 que vous souhaitez avoir une fois l'opération terminée, dans la limite de 5 maximum. Utilisez ce paramètre pour les groupes de réplication Valkey ou Redis OSS (mode cluster désactivé) où il n'existe qu'un seul groupe de nœuds ou pour les groupes Valkey ou Redis OSS (mode cluster activé), ou pour lesquels vous souhaitez que tous les groupes de nœuds aient le même nombre de répliques. Si cette valeur n'est pas supérieure au nombre de réplicas actuel du groupe de nœuds, l'appel échoue avec une exception. + `--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 (partition) Valkey ou Redis OSS (mode cluster activé), consultez. [Recherche de l'ID d'une partition](Shards.md#shard-find-id) + `NewReplicaCount` – Nombre de réplicas que vous souhaitez dans ce groupe de nœuds à la fin de cette opération. La valeur doit être supérieure au nombre actuel de réplicas, dans la limite de cinq maximum. Si cette valeur n'est pas supé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 `--replica-configuration` est omis, ElastiCache pour Redis OSS, il choisit la zone de disponibilité pour chacune des nouvelles répliques. **Important** Vous devez inclure le paramètre `--new-replica-count` ou le paramètre `--replica-configuration`, mais pas les deux, dans votre appel. **Example** L'exemple suivant fait passer à 3 le nombre de réplicas du groupe de réplication `sample-repl-group`. À la fin de cet exemple, il y a trois réplicas 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 increase-replica-count \ --replication-group-id sample-repl-group \ --new-replica-count 3 \ --apply-immediately ``` Pour Windows : ``` aws elasticache increase-replica-count ^ --replication-group-id sample-repl-group ^ --new-replica-count 3 ^ --apply-immediately ``` L'exemple suivant fait passer 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 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 ``` Pour 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 ``` Pour plus d'informations sur l'augmentation du nombre de répliques à l'aide de la CLI, consultez le [increase-replica-count](https://docs.aws.amazon.com/cli/latest/reference/elasticache/increase-replica-count.html)manuel *Amazon ElastiCache Command Line Reference*. ## Utilisation de l' ElastiCache API Pour augmenter le nombre de répliques dans une partition Valkey ou Redis OSS, utilisez l'`IncreaseReplicaCount`action avec les paramètres suivants : + `ReplicationGroupId` – Obligatoire. Identifie le groupe de réplication dans lequel vous souhaitez augmenter le nombre de réplicas. + `ApplyImmediately` – Obligatoire. Spécifie si le nombre de réplicas doit être augmenté 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 que vous souhaitez avoir une fois l'opération terminée, dans la limite de 5 maximum. Utilisez ce paramètre pour les groupes de réplication Valkey ou Redis OSS (mode cluster désactivé) où il n'existe qu'un seul groupe de nœuds, ou pour les groupes Valkey ou Redis OSS (mode cluster activé) où vous souhaitez que tous les groupes de nœuds aient le même nombre de répliques. Si cette valeur n'est pas supérieure au nombre de réplicas actuel du groupe de nœuds, l'appel échoue avec une exception. + `ReplicaConfiguration` : 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. `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 (partition) est toujours. `0001` Pour trouver l'ID d'un groupe de nœuds (partition) Valkey ou Redis OSS (mode cluster activé), consultez. [Recherche de l'ID d'une partition](Shards.md#shard-find-id) + `NewReplicaCount` – Nombre de réplicas que vous souhaitez dans ce groupe de nœuds à la fin de cette opération. La valeur doit être supérieure au nombre actuel de réplicas, dans la limite de cinq maximum. Si cette valeur n'est pas supé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 pour Redis OSS, il choisit la zone de disponibilité pour chacune des nouvelles répliques. **Important** Vous devez inclure le paramètre `NewReplicaCount` ou le paramètre `ReplicaConfiguration`, mais pas les deux, dans votre appel. **Example** L'exemple suivant fait passer à 3 le nombre de réplicas du groupe de réplication `sample-repl-group`. À la fin de cet exemple, il y a trois réplicas 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=IncreaseReplicaCount &ApplyImmediately=True &NewReplicaCount=3 &ReplicationGroupId=sample-repl-group &Version=2015-02-02 &SignatureVersion=4 &SignatureMethod=HmacSHA256 &Timestamp=20150202T192317Z &X-Amz-Credential= ``` L'exemple suivant fait passer 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=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= ``` Pour plus d'informations sur l'augmentation du nombre de répliques à l'aide de l'API, consultez [IncreaseReplicaCount](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_IncreaseReplicaCount.html)le *Amazon ElastiCache API Reference*. # 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 l' AWS Management Console API AWS CLI ou l' ElastiCache API pour réduire le nombre de répliques dans un groupe de nœuds (partition) ou un groupe de réplication. **Topics** + [En utilisant le AWS Management Console](#decrease-replica-count-con) + [En utilisant le AWS CLI](#decrease-replica-count-cli) + [Utilisation de l' ElastiCache API](#decrease-replica-count-api) ## 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/](https://console.aws.amazon.com/elasticache/). 1. Dans le volet de navigation, choisissez **Valkey** ou **Redis OSS**, puis choisissez le nom du groupe de réplication dont vous souhaitez supprimer les répliques. 1. Cochez la case correspondant à chaque partition dont vous souhaitez supprimer un nœud de réplica. 1. Choisissez **Delete replicas (Supprimer des réplicas)**. 1. 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. 1. 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 Redis OSS sélectionne automatiquement les nœuds de réplication à supprimer. Ce faisant, ElastiCache Redis OSS tente 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 Redis OSS, 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](#decrease-replica-count). 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 (partition) Valkey ou Redis OSS (mode cluster activé), consultez. [Recherche de l'ID d'une partition](Shards.md#shard-find-id) + `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](#decrease-replica-count). 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 pour Redis OSS, il 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`. **Example** 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 de la CLI, consultez le [decrease-replica-count](https://docs.aws.amazon.com/cli/latest/reference/elasticache/decrease-replica-count.html)manuel *Amazon ElastiCache Command Line Reference*. ## Utilisation de l' ElastiCache API Pour réduire le nombre de répliques dans une partition Valkey ou Redis OSS, utilisez l'`DecreaseReplicaCount`action 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](#decrease-replica-count). 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 (partition) Valkey ou Redis OSS (mode cluster activé), consultez. [Recherche de l'ID d'une partition](Shards.md#shard-find-id) + `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 pour Redis OSS, il 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`. **Example** 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= ``` 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= ``` 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= ``` Pour plus d'informations sur la réduction du nombre de répliques à l'aide de l'API, consultez [DecreaseReplicaCount](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DecreaseReplicaCount.html)le *Amazon ElastiCache API Reference*. # Ajouter une réplique de lecture pour Valkey ou Redis OSS (mode cluster désactivé) Les informations de la rubrique suivante s'appliquent uniquement aux groupes de réplication Valkey ou Redis OSS (mode cluster désactivé). À mesure que la charge de lecture augmente, vous pouvez avoir besoin de répartir ces lectures sur plusieurs nœuds et réduire la charge sur chaque nœud individuellement. Dans cette rubrique, vous découvrirez comment ajouter une réplique en lecture à un cluster Valkey ou Redis OSS (mode cluster désactivé). Un groupe de réplication Valkey ou Redis OSS (mode cluster désactivé) peut avoir un maximum de cinq répliques en lecture. Si vous essayez d'ajouter un réplica en lecture à un groupe de réplication qui en contient déjà cinq, l'opération échoue. Pour plus d'informations sur l'ajout de répliques à un groupe de réplication Valkey ou Redis OSS (mode cluster activé), consultez ce qui suit : + [Mise à l'échelle des clusters Valkey ou Redis OSS (mode cluster activé)](scaling-redis-cluster-mode-enabled.md) + [Augmentation du nombre de réplicas dans une partition](increase-replica-count.md) Vous pouvez ajouter une réplique en lecture à un cluster Valkey ou Redis OSS (mode cluster désactivé) à l'aide de la ElastiCache console, de l'API ou de l' AWS CLI API. ElastiCache **Rubriques en relation** + [Ajouter des nœuds à un ElastiCache cluster](Clusters.AddNode.md) + [Ajout d'un réplica en lecture à un groupe de réplication (AWS CLI)](#Replication.AddReadReplica.CLI) + [Ajout d'un réplica en lecture à un groupe de réplication à l'aide de l'API](#Replication.AddReadReplica.API) ## Ajout d'un réplica en lecture à un groupe de réplication (AWS CLI) Pour ajouter une réplique en lecture à un groupe de réplication Valkey ou Redis OSS (mode cluster désactivé), utilisez la AWS CLI `create-cache-cluster` commande, avec le paramètre `--replication-group-id` pour spécifier le groupe de réplication auquel ajouter le cluster (nœud). L'exemple suivant crée le cluster `my-read replica` et l'ajoute au groupe de réplication `my-replication-group`. Les types de nœud, les groupes de paramètres, les groupes de sécurité, le créneau de maintenance et les autres paramètres du réplica en lecture seront les mêmes que ceux des autres nœuds dans `my-replication-group`. Pour Linux, macOS ou Unix : ``` aws elasticache create-cache-cluster \ --cache-cluster-id my-read-replica \ --replication-group-id my-replication-group ``` Pour Windows : ``` aws elasticache create-cache-cluster ^ --cache-cluster-id my-read-replica ^ --replication-group-id my-replication-group ``` Pour plus d'informations sur l'ajout d'une réplique en lecture à l'aide de la CLI, consultez [create-cache-cluster](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-cache-cluster.html) le manuel *Amazon ElastiCache Command Line Reference.* ## Ajout d'un réplica en lecture à un groupe de réplication à l'aide de l'API Pour ajouter une réplique en lecture à un groupe de réplication Valkey ou Redis OSS (mode cluster désactivé), utilisez l' ElastiCache `CreateCacheCluster`opération, avec le paramètre `ReplicationGroupId` pour spécifier le groupe de réplication auquel ajouter le cluster (nœud). L'exemple suivant crée le cluster `myReadReplica` et l'ajoute au groupe de réplication `myReplicationGroup`. Les types de nœud, les groupes de paramètres, les groupes de sécurité, le créneau de maintenance et les autres paramètres du réplica en lecture seront les mêmes que ceux des autres nœuds `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= ``` Pour plus d'informations sur l'ajout d'une réplique en lecture à l'aide de l'API, consultez [CreateCacheCluster](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateCacheCluster.html) le *Amazon ElastiCache API Reference.* # Suppression d'une réplique de lecture pour Valkey ou Redis OSS (mode cluster désactivé) Les informations de la rubrique suivante s'appliquent uniquement aux groupes de réplication Valkey ou Redis OSS (mode cluster désactivé). À mesure que le trafic de lecture sur votre groupe de réplication Valkey ou Redis OSS change, vous souhaiterez peut-être ajouter ou supprimer des répliques de lecture. La suppression d'un nœud d'un groupe de réplication équivaut à supprimer un cluster, avec les restrictions suivantes : + Vous ne pouvez pas supprimer le réplica principal d'un groupe de réplication. Si vous souhaitez supprimer le réplica principal, procédez comme suit : 1. Promouvez un réplica en lecture en réplica principal. Pour plus d'informations sur la promotion d'un réplica en lecture en réplica principal, consultez [Promouvoir une réplique en lecture au statut principal, pour les groupes de réplication Valkey ou Redis OSS (mode cluster désactivé)](Replication.PromoteReplica.md). 1. Supprimez l'ancienne réplica principal. Reportez-vous au point suivant pour consulter une restriction à cette méthode. + Si l'option Multi-AZ est activée sur un groupe de réplication, vous ne pouvez pas supprimer le dernier réplica en lecture de ce groupe de réplication. Dans ce cas, procédez comme suit : 1. Modifiez le groupe de réplication en désactivant Multi-AZ. Pour de plus amples informations, veuillez consulter [Modification d'un groupe de réplication](Replication.Modify.md). 1. Supprimez le réplica en lecture. Vous pouvez supprimer une réplique en lecture d'un groupe de réplication Valkey ou Redis OSS (mode cluster désactivé) à l'aide de la ElastiCache console, du AWS CLI for ElastiCache ou de l' ElastiCache API. Pour savoir comment supprimer un cluster d'un groupe de réplication Valkey ou Redis OSS, consultez ce qui suit : + [En utilisant le AWS Management Console](Clusters.Delete.md#Clusters.Delete.CON) + [Utilisation du AWS CLI pour supprimer un ElastiCache cluster](Clusters.Delete.md#Clusters.Delete.CLI) + [Utilisation de l' ElastiCache API](Clusters.Delete.md#Clusters.Delete.API) + [Mise à l'échelle des clusters Valkey ou Redis OSS (mode cluster activé)](scaling-redis-cluster-mode-enabled.md) + [Diminution du nombre de réplicas dans une partition](decrease-replica-count.md)