此操作用來導出備份。
說明
僅本地卷支持導出備份。
備份分為全量備份和增量備份：
全量備份：導出從卷創建到快照時刻數據到備份文件中。
增量備份：導出同一個卷的兩個快照之間的差異數據到備份文件中，如創建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
