查询Dts子任务同步信息
更新时间 2026-06-16 17:02:51
最近更新时间: 2026-06-16 17:02:51
接口功能介绍
查询 Dts 子任务同步信息。
接口约束
无
URI
POST /dts/v2/open-api/instance/describeSubDtsJobSyncTaskInfo
路径参数 无
Query参数 无
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionId | 是 | String | 资源池id | 200000001790 |
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| dtsJobId | 是 | Integer | 任务id | 100001 |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| httpStatusCode | Integer | 状态码 | ||
| errCode | String | 错误码 | ||
| errMessage | String | 提示信息 | ||
| success | Boolean | 请求是否成功 | ||
| requestId | String | 请求id | ||
| data | Array of Objects | 响应数据 | SubPlanConfigStatusInfo |
表 SubPlanConfigStatusInfo
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| dtsJobName | String | 任务名 | ||
| dtsJobId | Integer | 任务id | ||
| status | String | 任务状态：UNCONFIGURED (未配置),RUNNING (运行中),RETRYING (重试中),UPDATE_SUB_JOB (修改同步对象中),UNPRECHECK (未预检查),PRECHECKING (预检查中),PRECHECKFAILURE (未通过预检查),PRECHECKPASS (预检查通过),MIGRATING (结构迁移中),MIGRATED (结构迁移完成),START ((全量) 开始),FULLOVER (全量迁移完成),INCSTART ((增量) 开始),STOP (暂停 (可再次启动)),PAUSE (运行异常 (可再次启动)),REVERSE (一键切换),FINISH (完成 (终结)),INC_SERVICE_START (源端读取服务开始),INC_SERVICE_DISPATCH_DONE (源端读取服务运行中),POST_STRUCT_START (后置结构迁移开始),POST_STRUCT_DONE (后置结构迁移完成),INC_DISPATCH_START (增量服务调度开始),INC_DISPATCH_DONE (增量服务调度完成，增量运行中),MONITOR_START (监控开始),MONITOR_DISPATCH_DONE (监控调度完成),FAILOVER_SWITCHING (udal 的容灾切换) | RUNNING | |
| syncStatusInfo | Object | 同步信息 | SyncStatusInfo |
表 SyncStatusInfo
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| srcDbName | String | 源库名 | ||
| tgtDbName | String | 目标库名 | ||
| curPos | String | 当前已经同步的位点 | ||
| dstPos | String | 源库的最新位点 | ||
| status | String | 延时状态：INIT (初始态),STARTING (启动中),RUNNING (运行中),FAIL (失败),STOP (暂停),RETRY (重试中),DONE (完成) | RUNNING | |
| writerCheckPoint | Integer | writerCheckPoint | ||
| delay | Integer | 延时时间（秒） | ||
| direction | String | 方向：Forward, Reverse |
枚举参数
无
请求示例
请求url
https://{host}/dts/v2/open-api/instance/describeSubDtsJobSyncTaskInfo
请求头header
无
请求体body
{
"dtsJobId": "172"
}
响应示例
{
"httpStatusCode": 200,
"success": true,
"requestId": "00-6a2a8cf4d2f550a881201d95fbe3ce7e-d24cca039723852e-00",
"data": [
{
"dtsJobName": "dts-889-song-test_shard[192.168.0.33:9032,192.168.0.35:9032]",
"dtsJobId": 173,
"status": "FINISH",
"syncStatusInfo": {
"curPos": "---",
"dstPos": "---",
"writerCheckPoint": -1,
"delay": -1
}
},
{
"dtsJobName": "dts-889-song-test_shard[192.168.0.34:9032,192.168.0.36:9032]",
"dtsJobId": 174,
"status": "FINISH",
"syncStatusInfo": {
"curPos": "---",
"dstPos": "---",
"writerCheckPoint": -1,
"delay": -1
}
}
]
}
状态码
请参考 状态码
错误码
请参考 错误码
