网关更新子设备状态
功能介绍
网关更新子设备状态,更新结果通过网关更新子设备状态响应接口通知网关设备。网关与子设备关系,请查看网关与子设备。
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 |
参数解释: 子设备状态。 取值范围:
|
示例
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" } ] } }] }