Tair (Redis OSS-compatible) lets you switch an instance between the standard (master-replica) and cluster architectures.
Limitations
Not all instance types support architecture changes. Review the table below before proceeding.
| Instance type | Standard to cluster | Cluster to standard |
|---|---|---|
| Standard instance with read/write splitting enabled | Disable read/write splitting first | Disable read/write splitting first |
| Child instance of a distributed instance | Not supported | Not supported |
| Tair (Enterprise Edition) SSD-based instance | Not supported | Not supported |
| Cluster instance in direct connection mode | — | Not supported |
Billing
Charges depend on your billing method:
Pay-as-you-go: Billed at the new specification rate immediately after the change.
Subscription: Charged or refunded the price difference depending on whether you upgrade or downgrade.
For details, see Configuration changes.
Change from standard (master-replica) to cluster
Before you begin
Review these impacts before starting the change.
Endpoints, accounts, passwords, and whitelists remain unchanged. No application code changes are required.
Data is typically preserved. In the rare event that the primary node fails during switchover, a small amount of unsynchronized data may be lost.
1–2 transient disconnections, each under 30 seconds. Make sure your application has a reconnection mechanism.
Read-only state for about 1 minute. The instance enters read-only mode while the new instance syncs incremental data and DNS cache clears. High write-load instances may experience a longer read-only period.
Lua scripts may be lost. Back up your Lua scripts before proceeding. For details, see Special limits on cluster instances.
Additional command limitations apply. Some commands are not supported in cluster architecture. Evaluate the impact on your workload before changing. For details, see Command limitations for cluster instances.
Instance is upgraded to the latest minor version. Minor versions are forward-compatible, so no compatibility issues are expected.
Change the architecture
Log on to the console and go to the Instances page. In the top navigation bar, select the region where your instance resides, then click the instance ID.
In the upper-right corner, click Specification Adjustment, then:
For a subscription instance: select Specification Upgrade.
For a pay-as-you-go instance: select Specifications Upgrade/Downgrade.
On the specification change page, select the target configuration, then click Buy Now. For the Switching Time parameter, choose one of the following options:
Option Behavior Switch Within Maintenance Window (recommended) The switchover runs during the maintenance window (off-peak hours). Before the switchover, go to Task Hub and click Modify Switchover Time to adjust the time if needed. Switch after Data Migration The switchover runs immediately after data migration completes. Complete the payment as prompted.
After you submit the request, the instance status changes to Adjusting configuration regardless of the switching time you selected. This status does not affect your running services — the system is preparing resources and syncing data in the background. Transient disconnections only occur at the moment of switchover.
After the change
Connection mode defaults to proxy mode. Monitor client connections on the proxy node monitoring page. The connection count on data nodes is displayed as 0.
Alert settings are disabled. Existing application groups in CloudMonitor may also be disabled. Reconfigure them to resume monitoring.
Data flashback is disabled. Reconfigure the feature to resume point-in-time recovery.
Change from cluster to standard (master-replica)
Before you begin
Review these impacts before starting the change.
Endpoints, accounts, passwords, and whitelists remain unchanged. No application code changes are required.
Data is typically preserved. In the rare event that the primary node fails during switchover, a small amount of unsynchronized data may be lost.
1–2 transient disconnections, each under 30 seconds. Make sure your application has a reconnection mechanism.
Read-only state for about 1 minute. The instance enters read-only mode while the new instance syncs incremental data and DNS cache clears. High write-load instances may experience a longer read-only period.
Instance is upgraded to the latest minor version. Minor versions are forward-compatible, so no compatibility issues are expected.
Change the architecture
Log on to the console and go to the Instances page. In the top navigation bar, select the region where your instance resides, then click the instance ID.
In the upper-right corner, click Specification Adjustment, then:
For a subscription instance: select Specification Downgrade.
For a pay-as-you-go instance: select Specifications Upgrade/Downgrade.
On the specification change page, select the target configuration, then click Buy Now. For the Switching Time parameter, choose one of the following options:
Option Behavior Switch During Maintenance Window (recommended) The switchover runs during the maintenance window (off-peak hours). Before the switchover, go to Task Hub and click Modify Switchover Time to adjust the time if needed. Switch after Data Migration The switchover runs immediately after data migration completes. Complete the payment as prompted.
After you submit the request, the instance status changes to Adjusting configuration regardless of the switching time you selected. This status does not affect your running services — the system is preparing resources and syncing data in the background. Transient disconnections only occur at the moment of switchover.
After the change
Alert settings are disabled. Existing application groups in CloudMonitor may also be disabled. Reconfigure them to resume monitoring.
Data flashback is disabled. Reconfigure the feature to resume point-in-time recovery.
FAQ
Do I need to pause read and write operations during a specification change?
Is data automatically migrated to each shard when changing to cluster?
Does the number of databases change after an architecture change?
What does the error "The direct custins can not trans to normal custins" mean?
Can I change a high-availability (dual-replica) instance to a single-replica instance?
Can I change the storage medium for a Tair (Enterprise Edition) instance?
Can a classic instance be directly upgraded to a cloud-native instance?
How long does an architecture change take?
The duration depends on network conditions, request volume, and data size, so it cannot be predicted in advance.
Track progress by clicking the 
icon in the upper-right corner of the instance details page.
Do I need to pause read and write operations during a specification change?
Is data automatically migrated to each shard when changing to cluster?
Yes. The system migrates the data automatically and distributes it evenly across all shards.
Does the number of databases change after an architecture change?
Are backup sets lost after a specification change?
No. Backup sets are preserved. However, when you reduce the number of shards for a classic cluster instance or change its architecture to standard, the mapping between historical backup sets and instance nodes changes.
To locate historical backup sets in this case, search by backup time or backup set ID. To restore data, download the backup set (RDB file), parse it, and import the data into the new instance.
Why are configurations not updated after the change?
This is usually caused by a metadata cache refresh delay. Wait a few minutes, then refresh the page.