Help Center/ Distributed Cache Service/ User Guide/ Changing an Instance/ Changing DCS Instance Specifications
Updated on 2026-08-27 GMT+08:00

Changing DCS Instance Specifications

On the DCS console, you can change DCS Redis or Memcached instance specifications, including the instance type, memory, number of shards, and number of replicas. You can select the specifications that best suit your needs.

Changing instance specifications does not affect other instance configurations such as the connection address, access password, security group, and whitelist. Additionally, the instance does not need to be restarted.

Changing the specifications of instances does not affect instance data, except for single-node instances.

Notes and Constraints

  • It is recommended that you change instance specifications during off-peak hours. The specifications change may fail during peak hours, for example, when the memory usage or maximum CPU usage of an instance exceeds 90% or the write traffic surges. If the change fails, try again during off-peak hours.
  • This function is unavailable on the console for legacy instances. In this case, submit a service ticket and contact the customer service to upgrade the instances to the latest version. After the upgrade, the instance specifications can be changed.
  • Cluster DCS Redis 3.0 instances cannot be vertically scaled.
  • If the reserved memory of a DCS Redis 3.0 or Memcached instance is insufficient, specifications scale-up may fail when the memory is used up. For details, see Reserved Memory.
  • The number of replicas and the capacity must be changed separately.
  • Only one replica can be deleted at a time.

Billing

Changing the type or specifications of a DCS instance will affect your billing. Before confirming the change, review the new price.

Video Tutorial

This video demonstrates how to change the specifications of a DCS instance. As product functions evolve, the GUI may vary. This tutorial is for reference only.

Instance Change Notice

For notice on changing the instance type, see Changing the Instance Type. For notice on changing the instance specifications, see Changing Instance Specifications.

Table 1 Details on changing the instance type of DCS instances

Instance Version

Supported Change Type

Notice and Impact

Redis 3.0

From single-node to master/standby

The instance cannot be connected for several seconds and remains read-only for about one minute.

From master/standby to Proxy Cluster

  1. If the data of a master/standby DCS Redis 3.0 instance is stored in multiple databases, or in non-DB0 databases, the instance cannot be changed to the Proxy Cluster type. A master/standby instance can be changed to the Proxy Cluster type only if its data is stored only on DB0.
  2. The instance cannot be connected and remains read-only for 5 to 30 minutes.

Memcached

From single-node to master/standby

Services are interrupted for several seconds and remain read-only for about 1 minute.

Redis 4.0/5.0/6.0

From master/standby or read/write splitting to Proxy Cluster

  1. After the instance is changed to Proxy Cluster, the multi-DB function is enabled for Proxy Cluster by default. In this case, you need to evaluate the impacts of the restrictions on using multi-DB and running commands. For details, see Notes and Procedure for Enabling Multi-DB for Proxy Cluster Instances, and Command Restrictions.
  2. The used memory of the current instance must be less than 70% of the new instance's maximum memory. Otherwise, the change will be prohibited. To query the used memory of an instance, see parameter Used/Available Memory (MB) in Viewing and Modifying Basic Settings of a DCS Instance.
  3. Some keys may be evicted if the current memory usage exceeds 90% of the total.
  4. After the change is complete, you need to create alarm rules for the new instance by referring to Configuring DCS Monitoring and Alarms.
  5. For a master/standby instance, ensure that its read-only IP address or read-only domain name is not directly referenced by your application.
  6. If your application cannot reconnect to Redis or handle exceptions, you may need to restart the application after the change.
  7. During the change, services are interrupted for seconds and remain read-only for about 1 minute. You are advised to perform the change during off-peak hours.

From Proxy Cluster to master/standby or read/write splitting

Redis 4.0/5.0/6.0

From master/standby to read/write splitting

NOTE:

