备份管理接口说明
所有文档

          云数据库 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"
          }