創建快照
更新時間 2025-07-14 18:44:11
最近更新時間: 2025-07-14 18:44:11
分享文章
本節主要介紹如何使用API創建快照。
此操作用來創建單卷快照。
注意
在執行此操作之前，請確保源卷的所有數據已持久化，即如果源卷已被客戶端掛載，需確保客戶端的數據都已經同步到卷上，創建快照前：
對于Linux客戶端：如果客戶端支持sync -f（可以通過sync --help命令查看是否支持），在客戶端執行sync -f命令；否則在客戶端執行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"
}
}
