# 重跑作业实例 - RestoreJobInstance
#### 功能介绍
重跑指定作业实例。只有作业实例的状态是成功、失败和取消，才能重跑作业实例。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/DGC/doc?api=RestoreJobInstance)中调试该接口，支持自动认证鉴权。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dataartsstudio/abcd.html)。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
 
#### URI
- URI格式 POST /v1/{project_id}/jobs/{job_name}/instances/{instance_id}/restart
  

- 参数说明
  表1URI参数说明 
  | 参数名         | 是否必选 | 参数类型   | 说明                                                                                                                           |
  |:---|:---|:---|:---|
  | project_id  | 是    | String | 项目编号，获取方法请参见[项目ID和账号ID](https://support.huaweicloud.com/api-dataartsstudio/projectid_accountid.html)。                        |
  | job_name    | 是    | String | 作业名称。                                                                                                                        |
  | instance_id | 是    | Long   | 作业实例ID，获取方法请参见[查询作业实例列表 - ListJobInstances](https://support.huaweicloud.com/api-dataartsstudio/dataartsstudio_02_0094.html)。 |
     
  
 
#### 请求参数
表2请求Header参数 
| 参数名       | 是否必选 | 参数类型   | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|:---|
| workspace | 否    | String | 工作空间id。获取方法请参见[实例ID和工作空间ID](https://support.huaweicloud.com/api-dataartsstudio/dataartsstudio_02_0350.html)。 - 如果不设置该参数，默认查询default工作空间下的数据。  - 如果需要查询其他工作空间的数据，需要带上该消息头。 说明： - 多个DataArts Studio实例需要指定工作空间。  - 当工作空间里面没有default工作空间时，工作空间为必填参数，否则会报错。      |
   
表3参数说明 
| 参数名                | 是否必选 | 类型      | 描述                                                                                                                               |
|:---|:---|:---|:---|
| retry_location     | 否    | String  | 作业重跑的位置。error_node （从错误节点开始重跑） first_node （从第一个节点开始重跑）、 specified_node (从指定的节点开始) ，particular_node（仅重跑选中的节点），默认从第一个节点开始重跑。       |
| job_param_version  | 否    | String  | 使用的作业参数。original_version （使用原有作业参数）、latest_version （使用最新提交作业参数重跑）。                                                               |
| ignore_obs_monitor | 否    | boolean | 是否忽略obs监听。                                                                                                                       |
| node_name          | 否    | String  | 指定的节点名。当retry_location选择specified_node指定重跑节点，当retry_location选择particular_node时，重跑选中的节点。如果有多个节点，以英文逗号间隔分开。比如 "node1,node2,node3"。 |
   
#### 响应参数
无
#### 请求示例
```
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.30137",
      "error_msg":"Job instance does not exist."
  }
  ```