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

备份相关

1.设置备份策略

接口地址

  1. https://api.yisu.com/redis/backup/modifyBackupSetting

HTTP METHOD

POST

HTTP BODY编码格式

application/x-www-form-urlencoded

请求参数

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

名称 类型 是否必填 说明
instanceId string 实例ID
backupTime string 备份时间点如7:00-8:00
backupCycle string 备份周期,可选范围:Monday,Tuesday,Wednesday,Thursday,Friday,Saturday,Sunday

返回数据








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

请求示例

  1. curl -XPOST
  2. "https://api.yisu.com/redis/backup/modifyBackupSetting" \
  3. -H "content-type: application/x-www-form-urlencoded" \
  4. -d "accessId=abcdefghijklmnop&nonce=48693365&signature=wm8pQlU34oA5NAEffMtc8NQHues%3D&instanceId=yisuredis-60ecfbddc5e663-40223956=backupTime=7-8=backupCycle=Monday%2CWednesday"

返回示例

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

2.获取备份策略明细

接口地址

  1. https://api.yisu.com/redis/backup/getBackupSetting

HTTP METHOD

POST

HTTP BODY编码格式

application/x-www-form-urlencoded

请求参数

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

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

返回数据








名称类型是否必须默认值备注其他信息
codenumber非必须错误码
messagestring非必须错误信息
dataobject非必须返回数据
├─ backupTimestring非必须备份时间点(07:00-08:00)
├─ nextBackupTimestring非必须下次备份时间
├─ backupCyclestring非必须备份周期:Monday,Tuesday,Wednesday,Thursday,Friday,Saturday,Sunday;多个用英文逗号隔开
├─ backupSaveDaysstring非必须备份保留时间
requestIdstring非必须请求ID

请求示例

  1. curl -XPOST
  2. "https://api.yisu.com/redis/backup/getBackupSetting" \
  3. -H "content-type: application/x-www-form-urlencoded" \
  4. -d "accessId=abcdefghijklmnop&nonce=48693365&signature=wm8pQlU34oA5NAEffMtc8NQHues%3D&instanceId=yisuredis-60ecfbddc5e663-40223956"

返回示例

  1. {
  2. "code": 200,
  3. "message": "请求成功",
  4. "data": {
  5. "backupTime": "07:00-08:00",
  6. "nextBackupTime": "2021-07-21 0:16:00",
  7. "backupCycle": "Monday,Wednesday",
  8. "backupSaveDays": "7"
  9. },
  10. "requestId": "02c2da1ba1dd1edf5d002fe7c9e7085a"
  11. }

3.创建备份

接口地址

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

HTTP METHOD

POST

HTTP BODY编码格式

application/x-www-form-urlencoded

请求参数

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

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

返回数据








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

请求示例

  1. curl -XPOST
  2. "https://api.yisu.com/redis/backup/createBackup" \
  3. -H "content-type: application/x-www-form-urlencoded" \
  4. -d "accessId=abcdefghijklmnop&nonce=48693365&signature=wm8pQlU34oA5NAEffMtc8NQHues%3D&instanceId=yisuredis-60ecfbddc5e663-40223956"

返回示例

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

4.恢复备份

接口地址

  1. https://api.yisu.com/redis/backup/restoreInstance

HTTP METHOD

POST

HTTP BODY编码格式

application/x-www-form-urlencoded

请求参数

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

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

返回数据








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

请求示例

  1. curl -XPOST
  2. "https://api.yisu.com/redis/backup/restoreInstance" \
  3. -H "content-type: application/x-www-form-urlencoded" \
  4. -d "accessId=abcdefghijklmnop&nonce=48693365&signature=wm8pQlU34oA5NAEffMtc8NQHues%3D&instanceId=yisuredis-60ecfbddc5e663-40223956=fileName=handle_1626685661.rdb"

返回示例

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

5.备份文件列表

接口地址

  1. https://api.yisu.com/redis/backup/getBackupList

HTTP METHOD

POST

