文档首页> 数据治理中心 DataArts Studio> API参考（吉隆坡区域）> 数据开发API> 待下线API> 查询作业实例详情
更新时间：2023-06-15 GMT+08:00
查看PDF

查询作业实例详情

功能介绍

查询指定作业实例详情信息，包括作业实例内各个节点的执行信息。

URI

  • URI格式

    GET /v1/{project_id}/jobs/{job_name}/instances/{instance_id}

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

    参数名

    是否必选

    参数类型

    说明

    project_id

    是

    String

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

    job_name

    是

    String

    作业名称

    instance_id

    是

    Long

    作业实例ID

请求消息

表2 请求Header参数

参数名

是否必选

参数类型

说明

workspace

否

String

工作空间id。

  • 如果不设置该参数，默认查询default工作空间下的数据。
  • 如果需要查询其他工作空间的数据，需要带上该消息头。

响应消息

表3 参数说明

参数名

是否必选

参数类型

说明

jobName

是

String

作业名称

instanceId

是

Long

作业实例ID

status

是

String

作业实例状态：

  • waiting：等待运行
  • running：运行中
  • success：运行成功
  • fail：运行失败
  • running-exception：运行异常
  • pause：暂停
  • manual-stop：取消

planTime

是

Long

作业实例计划执行时间

startTime

是

Long

作业实例实际执行开始时间

endTime

否

Long

作业实例实际执行结束时间

executeTime

否

Long

执行耗时，单位：毫秒

total

是

int

总的节点数据条数

nodes

是

List<Node>

节点实例状态，参考表4
表4 Node属性说明

参数名

是否必选

参数类型

说明

nodeName

是

String

节点名称

status

是

String

节点状态：

  • waiting：等待运行
  • running -运行中
  • success：运行成功
  • fail：运行失败
  • skip：跳过
  • pause：暂停
  • manual-stop：取消

planTime

是

Long

作业实例计划执行时间

startTime

是

Long

节点实际执行开始时间

endTime

否

Long

节点实际执行结束时间

type

是

String

节点类型

retryTimes

否

Int

失败重试次数

instanceId

是

Long

作业实例id

inputRowCount

否

Long

写入数据行数

speed

否

double

写入速度(行/秒)

logPath

否

String

节点执行的日志路径

示例

查询作业job_batch实例ID为34765的实例详情。

  • 请求
    GET /v1/b384b9e9ab9b4ee8994c8633aabc9505/jobs/job_batch/instances/34765
  • 响应
    {
    "jobName":"job_batch",
    "instanceId":34765,
    
    "status":"fail",
    "planTime":1551425326540,
    "startTime":1551425327000,
    "endTime":1551425387000,
    "executeTime":1,
    "instanceId":30654,
    "total":2,
    "nodes":[
        {
            "endTime":1551671590000,
            "inputRowCount":0,
            "instanceId":34765,
            "nodeName":"Dummy_8556",
            
            "planTime":1551671580000,
            "retryTimes":0,
            "startTime":1551671584000,
            "status":"success",
            "submitTime":1550910278706,
            "type":"Dummy"
        },
        {
            "endTime":1551671598000,
            "inputRowCount":0,
            "instanceId":34765,
            "logPath":"obs://dlf-log-b384b9e9ab9b4ee8994c8633aabc9505/job_batch/2019-03-04 11_53_00.000/error/error.job",
            "nodeName":"error",
            
            "planTime":1551671580000,
            "retryTimes":0,
            "startTime":1551671594000,
            "status":"success",
            "submitTime":1550910278706,
            "type":"DWS SQL"
        }
    ]
}
  • 失败响应

    HTTP状态码 400

    {
    "error_code":"DLF.0137",
    "error_msg":"Job instance does not exist."
}
父主题： 待下线API