导入备份
更新时间 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
