此操作用查询指定快照
请求语法
GET /rest/v1/block/snapshot/snapshotName HTTP/1.1
Date:date
Host: ip:port
Authorization: authorization请求参数
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| snapshotName | String | 指定要查询的快照名称。 | 是 |
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| snapshotName | String | 快照名称。 |
| description | String | 快照描述信息。 |
| lunName | String | 源卷的名称。 |
| lunCapacity | Integer | 创建一致性快照时刻，源卷的容量。 |
| consistencySnapshotName | String | 所属的一致性快照名称。 说明 仅一致性快照的卷快照显示。 |
| status | String | 快照的状态：
|
| reclaimPolicy | String | 快照回收策略：
|
| createTime | Long | 快照的创建时间。 |
| clones | Array of clone | 克隆卷信息，详见“表1 响应参数clones说明”。 |
表1 响应参数clones说明
| 名称 | 类型 | 描述 |
|---|---|---|
| lunName | String | 克隆卷名称 |
| capacity | Integer | 克隆卷容量，单位是GiB。 |
| status | String | Status：克隆卷的状态：
|
请求示例1
查询快照lun01-snap20250304170942的信息。
GET /rest/v1/block/snapshot/lun01-snap20250304170942 HTTP/1.1
Date: Wed, 26 Mar 2025 02:38:08 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.65:1443
Connection: keep-alive响应示例1
HTTP/1.1 200 OK
x-hblock-request-id: 484cc1221acd42aeafae7a3675efd45a
Date: Wed, 26 Mar 2025 02:38:08 GMT
Connection: keep-alive
Content-Type: application/json;charset=utf-8
Content-Length: 329
Server: HBlock
{
"data": {
"snapshotName": "lun01-snap20250304170942",
"description": "The snapshot of consistencysnapshot4.",
"lunName": "lun01",
"lunCapacity": 100,
"consistencySnapshotName": "consistencysnapshot4",
"status": "Normal",
"reclaimPolicy": "Delete",
"createTime": 1741079382716,
"clones": [
{
"lunName": "lun01clon",
"capacity": 100,
"status": "Normal"
}
]
}
}请求示例2
查询快照snapshot-lun02-3的信息。
GET /rest/v1/block/snapshot/ snapshot-lun02-3 HTTP/1.1
Date: Wed, 26 Mar 2025 02:41:11 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.65:1443
Connection: keep-alive响应示例2
HTTP/1.1 200 OK
x-hblock-request-id: aa3de918f8c447d6b45565bf4fb0af00
Date: Wed, 26 Mar 2025 02:41:11 GMT
Connection: keep-alive
Content-Type: application/json;charset=utf-8
Content-Length: 267
Server: HBlock
{
"data": {
"snapshotName": "snapshot-lun02-3",
"description": "The third snapshot of lun02.",
"lunName": "lun02",
"lunCapacity": 100,
"status": "Normal",
"reclaimPolicy": "Retain",
"createTime": 1741072715661,
"clones": [
{
"lunName": "clone-lun02-3",
"capacity": 100,
"status": "Normal"
}
]
}
}
