此操作用来查询指定服务器。
请求语法
GET /rest/v1/system/server/serverId HTTP/1.1
Date: date
Host: ip:port
Authorization: authorization请求参数
| 参数 | 描述 | 是否必须 |
|---|---|---|
| serverId | 要查询的服务器ID。 如果未指定服务器ID，则查询所有服务器。 类型：字符串 | 否 |
响应结果
| 名称 | 描述 |
|---|---|
| serverName | 服务器名称。 |
| serverId | 服务器ID。 |
| status | 服务器状态：
|
| version | 服务器上的HBlock版本。 |
| isMasterServer | 该服务器是否为Master节点：
|
| isBaseServer | 该服务器是否为基础节点：
|
| publicAddress.ip | 业务网络的IP。 |
| publicAddress.port | 业务网络端口号。 |
| clusterAddress.ip | 集群网络的IP。 |
| clusterAddress.port | 集群网络端口号。 |
| targetPortalIP.ips | iSCSI目标门户IP属性集合，包含：ip、port。 类型：数组 |
| ip | iSCSI目标门户IP。 |
| port | iSCSI目标门户端口号。 |
| targetPortalIP.status | iSCSI目标门户IP状态：
|
| diskPaths | HBlock数据目录信息集合，包含：path、totalCapacity、usedCapacity、usedCapacityQuota、capacityQuota、managementStatus、healthStatus、healthDetail。 类型：数组 |
| path | HBlock数据目录。 |
| totalCapacity | 当前HBlock数据目录对应分区的总容量，单位是字节。 |
| usedCapacity | 服务器上HBlock数据目录对应分区的已用容量，单位是字节。 |
| usedCapacityQuota | HBlock在该数据目录的已写入量，即已用容量配额。单位是字节。 |
| capacityQuota | 数据目录的容量配额。单位是字节。 0表示禁止写入。不输出，表示没有限制。 |
| managementStatus | 数据目录管理状态：
|
| subStatus.stage | 移除数据目录所处的阶段：
|
| subStatus.totalFD | 总的故障域个数。 |
| subStatus.healthyFD | 状态为Healthy的故障域个数。 |
| subStatus.warningFD | 状态为Warning的故障域个数。 |
| subStatus.errorFD | 状态为Error的故障域个数。 |
| subStatus.safeData | 安全数据百分比，单位是%。 |
| subStatus.reconstructionWaitData | 需要重建的数据百分比，单位是%。 |
| subStatus.availFDWaitData | 移除磁盘或者服务器时，数据重建需要的故障域个数不足，因此引发的无法重建的数据百分比。 |
| subStatus.singleCopyLUNData | 单副本数据百分比，单位是%。 |
| subStatus.corruptedData | 已经损坏的数据百分比，单位是%。 |
| subStatus.availFDWaitWarning | 告警信息。 根据状态不同，显示的告警信息不同：
|
| subStatus.singleCopyLUNWarning | |
| subStatus.corruptedWarning | |
| healthStatus | 数据目录健康状态：
|
| healthDetail | 数据目录健康状态详情：
|
| defaultPath | 默认的数据目录（仅单机版支持）。 |
| recentStartTime | HBlock服务在该节点上最近一次成功启动的时间。 服务器未连接时，不返回此项。 |
| ports | HBlock端口的集合。数组，包括portName、port。 |
| portName | HBlock端口名称。 |
| port | HBlock在当前服务器上使用的端口号。 |
| portRange | 端口范围。 |
| iSCSIPort | iSCSI端口。 |
| storagePorts | 存储服务端口集合（仅集群版支持）。 数组，包括portN、diskpath、description、pathId。 |
| portN | 存储服务端口。 |
| diskpath | 存储服务的数据目录。 |
| pathId | 数据目录ID。 |
| nodeName | 节点名称（仅集群版支持）。 |
| parentName | 父节点名称（仅集群版支持）。 |
| description | 节点描述（仅集群版支持）。 |
| baseServices | 基础服务属性的集合（仅集群版基础服务器支持）。数组，包括name、status、metaDir。 |
| name | 基础服务名称：
|
| status | 基础服务的状态：
|
| metaDir | 存储基础服务数据的数据目录。 |
请求示例1
单机版：查询服务器ID为hblock_1的信息。
GET /rest/v1/system/server/hblock_1 HTTP/1.1
Date: Tue, 14 Jan 2025 08:45:46 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.32:1443
响应示例1
HTTP/1.1 200 OK
x-hblock-request-id: 1bc58ab26322494fb2d2e6a5837f6193
Connection: keep-alive
Content-Length: 794
Date: Tue, 14 Jan 2025 08:45:46 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"serverName": "ecs-9689-0915127",
"serverId": "hblock_1",
"status": "Connected",
"version": "3.8.0",
"publicAddress": {
"ip": "192.168.0.32",
"port": 3260
},
"clusterAddress": {
"ip": "192.168.0.32",
"port": 20004
},
"diskPaths": [
{
"path": "/mnt/stor",
"usedCapacity": 35861303296,
"totalCapacity": 100169342976,
"usedCapacityQuota": 356576,
"managementStatus": "Added",
"healthStatus": "Healthy",
"healthDetail": []
}
],
"defaultPath": "/mnt/stor",
"recentStartTime": 1735873608983,
"ports": [
{
"portName": "apiPort",
"port": 1443
},
{
"portName": "webPort",
"port": 2443
},
{
"portName": "managementPort1",
"port": 20004
},
{
"portName": "managementPort2",
"port": 20000
},
{
"portName": "managementPort3",
"port": 20002
},
{
"portName": "managementPort4",
"port": 20003
},
{
"portName": "managementPort6",
"port": 20001
}
],
"portRange": "20000-20500",
"iSCSIPort": 3260
}
}
请求示例2
集群版：查询服务器ID为hblock_2的信息。
GET /rest/v1/system/server/hblock_2 HTTP/1.1
Date: Mon, 25 Nov 2024 09:29:43 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.117:1443
响应示例2
HTTP/1.1 200 OK
x-hblock-request-id: 23faa39b4637441194e988a0b40cf266
Connection: keep-alive
Content-Length: 1414
Date: Mon, 25 Nov 2024 09:29:43 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"serverName": "ecs-9689-0915142",
"serverId": "hblock_2",
"status": "Connected",
"version": "3.8.0",
"isMasterServer": false,
"isBaseServer": true,
"publicAddress": {
"ip": "192.168.0.117",
"port": 3260
},
"clusterAddress": {
"ip": "192.168.0.117",
"port": 20008
},
"diskPaths": [
{
"path": "/mnt/storage02",
"storagePool": "default",
"usedCapacity": 18030116864,
"totalCapacity": 35963482112,
"usedCapacityQuota": 69632,
"managementStatus": "Added",
"healthStatus": "Healthy",
"healthDetail": []
}
],
"recentStartTime": 1732519209900,
"ports": [
{
"portName": "apiPort",
"port": 1443
},
{
"portName": "webPort",
"port": 2443
},
{
"portName": "managementPort1",
"port": 20008
},
{
"portName": "managementPort2",
"port": 20013
},
{
"portName": "managementPort3",
"port": 20004
},
{
"portName": "managementPort4",
"port": 20011
},
{
"portName": "managementPort5",
"port": 20000
},
{
"portName": "managementPort6",
"port": 20010
},
{
"portName": "dataPort1",
"port": 20002
},
{
"portName": "metadataPort4",
"port": 20005
},
{
"portName": "metadataPort5",
"port": 20001
},
{
"portName": "metadataPort6",
"port": 20006
},
{
"portName": "metadataPort7",
"port": 20012
},
{
"portName": "metadataPort8",
"port": 20007
}
],
"portRange": "20000-20500",
"iSCSIPort": 3260,
"storagePorts": [
{
"port1": 20003,
"port2": 20014,
"port3": 20009,
"diskpath": "/mnt/storage02",
"pathId": "1"
}
],
"nodeName": "default:hblock_2",
"parentName": "default",
"baseServices": [
{
"name": "ls",
"status": "Up",
"metaDir": "/mnt/storage02"
},
{
"name": "cs",
"status": "Up",
"metaDir": "/mnt/storage02"
}
]
}
}
