此操作用來查詢QoS策略關聯/可關聯的對象信息。
請求語法
GET /rest/v1/system/qos/qosName?object=object&status=status HTTP/1.1
Date: date
Content-Type: application/json; charset=utf-8
Host: ip:port
Authorization: authorization請求參數
| 參數 | 類型 | 描述 | 是否必須 |
|---|---|---|---|
| qosName | String | 指定要查詢的QoS策略名稱。 | 是 |
| object | String | 指定關聯的對象類型。 取值：
| 是 |
| status | String | 對象與QoS策略的關聯狀態。 取值：
默認值為associated。 | 否 |
響應結果
| 名稱 | 類型 | 描述 |
|---|---|---|
| totalNum | Integer | 對象總個數。 |
| luns | Array of lun | 卷信息集合。詳見“表1 響應參數lun說明”。 說明 如果查詢的對象是lun，才輸出此項。 |
| storagepools | Array of storagepool | 存儲池信息集合。詳見“表2 響應參數storagepool說明”。 說明 如果查詢的對象是storagepool、storagepoolforlun，才輸出此項。 |
表1 響應參數lun說明
| 名稱 | 類型 | 描述 |
|---|---|---|
| lunName | String | 卷名稱。 |
| status | String | 卷的狀態：
|
| capacity | Integer | 卷容量，單位是GiB。 |
| storageMode | String | 卷的存儲類型：
|
| config.localStorageClass | String | 卷冗余模式（僅集群版支持）：
|
| config.ECfragmentSize | Integer | 分片大小（僅集群版支持）。如果冗余模式為EC N+M，則會返回此項。 |
表2 響應參數storagepool說明
| 名稱 | 類型 | 描述 |
|---|---|---|
| name | String | 存儲池名稱。 |
| isBasePool | Boolean | 是否是基礎存儲池：
|
| status | String | 存儲池狀態：
|
| faultDomain | String | 存儲池故障域級別：
|
| totalCapacity | Long | 存儲池總容量，單位是字節。 |
| usedCapacity | Long | 存儲池已用容量，單位是字節。 |
請求示例1
單機版：查詢所有QoS策略QoS1關聯的卷。
GET /rest/v1/system/qos/QoS1?object=lun HTTP/1.1
Date: Fri, 15 Aug 2025 07:48:10 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.66:1443 響應示例1
HTTP/1.1 200 OK
x-hblock-request-id: 3be0bb06fb144b25a3d77beba4bf24f7
Connection: keep-alive
Content-Length: 182
Date: Fri, 15 Aug 2025 07:48:10 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"totalNum": 2,
"luns": [
{
"lunName": "luna1",
"status": "Normal",
"capacity": 100,
"storageMode": "Local"
},
{
"lunName": "lunc3",
"status": "Normal",
"capacity": 390,
"storageMode": "Cache"
}
]
}
}請求示例2
集群版：查詢所有QoS策略QoS6關聯的卷。
GET /rest/v1/system/qos/QoS6?object=lun HTTP/1.1
Date: Tue, 05 Aug 2025 07:59:50 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.64:1443 響應示例2
HTTP/1.1 200 OK
x-hblock-request-id: 731afda1b93c4b3186ba1c9d5ab181ed
Connection: keep-alive
Content-Length: 447
Date: Tue, 05 Aug 2025 07:59:50 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"totalNum": 3,
"luns": [
{
"lunName": "lun01a",
"status": "Normal",
"capacity": 200,
"storageMode": "Local",
"config": {
"localStorageClass": "EC 2+1",
"ECfragmentSize": 16
}
},
{
"lunName": "lunn01a-clone1",
"status": "Normal",
"capacity": 200,
"storageMode": "Local",
"config": {
"localStorageClass": "EC 2+1",
"ECfragmentSize": 16
}
},
{
"lunName": "lun04",
"status": "Normal",
"capacity": 404,
"storageMode": "Local",
"config": {
"localStorageClass": "EC 2+1",
"ECfragmentSize": 16
}
}
]
}
}請求示例3
集群版：查詢所有QoS策略QoS6關聯的存儲池。
GET /rest/v1/system/qos/QoS6?object=storagepool HTTP/1.1
Date: Fri, 04 Jul 2025 03:27:32 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.64:1443 響應示例3
HTTP/1.1 200 OK
x-hblock-request-id: 18732cfc7cb74914a89c79ca1f324316
Connection: keep-alive
Content-Length: 286
Date: Fri, 04 Jul 2025 03:27:32 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"totalNum": 2,
"storagepools": [
{
"name": "default",
"isBasePool": true,
"status": "Normal",
"faultDomain": "server",
"totalCapacity": 299111325696,
"usedCapacity": 70197202944
},
{
"name": "pool1",
"isBasePool": false,
"status": "Normal",
"faultDomain": "server",
"totalCapacity": 0,
"usedCapacity": 0
}
]
}
}請求示例4
集群版：查詢設置存儲池內卷的默認QoS策略為QoS6的存儲池。
GET /rest/v1/system/qos/QoS6?object=storagepoolforlun HTTP/1.1
Date: Fri, 04 Jul 2025 03:31:06 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.64:1443 響應示例4
HTTP/1.1 200 OK
x-hblock-request-id: e943ad21499844549fd553cc4ef86b57
Connection: keep-alive
Content-Length: 286
Date: Fri, 04 Jul 2025 03:31:06 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"totalNum": 2,
"storagepools": [
{
"name": "pool1",
"isBasePool": false,
"status": "Normal",
"faultDomain": "server",
"totalCapacity": 0,
"usedCapacity": 0
},
{
"name": "default",
"isBasePool": true,
"status": "Normal",
"faultDomain": "server",
"totalCapacity": 299111325696,
"usedCapacity": 70197215232
}
]
}
}
