检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
创建设备组 典型场景 第三方应用可调用此接口在物联网平台上创建设备组，并把设备归类到不同的设备组内，进行分组管理。一个设备可以归属到多个设备组内。 在对设备进行某些操作时（如升级设备软固件、批量下发命令等），可通过设备组来指定要进行操作的设备。 接口功能 支持第三方应用在物联网平台创建设备组
固件升级状态变更通知 接口说明 应用服务器在物联网平台订阅了固件升级状态变更通知后（订阅的通知类型为fwUpgradeStateChangeNotify），当设备进行固件升级，升级任务的状态发生变化时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。
在线开发插件（联通用户专用） 非联通用户请查看设备接入服务。 借助开发中心，我们可以通过可视化的方式快速开发一款产品的编解码插件。在自定义新建产品时，如果选择使用系统模板，部分模板会包含编解码插件，您可以直接使用或在此基础上进行修改；如果选择自定义产品模板，则需要完成编解码插件的开发
设备数据变化通知 接口说明 应用服务器在物联网平台订阅了设备属性变化通知后（订阅的资源为device.data，事件为update），当设备上属性数据时，平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅设备属性变化通知的
Json组件使用说明 该组件为Agent Lite提供给开发者的工具组件，如果开发者无法进行Json格式的编码和解码，则可以使用该组件进行编码和解码。主要用于上报数据组装与下发命令解析。 1. Json编码 使用Json组件进行编码的流程。 创建Json编码对象。 1 HW_JSONOBJ
修订记录 发布日期 修订记录 2019-05-28 第三次正式发布 新增 设备侧MQTT接口参考 2019-05-13 第二次正式发布 修改 查询设备历史数据，删除serviceId和property可选参数。 2018-12-20 第一次正式发布 新增 应用侧API参考
温度过高时自动关闭设备（联通用户专用） 非联通用户请查看设备接入服务。 场景说明 物联网平台支持设备数据上报和设备命令下发，但若要将两者联动起来，一般需要由应用服务器实现对应逻辑。 设备管理服务提供规则引擎功能，平台上简单几步操作即可实现数据上报特定数据时平台自动下发指定命令，减少应用服务器开发工作量
离线开发的插件包通过了工具检测，上传到平台时，提示找不到插件？ 使用反编译工具打开preload文件夹下jar包，检查OSGI-INF->CodecProvideHandler.xml是否为xml格式，且不存在乱码。 图1 CodecProvideHandler.xml样例 检查name
产品模型（联通用户专用） 概述 产品模型（也称Profile）用于描述设备具备的能力和特性。开发者通过定义Profile，在物联网平台构建一款设备的抽象模型，使平台理解该款设备支持的服务、属性、命令等信息，如颜色、开关等。当定义完一款产品模型后，在进行设备注册时，就可以选择已在控制台上导入的产品模型
在开发中心上传Profile，无法点击上传按钮？ 检查Profile文件的名称是否符合“deviceType_manufacturerId_model.zip”格式，并检查“deviceType”、“manufacturerId”、“model”三个字段是否和“devicetype-capability.json
定时刷新token 典型场景 第三方应用通过调用此接口，定期刷新accessToken，刷新周期为鉴权方法返回值中的expiresIn，以保证accessToken不过期。accessToken由SDK管理，调用其他业务接口，accessToken可以直接传入null。 接口功能
使用模组接入 集成NB-IoT模组的设备，可以通过NB-IoT网络接入物联网平台。 特点 覆盖广，相比LTE提升20dB以上的增益 低功耗，聚焦小数据量、小速率应用 海量连接，单扇区支持5万个连接 低成本，低速率、低功耗、低带宽等特点使NB-IoT芯片或模组具备低成本优势 应用场景
设备触发告警并邮件或短信通知（联通用户专用） 非联通用户请查看设备接入服务。 场景说明 很多物联网设备24小时运行，设备管理者并不需要知道设备每一刻的状态，只需要设备在上报某些特定状态时能通知到管理者。 设备管理服务提供规则引擎功能可以满足该诉求，您可以通过设置规则简单实现当设备上报的数据满足某个条件时
在开发中心上传Profile，弹窗提示“文件输入格式有误”？ 检查每个json文件的格式是否正确，可以使用W3Cschool的在线JSON校验格式化工具。 检查servicetype-capability.json中commands/properties的值是否为数组格式（值是否包含在中括号之内
常见的软/固件升级错误有哪些？ 在软/固件升级时，可以在“执行详情”的任务列表中查看错误描述，常见错误描述如下： 失败原因 原因解释 处理建议 Device Abnormal is not online 设备未在线 请检查设备侧是否在线。 Task Conflict 任务冲突 请检查当前设备是否有软件升级
查询单个订阅 典型场景 第三方应用可在物联网平台上创建多个订阅，以订阅不同类型的设备变更通知。第三方应用若需要查看某个订阅的配置信息，可调用此接口进行查询。 接口功能 支持第三方应用在物联网平台根据订阅ID查询指定订阅的配置信息。 接口描述 1 SubscriptionDTO querySingleSubscription
命令下发（联通用户专用） 非联通用户请查看设备接入服务。 概述 为能有效地对设备进行管理，设备的产品模型中定义了物联网平台可向设备下发的命令，应用服务器可以调用物联网平台开放的API接口向单个设备或批量设备下发命令，或者用户通过物联网平台直接向单个设备下发命令，以实现对设备的远程控制
查询单个订阅 典型场景 第三方应用可在物联网平台上创建多个订阅，以订阅不同类型的设备变更通知。第三方应用若需要查看某个订阅的配置信息，可调用此接口进行查询。 接口功能 支持第三方应用在物联网平台根据订阅ID查询指定订阅的配置信息。 接口描述 1 def querySingleSubscription
更新设备状态 接口功能 通过该接口更新设备的状态信息，包括直连设备与所管理的非直连设备。设备离线、上线均可通过该接口刷新设备状态信息。 直连设备状态通过设备的登录状态进行管理，当直连设备连接断开则表示设备离线，当直连设备连接或重连成功，则表示设备上线，无需通过该接口进行刷新。故建议开发者使用该接口刷新非直连设备的状态
使用前必读 非联通用户请查看设备接入服务。 概述 物联网平台提供了Agent Lite SDK，帮助设备快速连接到物联网平台。支持TCP/IP协议栈的设备在集成Agent Lite SDK后，可以直接与物联网平台通信。不支持TCP/IP协议栈的设备例如蓝牙设备、ZigBee设备等，
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
