只读实例加入只读组
更新时间：2023-09-20
接口说明
只读实例加入只读组，可以单条加入只读组或者批量添加字读组（最多不超过4个）。
请求结构
PUT /v{version}/rds/{sourceAppId}/rogroup/{roGroupId}/join HTTP/1.1
HOST: rds.bj.baidubce.com
Authorization: authorization string
{"readReplicaList":[
{
"appId":"appId",
"appName":"appName",
"weight":weight,
"roGroupId":"roGroupId",
"sourceAppId":"sourceAppId",
"status":"status",
"createTime":"createTime",
"updateTime":"updateTime",
"appStatus":"appStatus",
"appIdShort":"rds-kSXJSmAk"
}
]
}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | Integer | 是 | URL参数 | API 版本号 |
| sourceAppId | String | 是 | URL参数 | 指定实例Id |
| roGroupId | String | 是 | URL参数 | 只读组Id |
| readReplicaList | List<AppList> | 是 | RequestBody参数 | 要加入的只读实例列表其中readReplica字段：1）appId String 只读实例ID2）weight Int 权重 |
AppList
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
|---|---|---|---|---|
| appId | String | 是 | AppList对象内 | 只读实例短ID |
| appName | String | 是 | AppList对象内 | 只读实例名称 |
| weight | Integer | 是 | AppList对象内 | 权重 |
| roGroupId | String | 是 | AppList对象内 | 只读组ID |
| sourceAppId | String | 是 | AppList对象内 | 资源ID |
| status | String | 是 | AppList对象内 | 只读组实例状态：joining(正在加入RO组), online(已加入RO组), leaving(正在离开RO组), offline(已离开RO组), weightUpdating(在更新权重),delay_offline(正在更新权重)，这里是只读组加入所以设置为online |
| createTime | String | 是 | AppList对象内 | 创建时间 格式：年-月-日 时:分:秒 |
| updateTime | String | 是 | AppList对象内 | 更新时间 格式：年-月-日 时:分:秒 |
| appStatus | String | 是 | AppList对象内 | 只读实例状态，参见实例状态表， 这里因为是加入只读组状态设置为 available |
| appIdShort | String | 是 | AppList对象内 | 只读实例短ID |
返回头域
除公共头域，无其它特殊头域。
返回参数
无特殊返回参数。
请求示例
PUT /v{version}/rds/rdsmap2ojzds5od/rogroup/rdsmrg-s71pji95/join HTTP/1.1
HOST: rds.bj.baidubce.com
Content-Type: application/json
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2017-11-21T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
"readReplicaList":[
{
"appId":"rds-wI2F7KOC",
"appName":"mysql56",
"weight":50,
"roGroupId":"rdsmrg-s71pji95",
"sourceAppId":"rdsmap2ojzds5od",
"status":"online",
"createTime":"2021-09-20 11:00:31",
"updateTime":"2021-09-20 11:00:31",
"appStatus":"available",
"appIdShort":"rds-wI2F7KOC"
}
]
}返回示例
HTTP/1.1 200 OK
x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
Content-Type: application/json