帮助中心 > 数据库 > 云数据库MySQL > API文档 > 备份相关

备份相关

1.数据备份列表

接口地址

  1. https://api.yisu.com/rds/backup/getDataLogList

HTTP METHOD

POST

HTTP BODY编码格式

application/x-www-form-urlencoded

请求参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

名称 类型 是否必填 说明
instanceId string
startTime string 开始时间
endTime string 结束时间:默认为该时间当天的23:59:59
currentPage string 页码
pageSize string 每页数量

返回数据








名称类型是否必须默认值备注其他信息
codenumber非必须错误码
messagestring非必须错误信息
dataobject非必须返回数据
├─ totalResultnumber非必须总记录数
├─ currentPagenumber非必须页码
├─ pageSizenumber非必须每页数量
├─ logFilesobject []非必须数据备份列表

item 类型: object

├─ fileNamestring必须文件名
├─ fileSizestring必须文件大小
├─ backupMethodnumber必须备份方式:2物理备份、1逻辑备份
├─ backupStrategynumber必须备份策略:1实例备份、2单库备份
├─ backupTypenumber必须备份方式:1全量备份
├─ startTimestring必须备份开始时间
├─ endTimestring必须备份完成时间
├─ recoverTimestring必须备份机恢复时间点
├─ backupDbsstring []必须单库备份数据库列表

item 类型: string

├─ 非必须
├─ enableRecovernumber必须是否允许恢复备份1是0否
requestIdstring非必须请求ID

请求示例

  1. curl -XPOST
  2. "https://api.yisu.com/rds/backup/getDataLogList" \
  3. -H "content-type: application/x-www-form-urlencoded" \
  4. -d "accessId=abcdefghijklmnop&nonce=48693365&signature=wm8pQlU34oA5NAEffMtc8NQHues%3D&instanceId=yisurds-60e69eab6173d8-66643171=startTime=2021-07-10=endTime=2021-07-9=currentPage=1=pageSize=2"

返回示例

  1. {
  2. "code": 200,
  3. "message": "请求成功",
  4. "data": {
  5. "totalResult": 6,
  6. "currentPage": 1,
  7. "pageSize": 10,
  8. "logFiles": [
  9. {
  10. "fileName": "auto_1625854443_840.xb",
  11. "fileSize": "165.98M",
  12. "backupMethod": 2,
  13. "backupStrategy": 1,
  14. "backupType": 1,
  15. "startTime": "2021-07-10 02:14:03",
  16. "endTime": "2021-07-10 02:14:08",
  17. "recoverTime": "2021-07-10 02:14:03",
  18. "backupDbs": [],
  19. "enableRecover": 1
  20. },
  21. ]
  22. },
  23. "requestId": "250e16d8ca796d7bc8a20a6cd8791558"
  24. }

2.binlog备份列表

接口地址

  1. https://api.yisu.com/rds/backup/getBinlogList

HTTP METHOD

POST

HTTP BODY编码格式

application/x-www-form-urlencoded

请求参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

名称 类型 是否必填 说明
instanceId string
startTime string 开始时间
endTime string 结束时间:默认为该时间当天的23:59:59
currentPage string 页码
pageSize string 每页数量

返回数据








名称类型是否必须默认值备注其他信息
codenumber非必须错误码
messagestring非必须错误信息
dataobject非必须返回数据
├─ totalResultnumber非必须总记录数
├─ currentPagenumber非必须页码
├─ pageSizestring非必须每页数量
├─ logFilesobject []非必须数据备份列表

item 类型: object

├─ fileNamestring必须文件名
├─ fileSizestring必须文件大小
├─ beginTimestring必须备份开始时间
├─ endTimestring必须备份完成时间
requestIdstring非必须请求ID

请求示例

  1. curl -XPOST
  2. "https://api.yisu.com/rds/backup/getBinlogList" \
  3. -H "content-type: application/x-www-form-urlencoded" \
  4. -d "accessId=abcdefghijklmnop&nonce=48693365&signature=wm8pQlU34oA5NAEffMtc8NQHues%3D&instanceId=yisurds-60e69eab6173d8-66643171=startTime=2021-07-9=endTime=2021-07-8=currentPage=1=pageSize=2"

