v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-14130363656.8 KB

Deletes an existing replication group. By default, this operation deletes the entire replication group, including the primary/primaries and all of the read replicas. If the replication group has only one primary, you can optionally delete only the read replicas, while retaining the primary by setting RetainPrimaryCluster=true.

When you receive a successful response from this operation, Amazon ElastiCache immediately begins deleting the selected resources; you cannot cancel or revert this operation.

This operation is valid for Redis only.

get/#Action=DeleteReplicationGroup

Query parameters

ReplicationGroupIdstring required

The identifier for the cluster to be deleted. This parameter is not case sensitive.

RetainPrimaryClusterboolean

If set to <code>true</code>, all of the read replicas are deleted, but the primary node is retained.

FinalSnapshotIdentifierstring

The name of a final node group (shard) snapshot. ElastiCache creates the snapshot from the primary node in the cluster, rather than one of the replicas; this is to ensure that it captures the freshest data. After the final snapshot is taken, the replication group is immediately deleted.

Action'DeleteReplicationGroup' required
Version'2015-02-02' required

Response

Success