Currently, a read/write splitting instance cannot be directly changed to a master/standby one.

  1. Currently, only a master/standby instance with 4 GB or more memory can be changed to a read/write splitting instance with the same capacity.
  2. Some keys may be evicted if the current memory usage exceeds 90% of the total.
  3. After the change is complete, you need to create alarm rules for the new instance by referring to Configuring DCS Monitoring and Alarms.
  4. Ensure that the read-only IP address or read-only domain name of the master/standby instance is not directly referenced by your application.
  5. If your application cannot reconnect to Redis or handle exceptions, you may need to restart the application after the change.
  6. During the change, services are interrupted for seconds. You are advised to perform the change during off-peak hours.
  7. If an ACL account has been created for the master/standby instance, the instance cannot be changed to a read/write splitting one.
  8. If SSL is enabled for a DCS Redis 6.0 instance, the instance cannot be changed to a read/write splitting one.

Currently, only the instance type changes listed in the table above are supported. To change the specifications of an instance across different instance types, you are advised to create a new instance, migrate data, and swap the IP addresses of the two instances. For details, see Online Migration Between Instances.

For details about the commands supported by different types of instances, see Command Compatibility.

  • Specifications change details
    Table 2 Instance specifications change details

    Cache Engine

    Single-Node

    Master/Standby

    Redis Cluster

    Proxy Cluster

    Read/Write Splitting

    Redis 3.0

    Scale-up and scale-down

    Scale-up and scale-down

    -

    Scale-up

    -

    Redis 4.0

    Scale-up and scale-down

    Scale-up, scale-down, and replica quantity change

    Scale-up, scale-down, and replica quantity change

    Scale-up and scale-down

    Scale-up, scale-down, and replica quantity change

    Redis 5.0

    Scale-up and scale-down

    Scale-up, scale-down, and replica quantity change

    Scale-up, scale-down, and replica quantity change

    Scale-up and scale-down

    Scale-up, scale-down, and replica quantity change

    Redis 6.0 Basic Edition

    Scale-up and scale-down

    Scale-up, scale-down, and replica quantity change

    Scale-up, scale-down, and replica quantity change

    Scale-up and scale-down

    Scale-up, scale-down, and replica quantity change

    Redis 6.0 Enterprise Edition

    -

    Scale-up and scale-down

    -

    -

    -

    Redis 7.0

    Scale-up and scale-down

    Scale-up, scale-down, and replica quantity change

    Scale-up, scale-down, and replica quantity change

    -

    -

    Memcached

    Scale-up and scale-down

    Scale-up and scale-down

    -

    -

    -

  • Specifications change impacts
    Table 3 Specifications change impacts

    Instance Type

    Specifications Change Type

    Impact

    Single-node, read/write splitting, and master/standby

    Scale-up or scale-down

    • During the scale-up, the instance cannot be connected for several seconds and remains read-only for about 1 minute. During the scale-down, the instance will not be disconnected.
    • A DCS Redis 3.0 instance will be disconnected for several seconds and remain read-only for 5 to 30 minutes.
    • A DCS Redis Enterprise-Edition instance will be disconnected for several seconds and remain read-only for about 1 minute.
    • In a scale-up, only the memory of the instance is increased. The CPU processing capability is not improved.
    • Single-node DCS instances do not support data persistence. Specifications change may compromise data reliability. After the specifications change, check whether the data is complete and import data if required. If there is important data, use a migration tool to migrate the data to other instances for backup.
    • The backup records of master/standby and read/write splitting instances before scale-down cannot be used after scale-down. If necessary, download the backup file in advance or back up the data again after scale-down.

    Proxy Cluster and Redis Cluster

    Scale-up or scale-down

    • Horizontal scaling by adding shards:
      • The server does not proactively disconnect from the instance but will consume CPU resources, deteriorating performance by up to 20%.
      • When the number of shards increases, data nodes are added. Data is automatically balanced to the new data nodes, increasing the access latency.
    • Horizontal scaling by reducing shards:
      • When the number of shards decreases, nodes are deleted. Before scaling down a Redis Cluster instance, ensure that the deleted nodes are not directly referenced by your application, to prevent service access exceptions.
      • Deleting nodes will cause intermittent disconnections. Ensure that your client application has a reconnection mechanism and can handle exceptions. Otherwise, you may need to restart the client application after the change.
    • Vertical scaling by increasing the shard capacity without changing the number of shards:
      • If the memory of the VM accommodating the node is insufficient, the node will be migrated. During the migration, service connections will be intermittently interrupted and the node will become read-only.
      • Increasing the shard capacity when the VM memory is sufficient does not affect services.
      NOTE:

      Cluster DCS Redis 3.0 instances cannot be vertically scaled.

    • Vertical scaling by reducing the shard capacity without changing the number of shards: There is no impact.
    • To scale down an instance, ensure that the used memory of each node is less than 70% of the node's maximum memory on the new instance. Otherwise, the change will be prohibited.
    • During the specifications change, data may be migrated, which increases the access latency. Ensure that the client can properly process MOVED and ASK commands. Otherwise, requests will fail.
    • If a large amount of data is written to the node during the instance specifications change, the node memory will be used up. As a result, the change will fail.
    • Before changing the instance specifications, check for big keys through Cache Analysis. Redis has a limit on key migration. If the instance has any single key greater than or equal to 512 MB, specifications change will fail when big key migration between nodes times out. A bigger key results in a higher probability of the failure.
    • Before scaling a Redis Cluster instance, ensure that automatic cluster topology refresh is enabled. If it is disabled, you will need to restart the client after the scaling. For details about how to enable automatic cluster topology refresh on a Lettuce client, see examples in Connecting to Redis on Lettuce (Java).
    • Backup records before the specifications change cannot be used after the change. If necessary, download the backup file in advance or back up data again after the change.

    Master/Standby, read/write splitting, and Redis Cluster instances

    Replica quantity change

    • Before adding or deleting replicas for a Redis Cluster instance, ensure that automatic cluster topology refresh is enabled. If it is disabled, you will need to restart the client after the change. For details about how to enable automatic cluster topology refresh on a Lettuce client, see examples in Connecting to Redis on Lettuce (Java).
    • Deleting replicas interrupts connections. If your application cannot reconnect to Redis or handle exceptions, you may need to restart the application after the change. Adding replicas does not interrupt connections.
    • If the number of replicas is already the minimum supported by the instance, you can no longer delete replicas.

