此操作用来创建单卷快照。
注意
在执行此操作之前，请确保源卷的所有数据已持久化，即如果源卷已经挂载客户端，需确保客户端的数据都已经同步到卷上，创建快照前：
对于Linux客户端：sync版本大于等于8.6版本时（可以通过sync –version命令查看版本信息），在客户端执行sync -f命令；sync版本低于8.6版本时，在客户端执行sync命令。
对于Windows客户端：在客户端将源卷对应的磁盘脱机；创建快照后，在客户端将源卷对应的磁盘重新联机。
源卷需要处于正常状态。
说明
单卷支持的最大快照数：512。
系统支持的最大快照数：100000。
单个快照可创建的最大克隆卷数：512。
系统支持的最大快照深度：512。
请求语法
POST /rest/v1/block/snapshot HTTP/1.1
Date:date
Content-Type: application/json; charset=utf-8
Content-Length: length
Host: ip:port
Authorization: authorization
{
"snapshotName": snapshotName,
"lunName": lunName,
"reclaimPolicy": reclaimPolicy,
"description": description
}请求参数
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| snapshotName | String | 指定快照的名称。 注意 快照名称、一致性快照名称及一致性快照的卷快照名称必须唯一，不可相互重复。 | 是 |
lunName | String | 指定快照对应的源卷。 注意 仅支持本地模式（Local）的卷。 | 是 |
| reclaimPolicy | String | 指定快照回收策略。
默认值为Retain。 | 否 |
| description | String | 指定快照的描述信息。 | 否 |
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| snapshotName | String | 快照的名称。 |
| lunName | String | 快照对应的源卷。 |
请求示例
创建卷lun01a的快照snapshot-lun01a-2。
POST /rest/v1/block/snapshot HTTP/1.1
Date: Wed, 05 Mar 2025 06:26:39 GMT
Content-Type: application/json; charset=utf-8
Authorization: HBlock userName:signature
Host: 192.168.0.66:1443
Connection: keep-alive
Content-Length: 157
{
"snapshotName": "snapshot-lun01a-2",
"lunName": "lun01a",
"reclaimPolicy": "Delete",
"description": "The second snapshot of lun01a."
}响应示例
HTTP/1.1 202 Accepted
x-hblock-request-id: 1657c5585b25408f883cb76e5d3ad7ef
Date: Wed, 05 Mar 2025 06:26:39 GMT
Connection: keep-alive
Content-Type: application/json;charset=utf-8
Content-Length: 64
Server: HBlock
{
"data": {
"snapshotName": "snapshot-lun01a-2",
"lunName": "lun01a"
}
}
