

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.

# Supprimer des nœuds d'un ElastiCache cluster
<a name="Clusters.DeleteNode"></a>

Vous pouvez supprimer un nœud d'un cluster Valkey, Memcached ou Redis OSS à l'aide de l'API AWS Management Console, de ou de l'API AWS CLI. ElastiCache 

**Note**  
Chaque fois que vous modifiez le nombre de nœuds dans un cluster Memcached, vous devez redéfinir le mappage, au minimum, d'une partie de votre espace de clé vers le nœud adéquat. Pour en savoir plus sur l'équilibrage de charge d'un cluster Memcached, consultez [Configuration de votre ElastiCache client pour un équilibrage de charge efficace (Memcached)](BestPractices.LoadBalancing.md).

## En utilisant le ElastiCache AWS Management Console
<a name="Clusters.DeleteNode.CON"></a>

**Pour supprimer des nœuds d'un cluster (console)**

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 la liste située dans le coin supérieur droit, choisissez la AWS région du cluster dont vous souhaitez supprimer des nœuds.

1. Dans le volet de navigation, choisissez le moteur s'exécutant sur le cluster duquel vous voulez supprimer un nœud.

   La liste des clusters exécutant le moteur choisi s'affiche.

1. Dans la liste de clusters, choisissez le nom du cluster dans lequel vous souhaitez supprimer un nœud.

   Une liste des nœuds du cluster s'affiche.

1. Choisissez la zone de gauche de l'ID de nœud pour le nœud que vous souhaitez supprimer. À l'aide de la console ElastiCache , vous pouvez supprimer un seul nœud à la fois. Par conséquent, la sélection de plusieurs nœuds vous empêche d'utiliser le bouton **Supprimer un nœud**.

   La page *Supprimer le nœud* s'affiche.

1. Pour supprimer le nœud, remplissez la page **Supprimer un nœud**, puis choisissez **Supprimer un nœud**. Pour conserver le nœud, choisissez **Annuler**.
**Important**  
Avec Valkey ou Redis OSS, si vous supprimez le nœud, le cluster n'est plus compatible avec Multi-AZ, assurez-vous d'abord de décocher la case **Multi-AZ**, puis de supprimer le nœud. Si vous désactivez la case à cocher **Multi-AZ** vous pouvez choisir d'activer le **basculement automatique**.


**Impact des nouvelles demandes d'ajout et de suppression sur les demandes en attente**  

| Scénarios | Opérations en suspens | Nouvelle demande | Résultats | 
| --- | --- | --- | --- | 
|  Scénario 1 |  Suppression | Suppression |  La nouvelle demande de suppression, en attente ou immédiate, remplace la demande de suppression en attente. Par exemple, si les nœuds 0001, 0003 et 0007 sont en attente de suppression et qu'une nouvelle demande de suppression des nœuds 0002 et 0004 est émise, seuls les nœuds 0002 et 0004 seront supprimés. Les nœuds 0001, 0003 et 0007 ne seront pas supprimés. | 
|  Scénario 2 |  Suppression |  Créer |  La nouvelle demande de création, en attente ou immédiate, remplace la demande de suppression en attente. Par exemple, si les nœuds 0001, 0003 et 0007 sont en attente de suppression et qu'une nouvelle demande de création d'un nœud est émise, un nouveau nœud sera créé et les nœuds 0001, 0003 et 0007 ne seront pas supprimés. | 
|  Scénario 3 |  Créer |  Suppression |  La nouvelle demande de suppression, en attente ou immédiate, remplace la demande de création en attente. Par exemple, s'il y a une demande en attente de création de deux nœuds et qu'une nouvelle demande est émise pour supprimer le nœud 0003, aucun nouveau nœud ne sera créé et le nœud 0003 sera supprimé. | 
|  Scénario 4 |  Créer |  Créer |  La nouvelle demande de création est ajoutée à la demande de création en attente. Par exemple, s'il y a une demande en attente pour créer deux nœuds et qu'une nouvelle demande est émise pour créer trois nœuds, les nouvelles demandes sont ajoutées à la demande en attente et cinq nœuds seront créés. Si la nouvelle demande de création est définie sur **Apply Immediately - Yes (Appliquer immédiatement. Oui)**, toutes les demandes de création sont exécutées immédiatement. Si la nouvelle demande de création est définie sur **Apply Immediately - No (Appliquer immédiatement. Non)**, toutes les demandes de création sont en attente. | 

Pour déterminer les opérations en attente, choisissez l'onglet **Description** et vérifiez combien de créations ou de suppressions en attente sont affichées. Vous ne pouvez pas avoir à la fois des créations et des suppressions en attente. 

## En utilisant le AWS CLI avec ElastiCache
<a name="Clusters.DeleteNode.CLI"></a>

