获取备份列表
更新时间:2020-05-14
获取一个实例下的备份列表。
请求结构
GET /v{version}/instance/{instanceId}/backup HTTP/1.1
HOST: rds.bj.baidubce.com
Authorization: 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详情)对象组成的数组 |
请求示例
GET /v{version}/instance/{instanceId}/backup?marker=snap-xxx-xxxx&maxKeys=2 HTTP/1.1
HOST: rds.bj.baidubce.com
Authorization: bce-auth-v1/rdsak/2016-07-03T06:13:13Z/1800/x-bce-date/{signature}
返回示例
HTTP/1.1 200 OK
x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
Content-Type: application/json
Content-Length: 567
{
"nextMarker": "snap-xxx-xxxx",
"marker": "snap-xxx-xxxx",
"maxKeys": 2,
"isTruncated": true,
"backups":[{
"backupId" : "snap-xxx-xxxx",
"backupSize" : 12,
"backupType" : "Manual",
"backupStatus" : "Available",
"backupStartTime" : "2016-06-01T12:00:11Z",
"backupEndTime" : "2016-06-01T13:00:11Z"
},{
"backupId" : "snap-xxx-xxxx",
"backupSize" : 12,
"backupType" : "Manual",
"backupStatus" : "Available",
"backupStartTime" : "2016-06-01T12:00:11Z",
"backupEndTime" : "2016-06-01T13:00:11Z"
}]
}