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

网关更新子设备状态

功能介绍

网关更新子设备状态,更新结果通过网关更新子设备状态响应接口通知网关设备。网关与子设备关系,请查看网关与子设备

Topic

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

参数说明

字段名

必选/可选

类型

参数描述

object_device_id

可选

String

参数解释:

该参数目前暂未实装使用,无需填写。

services

可选

List<EventService>

参数解释:

事件服务列表。

EventService定义表

字段名

必选/可选

类型

参数描述

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,唯一标识这次事件请求。如果不携带该参数,该参数由物联网平台自动生成,生成规则为数字、字母、中划线组成的36位随机字符串。

paras

必选

Object

参数解释:

事件参数JSON对象。

paras参数列表

字段名

必选/可选

类型

参数描述

device_statuses

必选

List<DeviceStatus>

参数解释:

设备状态列表,列表大小1~100。

DeviceStatus定义表:

字段名

必选/可选

类型

参数描述

device_id

必选

String

参数解释:

子设备ID。

status

必选

String

参数解释:

子设备状态。

取值范围:

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

示例

Topic: $oc/devices/{device_id}/sys/events/up
数据格式:   
{
        "object_device_id": "{object_device_id}",
	"services": [{
		"service_id": "$sub_device_manager",
		"event_type": "sub_device_update_status",
		"event_time": "20151212T121212Z",
		"paras": {
			"device_statuses": [{
					"device_id": "bf40f0c4-4022-41c6-a201-c5133122054a",
					"status": "ONLINE"
				},
				{
					"device_id": "4459c0f7-10bb-4718-9b07-7a82c2d508a5",
					"status": "ONLINE"
				}
			]
		}
	}]
}