查詢指定服務器
更新時間 2025-09-29 17:49:41
最近更新時間: 2025-09-29 17:49:41
分享文章
本節主要介紹如何使用API查詢指定服務器。
此操作用來查詢指定服務器。
請求語法
GET /rest/v1/system/server/serverId HTTP/1.1
Date: date
Host: ip:port
Authorization: authorization請求參數
| 參數 | 類型 | 描述 | 是否必須 |
|---|---|---|---|
| serverId | String | 要查詢的服務器ID。 如果未指定服務器ID,則查詢所有服務器。 | 否 |
響應結果
| 名稱 | 類型 | 描述 |
|---|---|---|
| serverName | String | 服務器名稱。 |
| serverId | String | 服務器ID。 |
| status | String | 服務器狀態:
|
| version | String | 服務器上的HBlock版本。 |
| isMasterServer | Boolean | 該服務器是否為Master節點:
|
| isBaseServer | Boolean | 該服務器是否為基礎節點:
|
| publicAddress.ip | String | 業務網絡的IP。 |
| publicAddress.port | Integer | 業務網絡端口號。 |
| clusterAddress.ip | String | 集群網絡的IP。 |
| clusterAddress.port | Integer | 集群網絡端口號。 |
| targetPortalIP.ips | Array of targetPortalIP.ip | iSCSI目標門戶IP屬性集合,詳見“表1 響應參數targetPortalIP.ip說明”。 |
| targetPortalIP.status | String | iSCSI目標門戶IP狀態:
|
| diskPaths | Array of diskPath | HBlock數據目錄信息集合,詳見“表2 響應參數diskPaths說明”。 |
| defaultPath | String | 默認的數據目錄(僅單機版支持)。 |
| recentStartTime | Long | HBlock服務在該節點上最近一次成功啟動的時間。 服務器未連接時,不返回此項。 |
| ports | Array of port | HBlock端口的集合,詳見“表3 響應參數ports說明”。 |
| portRange | String | 端口范圍。 |
| iSCSIPort | Integer | iSCSI端口。 |
| storagePorts | Array of storagePort | 存儲服務端口集合(僅集群版支持),詳見“表4 響應參數storagePorts說明”。 |
| nodeName | String | 節點名稱(僅集群版支持)。 |
| parentName | String | 父節點名稱(僅集群版支持)。 |
| description | String | 節點描述(僅集群版支持)。 |
| baseServices | Array of baseService | 基礎服務屬性的集合(僅集群版基礎服務器支持),詳見“表5 響應參數baseService說明”。 |
表1 響應參數targetPortalIP.ip說明
| 名稱 | 類型 | 描述 |
|---|---|---|
| ip | String | iSCSI目標門戶IP。 |
| port | Integer | iSCSI目標門戶端口號。 |
表2 響應參數diskPaths說明
| 名稱 | 類型 | 描述 |
|---|---|---|
| path | String | HBlock數據目錄。 |
| totalCapacity | Long | 當前HBlock數據目錄對應分區的總容量,單位是字節。 |
| usedCapacity | Long | 服務器上HBlock數據目錄對應分區的已用容量,單位是字節。 |
| usedCapacityQuota | Long | HBlock在該數據目錄的已寫入量,即已用容量配額。單位是字節。 |
| capacityQuota | Long | 數據目錄的容量配額。單位是字節。 0表示禁止寫入。不輸出,表示沒有限制。 |
| managementStatus | String | 數據目錄管理狀態:
|
| subStatus.stage | String | 移除數據目錄所處的階段:
|
| subStatus.totalFD | Integer | 總的故障域個數。 |
| subStatus.healthyFD | Integer | 狀態為Healthy的故障域個數。 |
| subStatus.warningFD | Integer | 狀態為Warning的故障域個數。 |
| subStatus.errorFD | Integer | 狀態為Error的故障域個數。 |
| subStatus.safeData | Double | 安全數據百分比,單位是%。 |
| subStatus.reconstructionWaitData | Double | 需要重建的數據百分比,單位是%。 |
| subStatus.availFDWaitData | Double | 移除磁盤或者服務器時,數據重建需要的故障域個數不足,因此引發的無法重建的數據百分比。 |
| subStatus.singleCopyLUNData | Double | 單副本數據百分比,單位是%。 |
| subStatus.corruptedData | Double | 已經損壞的數據百分比,單位是%。 |
| subStatus.availFDWaitWarning | String | 告警信息。 根據狀態不同,顯示的告警信息不同:
|
| subStatus.singleCopyLUNWarning | String | |
| subStatus.corruptedWarning | String | |
| healthStatus | String | 數據目錄健康狀態:
|
| healthDetail | Array of string | 數據目錄健康狀態詳情:
|
| dsId | String | 數據目錄對應的ds進程(僅集群版支持)。 說明 數據目錄加入存儲池后才會展示ds進程。 |
表3 響應參數ports說明
| 名稱 | 類型 | 描述 |
|---|---|---|
| portName | String | HBlock端口名稱。 |
| port | Integer | HBlock在當前服務器上使用的端口號。 |
表4 響應參數storagePorts說明
| 名稱 | 類型 | 描述 |
|---|---|---|
| portN | Integer | 存儲服務端口。 |
| diskpath | String | 存儲服務的數據目錄。 |
| pathId | String | 數據目錄ID。 |
表5 響應參數baseService說明
| 名稱 | 類型 | 描述 |
|---|---|---|
| name | String | 基礎服務名稱:
|
| status | String | 基礎服務的狀態:
|
| metaDir | String | 存儲基礎服務數據的數據目錄。 |
請求示例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: Tue, 05 Aug 2025 07:39:48 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.65:1443響應示例2
HTTP/1.1 200 OK
x-hblock-request-id: ade3787d115549519c8332e1bf154c1e
Connection: keep-alive
Content-Length: 1429
Date: Tue, 05 Aug 2025 07:39:48 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"serverName": "ecs-9689-0915142",
"serverId": "hblock_2",
"status": "Connected",
"version": "3.10.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": [],
"dsId": "ds-1"
}
],
"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"
}
]
}
}