更新时间:2024-10-11 GMT+08:00

网关更新子设备状态响应

功能介绍

平台将该网关更新子设备状态结果以列表返回,平台收到网关更新子设备状态请求后会在30秒内通过此接口返回响应消息。网关与子设备关系,请查看网关与子设备

Topic

下行: $oc/devices/{device_id}/sys/events/down

参数说明

字段名

必选/可选

类型

参数描述

object_device_id

可选

String

参数解释:

该参数与Topic中的device_id一致。

services

可选

List<ServiceEvent>

参数解释:

事件服务列表。

ServiceEvent定义表

字段名

必选/可选

类型

参数描述

service_id

必选

String

参数解释:

系统字段。

取值范围:

固定为:"$sub_device_manager"。

event_type

必选

String

参数解释:

系统字段。

取值范围:

固定为:"sub_device_update_status"。

event_time

可选

String

参数解释:

事件时间。UTC时间,格式:yyyyMMdd'T'HHmmss'Z'。

event_id

必选

String

参数解释:

事件请求Id,通过该参数关联对应的事件请求。

paras

必选

Object

参数解释:

事件参数JSON对象。

paras参数列表

字段名

必选/可选

类型

参数描述

successful_devices

必选

List<DeviceStatus>

参数解释:

成功更新的子设备列表详情。

failed_devices

必选

List<Reason>

参数解释:

更新子设备状态失败的原因。

DeviceStatus定义表

字段名

必选/可选

类型

参数描述

device_id

必选

String

参数解释:

设备ID。

status

可选

String

参数解释:

设备更新状态结果。

取值范围:

  • ONLINE:设备在线。
  • OFFLINE:设备离线。

Reason定义表

字段名

必选/可选

类型

参数描述

device_id

必选

String

参数解释:

对应请求中指定的设备的device_id。

error_code

必选

String

参数解释:

更新失败错误原因码。

error_msg

必选

String

参数解释:

更新失败原因描述。

示例

Topic: $oc/devices/{device_id}/sys/events/down  
数据格式: 
{
   "object_device_id": "{object_device_id}",
   "services": [
    {
      "service_id": "$sub_device_manager",
      "event_type": "sub_device_update_status_response",
      "event_time": "20151212T121212Z",
      "event_id": "40cc9ab1-3579-488c-95c6-c18941c99eb4",
      "paras": {
          "successful_devices": [
          {
            "device_id": "c6b39067b0325db34663d3ef421a42f6_subdevice11",
            "status": "ONLINE"
          }
        ],
        "failed_devices": [
          {
            "device_id": "c6b39067b0325db34663d3ef421a42f6_subdevice11",
            "error_code": "XXX",
            "error_msg": "XXXX"
          }
        ]

      }
    }
  ]
}