获取恢复记录
更新时间 2025-09-11 17:32:35
最近更新时间: 2025-09-11 17:32:35
接口功能介绍
调用接口获取恢复任务列表
接口约束
存在恢复任务
URI
GET /RDS2/v2/open-api/recovery/record
路径参数 无
Query参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
outerProdInstId | 否 | String | 外部实例id | b713b829c08746a094853c21d5aac0a1 | |
taskId | 否 | String | 任务Id | 1710384302-191-set_si_41976301_1 | |
startTime | 否 | String | 开始时间 | 2023-10-01 00:00:00 | |
endTime | 否 | String | 结束时间 | 2023-10-01 00:00:00 | |
pageNow | 否 | Integer | 当前页 | 1 | |
pageSize | 否 | Integer | 分页大小 | 10 | |
id | 否 | Integer | 恢复任务主键Id | 10 |
请求参数
请求头header参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
project-id | 否 | String | 项目id | b829cb71308746a094853c21d5aac0a1 | |
inst-id | 否 | String | 实例id (和参数outerProdInstId保持一致) | 264729201196525109 | |
regionId | 是 | String | 资源池regionId,比如实例在资源池A,则需要填写A资源池的regionId。 | 81f7728662dd11ec810800155d307d5b |
请求体body参数 无
响应参数
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
statusCode | Integer | 返回码 | 0 | |
message | String | 返回消息 | ||
returnObj | String | 返回结果 | returnObj | |
error | String | 错误码。当接口失败时才返回具体错误编码,成功不返回或者为空 | MYSQL_10002 | |
表 returnObj |
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
pageNum | Integer | 当前页 | 1 | |
pageSize | Integer | 每页的数量 | 1 | |
size | Integer | 当前页的数量 | 0 | |
startRow | Integer | 当前页面第一个元素在数据库中的行号 | 0 | |
endRow | Integer | 当前页面最后一个元素在数据库中的行号 | 0 | |
total | Integer | 总记录数 | 1 | |
pages | Integer | 总页数 | 1 | |
prePage | Integer | 前一页 | 1 | |
isFirstPage | Boolean | 是否为第一页 | ||
isLastPage | Boolean | 是否为最后一页 | ||
hasPreviousPage | Boolean | 是否有前一页 | ||
hasNextPage | Boolean | 是否有下一页 | ||
navigatePages | Integer | 导航页码数 | 1 | |
navigatepageNums | Array of Integers | 所有导航页号 | ||
list | Array of Objects | 结果集(每页显示的数据) | BrRecoveryRecordVo | |
navigateLastPage | String | 页面上显示的最后一个页码 | 1 | |
navigateFirstPage | String | 页面显示的第一个页码 | 1 | |
表 BrRecoveryRecordVo |
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
taskId | String | 恢复任务Id | 1698836670-10279-set_si_4315763011 | |
id | Long | 恢复任务主键Id | 1 | |
prodInstName | String | 实例名称 | Mysql-test | |
recoveryName | String | 恢复任务名字 | 10279-to-11058-20231031154949 | |
recoveryScope | Integer | 恢复范围 1实例全量 2单库单表 | 1 | |
startTime | String | 任务开始时间 | 2023-10-01 00:00:00 | |
endTime | String | 任务结束时间 | 2023-10-01 00:00:00 | |
taskStatus | Integer | 任务状态:0预检查中 1进行中,2成功,3失败 10 代处理 | 2 |
枚举参数
无
请求示例
请求url
/RDS2/v2/open-api/recovery/record?outerProdInstId=264729201196525109
请求头header
无
请求体body
无
响应示例
{
"returnObj": {
"total": 19,
"list": [{
"id": 1,
"taskId": "1698586336-357-set_si_616963011",
"prodInstName": "mysql-357",
"recoveryName": "357-to-357-20231028201956",
"recoveryScope": "2",
"startTime": "2023-10-29 21:30:39",
"endTime": "2023-10-29 21:33:15",
"taskStatus": 3
}, {
"id": 2,
"taskId": "1698585795-357-set_si_616963011",
"prodInstName": "mysql-357",
"recoveryName": "357-to-357-20231028201956",
"recoveryScope": "2",
"startTime": "2023-10-29 21:21:39",
"endTime": "2023-10-29 21:25:17",
"taskStatus": 2
}],
"pageNum": 1,
"pageSize": 10,
"size": 10,
"startRow": 1,
"endRow": 10,
"pages": 2,
"prePage": 0,
"nextPage": 2,
"isFirstPage": true,
"isLastPage": false,
"hasPreviousPage": false,
"hasNextPage": true,
"navigatePages": 8,
"navigatepageNums": [1, 2],
"navigateFirstPage": 1,
"navigateLastPage": 2
},
"statusCode": 0,
"message": "success"
}
状态码
请参考 状态码
错误码
请参考 错误码