创建恢复任务
更新时间 2025-09-17 16:11:15
最近更新时间: 2025-09-17 16:11:15
接口功能介绍
创建恢复任务
接口约束
实例状态正常
URI
POST /RDS2/v2/open-api/recovery/createNewRecoveryJob
路径参数 无
Query参数 无
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| project-id | 否 | String | 项目id | b829cb71308746a094853c21d5aac0a1 | |
| inst-id | 否 | String | 实例id （和参数outerProdInstId保持一致） | 264729201196525109 | |
| regionId | 是 | String | 资源池regionId，比如实例在资源池A，则需要填写A资源池的regionId。 | 81f7728662dd11ec810800155d307d5b |
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| srcOuterProdInstId | 是 | String | 恢复的源实例 | ||
| dstOuterProdInstId | 是 | String | 恢复的目标实例 | ||
| toTimepoint | 否 | String | 恢复到的时间点，格式为：yyyy-MM-dd HH:mm:ss【taskId和toTimepoint不能同时为空，优先取toTimepoint】 | 2023-12-26 14:00:00 | |
| taskId | 否 | String | 用来恢复的备份任务集【taskId和toTimepoint不能同时为空，优先取toTimepoint】 | 1700129225-322 | |
| restoreDbName | 否 | String | 恢复的库名 | ||
| restoreTables | 否 | Array of Strings | 恢复的表名 | ||
| newDbName | 否 | String | 新的库名 | ||
| newTables | 否 | Array of Strings | 新的表名 |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 返回码 | 0 | |
| message | String | 返回消息 | Success | |
| returnObj | Object | 任务记录主键id | 10 | DataObjVO |
| error | String | 错误码。当接口失败时才返回具体错误编码，成功不返回或者为空 | MYSQL_10002 | |
| 表 DataObjVO |
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| data | String | 恢复任务id | 10 |
枚举参数
无
请求示例
请求url
/RDS2/v2/open-api/recovery/createNewRecoveryJob
请求头header
无
请求体body
{
"srcProdInstId": 1,
"dstProdInstId": 2,
"toTimepoint": "2023-12-26 14:00:00",
"taskId": "",
"restoreDbName": "db-test",
"restoreTables": ["table-test1", "table-test2"],
"newDbName": "new-db-test",
"newTables": ["new-table-test1", "new-table-test2"]
}
响应示例
{
"returnObj": {},
"statusCode": 0,
"message": "success"
}
状态码
请参考 状态码
错误码
请参考 错误码
