挂起卷（上云卷适用）
更新时间 2026-03-24 17:16:02
最近更新时间: 2026-03-24 17:16:02
本节主要介绍如何使用API挂起卷。
此操作用来挂起HBlock上云卷。
挂起卷适用于“多集群轮流写入同一上云卷”的场景，例如：A集群把卷挂起后，B集群立即原地还原并写入新数据；待B集群再次挂起，A集群恢复卷即可直接看到B集群的最新写入，实现“一写一挂、交替接管”。
注意
挂起后将立即冻结该卷的所有读写请求。请确保卷的所有数据已持久化，即如果卷已经被客户端挂载，需确保客户端的数据都已经同步到卷上。恢复前，依赖此卷的业务将不可用。
卷在挂起状态下，仅允许挂起、修改卷配置、修改上云配置、恢复、删除、查询。
卷处于Suspended、Suspending、SuspendFailed状态时，不支持读写。
挂起卷前须先logout断开客户端连接，否则在卷状态恢复Normal前将无法断开客户端连接。
仅卷处于Normal、Suspended、Suspending、SuspendFailed状态时，才可以执行此操作。
请求语法
PUT /rest/v1/block/lun/lunName/suspend HTTP/1.1
Date: date
Content-Length: length
Host: ip:port
Authorization:authorization
{
"force": force
}请求参数
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| lunName | String | 指定需要挂起卷的名称。 取值：长度范围是1~16，只能由字母、数字和短横线（-）组成，字母区分大小写，且仅支持以字母或数字开头。 | 是 |
| force | Boolean | 是否强制挂起卷。 注意 强制挂起卷，会产生本地数据未被上传到云端的风险，请谨慎操作。 取值：
默认值为false。 | 否 |
请示示例
挂起卷lunb1。
PUT /rest/v1/block/lun/lunb1/suspend HTTP/1.1
Date: Wed, 21 Jan 2026 06:01:23 GMT
Content-Length: 0
Connection: keep-alive
Authorization: HBlock userName:signature
Host: 192.168.0.64:1443 响应示例
HTTP/1.1 202 Accepted
x-hblock-request-id: 8804e05a56b5425087f83db16b85a021
Connection: keep-alive
Content-Length: 0
Date: Wed, 21 Jan 2026 06:01:23 GMT
Server: HBlock
