热活实例组强切
更新时间：2021-03-29
请求头域
除公共头域外，无其它特殊头域。
请求结构
PUT /v{version}/instance/{groupId}/forceChange HTTP/1.1
HOST: rds.bj.baidubce.com
Authorization: authorization string
{
"leaderId" : "leaderId",
"force" : force,
"maxBehind" : maxBehind
}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
|---|---|---|---|---|
| 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 | 切换时备库延迟 |
请求示例
GET /v1/instance/rdcj5d7hs0c/forceChange HTTP/1.1
HOST: rds.bj.baidubce.com
Authorization: bce-auth-v1/rdsak/2016-07-03T06:13:13Z/1800/x-bce-date/{signature}
{
"leaderId" : "rds-y9dJu77d",
"force" : 1,
"maxBehind" : 10
}返回示例
HTTP/1.1 200 OK
x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
ETag:xxx-xxx-xxx
Content-Type: application/json
Content-Length: 567
{
"behindMaster": 0
}