1. 接口描述
本接口(ManualBackupInstance)用于手动备份 Redis 实例。
接口请求域名:redis.api.qcloud.com
请不要频繁的调用该接口,最好每天调用次数不超过24次,否则调用可能会失败。
2. 输入参数
以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,见 公共请求参数 页面。其中,此接口的 Action 字段为 ManualBackupInstance。
参数名称 | 是否必选 | 类型 | 描述 |
---|---|---|---|
redisId | 是 | String | 待操作的实例 ID,可通过 DescribeRedis 接口返回值中的 redisId 获取。 |
remark | 否 | String | 备份的备注信息 |
3. 输出参数
参数名称 | 类型 | 描述 |
---|---|---|
code | Int | 公共错误码,0表示成功,其他值表示失败。详见错误码页面的 公共错误码 |
message | String | 错误信息描述,成功时,该值为空 |
codeDesc | String | 业务侧错误码英文描述。成功时返回 Success,错误时返回具体业务错误原因 |
data | Object | 任务 ID |
其中,data 表示任务ID,其参数构成如下:
参数名称 | 类型 | 描述 |
---|---|---|
data.requestId | 任务ID | 任务 ID,可通过 DescribeTaskInfo 接口查询任务执行状态 |
4. 错误码
以下错误码表列出了该接口的业务逻辑错误码。
错误代码 | 英文提示 | 错误描述 |
---|---|---|
11201 | InvalidParameter | 业务参数错误 |
10701 | InstanceNotExists | 没有找到 serialId 对应的实例 |
10707 | InstanceLockedError | 实例已被锁住,暂时不能执行该操作 |
10702 | InstanceStatusAbnormal | 实例状态异常,暂时不能执行该操作(例如,流程中或已隔离或已删除) |
5. 示例
https://redis.api.qcloud.com/v2/index.php?Action=ManualBackupInstance &<公共请求参数> &redisId=crs-izbob1wh &remark=test_api
返回示例如下:
{
"code": 0,
"message": "",
"codeDesc": "Success",
"data": {
"requestId": 375062
}
}