热活实例组强切
更新时间：2021-03-29
请求头域
除公共头域外，无其它特殊头域。
请求结构
Plain Text
1PUT /v{version}/instance/{groupId}/forceChange HTTP/1.1
2HOST: rds.bj.baidubce.com
3Authorization: authorization string
4{
5 "leaderId" : "leaderId",
6 "force" : force,
7 "maxBehind" : maxBehind
8}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | string | 是 | URL参数 | API 版本号 |
| groupId | string | 是 | URL参数 | 实例组id |
| leaderId | string | 是 | RequestBody参数 | 实例组中要切换为主角色的实例id |
| force | int | 否 | RequestBody参数 | 0 - 非故障（非故障状态时使用）1 - 故障 |
| maxBehind | int | 否 | RequestBody参数 | 最大允许备库Behind_Master值（0 表示要求备库和故障主库数据完全一致，建议业务从0开始逐步增加，直至最大容忍值，force=0时，该参数不生效 ） |
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| behindMaster | int | 切换时备库延迟 |
请求示例
Plain Text
1GET /v1/instance/rdcj5d7hs0c/forceChange HTTP/1.1
2HOST: rds.bj.baidubce.com
3Authorization: bce-auth-v1/rdsak/2016-07-03T06:13:13Z/1800/x-bce-date/{signature}
4{
5 "leaderId" : "rds-y9dJu77d",
6 "force" : 1,
7 "maxBehind" : 10
8}返回示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
3ETag:xxx-xxx-xxx
4Content-Type: application/json
5Content-Length: 567
6
7{
8 "behindMaster": 0
9}