备份管理接口说明
更新时间：2025-08-22
获取备份列表
获取一个实例下的备份列表。
请求结构
Plain Text
1GET /v{version}/instance/{instanceId}/backup HTTP/1.1
2HOST: rds.bj.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | string | 是 | URL参数 | API 版本号 |
| instanceId | string | 是 | URL参数 | 实例ID |
| marker | string | 否 | Query参数 | 批量获取列表的查询的起始位置，是一个由系统生成的字符串 |
| maxKeys | int | 否 | Query参数 | 每页包含的最大数量(主实例)，最大数量通常不超过1000，缺省值为1000。 |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| marker | string | 批量获取列表的查询的起始位置，是一个由系统生成的字符串 |
| maxKeys | int | 每页包含的最大数量(主实例)，最大数量通常不超过1000，缺省值为1000。 |
| isTruncated | boolean | true表示后面还有数据，false表示已经是最后一页 |
| nextMarker | string | 获取下一页所需要传递的marker值。当isTruncated为false时，该域不出现 |
| instances | List Instance | 由[Instance](RDS/API参考/对象说明.md#Instance Object详情)对象组成的数组 |
请求示例
Plain Text
1GET /v{version}/instance/{instanceId}/backup?marker=snap-xxx-xxxx&maxKeys=2 HTTP/1.1
2HOST: rds.bj.baidubce.com
3Authorization: bce-auth-v1/rdsak/2016-07-03T06:13:13Z/1800/x-bce-date/{signature}返回示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
3Content-Type: application/json
4Content-Length: 567
5
6{
7 "nextMarker": "snap-xxx-xxxx",
8 "marker": "snap-xxx-xxxx",
9 "maxKeys": 2,
10 "isTruncated": true,
11 "backups":[{
12 "backupId" : "snap-xxx-xxxx",
13 "backupSize" : 12,
14 "backupType" : "Manual",
15 "backupStatus" : "Available",
16 "backupStartTime" : "2016-06-01T12:00:11Z",
17 "backupEndTime" : "2016-06-01T13:00:11Z"
18 },{
19 "backupId" : "snap-xxx-xxxx",
20 "backupSize" : 12,
21 "backupType" : "Manual",
22 "backupStatus" : "Available",
23 "backupStartTime" : "2016-06-01T12:00:11Z",
24 "backupEndTime" : "2016-06-01T13:00:11Z"
25 }]
26}获取备份信息
获取备份信息，下载链接有效时间为 1800 秒。下载有效时间是下载链接的有效时间，而非下载时间。
请求结构
Plain Text
1GET /v{version}/instance/{instanceId}/backup/{backupId} HTTP/1.1
2HOST: rds.bj.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | string | 是 | URL参数 | API 版本号 |
| instanceId | string | 是 | URL参数 | 实例ID |
| backupId | string | 是 | URL参数 | 备份ID |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| backupId | String | 备份标识 |
| backupSize | int | 备份大小，单位MB |
| backupType | String | 备份类型，Manual：手动，Automated：自动。取值参考 |
| backupStatus | String | 备份状态，取值参考 |
| backupStartTime | String | 备份开始时间 |
| backupEndTime | String | 备份结束时间 |
| downloadExpires | String | 下载链接有效时间，单位s（秒） |
请求示例
Plain Text
1GET /v{version}/instance/{instanceId}/backup/snap-xxx-xxx HTTP/1.1
2HOST: rds.bj.baidubce.com
3Authorization: bce-auth-v1/rdsak/2016-07-03T06:13:13Z/1800/x-bce-date/{signature}返回示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
3Content-Type: application/json
4Content-Length: 567
5
6{
7 "backupId" : "snap-xxx-xxxx",
8 "backupSize" : 12,
9 "backupType" : "manual",
10 "backupStatus" : "available",
11 "backupStartTime" : "2016-06-01T12:00:11Z",
12 "backupEndTime" : "2016-06-01T13:00:11Z",
13 "downloadUrl" : "http://snap-xx-xxxx.s3.baidu.com",
14 "downloadExpires" : "2016-06-01T13:30:11Z"
15}