
# 批量续传/重试 - BatchRestoreTask
#### 功能介绍
- 在任务进行过程中由于不确定因素导致任务失败，可通过重试功能，重新提交任务。
- 对于暂停的任务，可通过续传功能，继续任务。
- 双主灾备时，父任务不支持调用。
 
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=DRS&api=BatchRestoreTask)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-drs/drs_api_0035.html)。
#### URI
POST /v3/{project_id}/jobs/batch-retry-task
表1路径参数 
| **参数**     | **是否必选** | **参数类型** | **描述**                                                                                                                                            |
|:---|:---|:---|:---|
| project_id | 是        | String   | 租户在某一Region下的Project ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-drs/drs_api_0106.html)。 |
   
#### 请求参数
表2请求Header参数 
| **参数**       | **是否必选** | **参数类型** | **描述**                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|:---|
| Content-Type | 是        | String   | 指定类型为application/json。 缺省值：**application/json**                                                                                                                                                                                                                                                                                                                                                       |
| X-Auth-Token | 是        | String   | 从IAM服务获取的用户Token。                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| X-Language   | 否        | String   | 请求语言类型。 缺省值：**en-us** 取值： - **en-us**  - **zh-cn**   |
   
表3请求Body参数 
| **参数** | **是否必选** | **参数类型**         | **描述**                                                                                                                  |
|:---|:---|:---|:---|
| jobs   | 是        | Array of objects | 批量续传任务请求列表。 详情请参见[表4]。 |
   
 表4jobs字段数据结构说明 
| **参数**          | **是否必选** | **参数类型** | **描述**              |
|:---|:---|:---|:---|
| job_id          | 是        | String   | 任务ID。               |
| is_sync_re_edit | 否        | Boolean  | 任务再编辑之后启动时必填，为true。 |
   
#### 响应参数
**状态码：200**
表5响应Body参数 
| **参数**  | **参数类型**         | **描述**                                                                                                                     |
|:---|:---|:---|
| results | Array of objects | 批量续传返回列表。 详情请参见[表6]。 |
| count   | Integer          | 总数。                                                                                                                        |
   
 表6results字段数据结构说明 
| **参数**     | **参数类型** | **描述**                                                                                                                                                                                                                                                                                                                                                                                      |
|:---|:---|:---|
| id         | String   | 任务ID。                                                                                                                                                                                                                                                                                                                                                                                       |
| status     | String   | 状态。 取值范围： - **success**：成功  - **failed**：失败   |
| error_code | String   | 错误码。                                                                                                                                                                                                                                                                                                                                                                                        |
| error_msg  | String   | 错误信息。                                                                                                                                                                                                                                                                                                                                                                                       |
   
#### 请求示例
批量续传指定任务
```
https://{endpoint}/v3/054babbbde80d4602f5cc0043a40ed8c/jobs/batch-retry-task
{
  "jobs" : [ {
    "job_id" : "140b5236-88ad-43c8-811c-1268453jb101"
  } ]
}
```
#### 响应示例
**状态码：200**
OK
```
{
  "results" : [ {
    "id" : "140b5236-88ad-43c8-811c-1268453jb101",
    "status" : "success"
  } ],
  "count" : 1
}
```
#### 状态码
| **状态码** | **描述**      |
|:---|:---|
| 200     | OK          |
| 400     | Bad Request |
   
其他状态请参见[状态码](https://support.huaweicloud.com/api-drs/drs_api_0108.html)。
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-drs/drs_05_0004.html)。
