备份管理接口说明

获取备份列表

获取一个实例下的备份列表。

请求结构

GET /v{version}/instance/{instanceId}/backup HTTP/1.1
HOST: rds.bj.baidubce.com
Authorization: authorization string

请求头域

除公共头域外,无其它特殊头域。

请求参数

参数名称类型是否必须参数位置描述
versionstringURL参数API 版本号
instanceIdstringURL参数实例ID
marker string Query参数批量获取列表的查询的起始位置,是一个由系统生成的字符串
maxKeysintQuery参数每页包含的最大数量(主实例),最大数量通常不超过1000,缺省值为1000。

返回头域

除公共头域,无其它特殊头域。

返回参数

参数名称 类型 描述
marker string 批量获取列表的查询的起始位置,是一个由系统生成的字符串
maxKeys int 每页包含的最大数量(主实例),最大数量通常不超过1000,缺省值为1000。
isTruncated boolean true表示后面还有数据,false表示已经是最后一页
nextMarker string 获取下一页所需要传递的marker值。当isTruncated为false时,该域不出现
instances List Instance Instance对象组成的数组

请求示例

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"
    }]
}

获取备份信息

获取备份信息,下载链接有效时间为 1800 秒。下载有效时间是下载链接的有效时间,而非下载时间。

请求结构

GET /v{version}/instance/{instanceId}/backup/{backupId} HTTP/1.1
HOST: rds.bj.baidubce.com
Authorization: authorization string

请求头域

除公共头域外,无其它特殊头域。

请求参数

参数名称类型是否必须参数位置描述
versionstringURL参数API 版本号
instanceIdstringURL参数实例ID
backupIdstringURL参数备份ID

返回头域

除公共头域,无其它特殊头域。

返回参数

参数名称 类型 描述
backupId String 备份标识
backupSize int 备份大小,单位MB
backupType String 备份类型,Manual:手动,Automated:自动。取值参考
backupStatus String 备份状态,取值参考
backupStartTime String 备份开始时间
backupEndTime String 备份结束时间
downloadExpires String 下载链接有效时间,单位s(秒)

请求示例

GET /v{version}/instance/{instanceId}/backup/snap-xxx-xxx 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

{
        "backupId"          : "snap-xxx-xxxx",
        "backupSize" : 12,
        "backupType"        : "manual",
        "backupStatus"      : "available",
        "backupStartTime"   : "2016-06-01T12:00:11Z",
        "backupEndTime"     : "2016-06-01T13:00:11Z",
        "downloadUrl"       : "http://snap-xx-xxxx.s3.baidu.com",
        "downloadExpires"   : "2016-06-01T13:30:11Z"
}