清空卷（本地卷适用）
更新时间 2026-03-24 17:16:02
最近更新时间: 2026-03-24 17:16:02
本节主要介绍如何使用API清空卷。
此操作用来清空卷。
注意
如果克隆卷执行清空所有卷数据及卷对应的快照，会变成独立卷。
卷处于Wiping、WipeFailed状态时，不支持读写。
清空卷前须先logout断开客户端连接，否则在卷状态恢复Normal前将无法断开客户端连接。
请求语法
PUT /rest/v1/block/lun/lunName/wipe HTTP/1.1
Date: date
Content-Type: application/json; charset=utf-8
Content-Length: length
Host: ip:port
Authorization:authorization
{
"scope":scope
}请求参数
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| lunName | String | 指定需要清空的卷的名称。 取值：长度范围是1~16，只能由字母、数字和短横线（-）组成，字母区分大小写，且仅支持以字母或数字开头。 | 是 |
| scope | String | 指定清空卷的数据范围。 取值：
默认值为All。 | 否 |
请求示例1
清空卷lun01，包括卷数据及对应的快照。
PUT /rest/v1/block/lun/lun01/wipe HTTP/1.1
Date: Fri, 12 Dec 2025 03:31:37 GMT
Content-Type: application/json; charset=utf-8
Content-Length: 25
Authorization: HBlock userName:signature
Host: 192.168.0.64:1443
{
"scope": "All"
}响应示例1
HTTP/1.1 202 Accept
x-hblock-request-id: e6b663f013574507b542ce507528bde0
Connection: keep-alive
Date: Fri, 12 Dec 2025 03:31:37 GMT
Content-Length: 0
Server: HBlock请求示例2
清空卷lun04b，清空卷数据，保留卷对应的快照。
PUT /rest/v1/block/lun/lun04b/wipe HTTP/1.1
Date: Fri, 12 Dec 2025 03:49:34 GMT
Content-Type: application/json; charset=utf-8
Content-Length: 32
Authorization: HBlock userName:signature
Host: 192.168.0.64:1443
{
"scope": "NoSnapshot"
}响应示例2
HTTP/1.1 202 Accept
x-hblock-request-id: 535e2361cb1c4dd1b7b8f72ba79db002
Connection: keep-alive
Date: Fri, 12 Dec 2025 03:49:34 GMT
Content-Length: 0
Server: HBlock
