Menu
Amazon ElastiCache for Redis
ElastiCache for Redis User Guide (API Version 2015-02-02)

Deleting a Read Replica

Important

Currently, ElastiCache does not support deleting a read replica from a Redis (cluster mode enabled) replication group. If you need to reduce the number of read replicas, create the cluster anew with the desired number of read replicas.

As read traffic on your Redis (cluster mode disabled) replication group changes you might want to add or remove read replicas. Removing a node from a Redis (cluster mode disabled) replication group is the same as just deleting a cluster, though there are some restrictions.

Restriction on removing nodes from a Redis (cluster mode disabled) replication group

  • You cannot remove the primary from a replication group. If you want to delete the primary, you must do the following:

    1. Promote a read replica to primary. For more information on promoting a read replica to primary, see Promoting a Read-Replica to Primary.

    2. Delete the old primary. See the next point for a restriction on this method.

  • If Multi-AZ is enabled on a replication group, you cannot remove the last read replica from the replication group. In this case you must:

    1. Modify the replication group by disabling Multi-AZ. For more information, see Modifying a Replication Group.

    2. Delete the read-replica.

You can remove a read replica from a Redis (cluster mode disabled) replication group using the ElastiCache console, the AWS CLI for ElastiCache, or the ElastiCache API.