批量任务状态变更通知
功能介绍
应用服务器在调用物联网平台创建规则触发条件（Resource:batchtask，Event:update）、创建规则动作、修改规则触发条件接口配置并激活规则后，当批量任务状态变更时，物联网平台会向应用服务器推送通知消息。
URI
POST /由应用服务器创建批量任务状态变更通知规则的转发目标决定
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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 |
参数说明：设备的自定义字段列表。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
app_id |
是 |
String |
参数说明：应用ID。 |
|
task_id |
是 |
String |
参数说明：批量任务ID。调用创建批量任务接口时返回的任务ID。 |
|
task_type |
是 |
String |
参数说明：任务类型。
|
|
status |
是 |
String |
参数说明：任务状态。
|
|
status_desc |
是 |
String |
参数说明：任务状态描述。 |
响应参数
无
请求示例
批量任务状态变更通知示例：
批量任务状态变更通知
{
"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 |
错误码
请参见错误码。
