查詢指定快照
更新時間 2025-09-29 17:49:36
最近更新時間: 2025-09-29 17:49:36
分享文章
本節主要介紹如何使用API查詢指定快照。
此操作用查詢指定快照
請求語法
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說明”。 |
| snapshotSize | Long | 快照大小，即快照記錄的數據量。單位是字節。 注意 卷異常或上游快照刪除等因素可能導致快照大小波動。 |
表1 響應參數clones說明
| 名稱 | 類型 | 描述 |
|---|---|---|
| lunName | String | 克隆卷名稱 |
| capacity | Integer | 克隆卷容量，單位是GiB。 |
| status | String | 克隆卷的狀態：
|
請求示例1
查詢快照luna1-snap20250728153126的信息。
GET /rest/v1/block/snapshot/luna1-snap20250728153126 HTTP/1.1
Date: Mon, 28 Jul 2025 08:42:00 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.66:1443
Connection: keep-alive響應示例1
HTTP/1.1 200 OK
x-hblock-request-id: 213f54cf9c1b4c4d993dee36f3c36664
Date: Mon, 28 Jul 2025 08:42:00 GMT
Connection: keep-alive
Content-Type: application/json;charset=utf-8
Content-Length: 333
Server: HBlock
{
"data": {
"snapshotName": "luna1-snap20250728153126",
"description": "This is the snapshot of luna1.",
"lunName": "luna1",
"lunCapacity": 100,
"consistencySnapshotName": "consnap2",
"status": "Normal",
"reclaimPolicy": "Retain",
"createTime": 1753687886869,
"clones": [
{
"lunName": "clone-1",
"capacity": 100,
"status": "Normal"
}
],
"snapshotSize": 401063936
}
}請求示例2
查詢快照luna1-snap6的信息。
GET /rest/v1/block/snapshot/luna1-snap6 HTTP/1.1
Date: Mon, 28 Jul 2025 09:03:56 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.66:1443
Connection: keep-alive響應示例2
HTTP/1.1 200 OK
x-hblock-request-id: aa3de918f8c447d6b45565bf4fb0af00
Date: Mon, 28 Jul 2025 09:03:56 GMT
Connection: keep-alive
Content-Type: application/json;charset=utf-8
Content-Length: 271
Server: HBlock
{
"data": {
"snapshotName": "luna1-snap6",
"description": "The snapshot of luna1.",
"lunName": "luna1",
"lunCapacity": 100,
"status": "Normal",
"reclaimPolicy": "Retain",
"createTime": 1753692886817,
"clones": [
{
"lunName": "clone-6",
"capacity": 100,
"status": "Normal"
}
],
"snapshotSize": 98304
}
}
