查詢指定軟件許可證信息
更新時間 2025-09-29 17:49:35
最近更新時間: 2025-09-29 17:49:35
分享文章
本節主要介紹如何使用API查詢指定軟件許可證信息。
查詢指定軟件許可證的信息。信息包括軟件許可證的record信息以及usage信息：
record信息：購買記錄的信息。
usage信息：軟件許可證在不同時間段內的對應的容量和狀態信息。
請求語法
GET /rest/v1/system/license/licenseId?show=show HTTP/1.1
Date: date
Content-Type: application/json; charset=utf-8
Content-Length: length
Host: ip:port
Authorization: authorization請求參數
| 名稱 | 類型 | 描述 | 是否必須 |
|---|---|---|---|
| licenseId | String | 軟件許可證的ID。 | 否 |
| show | String | 查詢的輸出結果，record、usage。 如果不填寫，就是默認兩個信息都輸出。 | 否 |
響應結果
| 名稱 | 類型 | 描述 |
|---|---|---|
| licenseId | String | 軟件許可證ID。 |
| account | String | 軟件許可證所屬的賬號。 |
| customerName | String | 客戶名稱。 說明 如果申請許可證時未填寫，不顯示此字段。 |
| type | String | 軟件許可證的購買類型：
|
| status | String | 軟件許可證的狀態：
如果軟件許可證是Perpetual類型的，不存在過期狀態。 |
| maximumLocalCapacity | Long | 當前時間允許的最大本地卷容量，單位TiB。如果不限容量，不返回此項。 |
| records | Array of record | 軟件許可證的購買記錄的集合，詳見“表1 響應參數record說明”。 |
| usages | Array of usage | 軟件許可證使用記錄的集合，詳見“表2 響應參數usage說明”。 |
表1 響應參數record說明
| 名稱 | 類型 | 描述 |
|---|---|---|
| purchaseTime | Long | 記錄購買的時間，unix時間戳（UTC），精確到毫秒。 |
| operationtype | String | 軟件許可證的操作記錄：
|
| localCapacity | Long | 本次購買對應的本地卷容量，單位TiB。如果不限容量，不返回此項。 |
| subscribeEffectiveTime | Long | 對于訂閱模式的軟件許可證，本次購買操作對應的軟件許可證生效時間，unix時間戳（UTC），精確到毫秒。 |
| subscribeExpireTime | Long | 對于訂閱模式的軟件許可證，本次購買操作對應的軟件許可證的過期時間，unix時間戳（UTC），精確到毫秒。 |
| maintenanceEffectiveTime | Long | 對于永久許可模式的軟件許可證，本次購買操作對應的維保生效時間，unix時間戳（UTC），精確到毫秒。 |
| maintenanceExpireTime | Long | 對于永久許可模式的軟件許可證，本次購買操作對應的維保的過期時間，unix時間戳（UTC），精確到毫秒。 |
| substatus | String | 本次購買操作的當前狀態：
|
表2 響應參數usage說明
| 名稱 | 類型 | 描述 |
|---|---|---|
| maximumLocalCapacity | Long | 對應時間段內允許的最大本地卷容量，單位TiB。如果不限容量，不返回此項。 |
| subscribeEffectiveTime | Long | 對于訂閱模式的軟件許可證，許可證對應的生效時間，unix時間戳（UTC），精確到毫秒。 |
| subscribeExpireTime | Long | 對于訂閱模式的軟件許可證，許可證對應的過期時間，unix時間戳（UTC），精確到毫秒。 |
| maintenanceEffectiveTime | Long | 對于永久許可模式的軟件許可證，許可證對應的維保生效時間，unix時間戳（UTC），精確到毫秒。 |
| maintenanceExpireTime | Long | 對于永久許可模式的軟件許可證，許可證對應的維保過期時間，unix時間戳（UTC），精確到毫秒。 |
| substatus | String | 對于訂閱模式的軟件許可證，表示對應時間段內許可證的狀態；對于永久許可模式的軟件許可證，表示對應時間段內許可證的維保狀態：
|
請求示例1
訂閱模式：查詢軟件許可證ID為ehc2b6a9-f3fb-4098-a6b3-3652a5d71232的軟件許可證信息。
GET /rest/v1/system/license/ehc2b6a9-f3fb-4098-a6b3-3652a5d71232 HTTP/1.1
Date: Tue, 05 Aug 2025 02:40:01 GMT
Authorization: HBlock userName:signature
Host:192.168.0.66:1443響應示例1
HTTP/1.1 200 OK
x-hblock-request-id: e4a388cfebe24398a09ee6bdc5d22b2a
Connection: keep-alive
Content-Length: 518
Date: Tue, 05 Aug 2025 02:40:01 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"licenseId": "ehc2b6a9-f3fb-4098-a6b3-3652a5d71232",
"account": "testaccount1@ctyun.com",
"status": "Effective",
"type": "Subscription",
"maximumLocalCapacity": 1024,
"records": [
{
"purchaseTime": 1753857636859,
"operationtype": "New",
"localCapacity": 1024,
"subscribeEffectiveTime": 1753857636859,
"subscribeExpireTime": 1785393636859,
"substatus": "Effective"
}
],
"usages": [
{
"maximumLocalCapacity": 1024,
"subscribeEffectiveTime": 1753857636859,
"subscribeExpireTime": 1785393636859,
"substatus": "Effective"
}
]
}
}請求示例2
永久許可模式：查詢軟件許可證ID為qws2b6a9-f3fb-4098-a6b3-3652a5a76530的軟件許可證信息。
GET /rest/v1/system/license/qws2b6a9-f3fb-4098-a6b3-3652a5a76530 HTTP/1.1
Date: Tue, 05 Aug 2025 02:17:13 GMT
Authorization: HBlock userName:signature
Host:192.168.0.65:1443響應示例2
HTTP/1.1 200 OK
x-hblock-request-id: 7b4ee400d293497bba0c9182b256e678
Connection: keep-alive
Content-Length: 518
Date: Tue, 05 Aug 2025 02:17:13 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"licenseId": "qws2b6a9-f3fb-4098-a6b3-3652a5a76530",
"account": "test@daliqc.cn",
"customerName": "Customer ABC",
"status": "Effective",
"type": "Perpetual",
"maximumLocalCapacity": 2048,
"records": [
{
"purchaseTime": 1754357667366,
"operationtype": "New",
"localCapacity": 2048,
"maintenanceEffectiveTime": 1754357667366,
"maintenanceExpireTime": 1785893667366,
"substatus": "Effective"
}
],
"usages": [
{
"maximumLocalCapacity": 2048,
"maintenanceEffectiveTime": 1754357667366,
"maintenanceExpireTime": 1785893667366,
"substatus": "Effective"
}
]
}
}
