代理节点替换API

更新时间：2026-08-27

请求说明

云数据库 Redis（SCS）支持通过调用API替换实例中的代理节点（Proxy）。代理节点是实例的接入层组件，负责客户端连接管理、请求转发与负载均衡，是实例高可用的关键一环。当单个或多个代理节点出现异常时，可通过本接口在控制台或通过OpenAPI一键完成替换，替换后的新节点会自动同步配置并重新接入集群。

使用说明：

• Redis 标准架构、集群架构均支持代理节点替换。
• 支持替换单个代理节点，也支持批量替换多个代理节点。
• 实例状态须为「运行中」才可执行替换。
• 执行时间支持「立即执行」与「维护窗口执行」两种方式：isDefer=false 表示立即执行，isDefer=true 表示创建维护窗口任务。
• 替换代理节点期间，连接中断时间小于 1 分钟，建议在业务低峰期执行，并确保业务具备自动重连能力。
• 实例存在待执行的备份、扩容、迁移等任务时，不支持执行替换。

请求结构

Plain Text

1PUT /v1/instance/{instanceId}/proxyNode
2Host: scs.bj.baidubce.com
3Authorization: authorization string
4{
5    "proxyList": ["proxy-node-1", "proxy-node-2"],
6    "defer": false
7}

请求头域

除公共请求头域外，无其它特殊头域。

请求参数

返回头域

除公共头部，无其它特殊头部。

返回参数

无。

请求示例

Plain Text

1PUT /v1/instance/scs-bj-elahimuhxjia/proxyNode
2Host: scs.bj.baidubce.com
3Authorization: authorization string
4{
5    "proxyList": ["proxy-node-1", "proxy-node-2"],
6    "defer": false
7}

返回示例

Plain Text

1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3x-bce-request-id: 73c4e74c-310d-4a5e-8d4e-d70b9e0a2e33

说明：文档基于「Redis 支持代理节点替换」PRD v1.1（2026-07-27）及控制台「替换代理节点」接口定义整理。如与实际接口存在差异，请以控制台实际能力为准。