返回示例

  1. {
  2. "code": 200,
  3. "message": "请求成功",
  4. "data": {
  5. "totalResult": 4,
  6. "currentPage": 1,
  7. "pageSize": "2",
  8. "logFiles": [
  9. {
  10. "fileName": "mysql-bin.000005",
  11. "fileSize": "2.75K",
  12. "beginTime": "2021-07-08 14:46:28",
  13. "endTime": "2021-07-08 4:08:02"
  14. }
  15. ]
  16. },
  17. "requestId": "3f93023b89e532d730bf50301d81c074"
  18. }

3.获取备份设置明细

接口地址

  1. https://api.yisu.com/rds/backup/getBackupSettingDetail

HTTP METHOD

POST

HTTP BODY编码格式

application/x-www-form-urlencoded

请求参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

名称 类型 是否必填 说明
instanceId string

返回数据








名称类型是否必须默认值备注其他信息
codenumber非必须错误码
messagestring非必须错误信息
dataobject非必须返回数据
├─ backupSettingsobject非必须备份设置明细
├─ instanceIdstring非必须实例ID
├─ nextBackupTimestring非必须下次备份时间
├─ dataBackupPeriodstring非必须数据备份周期:Monday,Tuesday,Wednesday,Thursday,Friday,Saturday,Sunday;多个用英文逗号隔开
├─ dataKeepDaysstring非必须数据备份保留天数
├─ dataBackupTimestring非必须数据备份时间点:03:10-04:10
├─ backupLogstring非必须是否开启日志备份
├─ logKeepDaysstring非必须日志备份保留天数
requestIdstring非必须请求ID

请求示例

  1. curl -XPOST
  2. "https://api.yisu.com/rds/backup/getBackupSettingDetail" \
  3. -H "content-type: application/x-www-form-urlencoded" \
  4. -d "accessId=abcdefghijklmnop&nonce=48693365&signature=wm8pQlU34oA5NAEffMtc8NQHues%3D&instanceId=yisurds-60e69eab6173d8-66643171"

返回示例

  1. {
  2. "code": 200,
  3. "message": "请求成功",
  4. "data": {
  5. "backupSettings": {
  6. "instanceId": "yisurds-60e69eab6173d8-66643171",
  7. "nextBackupTime": "2021-07-11 02:00:00",
  8. "dataBackupPeriod": "Monday,Tuesday,Wednesday,Thursday,Friday,Saturday,Sunday",
  9. "dataKeepDays": "7",
  10. "dataBackupTime": "02:00-04:00",
  11. "backupLog": "1",
  12. "logKeepDays": "7"
  13. }
  14. },
  15. "requestId": "6a235a15721d1b5c4d4d65f896508af9"
  16. }

4.创建备份

接口地址

  1. https://api.yisu.com/rds/backup/createBackup

HTTP METHOD

POST

HTTP BODY编码格式

application/x-www-form-urlencoded

请求参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

名称 类型 是否必填 说明
instanceId string 实例ID
backupStrategy string 备份策略:1实例备份、2单库备份
backupMethod string 备份方式:2物理备份、1逻辑备份

返回数据








名称类型是否必须默认值备注其他信息
codenumber非必须错误码
messagestring非必须错误信息
requestIdstring非必须请求ID

请求示例

  1. curl -XPOST
  2. "https://api.yisu.com/rds/backup/createBackup" \
  3. -H "content-type: application/x-www-form-urlencoded" \
  4. -d "accessId=abcdefghijklmnop&nonce=48693365&signature=wm8pQlU34oA5NAEffMtc8NQHues%3D&instanceId=yisurds-60e69eab6173d8-66643171=backupStrategy=1=backupMethod=1"

返回示例

  1. {
  2. "code": 200,
  3. "message": "请求成功",
  4. "requestId": "ecbd142fdba284b949538e7cd562ba4e"
  5. }

5.获取备份集的数据库、表信息

接口地址

  1. https://api.yisu.com/rds/backup/getRecordDbsInfo

HTTP METHOD

POST

HTTP BODY编码格式

application/x-www-form-urlencoded

请求参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

名称 类型 是否必填 说明
instanceId string 实例ID
fileName string 备份集文件名

返回数据








名称类型是否必须默认值备注其他信息
codenumber非必须错误码
messagestring非必须错误信息
dataobject非必须返回数据
├─ filenamestring非必须文件名
├─ dbsobject []非必须当前备份文件时间点的数据库列表

item 类型: object

├─ db_namestring必须数据库名
├─ tablesobject []必须数据表列表