HTTP BODY编码格式

application/x-www-form-urlencoded

请求参数

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

名称 类型 是否必填 说明
instanceId string 实例ID
currentPage string 页码
pageSize string 每页数量

返回数据








名称类型是否必须默认值备注其他信息
codenumber非必须错误码
messagestring非必须错误信息
dataobject非必须返回数据
├─ Backupsobject []非必须备份列表

item 类型: object

├─ fileNamestring必须文件名
├─ createTimestring必须备份开始时间
├─ endTimestring必须备份结束时间
├─ allowDeleteboolean必须是否允许删除(手动备份的文件才可删除)
├─ totalResultnumber非必须总记录数
├─ currentPagestring非必须页码
├─ pageSizestring非必须每页数量
requestIdstring非必须请求ID

请求示例

  1. curl -XPOST
  2. "https://api.yisu.com/redis/backup/getBackupList" \
  3. -H "content-type: application/x-www-form-urlencoded" \
  4. -d "accessId=abcdefghijklmnop&nonce=48693365&signature=wm8pQlU34oA5NAEffMtc8NQHues%3D&instanceId=yisuredis-60ecfbddc5e663-40223956=currentPage=1=pageSize=20"

返回示例

  1. {
  2. "code": 200,
  3. "message": "请求成功",
  4. "data": {
  5. "Backups": [
  6. {
  7. "fileName": "handle_1626685661.rdb",
  8. "createTime": "2021-07-19 17:07:42",
  9. "endTime": "2021-07-19 17:07:47.300371",
  10. "allowDelete": true
  11. }
  12. ],
  13. "totalResult": 7,
  14. "currentPage": "1",
  15. "pageSize": "20"
  16. },
  17. "requestId": "3edc22e1d57cf75886629f304b84dab9"
  18. }

6.删除备份文件

接口地址

  1. https://api.yisu.com/redis/backup/deleteBackupFile

HTTP METHOD

POST

HTTP BODY编码格式

application/x-www-form-urlencoded

请求参数

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

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

返回数据








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

请求示例

  1. curl -XPOST
  2. "https://api.yisu.com/redis/backup/deleteBackupFile" \
  3. -H "content-type: application/x-www-form-urlencoded" \
  4. -d "accessId=abcdefghijklmnop&nonce=48693365&signature=wm8pQlU34oA5NAEffMtc8NQHues%3D&instanceId=yisuredis-60ecfbddc5e663-40223956=fileName=handle_1626685661.rdb"

返回示例

  1. {
  2. "code": 500,
  3. "message": "请求失败",
  4. "requestId": "dece35f894d3265a4684b2e7ba5fa53b"
  5. }

7.获取文件下载链接

接口地址

  1. https://api.yisu.com/redis/backup/getFileDownloadLink

HTTP METHOD

POST

HTTP BODY编码格式

application/x-www-form-urlencoded

请求参数

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

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

返回数据








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

请求示例

  1. curl -XPOST
  2. "https://api.yisu.com/redis/backup/getFileDownloadLink" \
  3. -H "content-type: application/x-www-form-urlencoded" \
  4. -d "accessId=abcdefghijklmnop&nonce=48693365&signature=wm8pQlU34oA5NAEffMtc8NQHues%3D&instanceId=yisuredis-60ecfbddc5e663-40223956=fileName=handle_1626685661.rdb"

返回示例

  1. {
  2. "code": 200,
  3. "message": "请求成功",
  4. "data": {
  5. "links": {
  6. "inner_address": "",
  7. "outer_address": "http://rpm2.file.yisu.com/redis/237/handle_1626685661.rdb?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=download%2F20210719%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210719T101555Z&X-Amz-Expires=7200&X-Amz-SignedHeaders=host&X-Amz-Signature=5429739592a179d68bf10de4efb38648280e655f1d1c93fbb7d3ad006069ad15"
  8. }
  9. },
  10. "requestId": "e805f953f2dc0479a103fe8436b2710c"
  11. }