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

重跑作业实例

功能介绍

重跑指定作业实例。只有作业实例的状态是成功、失败和取消，才能重跑作业实例。

URI

  • URI格式

    POST /v1/{project_id}/jobs/{job_name}/instances/{instance_id}/restart

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

    参数名

    是否必选

    参数类型

    说明

    project_id

    是

    String

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

    job_name

    是

    String

    作业名称。

    instance_id

    是

    Long

    作业实例ID，获取方法请参见查询作业实例列表。

请求参数

表2 请求Header参数

参数名

是否必选

参数类型

说明

workspace

否

String

工作空间id。

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

参数名

是否必选

类型

描述

retry_location

否

String

作业重跑的位置。error_node （从错误节点开始重跑） first_node （从第一个节点开始重跑）、 specified_node (从指定的节点开始) ，默认从重跑位置默认节点开始。

job_param_version

否

String

使用的作业参数。original_version （使用原有作业参数）、latest_version （使用最新提交作业参数重跑）。

ignore_obs_monitor

否

boolean

是否忽略obs监听。

node_name

否

String

指定的节点名。当retry_location选择specified_node指定重跑节点。

响应参数

无

请求示例

POST /v1/b384b9e9ab9b4ee8994c8633aabc9505/jobs/job_batch/instances/34765/restart
{
    "retry_location": "error_node",
    "job_param_version": "original_version"，
    "ignore_obs_monitor": "true",
    "node_name": "test_node"
}

响应示例

  • 成功响应

    HTTP状态码 204

  • 失败响应

    HTTP状态码 400

    {
    "error_code":"DLF.0137",
    "error_msg":"Job instance does not exist."
}
父主题： 作业开发API