item 类型: object

├─ namestring必须表名
├─ sizestring必须数据大小,单位MB
requestIdstring非必须请求ID

请求示例

  1. curl -XPOST
  2. "https://api.yisu.com/rds/backup/getRecordDbsInfo" \
  3. -H "content-type: application/x-www-form-urlencoded" \
  4. -d "accessId=abcdefghijklmnop&nonce=48693365&signature=wm8pQlU34oA5NAEffMtc8NQHues%3D&instanceId=yisurds-60e69eab6173d8-66643171=fileName=auto_1626027242_716.xb"

返回示例

  1. {
  2. "code": 200,
  3. "message": "请求成功",
  4. "data": {
  5. "filename": "auto_1626027242_716.xb",
  6. "dbs": [
  7. {
  8. "db_name": "db2",
  9. "tables": [
  10. {
  11. "name": "sbtest1",
  12. "size": "23.063"
  13. }
  14. ]
  15. }
  16. ]
  17. },
  18. "requestId": "148ccfe12bc5947e7ec41b9b1f2cf038"
  19. }

6.恢复备份

接口地址

  1. https://api.yisu.com/rds/backup/recoverBackup

HTTP METHOD

POST

HTTP BODY编码格式

application/x-www-form-urlencoded

请求参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

名称 类型 是否必填 说明
instanceId string 实例ID
fileName string 文件名
backupInfos string 恢复明细

返回数据








名称类型是否必须默认值备注其他信息
codenumber非必须错误码
messagestring非必须错误信息
requestIdstring非必须请求ID

请求示例

  1. curl -XPOST
  2. "https://api.yisu.com/rds/backup/recoverBackup" \
  3. -H "content-type: application/x-www-form-urlencoded" \
  4. -d "accessId=abcdefghijklmnop&nonce=48693365&signature=wm8pQlU34oA5NAEffMtc8NQHues%3D&instanceId=yisurds-60e69eab6173d8-66643171=fileName=auto_1626027242_716.xb=backupInfos=%5B%7B%22backupType%22%3A%22db%22%2C%22dbName%22%3A%22db2%22%2C%22backupDbName%22%3A%22db2_backup_backup%22%2C%22tableName%22%3A%22%22%2C%22backupTableName%22%3A%22%22%7D%2C%7B%22backupType%22%3A%22table%22%2C%22dbName%22%3A%22t101%22%2C%22backupDbName%22%3A%22t101%22%2C%22tableName%22%3A%22T1%22%2C%22backupTableName%22%3A%22T1_backup_backup%22%7D%5D"

返回示例

  1. {
  2. "code": 200,
  3. "message": "请求成功",
  4. "requestId": "108207b88d3975ac162ed8697e8ea899"
  5. }

7.获得备份文件下载地址

接口地址

  1. https://api.yisu.com/rds/backup/getDownloadLink

HTTP METHOD

POST

HTTP BODY编码格式

application/x-www-form-urlencoded

请求参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

名称 类型 是否必填 说明
instanceId string 实例ID
fileName string 文件名

返回数据








名称类型是否必须默认值备注其他信息
codenumber非必须错误码
messagestring非必须错误信息
dataobject非必须返回数据
├─ fileLinksobject非必须下载链接信息
├─ outer_addressstring非必须下载链接地址
requestIdstring非必须请求ID

请求示例

  1. curl -XPOST
  2. "https://api.yisu.com/rds/backup/getDownloadLink" \
  3. -H "content-type: application/x-www-form-urlencoded" \
  4. -d "accessId=abcdefghijklmnop&nonce=48693365&signature=wm8pQlU34oA5NAEffMtc8NQHues%3D&instanceId=yisurds-60e69eab6173d8-66643171=fileName=auto_1626027242_716.xb"

返回示例

  1. {
  2. "code": 200,
  3. "message": "请求成功",
  4. "data": {
  5. "fileLinks": {
  6. "outer_address": "http://rpm9.file.yisu.com/mysql/1229/auto_1626027242_716.xb?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=download%2F20210712%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210712T025129Z&X-Amz-Expires=7200&X-Amz-SignedHeaders=host&X-Amz-Signature=eda3eee7be52b2f5d7b3b5d94d2413fb22040a3273877b8dd2ceb2eac2053346"
  7. }
  8. },
  9. "requestId": "48b2ca4fb446cfe251e2964504aef23a"
  10. }