# 批量暂停任务 - BatchStopJobs
#### 功能介绍
批量暂停任务。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=DRS&api=BatchStopJobs)中调试该接口，支持自动认证鉴权。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-pause-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 | 不能包含空对象。 集合中的job_id取值严格匹配UUID规则。 详情请参见[表4]。 |
   
 表4jobs字段数据结构说明 
| **参数**     | **是否必选** | **参数类型** | **描述**                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| job_id     | 是        | String   | 任务ID。                                                                                                                                                                                                                                                                                                                                                                                                   |
| pause_mode | 是        | String   | 暂停类型，target：停回放，all：停日志抓取和回放。 取值： - **target**  - **all**   |
   
#### 响应参数
**状态码：200**
表5响应Body参数 
| **参数**  | **参数类型**         | **描述**                                                                                                                    |
|:---|:---|:---|
| results | Array of objects | 批量暂停返回列表。 详情请参见[表6]。 |
| count   | Integer          | 总数。                                                                                                                       |
   
 表6results字段数据结构说明 
| **参数**     | **参数类型** | **描述** |
|:---|:---|:---|
| id         | String   | 任务ID。  |
| status     | String   | 暂停结果。  |
| error_code | String   | 错误码。   |
| error_msg  | String   | 错误信息。  |
   
#### 请求示例
批量暂停指定任务
```
https://{endpoint}/v3/054ba152d480d55b2f5dc0069e7ddef0/jobs/batch-pause-task
{
  "jobs" : [ {
    "job_id" : "8d0e8e36-a618-490d-8a46-8c61ac9jb502",
    "pause_mode" : "target"
  } ]
}
```
#### 响应示例
**状态码：200**
OK
```
{
  "results" : [ {
    "id" : "8d0e8e36-a618-490d-8a46-8c61ac9jb502",
    "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)。