设备接入 IoTDA设备接入 IoTDA

更新时间:2021/09/06 GMT+08:00
分享

网关新增子设备请求

功能介绍

网关主动新增其下接入的子设备,在平台上完成开户。

Topic

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

参数说明

字段名

必选/可选

类型

参数描述

object_device_id

可选

String

对应网关设备id

services

必选

List<ServiceEvent>

事件服务列表

ServiceEvent定义表

字段名

必选/可选

类型

参数描述

service_id

必选

String

$sub_device_manager

event_type

必选

String

add_sub_device_request

event_time

可选

String

事件时间

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"
          }
        ]
      }
    }
  ]
}
分享:

    相关文档

    相关产品