网关新增子设备请求
功能介绍
网关主动新增其下接入的子设备,在平台上完成开户。网关与子设备关系,请查看网关与子设备。
Topic
上行: $oc/devices/{device_id}/sys/events/up
参数说明
字段名 |
必选/可选 |
类型 |
参数描述 |
---|---|---|---|
object_device_id |
可选 |
String |
参数解释: 该参数目前暂未实装使用,无需填写。 |
services |
必选 |
List<ServiceEvent> |
参数解释: 事件服务列表。 |
ServiceEvent定义表
字段名 |
必选/可选 |
类型 |
参数描述 |
---|---|---|---|
service_id |
必选 |
String |
参数解释: 系统字段。 取值范围: 固定为:"$sub_device_manager"。 |
event_type |
必选 |
String |
参数解释: 系统字段。 取值范围: 固定为:"add_sub_device_request"。 |
event_time |
可选 |
String |
参数解释: 事件时间。UTC时间,格式:yyyyMMdd'T'HHmmss'Z'。 设备上报数据不带该参数或参数格式错误时,则数据上报时间以平台时间为准。 |
event_id |
可选 |
String |
参数解释: 事件请求Id,唯一标识这次事件请求。如果不携带该参数,该参数由物联网平台自动生成,生成规则为数字、字母、中划线组成的36位随机字符串。 |
paras |
必选 |
Object |
参数解释: 事件参数JSON对象。 |
paras参数列表
字段名 |
必选/可选 |
类型 |
参数描述 |
---|---|---|---|
devices |
必选 |
List<DeviceInfo> |
参数解释: 待新增的子设备信息列表,单次增加最大不超过50个设备。 |
DeviceInfo定义表
字段名 |
必选/可选 |
类型 |
参数描述 |
---|---|---|---|
parent_device_id |
可选 |
String |
参数解释: 父节点设备ID,默认为对应网关设备id。 |
node_id |
必选 |
String |
参数解释: 设备标识。 |
device_id |
可选 |
String |
参数解释: 设备ID,用于唯一标识一个设备。如果携带该参数,平台将设备ID设置为该参数值;如果不携带该参数,设备ID由物联网平台分配获得,生成规则为"product_id" + "_" + "node_id"拼接而成。 |
name |
可选 |
String |
参数解释: 设备名称。 |
description |
可选 |
String |
参数解释: 设备描述。 |
product_id |
必选 |
String |
参数解释: 设备关联的产品ID,用于唯一标识一个产品模型,在控制台导入产品模型后由平台分配获得。 |
extension_info |
可选 |
Object |
参数解释: 设备扩展信息。用户可以自定义任何想要的扩展信息。字段值大小上限为1K。 |
示例
Topic: $oc/devices/{device_id}/sys/events/up 数据格式: { "object_device_id": "{object_device_id}", "services": [ { "service_id": "$sub_device_manager", "event_type": "add_sub_device_request", "event_time": "20151212T121212Z", "event_id": "40cc9ab1-3579-488c-95c6-c18941c99eb4", "paras": { "devices": [ { "name": "subdevice11", "node_id": "subdevice11", "product_id": "c6b39067b0325db34663d3ef421a42f6", "description": "subdevice11" }, { "name": "subdevice12", "node_id": "subdevice12", "product_id": "c6b39067b0325db34663d3ef421a42f6", "description": "subdevice12" } ] } } ] }