文档首页/ 设备接入 IoTDA/ API参考/ 设备侧MQTT/MQTTS接口参考/ 网关与子设备管理/ 网关更新子设备状态
更新时间：2024-11-26 GMT+08:00
查看PDF
分享

网关更新子设备状态

功能介绍

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

  • 接口tps限制为直连设备并发建链的1.5倍。即为单个实例每秒最大建立请求连接数量为100*购买单元数量 *1.5。
  • 该接口1次调用的tps为1*上报子设备的数量。

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"
				}
			]
		}
	}]
}