展示主实例关联的只读组列表
更新时间：2023-09-20
接口说明
展示主实例关联的只读组列表。
请求结构
Plain Text
1GET /v{version}/rds/{sourceAppId}/rogroup/list HTTP/1.1
2HOST: rds.bj.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | Integer | 是 | URL参数 | API 版本号 |
| sourceAppId | String | 是 | URL参数 | 指定实例ID |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| roGroupId | String | 只读组ID |
| status | String | 只读组状态 |
| roGroupName | String | 只读组名称 |
| endpoint | Dict | 只读组连接信息 |
| sourceAppId | String | 指定实例ID |
| instanceShortId | String | 实例短ID |
| appAmount | String | 只读组绑定只读实例数量 |
| appList | AppList | 只读组详情 |
| vpcId | String | VPC ID |
| subnetId | String | 子网ID |
| enableDelayOff | Boolean | 是否启用延迟剔除。true：启用，false：未启用 |
| delayThreshold | Integer | 延迟阈值 |
| leastAppAmount | Integer | 组内最少保留实例数目 |
| balanceReload | Boolean | 是否启用重新负载均衡开关,true：启用，false：未启用。 |
| bgwGroupExclusive | Boolean | 分配到共享集群还是专属集群,true：共享集群、false专属集群。 |
| bgwGroupId | String | 集群ID |
| vpcVo | SimpleVpcVo | vpcVo 对象 |
| subnetVo | SubnetVo | 子网对象 |
| region | String | 地域。如：bj、cd |
Dict 对象
| 参数名称 | 类型 | 描述 |
|---|---|---|
| entryHost | String | 主机 |
| entryPort | Integer | 端口 |
| vnetIp | String | 内网IP |
| inetIp | String | 公网IP |
| eipStatus | String | 公网状态。closed：关闭、online：开通 |
AppList 对象
| 参数名称 | 类型 | 描述 |
|---|
| 参数名称 | 类型 | 描述 |
|---|---|---|
| vpcId | String | vpcID |
| shortId | String | vpc短ID |
| name | String | vpc名称 |
| cidr | String | Ipv4地址Ipv4地址 |
| status | Integer | 子网状态 0表示可用、1表示创建中、大于等于2时表示不可用 |
| createTime | Date | 创建时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z'。 |
| description | String | 子网描述。 |
| defaultVpc | Boolean | 是否默认子网。 true：有、false：没有；默认false |
| ipv6Cidr | String | Ipv4地址 |
| auxiliaryCidr | List<String> | Ipv4地址（vpc辅网络） |
| relay | Boolean | 是否开启replay。true：开启、false：未开启；默认false |
SimpleVpcVo
| 参数名称 | 类型 | 描述 |
|---|---|---|
| name | String | vpc名称 |
| subnetId | String | 子网ID |
| az | String | 逻辑区域名称，zone+大些字母，例如zoneE |
| cidr | String | Ipv4地址 |
| ipv6Cidr | String | Ipv6地址 |
| vpcId | String | vpcID |
| vpcShortId | String | vpc短ID |
| subnetUuid | String | 子网唯一序列号 |
| accountId | String | 账号 |
| subnetType | Intger | 设备类型 BCC(1), BBC（2）, BCC_NAT（3）,BBC_NAT（4） |
| type | Intger | 网络类型 未分配（-1） VPC(0),SUBNET(1),ROUTE_TABLE(2), ROUTE_RULE(3), ACL_RULE(4), ENI(5); |
| createdTime | String | 创建时间 年-月-日 时:分:秒 |
| updatedTime | String | 更新时间 年-月-日 时:分:秒 |
| description | String | 描述 |
| shortId | String | 子网 短ID |
| usedIps | String | 使用连接数 |
| totalIps | String | 总数连接数 |
| tags | List<Tag> | 分组标签 |
| zoneName | String | 区域名称 |
请求示例
Plain Text
1GET v1/rds/rdsmap2ojzds5od/rogroup/list HTTP/1.1
2HOST: rds.bj.baidubce.com
3Content-Type: application/json
4Authorization: bce-auth-v1/rdsak/2016-07-03T06:13:13Z/1800/x-bce-date/{signature}返回示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
3Content-Type: application/json
4{
5"roGroupList": [
6 {
7 "roGroupId": "rdsmrg-p9xd56s7",
8 "status": "available",
9 "roGroupName": "rdsmrg",
10 "endpoint": {
11 "entryHost": "rdsmrg.rdsmrg-p9xd56s7.rds.bj.baidubce.com",
12 "entryPort": 3306,
13 "vnetIp": "192.168.48.20",
14 "inetIp": "",
15 "eipStatus": "closed"
16 },
17 "sourceAppId": "rdsmap2ojzds5od",
18 "instanceShortId": "rds-b3VFCjMA",
19 "appAmount": 1,
20 "appList": [
21 {
22 "appId": "rdsmdvr8simmfn4",
23 "appName": "mysql56",
24 "weight": 50,
25 "roGroupId": "rdsmrg-p9xd56s7",
26 "sourceAppId": "rdsmap2ojzds5od",
27 "status": "online",
28 "createTime": "2023-09-19 20:21:44",
29 "updateTime": "2023-09-19 20:21:46",
30 "appStatus": "available",
31 "appIdShort": "rds-wI2F7KOC"
32 }
33 ],
34 "vpcId": "65554ee8-9094-4d13-99fb-7a0f23b687d2",
35 "subnetId": "87d3c2d1-1059-484a-8b57-40ee473405fd",
36 "enableDelayOff": true,
37 "delayThreshold": 10,
38 "leastAppAmount": 1,
39 "balanceReload": true,
40 "bgwGroupExclusive": false,
41 "bgwGroupId": "",
42 "vpcVo": {
43 "vpcId": "65554ee8-9094-4d13-99fb-7a0f23b687d2",
44 "shortId": "vpc-70pxg3pmv8rv",
45 "name": "default",
46 "cidr": "192.168.0.0/16",
47 "status": 0,
48 "createTime": "2021-09-17T08:00:27Z",
49 "description": "default",
50 "defaultVpc": true,
51 "ipv6Cidr": "",
52 "auxiliaryCidr": null,
53 "relay": false
54 },
55 "subnetVo": {
56 "name": "系统预定义子网E",
57 "subnetId": "87d3c2d1-1059-484a-8b57-40ee473405fd",
58 "az": "zoneE",
59 "cidr": "192.168.48.0/20",
60 "ipv6Cidr": "",
61 "vpcId": "65554ee8-9094-4d13-99fb-7a0f23b687d2",
62 "vpcShortId": "vpc-70pxg3pmv8rv",
63 "subnetUuid": "87d3c2d1-1059-484a-8b57-40ee473405fd",
64 "accountId": "3aa23ba0d8734fe5a77a4399401a916b",
65 "subnetType": 1,
66 "type": 1,
67 "createdTime": "2021-09-17T08:00:32Z",
68 "updatedTime": "2021-09-17T16:00:32Z",
69 "description": "",
70 "shortId": "sbn-gr4nfq5wv8si",
71 "usedIps": -1,
72 "totalIps": -1,
73 "tags": null,
74 "enable_ipv6": null
75 },
76 "region": "bj"
77 }
78 ]
79}