查询备份列表
更新时间：2025-03-20
查询备份列表
接口描述
- 用于查询备份列表
- 本接口为v1接口
权限说明
所有API的安全认证一律采用Access Key与请求签名机制。 Access Key由Access Key ID和Secret Access Key组成，均为字符串。 对于每个HTTP请求，使用下面所描述的算法生成一个认证字符串。提交认证字符串放在Authorization头域里。服务端根据生成算法验证认证字符串的正确性。 认证字符串的格式为bce-auth-v{version}/{accessKeyId}/{timestamp}/{expirationPeriodInSeconds}/{signedHeaders}/{signature}。
- version是正整数。
- timestamp是生成签名时的UTC时间。
- expirationPeriodInSeconds表示签名有效期限。
- signedHeaders是签名算法中涉及到的头域列表。头域名之间用分号（;）分隔，如host;x-bce-date。列表按照字典序排列。（本API签名仅使用host和x-bce-date两个header）
- signature是256位签名的十六进制表示，由64个小写字母组成。
当百度智能云接收到用户的请求后，系统将使用相同的SK和同样的认证机制生成认证字符串，并与用户请求中包含的认证字符串进行比对。如果认证字符串相同，系统认为用户拥有指定的操作权限，并执行相关操作；如果认证字符串不同，系统将忽略该操作并返回错误码。
鉴权认证机制的详细内容请参见 鉴权认证。
注意事项
请求结构
Plain Text
1GET /v{version}/vdb/backup/listRecords?instanceId=vdb-bj-xxxx&listOrder=desc&page=1&pageSize=10 HTTP/1.1
2HOST: vdb.bj.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号。 |
| instanceId | String | 是 | Query参数 | 要备份的实例ID |
| listOrder | String | 是 | Query参数 | 取值范围：desc, asc |
| page | Integer | 是 | Query参数 | 页码，从1开始 |
| pageSize | Integer | 是 | Query参数 | 每页大小 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| total | Integer | 数据总条数 |
| records | List < Record > | Record 数组 |
Record
| 参数名称 | 类型 | 描述 |
|---|---|---|
| batchId | String | 批次id |
| backupType | String | 备份类型auto/manual |
| comment | String | 备注 |
| startTime | String | 开始备份时间 |
| recoverable | String | recoverable/non-recoverable |
| storageType | String | phy表示物理备份，其他表示快照备份 |
| batchRecords | List < BackupRecord > | 一批备份实例 |
Record
| 参数名称 | 类型 | 描述 |
|---|---|---|
| backupId | Integer | 备份id |
| startTime | String | 开始时间 |
| duration | Integer | 持续时间 |
| objectSize | Integer | 文件大小 |
| backupType | String | 备份类型auto/manual |
| backupStatus | String | 状态 |
| nodeInfo | String | 节点信息 |
| comment | String | 备注 |
请求示例
Plain Text
1GET /v1/vdb/backup/listRecords?instanceId=vdb-bj-xxxx&listOrder=desc&page=1&pageSize=10 HTTP/1.1
2HOST: vdb.bj.baidubce.com
3Content-Type: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2017-11-21T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de响应示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
3Content-Type: application/json
4
5{
6 "total": 1,
7 "records": [
8 {
9 "batchId": "1742407135093274001",
10 "backupType": "auto",
11 "comment": "",
12 "startTime": "2025-03-19T18:30:55Z",
13 "recoverable": "recoverable",
14 "storageType": "",
15 "batchRecords": [
16 {
17 "backupId": 24736,
18 "startTime": "2025-03-19T18:30:55Z",
19 "duration": 96,
20 "objectSize": 1,
21 "backupType": "auto",
22 "backupStatus": "success",
23 "nodeInfo": "vdb-bj-mbkctehtcusz-m-1_192.168.0.85_8288",
24 "comment": ""
25 }
26 ]
27 }
28 ]
29}