此操作用来导出备份。
说明
仅本地卷支持导出备份。
备份分为全量备份和增量备份：
全量备份：导出从卷创建到快照时刻数据到备份文件中。
增量备份：导出同一个卷的两个快照之间的差异数据到备份文件中，如创建snap1-snap2的增量备份，即导出从快照snap1时刻到快照snap2时刻的卷数据。
注意
只有在快照均为Normal状态下才可以导出备份。
只有卷在Normal状态下才可以导出备份。
导出备份时，不能删除相关的快照和卷。
请求语法
请求语法1
POST /rest/v1/block/backup/export HTTP/1.1
Date: date
Content-Type: application/json; charset=utf-8
Content-Length: length
Host: ip:port
Authorization: authorization
{
"snapshot": snapshot,
"fromSnap": snapshot,
"breakpoint": breakpoint,
"compression": compression
}请求语法2
GET /rest/v1/block/backup/export?snapshot=snapshotName&checkFlag=checkFlag&fromSnap=snapshotName&breakpoint=breakpoint&compression=compression HTTP/1.1
Date: date
Content-Type: application/json; charset=utf-8
Content-Length: length
Host: ip:port
Authorization: authorization参数
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| snapshot | String | 快照名称，表示将快照时刻的数据进行导出。 | 是 |
| fromSnap | String | 快照名称，表示导出此快照时刻之后的数据。 说明 导出增量备份时必须设置此参数，表示增量备份的起始快照名称。不设置此参数，表示从卷的起始位置开始备份。 | 否 |
| breakpoint | Long | 断点位置，本次备份任务导出任务的起始位置。如果上次导出时中断，本次导出任务需要从中断位置进行导出。 取值：268435456的倍数，单位是字节。不输入或者0表示导出全部数据。如果超过了备份文件的大小，则以空数据生成一个空备份文件。 说明 针对非压缩模式的备份文件，由固定大小的分片（256MiB）组成。在计算导出任务的中断位置时，根据已经导出的备份文件大小，以及固定分片大小，计算出已经成功导出的分片文件大小，即中断位置。
后续中断依此规则类推。 | 否 |
| compression | String | 是否对备份文件压缩。 取值：
如果breakpoint取值不为0，默认值为Disabled；如果breakpoint取值为0，或者没有赋值，默认值为Enabled。 注意 compression=Enabled和breakpoint=!0不能同时存在。 | 否 |
| checkFlag | Boolean | 是否仅校验参数。 取值：
默认值为false。 | 否 |
请求示例1
导出全量备份。
POST /rest/v1/block/backup/export HTTP/1.1
Date: Wed, 30 Jul 2025 06:51:04 GMT
Content-Type: application/json; charset=utf-8
Authorization: HBlock userName:signature
Host: 192.168.0.66:1443
Connection: keep-alive
Content-Length: 35
{
"snapshot": "luna1-snap1"
}响应示例1
HTTP/1.1 200 OK
x-hblock-request-id: 7548f1bb2ae048c59925ab8f15c8dcc5
Date: Wed, 05 Mar 2025 06:26:39 GMT
Connection: keep-alive
Content-Type: application/octet-stream;charset=utf-8
Server: HBlock
Content-Disposition: attachment;filename=[luna1]_[luna1-snap1]_20250730145104请求示例2
导出增量备份。
GET /rest/v1/block/backup/export?snapshot=luna1-snap3&checkFlag=false&fromSnap=luna1-snap1 HTTP/1.1
Date: Wed, 30 Jul 2025 07:07:55
Authorization: HBlock userName:signature
Host: 192.168.0.66:1443
Connection: keep-alive响应示例2
HTTP/1.1 200 OK
x-hblock-request-id: d16ed90970f3443daab104b6b9cd5441
Date: Wed, 30 Jul 2025 07:07:57
Connection: keep-alive
Content-Type: application/octet-stream;charset=utf-8
Server: HBlock
Content-Disposition: attachment;filename=[luna1]_[luna1-snap1]_[luna1-snap3]_20250730150757
