Help Center> IoT Device Access> API Reference> 应用侧API参考> 流转数据> 批量任务状态变更通知
View PDF

批量任务状态变更通知

接口说明

应用服务器在调用物联网平台的创建规则触发条件（Resource:batchtask，Event:update）、创建规则动作、修改规则触发条件接口配置并激活规则后，当批量任务状态变更时，物联网平台会向应用服务器推送通知消息。

注意事项

应用服务器收到推送消息时，请务必返回响应码。

URI

请求方法

POST

URI

应用服务器创建批量任务状态变更通知规则时的Url决定（HTTP），AMQP通道不需要url

传输协议

HTTPS

请求参数

名称

必选/可选

类型

位置

说明

resource

必选

String

Body

参数说明：订阅的资源名称，取值为batchtask。

event

必选

String

Body

参数说明：订阅的资源事件，取值为update。

event_time

必选

String

Body

参数说明：资源事件生成时间,格式：yyyyMMdd'T'HHmmss'Z' UTC字符串，如：20151212T121212Z。

notify_data

必选

BatchTaskUpdateNotifyData Object

Body

参数说明：设备的自定义字段列表。
表1 BatchTaskUpdateNotifyData

名称

必选/可选

类型

说明

body

必选

BatchTaskUpdate Object

参数说明：推送消息body。
表2 BatchTaskUpdate

名称

必选/可选

类型

说明

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

参数说明：任务状态描述。

请求示例

POST https://{Endpoint}应用服务器创建批量任务状态变更通知规则时的Url决定（HTTP），AMQP通道不需要url
Content-Type: application/json

{
  "resource" : "batchtask",
  "event" : "update",
  "event_time" : "20151212T121212Z",
  "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"
    }
  }
}

响应示例

Status Code: 200 OK

父主题： 流转数据