查询任务列表V3
功能介绍
查询任务列表
URI
GET /v3/{project_id}/jobs
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 租户在某一region下的project ID。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| offset | 否 | Integer | 索引位置，偏移量。 从第一条数据偏移offset条数据后开始查询，默认为0。 取值必须为数字，且不能为负数。 |
| limit | 否 | Integer | 查询个数上限值。 取值范围：1~128。 不传该参数时，默认值为10。 |
| start_time | 是 | Long | 查询开始时间，时间戳格式，单位毫秒。查询时间不能早于30天前。 |
| end_time | 是 | Long | 查询结束时间，时间戳格式，单位毫秒。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
响应参数
状态码：200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| jobs | Array of JobItem objects | 任务列表。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 任务ID。 |
| name | String | 任务名称。 |
| status | String | 任务执行状态。 取值： “Running”，表示任务正在执行。 “Completed”，表示任务执行成功。 “Failed”，表示任务执行失败。 |
| created_time | String | 创建时间，格式为“yyyy-mm-ddThh:mm:ssZ”。 其中，T指某个时间的开始；Z指时区偏移量，例如中欧时间偏移显示为+0100。 |
| end_time | String | 结束时间，格式为“yyyy-mm-ddThh:mm:ssZ”。 其中，T指某个时间的开始；Z指时区偏移量，例如中欧时间偏移显示为+0100。 |
| process | String | 任务执行进度。 执行中状态才返回执行进度，例如“60%”，表示任务执行进度为60%，否则返回“”。 |
| instance | Instance object | 执行任务的实例信息。 |
状态码：400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码。 |
| error_msg | String | 错误消息。 |
状态码：500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码。 |
| error_msg | String | 错误消息。 |
请求示例
GET https://ddm.eu-de.otc.t-systems.com/v3/619d3e78f61b4be68bc5aa0b59edcf7b/jobs?start_time=1746028800000&end_time=1747319097182
响应示例
{
"jobs": [
{
"id": "92370d30-3ddc-4e05-b8ab-51662d824318",
"name": "migrateLogicDb",
"status": "ToBeSwitched",
"created_time": "2025-05-20T15:05:13+0000",
"end_time": "2025-05-20T15:05:13+0000",
"process": "",
"instance_name": "UTS-ddm-dtc-src",
"instance_id": "733c7e8d73a54c27b8308ec784a8be8cin09",
"operations": [
"modifySwitchingStrategy",
"toBeCanceled"
],
"database_name": "db_e487",
"fail_reason": ""
},
{
"id": "10501cd3-0c19-498b-9ba4-8935ed447542",
"name": "migrateLogicDb",
"status": "Completed",
"created_time": "2025-05-20T14:48:09+0000",
"end_time": "2025-05-20T15:03:45+0000",
"process": "",
"instance_name": "UTS-ddm-dtc-src",
"instance_id": "733c7e8d73a54c27b8308ec784a8be8cin09",
"operations": [],
"database_name": "db_e487",
"fail_reason": ""
},
{
"id": "57933931-9323-422d-8f3d-20a62eb00c4e",
"name": "CreateInstance",
"status": "Completed",
"created_time": "2025-05-20T07:51:47+0000",
"end_time": "2025-05-20T07:56:54+0000",
"process": "",
"instance_name": "UTS-ddm-dtc-src",
"instance_id": "733c7e8d73a54c27b8308ec784a8be8cin09",
"operations": [],
"database_name": "",
"fail_reason": ""
}
],
"offset": 0,
"limit": 10,
"total": 3
} 状态码：400
bad request
{
"error_msg" : "Parameter error.",
"error_code" : "DBS.280001"
} 状态码：500
server error
{
"error_msg" : "Parameter error.",
"error_code" : "DBS.280001"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | ok |
| 400 | bad request |
| 500 | server error |
错误码
请参见错误码。
