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

Modifying an ElastiCache Cluster

In addition to adding or removing nodes from a cluster, there can be times where you need to make other changes to an existing cluster, such as, adding a security group, changing the maintenance window or a parameter group.

We recommend that you have your maintenance window fall at the time of lowest usage. Thus it might need modification from time to time.

Changes in a cluster's parameters by changing the cluster's parameter group or by changing the value of a parameter in the cluster's parameter group are applied only after the cluster is rebooted.

Modifying a Cluster (Console)

To modify a cluster (console)

  1. Sign in to the AWS Management Console and open the ElastiCache console at https://console.aws.amazon.com/elasticache/.

  2. From the dropdown in the upper right corner, choose the region you are interested in.

  3. In the navigation pane, choose Redis or Memcached.

    A list of the chosen engine's clusters appears.

  4. In the list of clusters, choose the name of the cluster you want to modify. The modifications you can make to a Redis (cluster mode enabled) cluster are limited to modifications to security groups, description, parameter groups, backup options, maintenance window, and SNS notifications.

  5. Choose Modify.

    The Modify Cluster window appears.

  6. In the Modify Cluster window, make the modification(s) you want.

    Important

    You can upgrade to newer engine versions (see Upgrading Engine Versions), but you cannot downgrade to older engine versions except by deleting the existing cluster and creating it anew.

    Because the newer Redis versions provide a better and more stable user experience, Redis versions 2.6.13, 2.8.6, and 2.8.19 are deprecated when using the ElastiCache console. We recommend against using these Redis versions. If you need to use one of them, work with the AWS CLI or ElastiCache API.

    For more information, see the following topics:

    AWS CLI ElastiCache API

    Create Cluster

    Creating a Cache Cluster (AWS CLI)

    This action cannot be used to create a replication group with cluster mode enabled.

    Creating a Cache Cluster (ElastiCache API)

    This action cannot be used to create a replication group with cluster mode enabled.

    Modify Cluster

    Modifying a Cache Cluster (AWS CLI)

    This action cannot be used to create a replication group with cluster mode enabled.

    Modifying a Cache Cluster (ElastiCache API)

    This action cannot be used to create a replication group with cluster mode enabled.

    Create Replication Group

    Creating a Redis (cluster mode disabled) Cluster with Replicas from Scratch (AWS CLI)

    Creating a Redis (cluster mode enabled) Cluster with Replicas from Scratch (AWS CLI)

    Creating a Redis (cluster mode disabled) Cluster with Replicas from Scratch (ElastiCache API)

    Creating a Redis (cluster mode enabled) Cluster with Replicas from Scratch (ElastiCache API)

    Modify Replication Group

    Modifying a Replication Group (AWS CLI)

    This action cannot be used to create a replication group with cluster mode enabled.

    Modifying a Replication Group (ElastiCache API)

    This action cannot be used to create a replication group with cluster mode enabled.

    The Apply Immediately box applies only to modifications in node type and engine version. If you want to apply any of these changes immediately, choose the Apply Immediately check box. If this box is not chosen, engine version and node type modifications will be applied during the next maintenance window. Other modifications, such as changing the maintenance window, are applied immediately.

  7. Choose Modify.

Modifying a Cache Cluster (AWS CLI)

You can modify an existing cluster using the AWS CLI modify-cache-cluster operation. To modify a cluster's configuration value, specify the cluster's ID, the parameter to change and the parameter's new value. The following example changes the maintenance window for a cluster named myCluster and applies the change immediately.

Important

You can upgrade to newer engine versions (see Upgrading Engine Versions), but you cannot downgrade to older engine versions except by deleting the existing cache cluster or replication group and creating it anew.

For Linux, macOS, or Unix:

Copy
aws elasticache modify-cache-cluster \ --cache-cluster-id myCluster \ --preferred-maintenance-window sun:23:00-mon:02:00

For Windows:

Copy
aws elasticache modify-cache-cluster ^ --cache-cluster-id myCluster ^ --preferred-maintenance-window sun:23:00-mon:02:00

The --apply-immediately parameter applies only to modifications in node type, engine version, and changing the number of nodes in a cluster. If you want to apply any of these changes immediately, use the --apply-immediately parameter. If you prefer postponing these changes to your next maintenance window, use the --no-apply-immediately parameter. Other modifications, such as changing the maintenance window, are applied immediately.

For more information, go to the AWS CLI for ElastiCache topic modify-cache-cluster.

Modifying a Cache Cluster (ElastiCache API)

You can modify an existing cluster using the ElastiCache API ModifyCacheCluster operation. To modify a cluster's configuration value, specify the cluster's ID, the parameter to change and the parameter's new value. The following example changes the maintenance window for a cluster named myCluster and applies the change immediately.

Important

You can upgrade to newer engine versions (see Upgrading Engine Versions), but you cannot downgrade to older engine versions except by deleting the existing cache cluster or replication group and creating it anew.

Line breaks are added for ease of reading.

Copy
https://elasticache.us-west-2.amazonaws.com/ ?Action=ModifyCacheCluster &CacheClusterId=myCluster &PreferredMaintenanceWindow=sun:23:00-mon:02:00 &SignatureVersion=4 &SignatureMethod=HmacSHA256 &Timestamp=20150901T220302Z &X-Amz-Algorithm=AWS4-HMAC-SHA256 &X-Amz-Date=20150202T220302Z &X-Amz-SignedHeaders=Host &X-Amz-Expires=20150901T220302Z &X-Amz-Credential=<credential> &X-Amz-Signature=<signature>

The ApplyImmediately parameter applies only to modifications in node type, engine version, and changing the number of nodes in a cluster. If you want to apply any of these changes immediately, set the ApplyImmediately parameter to true. If you prefer postponing these changes to your next maintenance window, set the ApplyImmediately parameter to false. Other modifications, such as changing the maintenance window, are applied immediately.

For more information, go to the ElastiCache API reference topic ModifyCacheCluster.