检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
平台通知网关子设备新增 功能介绍 平台将该网关新增的子设备列表信息通知给网关设备。网关与子设备关系，请查看网关与子设备。 Topic 下行: $oc/devices/{device_id}/sys/events/down 参数说明 字段名 必选/可选 类型 参数描述 object_device_id
解冻设备 功能介绍 应用服务器可调用此接口解冻设备，解除冻结后，设备可以连接上线。该接口仅支持解冻单个设备，如需批量解冻设备，请参见 创建批量任务。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/devices/{device_id}/unfreeze
平台通知网关子设备删除 功能介绍 平台将该网关删除的子设备信息通知给网关设备。网关与子设备关系，请查看网关与子设备。 Topic 下行: $oc/devices/{device_id}/sys/events/down 参数说明 字段名 必选/可选 类型 参数描述 object_device_id
平台规范、解析、过滤的数据。 使用限制 单个消息内容不大于64K。 需要定义产品模型。 相关API接口 平台设置设备属性 平台查询设备属性 属性下发使用说明 属性下发分为修改属性与获取属性值，下列以修改属性为例，介绍属性下发。 图1 属性下发流程图 应用调用修改设备属性接口，下发请求到物联网平台，属性下发消息样例如下：
18 19 20 21 22 /** * 设备上报数据到物联网平台时调用此接口进行解码, 将设备的原始数据解码为符合产品模型定义的JSON格式数据。 * 该接口名称和入参已经定义好，开发者只需要实现具体接口即可。 * @param byte[] payload 设备上报的原始码流
设备属性上报：设备通过MQTT/HTTP/LwM2M等协议上报属性数据。 按照不同的设备协议，调用的接口不一样，下面分别介绍MQTT、HTTPS、LwM2M/CoAP这三种协议中属性上报的样例： MQTT：通过属性上报接口MQTT协议属性上报、使用MQTT.fx调测上报数据到物联网平台，MQTT属性上报样例如下：
平台命令下发（对应图中的消息③） 表3 平台下发命令encode接口的入参结构定义 字段名 类型 参数描述 是否必填 identifier String 设备在应用协议里的标识，物联网平台通过decode接口解析码流时获取该参数，通过encode接口编码时将该参数放入码流。 否 msgType String
平台下发文件下载临时URL 功能介绍 平台下发文件下载临时URL给设备。 Topic 下行: $oc/devices/{device_id}/sys/events/down 参数说明 字段名 必选/可选 类型 参数描述 object_device_id 可选 String 参数解释：
平台下发文件上传临时URL 功能介绍 平台下发文件上传临时URL。 Topic 下行: $oc/devices/{device_id}/sys/events/down 参数说明 字段名 必选/可选 类型 参数描述 object_device_id 可选 String 参数解释：
创建产品 功能介绍 应用服务器可调用此接口创建产品。此接口仅创建了产品，没有创建和安装插件，如果需要对数据进行编解码，还需要在平台开发和安装插件。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/products 表1 路径参数 参数
SQL语句 创建数据转发规则时，需要编写SQL来解析和处理设备上报的JSON数据，JSON数据具体格式参考流转数据。本文主要介绍如何编写数据转发规则的SQL表达式。 SQL语句 SQL语句由SELECT子句和WHERE子句组成，每个子句不能大于500个字符，暂不支持中文等其他字符
（如果需要下发初始化配置，那么对应在初始设备配置选项中填写对应的JSON字符串，设备发放不理解该字段，只是透传该JSON字符串，由设备理解解析。如果不需要下发该字段则不填）。 图3 注册设备 图4 创建密钥模式静态策略设备 此处注册设备的设备名称需与添加静态策略步骤的策略实例关键字相匹配，方能触发该静态策略。
灵活搜索设备列表 功能介绍 接口说明 应用服务器使用SQL语句调用该接口，灵活的搜索所需要的设备资源列表 限制 仅标准版实例、企业版实例支持该接口调用，基础版不支持。 单账号调用该接口的 TPS 限制最大为1/S(每秒1次请求数) 类SQL语法使用说明 类SQL语句由select
适用于具体的场景。第三方协议由生态伙伴基于华为云IoT泛协议SDK开发，需至云市场单独购买协议解析插件，结合IoTDA共同使用。 表2 第三方协议 第三方协议 第三方协议由生态伙伴基于华为云IoT泛协议设备端SDK开发。需至云市场单独购买协议解析插件，加载到设备侧网关，再结合IoTDA共同使用。通过网关来完成
的，供外部访问的restful接口地址。当物联网平台向业务应用推送消息时，实际是调用业务应用的restful接口把数据发给业务应用。 回调地址的请求方式必须为POST。 怎样获取回调地址？ 回调地址由通信方式、业务应用的访问地址和restful接口的URL组成，如https://server:port/URL。
应用侧和设备侧基于物模型定义的属性、命令和事件进行解耦通信。 自定义Topic通信 支持用户自定义Topic进行双向消息通信。 数据解析转换 在线开发编解码插件，对设备数据进行数据解析和格式转换。 命令下发 支持以同步方式向在线设备下发命令，NB场景支持异步方式下发命令，详细请参见命令下发。 规则引擎
查询设备隧道 功能介绍 用户可通过该接口查询某项目中的某个设备隧道，查看该设备隧道的信息与连接情况。应用服务器可调用此接口向平台查询设备隧道建立情况。 该API接口在基础版不支持。 具体应用可见“设备远程登录”功能，请参见设备远程登录。 调用方法 请参见如何调用API。 URI GET /v
查询设备所有隧道 功能介绍 用户可通过该接口查询某项目下的所有设备隧道，以实现对设备管理。应用服务器可通过此接口向平台查询设备隧道建立的情况。 该API接口在基础版不支持。 具体应用可见“设备远程登录”功能，请参见设备远程登录。 调用方法 请参见如何调用API。 URI GET /v5/i
法正常上报数据怎么办？进行排查。 设备上报数据，应该选择消息接口还是属性接口？ 根据实际业务场景来使用。如果不需要平台解析数据，仅透传数据的话，可以使用消息上报（无需开发产品模型）；如果需要平台解析数据，请使用属性接口上报（需要开发产品模型）。 设备消息上报成功后，如何在平台查看是否上报成功？
创建设备接入实例 功能介绍 用户可以调用此接口创建一个设备接入实例。支持的实例规格请参见产品规格说明。 接口约束： 请保证账户余额充足，此接口无法使用优惠券支付，在创建包年/包月实例时，若余额不足会创建一个待支付订单。 若想使用优惠券，请将请求中的is_auto_pay字段设置为
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
