文档首页/ 数据治理中心 DataArts Studio/ 更多文档/ API参考 (联盟区域) / 数据开发API/ 作业开发API/ 查询系统任务详情
更新时间：2026-01-30 GMT+08:00
查看PDF
分享

查询系统任务详情

功能介绍

本接口用于查询异步任务详情。

URI

  • URI格式

    GET /v1/{project_id}/system-tasks/{task_id}

  • 参数说明
    表1 URI参数说明

    参数名

    是否必选

    参数类型

    说明

    project_id

    是

    String

    项目编号，获取方法请参见项目ID和账号ID。

    task_id

    是

    String

    任务ID，获取方法请参见导入作业的响应参数。

请求参数

表2 请求Header参数

参数名

是否必选

参数类型

说明

workspace

否

String

工作空间id。

  • 如果不设置该参数，默认查询default工作空间下的数据。
  • 如果需要查询其他工作空间的数据，需要带上该消息头。
    说明：
    • 多个DataArts Studio实例需要指定工作空间。
    • 当工作空间里面没有default工作空间时，工作空间为必填参数，否则会报错。

响应参数

表3 参数说明

参数名

是否必选

参数类型

说明

id

是

String

任务ID。

name

是

String

任务名称。

startTime

是

Long

开始时间。

endTime

否

Long

结束时间。

lastUpdate

是

Long

更新时间。

status

是

String

状态：

  • RUNNING
  • SUCCESSFUL
  • FAILED

projectId

否

String

项目编号。

subtasks

否

List<SubTask>

子任务，参考表4。
表4 SubTask参数说明

参数名

是否必选

参数类型

说明

id

是

String

子任务ID。

name

是

String

子任务名称。

lastUpdate

是

Long

更新时间。

status

是

String

状态：

  • RUNNING
  • SUCCESSFUL
  • FAILED

taskId

否

String

任务消息。

请求示例

查询导出作业的任务。 
GET /v1/b384b9e9ab9b4ee8994c8633aabc9505/systemTasks/008aae2e675d3bcb01675d40ab3f0005

响应示例

  • 成功响应 
    {
    "endTime": 1544777083000,
    "id": "008aae2e67abe2ff0167abe3a28f0000",
    "lastUpdate": 1544777083000,
    "name": "从路径[obs://aaaaa/job_batch.zip]导入作业。",
    "projectId": "b384b9e9ab9b4ee8994c8633aabc9505",
    "startTime": 1544777081000,
    "status": "SUCCESSFUL",
    "subtasks": [
        {
            "id": "008aae2e67abe2ff0167abe3a7e70002",
            "lastUpdate": 1544777083000,
            "name": "导入作业[job_batch]。",
            "status": "SUCCESSFUL",
            "taskId": "008aae2e675d3bcb01675d40ab3f0005"
        }
    ]
}
  • 失败响应

    HTTP状态码 400

    {
    "error_code":"DLF.20810",
    "error_msg":"Task[008aae2e675d3bcb01675d40ab3f0005] does not exist"
}
父主题： 作业开发API