文档首页/ 数据治理中心 DataArts Studio/ API参考/ 数据开发API（V1）/ 作业开发API/ 重跑作业实例 - RestoreJobInstance
更新时间：2025-11-05 GMT+08:00
在线调试
CLI示例
查看PDF
分享

重跑作业实例 - RestoreJobInstance

功能介绍

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

URI

  • URI格式

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

请求参数

表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