检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
设备间消息通信概述 概述 M2M（Machine-to-Machine），物联网平台支持基于MQTT协议实现设备间的消息通信。设备的连接和通信请求都交由平台承担，客户只需要关注自己的业务实现。可以实现设备间1到1、1到N、N到N的使用。IoT环境具有规模巨大的特点，设备之间通信没有限制
修改产品 功能介绍 应用服务器可调用此接口修改已导入物联网平台的指定产品模型，包括产品模型的服务、属性、命令等。此接口仅修改了产品，未修改和安装插件，如果修改了产品中的service定义，且在平台中有对应的插件，请修改并重新安装插件。 调用方法 请参见如何调用API。 URI PUT
查询规则 功能介绍 应用服务器可调用此接口查询物联网平台中指定规则的配置信息。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/rules/{rule_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String
使用限制 设备发放服务具有以下使用限制。 表1 设备发放服务使用限制列表 对象 类别/描述 限制 设备 集成Agent Lite的设备（MQTT） 不支持 原生MQTT协议设备 支持，设备需要开发设备引导接口，具备设备发放能力。 集成LiteOS的设备（LwM2M） 支持 证书 数字证书保证系统内各服务及系统与外部通信的安全性
广播通信使用说明 广播通信使用说明 图1 广播通信时序图 操作步骤 设备发起连接鉴权，鉴权参数填写规则参考设备连接鉴权。 设备鉴权成功后，发起广播Topic订阅，广播Topic必须为“$oc/broadcast/”前缀，样例如下： $oc/broadcast/test 应用服务器下发广播消息
JT808协议说明 概述 JT808插件基于IoTDA泛协议插件框架开发，为终端设备提供JT808的协议接入能力。JT808泛协议插件把与JT808协议的终端设备的交互，转换为IoTDA产品中定义的属性、命令等，用户可通过IoTDA应用侧接口与JT808协议的终端设备进行交互。 约束
Topic定义 设备使用MQTT协议接入平台时，平台和设备通过Topic进行通信。平台预置的topic列表如下： Topic分类 Topic Publisher(发布者) Subscriber(订阅者) 用途 设备消息相关Topic $oc/devices/{device_id}/
创建规则 功能介绍 应用服务器可调用此接口在物联网平台创建一条规则。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/rules 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数说明：项目ID
注册设备 在使用IoTDA进行收发消息前，您需要创建产品和设备。 访问设备接入服务，单击“控制台”进入设备接入控制台。选择左侧导航栏“IoTDA实例”，单击您需要的实例卡片进入实例。 创建产品。单击左侧导航栏“产品”，单击页面左侧的“创建产品”。根据页面提示填写参数，然后单击“确定
平台下发日志收集通知 Topic 下行: $oc/devices/{device_id}/sys/events/down 接口功能 用于平台下发日志收集通知给设备。 参数说明 字段名 必选/可选 类型 参数描述 services 可选 List<EventService> 参数解释
SDK介绍 业务流程 基于SDK实现泛协议设备接入的业务流程： 图1 业务流程图 SDK接口说明： 表1 表1 泛协议SDK提供监听平台下行数据的接口说明 接口 说明 BridgeCommandListener 平台命令下发监听接口。泛协议插件可以通过该接口将平台的下行命令转发给第三方协议设备
查询产品列表 功能介绍 应用服务器可调用此接口查询已导入物联网平台的产品模型信息列表，了解产品模型的概要信息。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/products 表1 路径参数 参数 是否必选 参数类型 描述 project_id
平台下发隧道信息 功能介绍 物联网平台向设备侧下发安全隧道信息。设备侧在接收到信息后，可以使用该安全隧道信息建立与物联网平台的WebSocket连接，用户可以在应用端远程登录使用基于安全隧道建链的设备（远程SSH登录服务），进行设备的更新配置、排查诊断、运维变更等操作。 Topic
查询实例列表 功能介绍 用户可以调用此接口查询设备接入实例列表。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/iotda-instances 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数说明
Node.js Demo使用说明 概述 本文以Node.js为例，介绍通过MQTTS/MQTT协议接入平台，基于平台接口实现“属性上报”、“订阅接收命令”等功能。 本文中使用的代码为样例代码，仅用于体验平台通信功能，如需进行商用，可以参考资源获取获取对应语言的IoT Device
查询网桥列表 功能介绍 应用服务器可调用此接口在物联网平台查询网桥列表。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/bridges 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数说明：项目
平台通知网关子设备删除 功能介绍 平台将该网关删除的子设备信息通知给网关设备。网关与子设备关系，请查看网关与子设备。 Topic 下行: $oc/devices/{device_id}/sys/events/down 参数说明 字段名 必选/可选 类型 参数描述 object_device_id
平台下发获取版本信息通知 功能介绍 平台下发获取版本信息通知。 Topic 下行: $oc/devices/{device_id}/sys/events/down 参数说明 字段名 必选/可选 类型 参数描述 object_device_id 可选 String 参数解释： 平台下发时
查询设备下的历史命令 功能介绍 查询设备下发的历史异步命令，包含EXPIRED、SUCCESSFUL、FAILED、TIMEOUT、DELIVERED五种状态。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/devices/{device_id
查询设备下队列中的命令 功能介绍 查询设备下队列中的命令（处理中的命令），包含PENDING、SENT、DELIVERED三种状态，注意：DELIVERED状态的命令经过系统设定的一段时间（具体以系统配置为准）仍然没有更新，就会从队列中移除，变为历史命令。 调用方法 请参见如何调用
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
