查询备份列表
更新时间：2023-09-25
接口说明
查询备份列表
请求结构
Plain Text
1GET /v{version}/instance/{instanceId}/backup?marker={marker}&maxKeys={maxKeys} http 1.1
2HOST: rds.bj.baidubce.com
3Authorization:authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 参数类型 | 是否必须 | 参数位置 | 示例值 | 描述 |
|---|---|---|---|---|---|
| version | Integer | 是 | URL参数 | 1 | API版本号 |
| instanceId | String | 是 | URL参数 | rds-JGroEX60 | 实例ID列表 |
| marker | String | 否 | Query参数 | -1 | 查找的分页的backupId，默认值为-1，表示第一页 |
| maxKeys | Integer | 否 | Query参数 | 1000 | 每一页的分页条数，默认值为1000 |
返回头域
除公共头域外，无其它特殊头域。
返回参数
| 参数名称 | 参数类型 | 描述 |
|---|---|---|
| marker | String | 查找的分页的backupId，默认为-1 |
| isTruncated | Boolean | 是否还有下一页，如果有此选项为true，如果没有则为false |
| nextMarker | String | 下一页backupId值，如果有此选项不为空，没有则为空 |
| backups | List<OpenApiBackup> | 备份对象 |
OpenApiBackup
| 参数名称 | 参数类型 | 描述 |
|---|---|---|
| backupId | String | 备份 ID |
| backupSize | Long | 实例大小，单位MB |
| backupType | String | 备份类型 manual(手工创建)， automated(自动创建) |
| backupStatus | String | 备份状态。 creating(创建中) available(备份可用) deleting(正在删除) |
| backupStartTime | String | 备份开始时间 |
| backupEndTime | String | 备份结束时间 |
| downloadUrl | String | 下载URL |
| downloadExpires | String | 下载有效期 |
请求示例
Plain Text
1 GET /v1/instance/rds-JGroEX60/backup?marker=-1&maxKeys=100
2 HOST: rds.bj.baidubce.com
3 Content-Type: application/json
4 Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2017-11-21T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de 返回示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
3Content-Type: application/json
4{
5"marker": "-1",
6"isTruncated": false,
7"nextMarker": null,
8"maxKeys": 1000,
9"backups": [
10 {
11 "backupId": "1689087605048013371",
12 "backupSize": 1,
13 "backupType": "automated",
14 "backupStatus": "available",
15 "backupStartTime": "2023-07-11T18:24:14Z",
16 "backupEndTime": "2023-07-11T18:22:29Z",
17 "downloadUrl": null,
18 "downloadExpires": null
19 },
20 {
21 "backupId":"1689001205147780871",
22 "backupSize":1,
23 "backupType":"automated",
24 "backupStatus":"available",
25 "backupStartTime":"2023-07-10T18:24:14Z",
26 "backupEndTime": "2023-07-10T18:22:31Z",
27 "downloadUrl": null,
28 "downloadExpires": null
29 }
30 ]
31}