Modifying a replication group - Amazon ElastiCache for Redis
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China.

Modifying a replication group

Important Constraints
  • Currently, ElastiCache supports limited modifications of a Redis (cluster mode enabled) replication group, for example changing the engine version, using the API operation ModifyReplicationGroup (CLI: modify-replication-group). You can modify the number of shards (node groups) in a Redis (cluster mode enabled) cluster with the API operation ModifyReplicationGroupShardConfiguration (CLI: modify-replication-group-shard-configuration). For more information, see Scaling clusters in Redis (Cluster Mode Enabled).

    Other modifications to a Redis (cluster mode enabled) cluster require that you create a cluster with the new cluster incorporating the changes.

  • You can upgrade Redis (cluster mode disabled) and Redis (cluster mode enabled) clusters and replication groups to newer engine versions. However, you can't downgrade to earlier engine versions except by deleting the existing cluster or replication group and creating it again. For more information, see Upgrading engine versions.

You can modify a Redis (cluster mode disabled) cluster's settings using the ElastiCache console, the Amazon CLI, or the ElastiCache API. Currently, ElastiCache supports a limited number of modifications on a Redis (cluster mode enabled) replication group. Other modifications require you create a backup of the current replication group then using that backup to seed a new Redis (cluster mode enabled) replication group.

Using the Amazon Web Services Management Console

To modify a Redis (cluster mode disabled) cluster, see Modifying an ElastiCache cluster.

Using the Amazon CLI

The following Amazon CLI command enables Multi-AZ on an existing Redis replication group. You can use the same command to make other modifications to a replication group.

For Linux, OS X, or Unix:

aws elasticache modify-replication-group \ --replication-group-id myReplGroup \ --multi-az-enabled = true

For Windows:

aws elasticache modify-replication-group ^ --replication-group-id myReplGroup ^ --multi-az-enabled

For more information on the Amazon CLI modify-replication-group command, see modify-replication-group.

Using the ElastiCache API

The following ElastiCache API operation enables Multi-AZ on an existing Redis replication group. You can use the same operation to make other modifications to a replication group.

https://elasticache.us-west-2.amazonaws.com/ ?Action=ModifyReplicationGroup &AutomaticFailoverEnabled=true &Mutli-AZEnabled=true &ReplicationGroupId=myReplGroup &SignatureVersion=4 &SignatureMethod=HmacSHA256 &Timestamp=20141201T220302Z &Version=2014-12-01 &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>

For more information on the ElastiCache API ModifyReplicationGroup operation, see ModifyReplicationGroup.