获取OB集群TOPO
更新时间：2025-10-23
获取OB集群TOPO
接口描述
本接口用于查询指定实例ID的集群TOPO数据，包含副本信息。
请求结构
Plain Text
1GET /v{version}/ddc/ob/instance/{instanceId}/topology HTTP/1.1
2Host: ddc.bj.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号。 |
| instanceId | String | 是 | URL参数 | 集群ID |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| replicaList | List<ObReplica> | 副本信息列表 |
ObReplica
| 参数名称 | 类型 | 描述 |
|---|---|---|
| status | String | 状态。 |
| readOnlyReplicaType | ObReadOnlyReplicaType | 只读副本类型。 |
| cpu | Integer | 副本的CPU。 |
| mem | Long | 副本的内存。 |
| diskSize | Double | 副本的磁盘大小。 |
| replicaResource | ObTenantResource | 副本的资源配置。该配置为所有节点资源配置的总和。 |
| nodeNum | Integer | 节点数。 |
| replicaType | ObReplicaType | 副本类型。 |
| logicalZone | String | 副本逻辑可用区，OB侧的可用区概念，示例值：cn-bd-b-z0。 |
| zoneRegionName | String | 副本可用区。示例值：cn-bd-b。 |
| readonlyInstanceId | String | 只读副本实例ID。仅只读副本和列存副本时该值有效。 |
请求示例
Plain Text
1GET http://ddc.bj.baidubce.com/v1/ddc/ob/instance/ob6oqa3a891obk/topology
2Host: ddc.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3Date: Wed, 08 Jul 2015 03:28:11 GMT
4x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
5Server: BWS
6{
7 "replicaList": [
8 {
9 "expireDate": 0,
10 "zoneLogicalId": 1,
11 "status": "ACTIVE",
12 "readOnlyReplicaType": "NOT_READONLY_REPLICA",
13 "cpu": 4,
14 "mem": 16,
15 "diskSize": 50.0,
16 "replicaResource": {
17 "cpu": {
18 "totalCpu": 4.0,
19 "usedCpu": 2.0
20 },
21 "memory": {
22 "totalMemory": 16.0,
23 "usedMemory": 4.0
24 },
25 "disk": {
26 "totalDiskSize": 50.0,
27 "usedDiskSize": 0.21
28 }
29 },
30 "nodeNum": 1,
31 "replicaType": "FULL",
32 "logicalZone": "cn-bd-b-z0",
33 "zoneRegionName": "cn-bd-b"
34 }
35 ]
36}评价此篇文章