# 取消任务 - CancelJobs
#### 功能介绍
取消任务，当前只支持扩缩集群的任务取消。
#### URI
POST /v1/jobs/cancel
#### 请求参数
表1请求Body参数 
| 参数      | 是否必选 | 参数类型             | 描述                                                                                                                                                                                                                                                                                                                                             |
|:---|:---|:---|:---|
| job_ids | 是    | Array of strings | **参数解释** 需要取消的任务ID列表。 **约束限制** 不涉及。 **取值范围** 任务ID列表，每个任务ID必须为以"short-"或"long-"开头，后跟字母、数字、连字符和下划线组成的字符串。 **默认取值** 不涉及。 |
   
#### 响应参数
**状态码：200**
表2响应Body参数 
| 参数           | 参数类型             | 描述                                                                                                                                                                                                           |
|:---|:---|:---|
| success_rows | Integer          | **参数解释** 取消成功的任务数量。 **取值范围** 值为大于等于0的整数。                                                                        |
| failed_rows  | Integer          | **参数解释** 取消失败的任务数量。 **取值范围** 值为大于等于0的整数。                                                                        |
| failed_ids   | Array of strings | **参数解释** 取消失败的任务ID列表，包含无法取消的任务标识符。 **取值范围** 任务ID数组，每个任务ID必须为以"short-"或"long-"开头，后跟字母、数字、连字符和下划线组成的字符串，最多100个元素。 |
   
**状态码：400**
表3响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                    |
|:---|:---|:---|
| error_code | String | **参数解释** 错误码，用于标识具体的错误类型。 **取值范围** 不涉及。  |
| error_msg  | String | **参数解释** 错误描述，用于说明具体的错误信息。 **取值范围** 不涉及。 |
   
**状态码：403**
表4响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                    |
|:---|:---|:---|
| error_code | String | **参数解释** 错误码，用于标识具体的错误类型。 **取值范围** 不涉及。  |
| error_msg  | String | **参数解释** 错误描述，用于说明具体的错误信息。 **取值范围** 不涉及。 |
   
#### 请求示例
取消任务，取消的id列表有"long-123123123"。
```
POST https://{endpoint}/v1/jobs/cancel
{
  "job_ids" : [ "long-123123123" ]
}
```
#### 响应示例
**状态码：200**
**参数解释**
取消任务成功返回响应体。
**取值范围**
不涉及。
```
{
  "success_rows" : 1,
  "failed_rows" : 0,
  "failed_ids" : [ ]
}
```
**状态码：400**
**参数解释**
错误响应体。
**取值范围**
不涉及。
```
{
  "error_code" : "EMS.00004000",
  "error_msg" : "invalid parameter"
}
```
**状态码：403**
**参数解释**
错误响应体。
**取值范围**
不涉及。
```
{
  "error_code" : "EMS.00004000",
  "error_msg" : "invalid parameter"
}
```
#### 状态码
| 状态码 | 描述                                                                                                                               |
|:---|:---|
| 200 | **参数解释** 取消任务成功返回响应体。 **取值范围** 不涉及。 |
| 400 | **参数解释** 错误响应体。 **取值范围** 不涉及。       |
| 403 | **参数解释** 错误响应体。 **取值范围** 不涉及。       |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-ems/ems_04_0031.html)。