清空卷（本地卷適用）
更新時間 2025-09-29 17:49:36
最近更新時間: 2025-09-29 17:49:36
分享文章
本節主要介紹如何使用API清空卷。
此操作用來清空卷。
注意
清空卷會將卷的現有數據和快照刪除，恢復到原始新創建的狀態。如果克隆卷執行清空操作，會變成獨立卷。
存在關聯克隆卷，不允許對源卷進行清空。
清空卷過程中，只能對卷進行查詢、刪除和再次清空的操作，不允許執行其他操作。
請求語法
PUT /rest/v1/block/lun/lunName/wipe HTTP/1.1
Date: date
Host: ip:port
Authorization:authorization請求參數
| 參數 | 類型 | 描述 | 是否必須 |
|---|---|---|---|
| lunName | String | 指定需要清空的卷的名稱。 取值：長度范圍是1~16，只能由字母、數字和短橫線（-）組成，字母區分大小寫，且僅支持以字母或數字開頭。 | 是 |
請求示例
清空卷lunc1。
PUT /rest/v1/block/lun/lunc1/wipe HTTP/1.1
Date: Wed, 30 Jul 2025 09:32:36 GMT
Content-Type: application/json; charset=utf-8
Content-Length: 0
Authorization: HBlock userName:signature
Host: 192.168.0.66:1443 響應示例
HTTP/1.1 202 Accept
x-hblock-request-id: a94e95535ac049d5ab150dcc5dbd4124
Connection: keep-alive
Date: Wed, 30 Jul 2025 09:32:36 GMT
Content-Length: 0
Server: HBlock
