设备接入 IOTDA-批量任务状态变更通知:请求参数

时间:2024-06-28 09:24:45

请求参数

表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

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

support.huaweicloud.com/api-iothub/iot_06_v5_01204.html