查询HBlock信息
更新时间 2026-03-24 17:16:08
最近更新时间: 2026-03-24 17:16:08
本节主要介绍如何使用API查询HBlock信息。
此操作用来查询HBlock信息,包括HBlock ID、HBlock名称、HBlock序列号、服务器数量、故障域(集群版)、初始化时间、试用期信息及HBlock的管理员用户名。
请求语法
GET /rest/v1/system/info HTTP/1.1
Date: date
Host: ip:port
Authorization: authorization响应结果
| 名称 | 类型 | 描述 |
|---|---|---|
| storId | String | HBlock ID。 |
| storName | String | HBlock的名称。 |
| serialId | String | HBlock序列号。 |
| serverNumbers | Integer | HBlock服务器数量。 |
| basePoolName | String | 基础存储池的名字(仅集群版)。 |
| faultDomain | String | 故障域类型(仅集群版):
|
| setupTime | Long | 系统初始化时间。unix时间戳(UTC),精确到毫秒。 |
| trialStatus | String | 试用期标识:
|
| trialExpireTime | Long | 试用期到期时间(商业版)。unix时间戳(UTC),精确到毫秒。 |
| userName | String | HBlock的管理员用户名。 |
licenseId | String | 最后一次成功导入的软件许可证ID(商业版)。 |
| type | String | 软件许可证订购类型(商业版):
|
| status | String | 软件许可证状态(商业版):
|
| maintenanceExpireTime | Long | 对于永久许可模式软件许可证,软件许可证维保过期时间。unix时间戳(UTC),精确到毫秒。 |
| subscribeExpireTime | Long | 对于订阅模式软件许可证,软件许可证过期时间。unix时间戳(UTC),精确到毫秒。 |
| proTrialStartTime | Long | 免费版的高级功能试用开启时间,unix时间戳(UTC),精确到毫秒。高级功能试用开启之后才返回,不开启不返回。 |
| proTrialExpireTime | Long | 免费版的高级功能试用结束时间,unix时间戳(UTC),精确到毫秒。高级功能试用开启之后才返回,不开启不返回。 |
| freeUpgradeExpireTime | Long | 免费版的升级功能过期时间,unix时间戳(UTC),精确到毫秒。 |
请求示例1
单机-商业版:查询HBlock信息。
GET /rest/v1/system/info HTTP/1.1
Date: Fri, 26 Dec 2025 07:50:09 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.66:1443响应示例1
HTTP/1.1 200 OK
x-hblock-request-id: 55cd9d5a2a0d4fafb873d337971848c7
Connection: keep-alive
Content-Length: 401
Date: Fri, 26 Dec 2025 07:50:09 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"storId": "0A769770-1528-49B8-A82D-D1CB71333FFB",
"storName": "storuser",
"serialId": "0A769770-1528-49B8-A82D-D1CB71333FFB-0201-040000",
"serverNumbers": 1,
"setupTime": 1765259023707,
"trialStatus": "NonTrialVersion",
"trialExpireTime": 1767851023707,
"userName": "storuser",
"licenseId": "qws2b6a9-f3fb-4098-a6b3-3652a5a76530",
"type": "Perpetual",
"status": "Effective",
"maintenanceExpireTime": 1798255505624
}
}请求示例2
单机-免费版(已开启高级功能试用):查询HBlock信息。
GET /rest/v1/system/info HTTP/1.1
Date: Mon, 12 Jan 2026 03:56:23 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.66:1443响应示例2
HTTP/1.1 200 OK
x-hblock-request-id: 5b8713084ded4ebdb7b84f6d68d831b6
Connection: keep-alive
Content-Length: 344
Date: Mon, 12 Jan 2026 03:56:23 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"storId": "C3238159-40D5-4E6E-A719-1A5205BB688D",
"storName": "stor1",
"serialId": "C3238159-40D5-4E6E-A719-1A5205BB688D-0201-040000",
"serverNumbers": 1,
"setupTime": 1768185567944,
"trialStatus": "ProTrialEnabled",
"userName": "storuser",
"proTrialStartTime": 1768188583000,
"proTrialExpireTime": 1770780583000,
"freeUpgradeExpireTime": 1831257567944
}
}请求示例3
集群-商业版:查询HBlock信息。
GET /rest/v1/system/info HTTP/1.1
Date: Fri, 26 Dec 2025 07:20:37 GMT
Authorization: HBlock userName:signature
Host:192.168.0.65:1443响应示例3
HTTP/1.1 200 OK
x-hblock-request-id: 0e653a2596334cc18aa7517a1250129f
Connection: keep-alive
Content-Length: 447
Date: Fri, 26 Dec 2025 07:20:37 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"storId": "1E46239F-BD8B-4CB3-A151-C3A58892AEF9",
"storName": "stor1",
"serialId": "1E46239F-BD8B-4CB3-A151-C3A58892AEF9-0202-040000",
"serverNumbers": 3,
"basePoolName": "default",
"faultDomain": "server",
"setupTime": 1766021632008,
"trialStatus": "NonTrialVersion",
"trialExpireTime": 1768613632008,
"userName": "storuser",
"licenseId": "ehc2b6a9-f3fb-4098-a6b3-3652a5d71232",
"type": "Subscription",
"status": "Effective",
"subscribeExpireTime": 1798255470002
}
}请求示例4
集群-免费版(未开启高级功能试用):查询HBlock信息。
GET /rest/v1/system/info HTTP/1.1
Date: Mon, 12 Jan 2026 03:58:18 GMT
Authorization: HBlock userName:signature
Host:192.168.0.65:1443响应示例4
HTTP/1.1 200 OK
x-hblock-request-id: 74a51ff96dc444d9b4107293fce19a9b
Connection: keep-alive
Content-Length: 319
Date: Mon, 12 Jan 2026 03:58:18 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"storId": "10266612-3B09-4111-968A-CBB4D271F358",
"storName": "stor2",
"serialId": "10266612-3B09-4111-968A-CBB4D271F358-0202-040000",
"serverNumbers": 3,
"basePoolName": "default",
"faultDomain": "server",
"setupTime": 1768187650175,
"trialStatus": "FreeEdition",
"userName": "storuser",
"freeUpgradeExpireTime": 1831259650175
}
}