Changing an Instance

  1. Log in to the DCS console.
  2. Click in the upper left corner of the console and select the region where your instance is located.
  3. In the navigation pane, choose Cache Manager.
  4. Choose More > Modify Specifications of the Operation column in the row containing the DCS instance.
  5. On the Modify Specifications page, select the desired specification.
  6. Set Apply Change to Now or During maintenance.

    Select During maintenance if the change will interrupt client connections.

    Table 4 Scenarios where specifications change will interrupt connections

    Specifications Change Task

    When Connections Are Interrupted

    Scaling up a single-node or master/standby instance

    Memory is increased from a size smaller than 8 GB to 8 GB or larger.

    Scaling down a Proxy Cluster or Redis Cluster instance

    The number of shards is decreased.

    Changing the instance type

    The instance type is changed between master/standby or read/write splitting and Proxy Cluster.

    Deleting replicas

    Replicas are deleted from a master/standby, Redis Cluster, or read/write splitting instance.

    • If the specifications change does not interrupt client connections, the change will be performed immediately even if you select During maintenance.
    • After you submit a specifications change request, the request cannot be canceled. You can change the maintenance window to reschedule the change for a maximum of three times.
    • To cancel the change before the maintenance window elapses, submit a service ticket and contact the customer service to enable the change cancellation feature. After the feature is enabled, click Cancel next to the task on the Background Tasks page.
    • DCS Redis 3.0 and Memcached instances can only be changed immediately.
    • If you apply the change during maintenance, the change starts at any time within the maintenance window, rather than at the start time of the window.
    • If a large amount of data needs to be migrated when you scale down a Cluster instance, the operation may not be completed within the maintenance window.

  7. Click Next. Confirm the change details and view the risk check results.

    • If any risk is found in the check, the instance may fail to be changed. In this case, rectify the fault by referring to Table 5.
    • If the check result is normal, the checked items have no change failure risks.
    • If the check fails, the possible causes are as follows:
      • Failed to connect to the master node of the instance. In this case, check the instance status.
      • A system exception occurred. In this case, click Check Again later.
    • Click Stop Check to stop the check. Click Check Again to restart the check.
    • If you want to proceed with the change after manually stopping the check or if the check result reports an exception, select I understand the risks.
      Table 5 Risk check items

      Check Item

      Reason for Check

      Solution

      Non-standard configuration check

      NOTE:

      Currently, non-standard configuration check is available only in certain regions, such as CN North-Beijing4, CN East-Shanghai1, and CN East-Shanghai2. The supported regions are provided on the console.

      The following non-standard check items are supported:
      • Non-standard bandwidth of a single node
      • Non-standard memory of a single node
      • Non-standard number of replicas on a Redis Cluster instance
      • Non-standard number of proxy nodes on a Proxy Cluster instance
      • Non-standard maxclients (exceeding the maximum number of allowed connections) on a Proxy Cluster instance

      If your instance has non-standard configurations, the console displays a message indicating that they will be converted to standard configurations during the change.

      Among these non-standard configurations, you can retain only the non-standard bandwidth or number of proxy nodes in the change.

      • If your instance does not have non-standard configurations, the check result is normal and no action is required.
      • If the instance has non-standard configurations, determine whether to proceed with the change or whether to retain the non-standard bandwidth or number of proxy nodes.

      Node status

      Abnormal node status will lead to instance change failures.

      If the node status is abnormal, submit a service ticket and contact the customer service.

      Dataset memory distribution check

      (This check item applies only to Proxy Cluster and Redis Cluster instances.)

      During the specifications change of a Redis Cluster instance, data is migrated between nodes. Redis has a limit on key migration. If the instance has any single key greater than 512 MB, specifications change will fail when big key migration between nodes times out.

      If the instance dataset memory is unevenly distributed among nodes and the difference is greater than 512 MB, the instance has a big key and the change may fail.

      If there are big keys on your instance, Handle big keys before proceeding with the change.

      Memory usage check

      If the memory usage of a node is greater than 90%, keys may be evicted or the change may fail.

      If the memory usage is too high, optimize the memory by optimizing big keys, scanning for expired keys, or deleting some keys.

      Network input traffic check

      (This check item applies only to single-node, read/write splitting, and master/standby instances.)

      The change may fail if the network input traffic is too heavy and the write buffer overflows.

      Perform the change during off-peak hours.

      CPU usage check

      If the node CPU usage within the last 5 minutes is greater than 90%, the change may fail.

      Perform the change during off-peak hours. Rectify the fault by referring to Troubleshooting High CPU Usage of a DCS Redis Instance.

      Resource capacity

      (This check item applies only to the scale-up of the shard capacity on a Cluster instance.)

      During the scale-up of the shard capacity, if the VM resources of the instance are insufficient, instance nodes will be migrated. During the migration, service connections will be intermittently interrupted and the nodes will become read-only.

      If there are risks in the resource capacity check, ensure that your client application has a reconnection mechanism and can handle exceptions. Otherwise, you may need to restart the client application after the change.

  8. After the risk check is complete, click Next. After the change request is submitted, you can go to the Background Tasks page to view the change status.

    Specifications change of a single-node, master/standby, or read/write splitting DCS instance takes about 5 to 30 minutes to complete, while that of a Cluster instance takes longer.

    Click the task name on the Background Tasks page to view task details. After the specifications of an instance is successfully changed, its status changes to Running.

    Figure 1 Viewing background task details
    • If the specifications change of a single-node instance fails, the instance is temporarily unavailable and its specifications remain unchanged. Some management operations (such as parameter configuration and specifications change) are temporarily unavailable. After the specifications change is complete in the background, the instance changes to the new specifications and becomes available again.
    • If the specifications change of a master/standby or Cluster instance fails, the instance is still available for use with its original specifications. Some management operations (such as parameter configuration, backup, restoration, and specifications change) are temporarily unavailable. Remember not to read or write more data than allowed by the original specifications. Otherwise, data loss may occur.