查询存储池关联的QoS
更新时间 2025-09-29 17:49:39
最近更新时间: 2025-09-29 17:49:39
本节主要介绍如何使用API查询存储池关联的QoS。
此操作用来查询存储池关联的QoS信息。
请求语法
GET /rest/v1/system/storagepool/poolName/qos HTTP/1.1
Date: date
Host: ip:port
Authorization: authorization请求参数
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| poolName | String | 存储池名称。 | 是 |
响应结果
| 名称 | 类型 | 描述 |
|---|---|---|
| qosPolicy | Object of qosPolicy | QoS策略信息集合，详见“表1 响应参数qosPolicy/qosPolicyforLUN说明”。 |
| qosPolicyforLUN | Object of qosPolicyforLUN | 存储池中卷的默认QoS策略信息，详见“表1 响应参数qosPolicy/qosPolicyforLUN说明”。 |
表1 响应参数qosPolicy/qosPolicyforLUN说明
| 名称 | 类型 | 描述 |
|---|---|---|
| qosName | String | QoS策略名称。 |
| IOPS | Long | 每秒能够进行读写操作次数的最大值。 说明 -1表示不限制。 |
| readIOPS | Long | 每秒能够进行读操作次数的最大值。 说明 -1表示不限制。 |
| writeIOPS | Long | 每秒能够进行写操作次数的最大值。 说明 -1表示不限制。 |
| Bps | Long | 每秒可传输数据量的最大值，单位是Bytes/s。 说明 -1表示不限制。 |
| readBps | Long | 读带宽上限，单位是Bytes/s。 说明 -1表示不限制。 |
| writeBps | Long | 写带宽上限，单位是Bytes/s。 说明 -1表示不限制。 |
| IOPSBurst | Long | 使用Burst功能时，每秒能够进行读写操作次数的最大值。 说明 -1表示不限制。 |
| readIOPSBurst | Long | 使用Burst功能时，每秒能够进行读操作次数的最大值。 说明 -1表示不限制。 |
| writeIOPSBurst | Long | 使用Burst功能时，每秒能够进行写操作次数的最大值。 说明 -1表示不限制。 |
| BpsBurst | Long | 使用Burst功能时，每秒可传输的数据量最大值，单位是Bytes/s。 说明 -1表示不限制。 |
| readBpsBurst | Long | 使用Burst功能时，读带宽上限，单位是Bytes/s。 说明 -1表示不限制。 |
| writeBpsBurst | Long | 使用Burst功能时，写带宽上限，单位是Bytes/s。 说明 -1表示不限制。 |
| IOPSBurstSecs | Long | 使用Burst功能时，按照Burst上限的能力进行读写操作所能持续的时间。单位是秒。 |
| readIOPSBurstSecs | Long | 使用Burst功能时，按照Burst上限的能力进行读操作所能持续的时间。单位是秒。 |
| writeIOPSBurstSecs | Long | 使用Burst功能时，按照Burst上限的能力进行写操作所能持续的时间。单位是秒。 |
| BpsBurstSecs | Long | 使用Burst功能时，按照Burst上限的流量能力所能持续的时间。单位是秒。 |
| readBpsBurstSecs | Long | 使用Burst功能时，按照Burst上限的读流量能力所能持续的时间。单位是秒。 |
| writeBpsBurstSecs | Long | 使用Burst功能时，按照Burst上限的写流量能力所能持续的时间。单位是秒。 |
| createTime | Long | QoS策略创建的时间。 |
| reclaimPolicy | String | QoS策略的回收策略：
|
| description | String | QoS策略的描述信息。 |
请求示例
查询存储池defaultpool的QoS策略。
GET /rest/v1/system/storagepool/defaultpool/qos HTTP/1.1
Date: Thu, 21 Aug 2025 03:36:22 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.64:1443响应示例
HTTP/1.1 200 OK
x-hblock-request-id: 8fda965846fa4ce4b0e1e96e40494786
Connection: keep-alive
Content-Length: 728
Date: Thu, 21 Aug 2025 03:36:22 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock
{
"data": {
"qosPolicy": {
"qosName": "QoS6",
"readIOPS": 600,
"writeIOPS": 440,
"readBps": 1048576000,
"writeBps": 1572864000,
"readIOPSBurst": 6000,
"writeIOPSBurst": 4000,
"readBpsBurst": 2097152000,
"writeBpsBurst": 2097152000,
"readIOPSBurstSecs": 1,
"writeIOPSBurstSecs": 1,
"readBpsBurstSecs": 1,
"writeBpsBurstSecs": 1,
"createTime": 1753950531353,
"reclaimPolicy": "Retain",
"description": "It is QoS6.",
"IOPS": 1000,
"Bps": 2097152000,
"IOPSBurst": 10000,
"BpsBurst": 2202009600,
"IOPSBurstSecs": 1,
"BpsBurstSecs": 1
},
"qosPolicyforLUN": {
"qosName": "QoS-Test",
"readIOPSBurstSecs": 1,
"writeIOPSBurstSecs": 1,
"readBpsBurstSecs": 1,
"writeBpsBurstSecs": 1,
"createTime": 1754470952232,
"reclaimPolicy": "Retain",
"IOPS": 8000,
"Bps": 8388608000,
"IOPSBurstSecs": 1,
"BpsBurstSecs": 1
}
}
}
