導入備份
更新時間 2025-09-29 17:49:37
最近更新時間: 2025-09-29 17:49:37
分享文章
本節主要介紹如何使用API 導入備份。
此操作用來將備份文件的數據導入卷。
僅本地卷支持導入備份。導入全量備份時，建議使用新卷，或者卷原有數據已經清除。
清空卷會將卷的現有數據和快照刪除，恢復到原始新創建的狀態。如果想保留目標卷（被導入備份的卷）的快照及數據，可以在卷首次寫入數據前創建一個“初始快照”，記錄卷初始狀態。后續導入備份時，將此卷回滾到“初始快照”即可。這樣操作即可保留目標卷已有快照，同時保證導入備份數據正常可用。
注意
每次只能導入一個備份文件。如果涉及多個備份文件，請按照快照生成的先后順序依次導入對應的備份文件。
被導入備份的卷，導入的時候卷不能有讀寫操作。
導入備份文件時，尤其是涉及多個全量和增量備份導入時，在沒有把多個備份文件導入完成之前，不能將目標卷掛載到客戶端，此時如果掛載到客戶端可能會引起文件系統損壞。需將全部需要導入的備份導入完成后再進行掛載，且掛載后不再導入備份文件。如果卷已經掛載到客戶端，需先取消掛載，執行清空卷后再導入備份文件。
如果用戶先將完整備份文件自行拆分為多個分片，再執行導入操作，需要確保前一個分片文件與后一個分片文件存在數據重疊，并且每個分片的起始位置需為256MiB的倍數。例如第一個分片為0 - 515MiB，第二個分片為512MiB - 1024MiB。
請求語法
PUT /rest/v1/block/backup/importfile/lunName HTTP/1.1
Date: date
Content-Type: application/octet-stream
Content-Length: length
Host: ip:port
Authorization: authorization
backupFileContent參數
| 參數 | 類型 | 描述 | 是否必須 |
|---|---|---|---|
| lunName | String | 要導入備份的卷名稱。 注意 卷大小需要大于備份文件對應快照在快照時刻的源卷大小。 | 是 |
| backupFileContent | 無 | 要導入的備份文件。 | 是 |
請求示例
導入備份文件到lunc1。
PUT /rest/v1/block/backup/importfile/lunc1 HTTP/1.1
Date: Wed, 30 Jul 2025 08:48:10 GMT
Content-Type: application/octet-stream
Authorization: HBlock userName:signature
Host: 192.168.0.66:1443
Connection: keep-alive
Content-Length: 300190151
file響應示例
HTTP/1.1 204 No Content
x-hblock-request-id: e89fd1bc1a264baaa26e4c7e50c63585
Date: Wed, 30 Jul 2025 08:48:10 GMT
Connection: keep-alive
Server: HBlock
