云数据库RDS

    备份管理接口说明

    获取备份列表

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

    请求结构

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

    获取备份信息

    获取备份信息,下载链接有效时间为 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"
    }