此操作用来设置卷关联的QoS策略。
当同一个卷多次设置QoS策略时，以最后一次操作为准。
注意
关联的卷状态不能为Deleting、Deletefailed。
说明
集群版中，卷最终的QoS限制由卷级 QoS 策略与存储池级 QoS 策略共同决定。两者同时存在时，系统取较小值生效。实际 QoS 限制 = min(卷级 QoS 限制，存储池级 QoS 限制)。存储池级 QoS 限制由池内所有卷共享。具体详见“集群版卷QoS限制生效原则”。
例如：卷lun1直接关联的QoS策略带宽限速为500MiB/s，存储池级QoS策略为300MiB/s，根据实际生效限制=min (500MiB/s, 300MiB/s)=300MiB/s。但存储池级QoS为池内所有卷的总带宽上限，非每个卷独享，所以最终的带宽可能小于300MiB/s。
集群版卷QoS限制生效原则：
卷级的QoS策略：
若卷已关联了QoS策略，则以该关联的QoS策略为准。
若卷未关联QoS策略：
当卷同时存在缓存存储池和存储池时，采用缓存存储池的“存储池内卷的默认QoS策略”；若缓存存储池未设置“存储池内卷的默认QoS策略”，则该卷无卷级QoS策略。
当卷仅存在存储池时，采用存储池的“存储池内卷的默认QoS策略”；若存储池未设置“存储池内卷的默认QoS策略”，则该卷无卷级QoS策略。
卷的存储池级QoS策略：
当卷同时有缓存存储池和存储池时，存储池级QoS策略以缓存存储池设置的QoS策略为准；若缓存存储池未设置QoS策略，则该卷无存储池级QoS策略。
当卷仅有存储池时，存储池级QoS策略以该存储池的QoS策略为准；若存储池未设置QoS策略，则该卷无存储池级QoS策略。
说明
存储池级别的QoS 限制由池内所有卷共享。
最终生效策略：综合卷级与存储池级 QoS 策略，最终生效规则如下：
卷级别的QoS策略 存储池级别的QoS策略 生效策略 有 无 卷级QoS策略 有 有 min(卷级QoS,存储池级QoS) 无 有 存储池级QoS 无 无 无生效的QoS策略
请求语法
PUT /rest/v1/system/qos/qosName/lun/assoc HTTP/1.1
Date: date
Content-Type: application/json; charset=utf-8
Content-Length: length
Host: ip:port
Authorization: authorization
{
"list": [ lunName1,lunName2… ],
}请求参数
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| qosName | String | 指定QoS策略名称。 | 是 |
| list | Array of string | 指定关联QoS策略的卷名称。 | 是 |
请求示例
设置卷的QoS策略。
PUT /rest/v1/system/qos/QoS6/lun/assoc HTTP/1.1
Date: Wed, 02 Jul 2025 03:22:28 GMT
Content-Type: application/json; charset=utf-8
Authorization: HBlock userName:signature
Content-Length: 43
Host: 192.168.0.64:1443
{
"list": ["luna1","lunb1","lunb2"]
}响应示例
HTTP/1.1 204 No Content
x-hblock-request-id: 3f0246e386ca42988afe8abc672bb789
Connection: keep-alive
Date: Wed, 02 Jul 2025 03:22:28 GMT
Server: HBlock
