查询DTS任务同步信息
更新时间 2026-06-16 17:01:14
最近更新时间: 2026-06-16 17:01:14
接口功能介绍
查询 DTS 任务同步信息。
接口约束
无
URI
POST /dts/v2/open-api/instance/describeDtsJobSyncTaskInfo
路径参数 无
Query参数 无
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionId | 是 | String | 资源池id | 200000001790 |
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| dtsJobId | 是 | Integer | 任务id | 100001 |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| httpStatusCode | Integer | 状态码 | 200 | |
| errCode | String | 错误码 | SUCCESS | |
| errMessage | String | 提示信息 | 操作成功 | |
| success | Boolean | 请求是否成功 | true | |
| requestId | String | 请求id | req-20250905-0001 | |
| data | Object | 响应数据 | SyncStatusInfo |
表 SyncStatusInfo
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| srcDbName | String | 源库名 | ||
| tgtDbName | String | 目标库名 | ||
| curPos | String | 当前已经同步的位点 | ||
| dstPos | String | 源库的最新位点 | ||
| status | String | 延时状态：INIT (初始态),STARTING (启动中),RUNNING (运行中),FAIL (失败),STOP (暂停),RETRY (重试中),DONE (完成) | ||
| writerCheckPoint | Integer | writerCheckPoint | ||
| delay | Integer | 延时时间（秒） | ||
| direction | String | 方向：Forward, Reverse |
枚举参数
无
请求示例
请求url
https://{host}/dts/v2/open-api/instance/describeDtsJobSyncTaskInfo
请求头header
无
请求体body
{
"dtsJobId": 513
}
响应示例
{
"httpStatusCode": 200,
"success": true,
"requestId": "00-6a2a8a294450aa14422d7fee5cc66198-18f7e45553a3affd-00",
"data": {
"srcDbName": "192.168.0.32:11522/ORCLCDB",
"tgtDbName": "192.168.0.45:6543/postgres",
"curPos": "4199823(1781172763000)",
"dstPos": "4199878",
"status": "RUNNING",
"writerCheckPoint": 1781172763000,
"delay": 3182,
"direction": "Forward"
}
}
状态码
请参考 状态码
错误码
请参考 错误码
