创建只读组
更新时间：2023-09-20
请求接口
创建只读组。
请求结构
POST /v{version}/rds/{sourceAppId}/rogroup HTTP/1.1
HOST: rds.bj.baidubce.com
Authorization: authorization string
{
"sourceAppId":"sourceAppId",
"vpcId":"vpcId",
"subnetId":"subnetId",
"roGroupName":"roGroupName",
"enableDelayOff":enableDelayOff,
"delayThreshold":delayThreshold,
"leastAppAmount":leastAppAmount,
"balanceReload":balanceReload,
"bgwGroupExclusive":bgwGroupExclusive,
"bgwGroupId":"bgwGroupId",
"entryPort":entryPort,
"vnetIp":"vnetIp"
}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | Integer | 是 | URL参数 | API 版本号 |
| sourceAppId | String | 是 | URL参数 | 指定实例 ID |
| vpcId | String | 是 | RequestBody参数 | VPC ID |
| subnetId | String | 是 | RequestBody参数 | 子网 ID |
| roGroupName | String | 否 | RequestBody参数 | 只读组名称 |
| enableDelayOff | Boolean | 否 | RequestBody参数 | 是否启用延迟剔除，默认为关闭。启用后，组内的只读实例一旦发生延迟且达到阈值后，在满足最少实例保留数目条件下会将其剔除出组 |
| leastAppAmount | Integer | 否 | RequestBody参数 | 组内最少保留实例数目，取值为0~5之间的整数。默认为1 |
| balanceReload | Boolean | 否 | RequestBody参数 | 是否启用重新负载均衡开关，默认为关闭。启用后，组内只读实例发生权重修改时会断开老连接 |
| bgwGroupExclusive | Boolean | 否 | RequestBody参数 | 分配到共享集群还是专属集群，默认false |
| bgwGroupId | String | 否 | RequestBody参数 | 集群ID， 如果传了，要将blb分配到哪个集群；如果不传有专属集群用默认配置最少的专属集群，没有专属集群用配置最少的共享集群 |
| entryPort | Integer | 否 | RequestBody参数 | 服务端口，MySQL默认为3306 |
| vnetIp | String | 否 | RequestBody参数 | 内网IP |
| delayThreshold | Integer | 否 | RequestBody参数 | 延迟阈值，取值为大于等于0的整数。默认为10 |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 描述 | |
|---|---|---|
| roGroupId | String | 只读组ID |
| status | String | 只读组状态：creating |
| roGroupName | Boolean | 只读组名称 。支持数字、大小写字母、中文以及英文下划线，字母开头且不超过32个字符 |
| sourceAppId | String | 指定实例 ID |
| appAmount | Integer | 绑定资源数，创建时，默认为0 |
| vpcId | String | VPC ID |
| subnetId | String | 子网 ID |
| enableDelayOff | Boolean | RequestBody参数 |
| delayThreshold | Integer | 延迟阈值，取值为大于等于0的整数。默认为10 |
| leastAppAmount | Integer | 组内最少保留实例数目，取值为0~5之间的整数。默认为1 |
| balanceReload | Boolean | 是否启用重新负载均衡开关，默认为关闭。启用后，组内只读实例发生权重修改时会断开老连接 |
| bgwGroupExclusive | Boolean | 分配到共享集群还是专属集群，默认false |
| bgwGroupId | String | 否 |
| endpoint | Dict | endpoint 连接信息对象 |
Dict
| 参数名称 | 类型 | 描述 |
|---|---|---|
| entryHost | String | 服务主机，例如：rdsmrg.rdsmrg-p9xd56s7.rds.bj.baidubce.com |
| entryPort | Integer | 服务端口，MySQL默认为3306 |
| vnetIp | String | 内网IP |
| inetIp | String | 公网IP |
| eipStatus | String | 公网IP状态， close：关闭、available：已开通 |
请求示例
POST rds.bj.baidubce.com/v1/rds/rdsmap2ojzds5od/rogroup 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
{
"vpcId" : "45bea742-96c5-43ed-8a8b-1f989ecda9f1",
"subnetId" : "a5113dbf-841e-4f50-9b69-5c0f73e9a50e"
}返回示例
HTTP/1.1 200 OK
x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
Content-Type: application/json
{
"roGroupId": "rdsmrg-p9xd56s7",
"status": "creating",
"roGroupName": "rdsmrg",
"endpoint": {
"entryHost": "rdsmrg.rdsmrg-p9xd56s7.rds.bj.baidubce.com",
"entryPort": 3306,
"vnetIp": "",
"inetIp": "",
"eipStatus": "closed"
},
"sourceAppId": "rdsmap2ojzds5od",
"appAmount": 0,
"vpcId": "65554ee8-9094-4d13-99fb-7a0f23b687d2",
"subnetId": "87d3c2d1-1059-484a-8b57-40ee473405fd",
"enableDelayOff": false,
"delayThreshold": 10,
"leastAppAmount": 1,
"balanceReload": false,
"bgwGroupExclusive": false,
"bgwGroupId": ""}