只读实例加入只读组
更新时间：2023-09-20
接口说明
只读实例加入只读组，可以单条加入只读组或者批量添加字读组（最多不超过4个）。
请求结构
Plain Text
1PUT /v{version}/rds/{sourceAppId}/rogroup/{roGroupId}/join HTTP/1.1
2HOST: rds.bj.baidubce.com
3Authorization: authorization string
4 {"readReplicaList":[
5 {
6 "appId":"appId",
7 "appName":"appName",
8 "weight":weight,
9 "roGroupId":"roGroupId",
10 "sourceAppId":"sourceAppId",
11 "status":"status",
12 "createTime":"createTime",
13 "updateTime":"updateTime",
14 "appStatus":"appStatus",
15 "appIdShort":"rds-kSXJSmAk"
16 }
17]
18}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
|---|---|---|---|---|
| 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 |
返回头域
除公共头域，无其它特殊头域。
返回参数
无特殊返回参数。
请求示例
Plain Text
1PUT /v{version}/rds/rdsmap2ojzds5od/rogroup/rdsmrg-s71pji95/join HTTP/1.1
2HOST: rds.bj.baidubce.com
3Content-Type: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2017-11-21T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
5{
6 "readReplicaList":[
7 {
8 "appId":"rds-wI2F7KOC",
9 "appName":"mysql56",
10 "weight":50,
11 "roGroupId":"rdsmrg-s71pji95",
12 "sourceAppId":"rdsmap2ojzds5od",
13 "status":"online",
14 "createTime":"2021-09-20 11:00:31",
15 "updateTime":"2021-09-20 11:00:31",
16 "appStatus":"available",
17 "appIdShort":"rds-wI2F7KOC"
18 }
19 ]
20}返回示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
3Content-Type: application/json