云服务器

备份相关

1.设置备份策略

接口地址

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

HTTP METHOD

POST

HTTP BODY编码格式

application/x-www-form-urlencoded

请求参数

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

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

返回数据

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

请求示例

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

返回示例

{
    "code": 200,
    "message": "请求成功",
    "requestId": "ee294672a0b5f03e13004988d4e3f7a1"
}

2.获取备份策略明细

接口地址

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

HTTP METHOD

POST

HTTP BODY编码格式

application/x-www-form-urlencoded

请求参数

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

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

返回数据

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

请求示例

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

返回示例

{
    "code": 200,
    "message": "请求成功",
    "data": {
        "backupTime": "07:00-08:00",
        "nextBackupTime": "2021-07-21 0:16:00",
        "backupCycle": "Monday,Wednesday",
        "backupSaveDays": "7"
    },
    "requestId": "02c2da1ba1dd1edf5d002fe7c9e7085a"
}

3.创建备份

接口地址

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

HTTP METHOD

POST

HTTP BODY编码格式

application/x-www-form-urlencoded

请求参数

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

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

返回数据

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

请求示例

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

返回示例

{
    "code": 200,
    "message": "请求成功",
    "requestId": "701c2d240819a7e3e9876fc90dbd74fd"
}

4.恢复备份

接口地址

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

HTTP METHOD

POST

HTTP BODY编码格式

application/x-www-form-urlencoded

请求参数

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

名称类型是否必填说明
instanceIdstring实例ID
fileNamestring文件名

返回数据

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

请求示例

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

返回示例

{
    "code": 200,
    "message": "请求成功",
    "requestId": "02793bab13945947452dd185bb382edf"
}

5.备份文件列表

接口地址

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

HTTP METHOD

POST

HTTP BODY编码格式

application/x-www-form-urlencoded

请求参数

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

名称类型是否必填说明
instanceIdstring实例ID
currentPagestring页码
pageSizestring每页数量

返回数据

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

item 类型: object

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

请求示例

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

返回示例

{
    "code": 200,
    "message": "请求成功",
    "data": {
        "Backups": [
            {
                "fileName": "handle_1626685661.rdb",
                "createTime": "2021-07-19 17:07:42",
                "endTime": "2021-07-19 17:07:47.300371",
                "allowDelete": true
            }
        ],
        "totalResult": 7,
        "currentPage": "1",
        "pageSize": "20"
    },
    "requestId": "3edc22e1d57cf75886629f304b84dab9"
}

6.删除备份文件

接口地址

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

HTTP METHOD

POST

HTTP BODY编码格式

application/x-www-form-urlencoded

请求参数

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

名称类型是否必填说明
instanceIdstring实例ID
fileNamestring文件名

返回数据

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

请求示例

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

返回示例

{
    "code": 500,
    "message": "请求失败",
    "requestId": "dece35f894d3265a4684b2e7ba5fa53b"
}

7.获取文件下载链接

接口地址

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

HTTP METHOD

POST

HTTP BODY编码格式

application/x-www-form-urlencoded

请求参数

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

名称类型是否必填说明
instanceIdstring实例ID
fileNamestring文件名

返回数据

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

请求示例

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

返回示例

{
    "code": 200,
    "message": "请求成功",
    "data": {
        "links": {
            "inner_address": "",
            "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"
        }
    },
    "requestId": "e805f953f2dc0479a103fe8436b2710c"
}