此操作用来批量查询一致性快照。
请求语法
GET /rest/v1/block/conssnap?filter=filter&range=i-j HTTP/1.1
Date:date
Host: ip:port
Authorization: authorization请求参数
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| filter | String | 查询的过滤条件。 支持的过滤条件类型包括：
| 否 |
| range | String | 查询一致性快照的范围，格式为i-j，i和j为正整数，0<j-i<1000。按照一致性快照名称进行排序，返回第i到第j的快照。 | 否 |
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| consistencySnapshotName | String | 一致性快照名称。 |
| description | String | 一致性快照描述信息。 |
| lunSnapshotNumbers | Integer | 一致性快照的卷快照数。 |
| status | String | 一致性快照的状态：
|
| createTime | Long | 一致性快照的创建时间。 |
| lunSnapshots | Array of lunSnapshot | 一致性快照中卷快照信息集合，详见“表1 响应参数lunSnapshot说明”。 |
表1 响应参数lunSnapshot说明
| 名称 | 类型 | 描述 |
|---|---|---|
| snapshotName | String | 一致性快照中卷快照名称。 |
| cloneNumbers | Integer | 卷快照关联的链接克隆卷的个数。 |
请求示例
批量查询一致性快照信息：一致性快照名称中包含consistencysnapshot。
GET /rest/v1/block/conssnap?filter=consistencySnapshotName:consistencysnapshot HTTP/1.1
Date: Tue, 11 Mar 2025 02:22:20 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.66:1443
Connection: keep-alive响应示例
HTTP/1.1 200 OK
x-hblock-request-id: fcd556c82e19480ab050c200c631e89f
Date: Tue, 11 Mar 2025 02:22:20 GMT
Connection: keep-alive
Content-Type: application/json;charset=utf-8
Content-Length: 719
Server: HBlock
{
"data": {
"consistencySnapshot": [
{
"consistencySnapshotName": "consistencysnapshot1",
"description": "consistency snapshot",
"lunSnapshotNumbers": 1,
"status": "Normal",
"createTime": 1741076297083,
"lunSnapshots": [
{
"snapshotName": "lun01a-snap20250304161817",
"cloneNumbers": 1
}
]
},
{
"consistencySnapshotName": "consistencysnapshot4",
"description": "The consistencysnapshot of lun01,lun01a,lun02,lun03.",
"lunSnapshotNumbers": 4,
"status": "Normal",
"createTime": 1741079382519,
"lunSnapshots": [
{
"snapshotName": "lun01-snap20250304170942",
"cloneNumbers": 1
},
{
"snapshotName": "lun02-snap20250304170942",
"cloneNumbers": 0
},
{
"snapshotName": "lun01a-snap20250304170942",
"cloneNumbers": 2
},
{
"snapshotName": "lun03-snap20250304170942",
"cloneNumbers": 0
}
]
}
]
}
}
