- 最新动态
- 功能总览
- 服务公告
- 计费说明
- 产品介绍
- 快速入门
- 用户指南
- 最佳实践
- 开发指南
-
API参考
- 应用侧API参考
- 设备侧MQTT/MQTTS接口参考
- 设备侧HTTPS接口参考
- 设备侧LwM2M接口参考
- 安全隧道WebSocket接口参考
- 模组AT指令参考
- 修订记录
- SDK参考
- 场景代码示例
-
常见问题
- 热门问题
-
方案咨询
- 连接IoT平台的业务场景有哪些？
- 设备管理服务和设备接入服务合一后的差异点是什么？
- IAM子用户或子项目是否可以开通物联网平台服务？
- 物联网平台支持在华为云的哪些区域开通？
- 华为是否提供模组/硬件终端/应用软件等？
- IAM用户访问API提示没有权限？(是否区分版本？)
- 创建规则或者设置资源文件存储时候提示赋予Security Administrator权限
- 物联网平台设置默认资源空间的规则是什么？
- 设备接入服务如何获取设备数据？
- 物联网平台的资源空间和设备可以无限创建吗？
- 物联网平台支持批量注册设备吗？
- 物联网平台对应用侧和设备侧在开发或使用时有限制吗？
- 物联网平台支持的DTLS加密算法有哪些？
- 物联网平台支持二进制大小端模式切换吗？
- 什么是NB-IoT？
- 物联网平台支持的硬件架构和使用的相关组件有哪些？
- 如何获取平台接入地址？
- 设备集成相关问题
- 设备侧SDK相关问题
- 设备发放相关问题
- LWM2M/CoAP接入相关问题
- MQTT接入相关问题
- 泛协议接入相关问题
- 物模型相关问题
- 消息通信相关问题
- 订阅推送相关问题
- 编解码插件相关问题
- OTA升级相关问题
- 应用集成相关问题
- 实例管理相关问题
- 视频帮助
- 文档下载
- 通用参考
链接复制成功！
网关新增子设备请求
功能介绍
网关主动新增其下接入的子设备，在平台上完成开户。网关与子设备关系，请查看网关与子设备。
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"
}
]
}
}
]
}
