刪除卷
更新時間 2025-04-23 15:02:44
最近更新時間: 2025-04-23 15:02:44
分享文章
本節主要介紹如何使用API刪除卷。
此操作用來刪除卷。
說明
卷禁用后，才能被刪除（3.9之前的版本）。
對于上云卷，如果刪除卷的時候未刪除云上數據，后期可以使用卷還原功能進行卷數據還原。刪除卷時，應確保卷不包含快照、一致性快照。
注意
對于上云卷，選擇強制刪除卷，且同時刪除云上數據，可能會有云上數據殘留，需要對云上數據進行手動刪除。
如果卷存在關聯克隆卷，且克隆卷未處于“Deleting”或“Flattening”狀態，則禁止刪除源卷。
如果卷有關聯的快照或一致性快照，只能強制刪除卷。強制刪除卷時，將同時刪除此卷的快照和一致性快照中的卷快照。同時也會產生數據殘留風險，請謹慎操作。
請求語法
本地卷
DELETE /rest/v1/block/lun/lunName?force=force HTTP/1.1
Date: date
Host: ip:port
Authorization: authorization上云卷
DELETE /rest/v1/block/lun/lunName?force=force&deleteCloudData=deleteCloudData HTTP/1.1
Date: date
Host: ip:port
Authorization: authorization請求參數
| 參數 | 類型 | 描述 | 是否必須 |
|---|---|---|---|
| lunName | String | 要刪除的卷名稱。 取值：1~16位字符串，只能由字母、數字和短橫線（-）組成，字母區分大小寫，且僅支持以字母或數字開頭。 | 是 |
| force | Boolean | 是否強制刪除卷。 注意 強制刪除卷，會產生數據殘留風險，請謹慎操作。 取值：
默認值為false。 | 否 |
| deleteCloudData | Boolean | 刪除卷時，是否刪除云上的數據。 取值：
默認值為false。 如果刪除Local模式的卷時攜帶此參數，會直接忽略。 | 否 |
請求示例1
本地卷：刪除卷名稱為testLun1的卷。
DELETE /rest/v1/block/lun/testLun1 HTTP/1.1
Date: Tue, 15 Mar 2022 02: 40: 17 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.121: 1443響應示例1
HTTP/1.1 202 Accepted
x-hblock-request-id: 75dd09b8f97941d98b74ac15b4b5c855
Connection: keep-alive
Content-Length: 0
Date: Tue, 15 Mar 2022 02: 40: 17 GMT
Server: HBlock請求示例2
上云卷：刪除卷名稱為lun03a的卷，刪除卷時刪除云上數據。
DELETE /rest/v1/block/lun/lun03a?deleteCloudData=true HTTP/1.1
Date: Thu, 9 May 2024 08: 26: 41 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.192: 1443響應示例2
HTTP/1.1 202 Accepted
x-hblock-request-id: 460b71d05c4c4b119811cb4b8f6ddc5b
Connection: keep-alive
Content-Length: 0
Date: Thu, 9 May 2024 08: 26: 41 GMT
Server: HBlock
