文档首页/ 设备接入 IoTDA/ API参考/ 应用侧API参考/ API/ 流转数据/ 批量任务状态变更通知
更新时间：2024-07-02 GMT+08:00
查看PDF
分享

批量任务状态变更通知

功能介绍

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

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

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

参数

是否必选

参数类型

描述

body

是

BatchTaskUpdate object

参数说明：推送消息body。
表3 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

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

响应参数

无

请求示例

批量任务状态变更通知示例：

批量任务状态变更通知

{
  "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

错误码

请参见错误码。

父主题： 流转数据

相关文档