操作场景
副本升主（Replica Promotion） 指在检测到主节点存在潜在风险或触发告警时，通过手动操作将数据同步完备的从节点提升为新主节点的过程。该操作可在主节点发生实际故障前实现热切换，保障数据服务零中断，是预防性维护的核心运维能力。
版本说明
将副本节点提升为主节点（组）的原理是在集群中执行 cluster failover 命令，实现将主节点的角色切换到从节点。具体支持的版本信息如下所示。
存储引擎 | 支持的版本 | 支持的架构 |
Redis 版 | 4.0及以上 | 标准架构、集群架构 |
Valkey 版 | 8.0 | 标准架构、集群架构 |
Memcached 版 | 不支持 | |
注意事项
提主过程中服务会有短暂访问抖动，抖动的时间在几秒到3分钟以内，切换过程中 BLPOP、BRPOP、BRPOPLPUSH、SUBSCRIBE 等阻塞命令会有一次或者多次失败。
副本提主切换过程中，将会存在1分钟内的实例只读和业务闪断；执行过程可能会失败，通常重试即可执行成功。
说明：
多可用区部署的标准架构实例，切换主节点后，您的访问可能会跨可用区，导致访问延迟增加，QPS 降低。
前提条件
数据库版本要求：Redis 4.0及其以上， ValKey 8.0。
实例状态为运行中。
操作步骤
1. 登录 Redis 控制台。
2. 在右侧实例列表页面上方，选择地域。
3. 在实例列表中，找到需进行副本提主的多可用区实例。
4. 单击实例 ID，进入实例详情页面。
5. 在实例详情页面，单击节点管理页签，单击页面右上方的副本提主。
6. 在提升为主节点或主可用区的窗口，多可用区部署，配置新的主节点，以便将新主节点所在可用区标记为新主可用区，并设置切换时间，如下图所示。
标准架构
集群架构
界面参数 | 参数含义 | 配置方式 |
实例 ID | 当前待副本提主的多可用区实例 ID。 | 确认实例正确。 |
内存配置 | 当前实例内存配置规格。 | 确认实例的规格信息。 |
原主节点 ID | 多 AZ标准架构显示当前主节点的 ID。 | 确认当前主节点的 ID 信息。 |
新主节点 ID | 多 AZ 标准架构显示该参数，配置需切换为主节点的副本节点。 | 请在下拉列表选择待提升为主节点的副本节点。 |
原主节点组 | 多 AZ 集群架构显示该参数，显示当前主节点组名称。 | 确认当前主节点组名称。 |
新主节点组 | 多 AZ 集群架构显示该参数，配置需切换为主节点组的备节点组。 | 请在下拉列表选择待提升为主节点组的备节点组。 |
切换时间 | 选择副本提主的切换时间段。 | 立即切换：将立即发起切换任务。 维护时间窗切换：即在维护时间窗发起切换任务，维护时间窗相关介绍与配置，请参见 设置维护时间窗。 |
7. 配置完成，确认无误后，单击确定。
相关 API
API 接口 | 接口含义 |
该接口仅支持多 AZ 实例副本组提主和单 AZ 副本提主。 |
