创建只读组
更新时间:2023-09-20
请求接口
创建只读组。
请求结构
Plain Text
1POST /v{version}/rds/{sourceAppId}/rogroup HTTP/1.1
2HOST: rds.bj.baidubce.com
3Authorization: authorization string
4{
5 "sourceAppId":"sourceAppId",
6 "vpcId":"vpcId",
7 "subnetId":"subnetId",
8 "roGroupName":"roGroupName",
9 "enableDelayOff":enableDelayOff,
10 "delayThreshold":delayThreshold,
11 "leastAppAmount":leastAppAmount,
12 "balanceReload":balanceReload,
13 "bgwGroupExclusive":bgwGroupExclusive,
14 "bgwGroupId":"bgwGroupId",
15 "entryPort":entryPort,
16 "vnetIp":"vnetIp"
17}
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
---|---|---|---|---|
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:已开通 |
请求示例
Plain Text
1POST rds.bj.baidubce.com/v1/rds/rdsmap2ojzds5od/rogroup 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 "vpcId" : "45bea742-96c5-43ed-8a8b-1f989ecda9f1",
7 "subnetId" : "a5113dbf-841e-4f50-9b69-5c0f73e9a50e"
8}
返回示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
3Content-Type: application/json
4{
5"roGroupId": "rdsmrg-p9xd56s7",
6"status": "creating",
7"roGroupName": "rdsmrg",
8"endpoint": {
9 "entryHost": "rdsmrg.rdsmrg-p9xd56s7.rds.bj.baidubce.com",
10 "entryPort": 3306,
11 "vnetIp": "",
12 "inetIp": "",
13 "eipStatus": "closed"
14},
15"sourceAppId": "rdsmap2ojzds5od",
16"appAmount": 0,
17"vpcId": "65554ee8-9094-4d13-99fb-7a0f23b687d2",
18"subnetId": "87d3c2d1-1059-484a-8b57-40ee473405fd",
19"enableDelayOff": false,
20"delayThreshold": 10,
21"leastAppAmount": 1,
22"balanceReload": false,
23"bgwGroupExclusive": false,
24"bgwGroupId": ""
}