此操作用来查询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
}
]
}
}
