# 批量任务状态变更通知
#### 功能介绍
应用服务器在调用物联网平台[创建规则触发条件 - CreateRoutingRule](https://support.huaweicloud.com/api-iothub/iot_06_v5_01307.html)（Resource:batchtask，Event:update）、[创建规则动作 - CreateRuleAction](https://support.huaweicloud.com/api-iothub/iot_06_v5_01302.html)、[修改规则触发条件 - UpdateRoutingRule](https://support.huaweicloud.com/api-iothub/iot_06_v5_01309.html)接口配置并激活规则后，当批量任务状态变更时，物联网平台会向应用服务器推送通知消息。
#### URI
POST /由应用服务器创建批量任务状态变更通知规则的转发目标决定
#### 请求参数
表1请求Body参数 
| 参数            | 是否必选 | 参数类型                                                                                                                              | 描述                                                                                                         |
|:---|:---|:---|:---|
| resource      | 是    | String                                                                                                                            | **参数说明**：订阅的资源名称，取值为batchtask。                                                                             |
| event         | 是    | String                                                                                                                            | **参数说明**：订阅的资源事件，取值为update。                                                                                |
| event_time    | 是    | String                                                                                                                            | **参数说明**：资源事件生成时间,格式：yyyyMMdd'T'HHmmss'Z' UTC字符串，如：20151212T121212Z。若需要显示本地时区，您需要自己进行时间转换。                 |
| event_time_ms | 否    | String                                                                                                                            | **参数说明**：资源事件生成时间,格式：yyyy-MM-dd'T'HH:mm:ss.SSS'Z' UTC字符串，如：2015-12-12T12:12:12.000Z。若需要显示本地时区，您需要自己进行时间转换。 |
| request_id    | 否    | String                                                                                                                            | **参数说明**：消息ID，由设备侧指定或平台生成，用于跟踪业务流程。                                                                        |
| notify_data   | 是    | [BatchTaskUpdateNotifyData] object | **参数说明**：设备的自定义字段列表。                                                                                       |
   
 表2BatchTaskUpdateNotifyData 
| 参数   | 是否必选 | 参数类型                                                                                                          | 描述                 |
|:---|:---|:---|:---|
| body | 是    | [BatchTaskUpdate] object | **参数说明**：推送消息body。 |
   
 表3BatchTaskUpdate 
| 参数          | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|:---|
| app_id      | 是    | String | **参数说明**：应用ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| task_id     | 是    | String | **参数说明**：批量任务ID。调用创建批量任务接口时返回的任务ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| task_type   | 是    | String | **参数说明**：任务类型。 - firmwareUpgrade：固件升级   - softwareUpgrade：软件升级                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| status      | 是    | String | **参数说明**：任务状态。 - Waitting 任务正在被等待执行   - Processing 任务正在执行   - Success 任务成功   - PartialSuccess 任务部分成功   - Fail 任务失败   - Stopped 任务被停止    |
| status_desc | 是    | String | **参数说明**：任务状态描述。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
   
#### 响应参数
**状态码：200**
OK
无
#### 请求示例
批量任务状态变更通知示例：
```
批量任务状态变更通知
{
  "resource" : "batchtask",
  "event" : "update",
  "event_time" : "20151212T121212Z",
  "event_time_ms" : "2015-12-12T12:12:12.000Z",
  "request_id" : "3fe58d5e-8697-4849-a165-7db128f7e776",
  "notify_data" : {
    "body" : {
      "status_desc" : "status_desc",
      "task_id" : "1a7ffc5c-d89c-44dd-8265",
      "task_type" : "softwareUpgrade",
      "app_id" : "1a7ffc5c-d89c-44dd-8265-b1653d951ce0",
      "status" : "Waitting"
    }
  }
}
```
#### 响应示例
无
#### 状态码
| 状态码 | 描述 |
|:---|:---|
| 200 | OK |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-iothub/ErrorCode.html)。