查询DTS任务执行时间线
更新时间 2026-06-16 17:01:33
最近更新时间: 2026-06-16 17:01:33
接口功能介绍
查询 DTS 任务执行时间线。
接口约束
无
URI
POST /dts/v2/open-api/instance/describeDtsJobTimeLine
路径参数 无
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 | 响应数据 | DtsJobTimelineVO |
表 DtsJobTimelineVO
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| id | Integer | 任务时间线自增主键 | ||
| dtsJobId | Integer | 任务ID | ||
| planModuleId | Integer | 模块ID | ||
| type | String | 模块类型: 不记录MONITOR， DATA_CHECK, READER, STORE；枚举值：PRECHECK (预检查),STRUCT (前置结构迁移),POST_STRUCT (后置结构迁移),FULL (全量迁移),READER (增量读取),WRITER (增量写入),STORE (增量存储),INC_SERVICE (增量服务),MONITOR (监控上报),DATA_CHECK (数据稽查) | WRITER | |
| description | String | 阶段描述 | ||
| timeline | String | 模块状态： 不记录INIT：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 | |
| userId | Integer | 操作用户，用户/运维/系统 | ||
| gmtCreate | String | 当前时点 | ||
| msg | String | 模块信息，尤其是模块状态为FAIL的时候需要展示错误信息 |
枚举参数
无
请求示例
请求url
https://{host}/dts/v2/open-api/instance/describeDtsJobTimeLine
请求头header
无
请求体body
{
"dtsJobId": 513
}
响应示例
{
"httpStatusCode": 200,
"success": true,
"requestId": "00-6a2a89a1bf027f4327010b6da8e5eede-fe38925859fb9708-01",
"data": [
{
"id": 48969,
"dtsJobId": 513,
"description": "用户(42654)-任务启动中",
"timeline": "STARTING",
"userId": 42654,
"gmtCreate": "2026-06-11T09:03:31.432+00:00"
},
{
"id": 48970,
"dtsJobId": 513,
"planModuleId": 1867,
"type": "PRECHECK",
"description": "调度(0)-预检查启动中",
"timeline": "STARTING",
"userId": 0,
"gmtCreate": "2026-06-11T09:03:32.476+00:00"
},
{
"id": 48971,
"dtsJobId": 513,
"planModuleId": 1867,
"type": "PRECHECK",
"description": "调度(0)-预检查完成",
"timeline": "DONE",
"userId": 0,
"gmtCreate": "2026-06-11T09:03:48.362+00:00",
"msg": ""
},
{
"id": 48972,
"dtsJobId": 513,
"description": "用户(42654)-任务启动中",
"timeline": "STARTING",
"userId": 42654,
"gmtCreate": "2026-06-11T09:03:52.130+00:00"
},
{
"id": 48973,
"dtsJobId": 513,
"planModuleId": 1872,
"type": "INC_SERVICE",
"description": "调度(0)-增量服务运行中",
"timeline": "RUNNING",
"userId": 0,
"gmtCreate": "2026-06-11T09:05:47.709+00:00"
},
{
"id": 48974,
"dtsJobId": 513,
"planModuleId": 1869,
"type": "STRUCT",
"description": "调度(0)-前置结构迁移启动中",
"timeline": "STARTING",
"userId": 0,
"gmtCreate": "2026-06-11T09:05:50.783+00:00"
},
{
"id": 48975,
"dtsJobId": 513,
"planModuleId": 1869,
"type": "STRUCT",
"description": "调度(0)-前置结构迁移运行中",
"timeline": "RUNNING",
"userId": 0,
"gmtCreate": "2026-06-11T09:06:08.401+00:00",
"msg": ""
},
{
"id": 48976,
"dtsJobId": 513,
"planModuleId": 1869,
"type": "STRUCT",
"description": "调度(0)-前置结构迁移完成",
"timeline": "DONE",
"userId": 0,
"gmtCreate": "2026-06-11T09:06:28.363+00:00",
"msg": ""
},
{
"id": 48977,
"dtsJobId": 513,
"planModuleId": 1871,
"type": "FULL",
"description": "调度(0)-全量迁移启动中",
"timeline": "STARTING",
"userId": 0,
"gmtCreate": "2026-06-11T09:06:30.867+00:00"
},
{
"id": 48978,
"dtsJobId": 513,
"planModuleId": 1871,
"type": "FULL",
"description": "调度(0)-全量迁移运行中",
"timeline": "RUNNING",
"userId": 0,
"gmtCreate": "2026-06-11T09:06:48.030+00:00",
"msg": ""
},
{
"id": 48979,
"dtsJobId": 513,
"planModuleId": 1871,
"type": "FULL",
"description": "调度(0)-全量迁移完成",
"timeline": "DONE",
"userId": 0,
"gmtCreate": "2026-06-11T09:07:48.384+00:00",
"msg": ""
},
{
"id": 48980,
"dtsJobId": 513,
"planModuleId": 1870,
"type": "POST_STRUCT",
"description": "调度(0)-后置结构迁移启动中",
"timeline": "STARTING",
"userId": 0,
"gmtCreate": "2026-06-11T09:07:50.666+00:00"
},
{
"id": 48981,
"dtsJobId": 513,
"planModuleId": 1870,
"type": "POST_STRUCT",
"description": "调度(0)-后置结构迁移完成",
"timeline": "DONE",
"userId": 0,
"gmtCreate": "2026-06-11T09:08:08.418+00:00",
"msg": ""
},
{
"id": 48982,
"dtsJobId": 513,
"planModuleId": 1873,
"type": "WRITER",
"description": "调度(0)-增量写入启动中",
"timeline": "STARTING",
"userId": 0,
"gmtCreate": "2026-06-11T09:08:10.305+00:00"
},
{
"id": 48987,
"dtsJobId": 513,
"planModuleId": 1873,
"type": "WRITER",
"description": "调度(0)-增量写入运行中",
"timeline": "RUNNING",
"userId": 0,
"gmtCreate": "2026-06-11T09:08:29.823+00:00",
"msg": ""
}
]
}
状态码
请参考 状态码
错误码
请参考 错误码
