此操作用来查询指定拓扑节点。
请求语法
GET /rest/v1/system/topology/nodeName HTTP/1.1
Date: date
Content-Type: application/json; charset=utf-8
Host: ip:port
Authorization: authorization
请求参数
参数 描述 是否必须 nodeName 要查询的拓扑节点。
不支持查询path级别的节点信息。
类型:字符串
是
响应结果
名称 描述 name 拓扑节点名称。 fullname 节点在集群中的全路径名称,从根节点开始,使用name:name:name格式来唯一标识该节点的名称。 id 拓扑节点ID。 type 节点的类型:
server:服务器类型。
rack:机架类型。
room:机房类型。
root:根节点。
description 节点描述。
childNodes 子节点信息集合,根据子节点类型不同,展示的信息不同。 子节点类型为room name 子节点名称。 fullname 节点在集群中的全路径名称,从根节点开始,使用name:name格式来唯一标识该节点的名称。 id 节点ID。 type 节点类型。 description 节点描述。
子节点类型为rack name 子节点名称。 fullname 节点在集群中的全路径名称,从根节点开始,使用name:name:name格式来唯一标识该节点的名称。 id 节点ID。 type 节点类型。 description 节点描述。
子节点类型为server name 子节点名称。 fullname 节点在集群中的全路径名称,从根节点开始,使用name:name:name格式来唯一标识该节点的名称。 id 节点ID。 serverId 服务器ID。 type 节点类型。 description 节点描述。
clusterAddress 拓扑图集群网络IP。 publicAddress 拓扑图业务网络IP。 allDiskPaths.usedCapacity 服务器上HBlock数据目录对应分区的已用容量,单位是字节。 allDiskPaths.totalCapacity 服务器上HBlock数据目录对应分区的总容量,单位是字节。 serverStatus 服务器状态:
Connected:已连接。
Disconnected:未连接。
Removing:移除中。
子节点类型为path name 子节点名称。 fullname 节点在集群中的全路径名称,从根节点开始,使用name:name:name格式来唯一标识该节点的名称。 id 节点ID。 serverId 服务器ID。 type 节点类型。 totalCapacity HBlock数据目录对应分区的总容量,单位是字节。 usedCapacity HBlock数据目录对应分区的已用容量,单位是字节。 capacityQuota 数据目录容量配额。
负整数表示无限制写入。
usedCapacityQuota 数据目录已用容量配额。 storagePool 所属资源池。 healthStatus 数据目录健康状态:
Healthy:数据目录处于健康状态,可正常读写,且数据目录所在磁盘使用率未超过90%。
Warning:数据目录处于警告状态,可读,但存在以下情况的任意一种:慢盘;数据目录所在磁盘使用率超过90%;磁盘剩余空间不足1GiB;或者HBlock对这个目录停写。
Error:数据目录错误状态,无法访问,原因可能是:所在磁盘出现I/O错误导致无法读写,数据目录未正确挂载等。
healthDetail 数据目录健康状态详情:
如果健康状态为Healthy,此字段为空。
如果健康状态为Warning或Error,显示警告或错误的详细信息。
请求示例
查询节点room1。
GET /rest/v1/system/topology/room1 HTTP/1.1
Date: Fri, 2 Aug 2024 10:12:05 GMT
Content-Type: application/json; charset=utf-8
Authorization: HBlock userName:signature
Host: 192.168.0.110:1443
响应示例
HTTP/1.1 200 OK
x-hblock-request-id: a04f0b22a3844518afb8ab61e5bc3757
Connection: keep-alive
Content-Length: 2480
Date: Fri, 2 Aug 2024 10:12:05 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"name": "room1",
"fullname": "default:room1",
"id": "00457811-af8e-4f39-ba6c-f856cdc173f8",
"type": "room",
"childNodes": [
{
"name": "rack2",
"fullname": "default:room1:rack2",
"id": "3f591741-a387-44d2-8ae8-36c4ba546bd2",
"type": "rack",
"childNodes": [
{
"name": "server1",
"fullname": "default:room1:rack2:server1",
"id": "36a55e61-47e5-43f0-9d73-357a86d3ff53",
"serverId": "hblock_1",
"type": "server",
"clusterAddress": "192.168.0.192",
"publicAddress": "192.168.0.192",
"allDiskPaths": {
"usedCapacity": 18887569408,
"totalCapacity": 136132825088
},
"serverStatus": "Connected",
"childNodes": [
{
"name": "/mnt/stor",
"fullname": "default:room1:rack2:server1:/mnt/stor",
"id": "d14f3938-a6de-4950-87bc-e461d743284a",
"serverId": "hblock_1",
"type": "path",
"totalCapacity": 100169342976,
"usedCapacity": 11510775808,
"capacityQuota": -1,
"usedCapacityQuota": 172032,
"storagePool": "default",
"healthStatus": "Healthy",
"healthDetail": []
},
{
"name": "/mnt/storage01",
"fullname": "default:room1:rack2:server1:/mnt/storage01",
"id": "9999d96e-1032-404c-85de-4c76f8100e12",
"serverId": "hblock_1",
"type": "path",
"totalCapacity": 35963482112,
"usedCapacity": 7376793600,
"capacityQuota": -1,
"usedCapacityQuota": 106496,
"storagePool": "default",
"healthStatus": "Healthy",
"healthDetail": []
}
]
}
]
},
{
"name": "server2",
"fullname": "default:room1:server2",
"id": "444dd9a4-88db-4df5-9959-88d7b82edad8",
"serverId": "hblock_2",
"type": "server",
"clusterAddress": "192.168.0.110",
"publicAddress": "192.168.0.110",
"allDiskPaths": {
"usedCapacity": 8582782976,
"totalCapacity": 100169342976
},
"serverStatus": "Connected",
"childNodes": [
{
"name": "/mnt/stor",
"fullname": "default:room1:server2:/mnt/stor",
"id": "1451c75b-2e6f-4cbe-82ab-962019247f35",
"serverId": "hblock_2",
"type": "path",
"totalCapacity": 100169342976,
"usedCapacity": 8582782976,
"capacityQuota": -1,
"usedCapacityQuota": 229376,
"storagePool": "default",
"healthStatus": "Healthy",
"healthDetail": []
}
]
},
{
"name": "server3",
"fullname": "default:room1:server3",
"id": "f89a94bc-2cc3-4ac9-b5dc-13d227b40cf4",
"serverId": "hblock_3",
"type": "server",
"clusterAddress": "192.168.0.102",
"publicAddress": "192.168.0.102",
"allDiskPaths": {
"usedCapacity": 11067289600,
"totalCapacity": 100169342976
},
"serverStatus": "Connected",
"childNodes": [
{
"name": "/mnt/stor",
"fullname": "default:room1:server3:/mnt/stor",
"id": "effad142-9e34-43f4-8390-ccb5c211f60f",
"serverId": "hblock_3",
"type": "path",
"totalCapacity": 100169342976,
"usedCapacity": 11067289600,
"capacityQuota": -1,
"usedCapacityQuota": 229376,
"storagePool": "default",
"healthStatus": "Healthy",
"healthDetail": []
}
]
}
]
}
}