1. Identifiez IDs les nœuds que vous souhaitez supprimer. Pour de plus amples informations, veuillez consulter [Afficher les détails d'un ElastiCache cluster](Clusters.ViewDetails.md).

1. Utilisez l'opération `decrease-replica-count` de la CLI avec une liste des nœuds à supprimer, comme dans l'exemple suivant.

   Pour supprimer des nœuds d'un cluster à l'aide de l'interface de ligne de commande, utilisez la commande `decrease-replica-count` avec les paramètres suivants :
   + `--replication-group-id` ID du groupe de réplication auquel vous souhaitez ajouter des nœuds.
   + `--new-replica-count` Le paramètre `--new-replica-count` spécifie le nombre de nœuds que vous voulez ajouter à ce cluster après application de la modification.
   + `--replicas-to-remove`Liste des nœuds IDs que vous souhaitez supprimer de ce cluster.
   + `--apply-immediately` ou `--no-apply-immediately` qui spécifie s'il convient de supprimer ces nœuds immédiatement ou lors du prochain créneau de maintenance.
   + `--region`Spécifie la AWS région du cluster dont vous souhaitez supprimer des nœuds.
**Note**  
Vous ne pouvez passer qu'un seul des paramètres `--replicas-to-remove` ou `--new-replica-count` lors de l'appel de cette opération.

   Pour Linux, macOS ou Unix :

   ```
   aws elasticache decrease-replica-count \
       --replication-group-id my-replication-group \
       --new-replica-count 2 \   
       --region us-east-2 \
       --apply-immediately
   ```

   Pour Windows :

   ```
   aws elasticache decrease-replica-count ^
       --replication-group-id my-replication-group ^
       --new-replica-count 3 ^   
       --region us-east-2 ^
       --apply-immediately
   ```

   Cette opération produit une sortie similaire à la sortie suivante (format JSON) :

   ```
   {
       "ReplicationGroup": {
           "ReplicationGroupId": "node-test",
           "Description": "node-test"
          },
           "Status": "modifying",
           "PendingModifiedValues": {},
           "MemberClusters": [
               "node-test-001",
               "node-test-002",
               "node-test-003",
               "node-test-004",
               "node-test-005",
               "node-test-006"
           ],
           "NodeGroups": [
               {
                   "NodeGroupId": "0001",
                   "Status": "modifying",
                   "PrimaryEndpoint": {
                       "Address": "node-test.zzzzzz.ng.0001.usw2.cache.amazonaws.com",
                       "Port": 6379
                   },
                   "ReaderEndpoint": {
                       "Address": "node-test-ro.zzzzzz.ng.0001.usw2.cache.amazonaws.com",
                       "Port": 6379
                   },
                   "NodeGroupMembers": [
                       {
                           "CacheClusterId": "node-test-001",
                           "CacheNodeId": "0001",
                           "ReadEndpoint": {
                               "Address": "node-test-001.zzzzzz.0001.usw2.cache.amazonaws.com",
                               "Port": 6379
                           },
                           "PreferredAvailabilityZone": "us-west-2a",
                           "CurrentRole": "primary"
                       },
                       {
                           "CacheClusterId": "node-test-002",
                           "CacheNodeId": "0001",
                           "ReadEndpoint": {
                               "Address": "node-test-002.zzzzzz.0001.usw2.cache.amazonaws.com",
                               "Port": 6379
                           },
                           "PreferredAvailabilityZone": "us-west-2c",
                           "CurrentRole": "replica"
                       },
                       {
                           "CacheClusterId": "node-test-003",
                           "CacheNodeId": "0001",
                           "ReadEndpoint": {
                               "Address": "node-test-003.zzzzzz.0001.usw2.cache.amazonaws.com",
                               "Port": 6379
                           },
                           "PreferredAvailabilityZone": "us-west-2b",
                           "CurrentRole": "replica"
                       },
                       {
                           "CacheClusterId": "node-test-004",
                           "CacheNodeId": "0001",
                           "ReadEndpoint": {
                               "Address": "node-test-004.zzzzzz.0001.usw2.cache.amazonaws.com",
                               "Port": 6379
                           },
                           "PreferredAvailabilityZone": "us-west-2c",
                           "CurrentRole": "replica"
                       },
                       {
                           "CacheClusterId": "node-test-005",
                           "CacheNodeId": "0001",
                           "ReadEndpoint": {
                               "Address": "node-test-005.zzzzzz.0001.usw2.cache.amazonaws.com",
                               "Port": 6379
                           },
                           "PreferredAvailabilityZone": "us-west-2b",
                           "CurrentRole": "replica"
                       },
                       {
                           "CacheClusterId": "node-test-006",
                           "CacheNodeId": "0001",
                           "ReadEndpoint": {
                               "Address": "node-test-006.zzzzzz.0001.usw2.cache.amazonaws.com",
                               "Port": 6379
                           },
                           "PreferredAvailabilityZone": "us-west-2b",
                           "CurrentRole": "replica"
                       }
                   ]
               }
           ],
           "SnapshottingClusterId": "node-test-002",
           "AutomaticFailover": "enabled",
           "MultiAZ": "enabled",
           "SnapshotRetentionLimit": 1,
           "SnapshotWindow": "07:30-08:30",
           "ClusterEnabled": false,
           "CacheNodeType": "cache.r5.large",
            "DataTiering": "disabled",
           "TransitEncryptionEnabled": false,
           "AtRestEncryptionEnabled": false,
           "ARN": "arn:aws:elasticache:us-west-2:123456789012:replicationgroup:node-test"
       }
   }
   ```

Vous pouvez également appeler `decrease-replica-count` et au lieu de passer au paramètre `--new-replica-count`, vous pouvez passer le paramètre `--replicas-to-remove`, comme illustré ci-après :

Pour Linux, macOS ou Unix :

```
aws elasticache decrease-replica-count \
    --replication-group-id my-replication-group \
    --replicas-to-remove node-test-003 \   
    --region us-east-2 \
    --apply-immediately
```

Pour Windows :

```
aws elasticache decrease-replica-count ^
    --replication-group-id my-replication-group ^
    --replicas-to-remove node-test-003 ^   
    --region us-east-2 ^
    --apply-immediately
```

Pour plus d'informations, consultez les AWS CLI rubriques [https://docs.aws.amazon.com/cli/latest/reference/elasticache/decrease-replica-count.html](https://docs.aws.amazon.com/cli/latest/reference/elasticache/decrease-replica-count.html).

## Utilisation de l' ElastiCache API avec Valkey ou Redis OSS
<a name="Clusters.DeleteNode.API2"></a>

Pour supprimer des nœuds à l'aide de l' ElastiCache API, appelez l'opération d'`DecreaseReplicaCount`API avec l'ID du groupe de réplication et une liste des nœuds à supprimer, comme indiqué :
+ `ReplicationGroupId` ID du groupe de réplication auquel vous souhaitez ajouter des nœuds.
+ `ReplicasToRemove` Le paramètre `ReplicasToRemove` spécifie le nombre de nœuds que vous voulez ajouter à ce cluster après application de la modification.
+ `ApplyImmediately` spécifie s'il convient de supprimer ces nœuds immédiatement ou lors du prochain créneau de maintenance.
+ `Region`Spécifie la AWS région du cluster dont vous souhaitez supprimer un nœud.

L'exemple suivant supprime immédiatement les nœuds 0004 et 0005 du cluster my-cluster.

```
https://elasticache.us-west-2.amazonaws.com/
    ?Action=DecreaseReplicaCount
    &ReplicationGroupId=my-replication-group
    &ApplyImmediately=true
    &ReplicasToRemove=node-test-003    
    &Region us-east-2
    &Version=2014-12-01
    &SignatureVersion=4
    &SignatureMethod=HmacSHA256
    &Timestamp=20141201T220302Z
    &X-Amz-Algorithm=&AWS;4-HMAC-SHA256
    &X-Amz-Date=20141201T220302Z
    &X-Amz-SignedHeaders=Host
    &X-Amz-Expires=20141201T220302Z
    &X-Amz-Credential=<credential>
    &X-Amz-Signature=<signature>
```

Pour plus d'informations, consultez la rubrique ElastiCache API [https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DecreaseReplicaCount.html](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DecreaseReplicaCount.html).

## Utilisation de l' ElastiCache API avec Memcached
<a name="Clusters.DeleteNode.API"></a>

Pour supprimer des nœuds à l'aide de l' ElastiCache API, appelez l'opération d'`ModifyCacheCluster`API avec l'ID du cluster de cache et une liste des nœuds à supprimer, comme indiqué :
+ `CacheClusterId`ID du cluster dont vous souhaitez supprimer des nœuds.
+ `NumCacheNodes` Le paramètre `NumCacheNodes` spécifie le nombre de nœuds que vous voulez ajouter à ce cluster après application de la modification.
+ `CacheNodeIdsToRemove.member.n`Liste des nœuds IDs à supprimer du cluster.
  + `CacheNodeIdsToRemove.member.1=0004`
  + `CacheNodeIdsToRemove.member.1=0005`
+ `ApplyImmediately` spécifie s'il convient de supprimer ces nœuds immédiatement ou lors du prochain créneau de maintenance.
+ `Region`Spécifie la AWS région du cluster dont vous souhaitez supprimer un nœud.

L'exemple suivant supprime immédiatement les nœuds 0004 et 0005 du cluster my-cluster.

```
https://elasticache.us-west-2.amazonaws.com/
    ?Action=ModifyCacheCluster
    &CacheClusterId=my-cluster
    &ApplyImmediately=true
    &CacheNodeIdsToRemove.member.1=0004
    &CacheNodeIdsToRemove.member.2=0005
    &NumCacheNodes=3   
    &Region us-east-2
    &Version=2014-12-01
    &SignatureVersion=4
    &SignatureMethod=HmacSHA256
    &Timestamp=20141201T220302Z
    &X-Amz-Algorithm=&AWS;4-HMAC-SHA256
    &X-Amz-Date=20141201T220302Z
    &X-Amz-SignedHeaders=Host
    &X-Amz-Expires=20141201T220302Z
    &X-Amz-Credential=<credential>
    &X-Amz-Signature=<signature>
```

Pour plus d'informations, consultez la rubrique ElastiCache API [https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyCacheCluster.html](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyCacheCluster.html).