文档首页/ 设备接入 IoTDA/ API参考/ 设备侧MQTT/MQTTS接口参考/ 远程配置/ 设备上报配置响应
更新时间：2025-05-26 GMT+08:00
查看PDF
分享

设备上报配置响应

功能介绍

设备上报配置结果响应。创建远程配置任务时，可以配置超时时间（1-30天，不配置默认30天）。在超时时间内，平台每24小时向设备下发一次配置，直到设备上报配置响应。如果设备在超时时间内一直没有上报配置响应，则平台显示该设备配置任务超时失败。

Topic

上行: $oc/devices/{device_id}/sys/events/up

参数说明

字段名

必选/可选

类型

参数描述

object_device_id

可选

String

参数解释：

  • 网关设备上报时，子设备进行上报需填写该参数。object_device_id为Topic中设备的子设备Id，否则将请求失败。
  • 直连设备上报时，object_device_id需与Topic中的device_id一致。
  • 若为空则默认该参数与Topic中的device_id一致。

services

可选

List<ServiceEvent>

参数解释：

事件服务列表。

ServiceEvent定义表

字段名

必选/可选

类型

参数描述

service_id

必选

String

参数解释：

系统字段。

取值范围：

固定为："$device_config"。

event_type

必选

String

参数解释：

系统字段。

取值范围：

固定为："config_update_response"。

event_time

可选

String

参数解释：

事件时间。UTC时间，格式：yyyyMMdd'T'HHmmss'Z'。

设备上报数据不带该参数或参数格式错误时，则数据上报时间以平台时间为准。

paras

必选

Object

参数解释：

事件参数JSON对象。

paras参数列表

字段名

必选/可选

类型

参数描述

result_code

必选

Integer

参数解释：

设备的配置结果。

取值范围：

结果码定义如下：

  • 0：处理成功。
  • 其他整数：设备自定义异常。

description

可选

String

参数解释：

设备配置执行结果信息，可以返回具体配置失败原因。

示例

Topic: $oc/devices/{device_id}/sys/events/up  
数据格式： 
{
    "object_device_id":"{object_device_id}",
    "services":[
        {
            "service_id":"$device_config",
            "event_type":"config_update_response",
            "event_time":"20151212T121212Z",
            "paras":{
                "result_code":0,
                "description":"update config success"
            }
        }
    ]
}
父主题： 远程配置

相关文档