此操作用来批量查询快照。
请求语法
GET /rest/v1/block/snapshot?filter=filter&range=i-j HTTP/1.1
Date:date
Host: ip:port
Authorization: authorization请求参数
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| filter | String | 查询的过滤条件。可以选择多个查询，如果是或的关系，使用“or”将查询条件分隔开；如果是与的关系，使用“and”将查询条件分隔开。
| 否 |
| range | String | 查询快照的范围，格式为i-j，i和j为正整数，0<j-i<1000。按照快照名称进行排序，返回第i到第j的快照。 | 否 |
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| snapshots | Array of snapshot | 快照信息集合，详见“表1 响应参数snapshot说明”。 |
表1 响应参数snapshot说明
| 名称 | 类型 | 描述 |
|---|---|---|
| snapshotName | String | 快照名称。 |
| description | String | 快照描述信息。 |
| lunName | String | 源卷的名称。 |
| lunCapacity | Integer | 创建快照时刻，源卷的容量。 |
| consistencySnapshotName | String | 所属的一致性快照名称。 说明 仅一致性快照的卷快照显示。 |
| status | String | 快照的状态：
|
| reclaimPolicy | String | 快照回收策略：
|
| createTime | Long | 快照的创建时间。 |
| cloneNumbers | Integer | 克隆卷的个数。 |
请求示例
批量查询快照信息：源卷名称中包含lun，快照名称中包lun01a，输出第1-3条的显示信息。
GET /rest/v1/block/snapshot?filter=lunName:lun and snapshotName:lun01a&range=1-3 HTTP/1.1
Date: Mon, 10 Mar 2025 02:31:40 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.66:1443
Connection: keep-alive响应示例
HTTP/1.1 200 OK
x-hblock-request-id: c3a93a73e6844b159f369659b9c841aa
Date: Mon, 10 Mar 2025 02:31:40 GMT
Connection: keep-alive
Content-Type: application/json;charset=utf-8
Content-Length: 702
Server: HBlock
{
"data": {
"snapshots": [
{
"snapshotName": "lun01a-snap20250304161817",
"description": "",
"lunName": "lun01a",
"lunCapacity": 100,
"consistencySnapshotName": "consistencysnapshot1",
"status": "Normal",
"reclaimPolicy": "Retain",
"createTime": 1741076297203,
"cloneNumbers": 1
},
{
"snapshotName": "lun01a-snap20250304170942",
"description": "",
"lunName": "lun01a",
"lunCapacity": 100,
"consistencySnapshotName": "consistencysnapshot4",
"status": "Normal",
"reclaimPolicy": "Retain",
"createTime": 1741079382737,
"cloneNumbers": 0
},
{
"snapshotName": "snapshot-lun01a-2",
"description": "The second snapshot of lun01a.",
"lunName": "lun01a",
"lunCapacity": 100,
"status": "Normal",
"reclaimPolicy": "Delete",
"createTime": 1741155999216,
"cloneNumbers": 2
}
]
}
}
