检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
固件升级（联通用户专用） 概述 固件（Firmware）一般是指设备硬件的底层“驱动程序”，承担着一个系统最基础最底层工作的软件，比如计算机主板上的基本输入/输出系统BIOS（Basic Input/output System)。 固件升级又称为FOTA（Firmware Over
设备影子状态变更通知 典型场景 第三方应用在物联网平台订阅了设备影子状态变更通知后（订阅的通知类型为deviceDesiredPropertiesModifyStatusChanged），当平台中的设备影子向设备同步数据成功或失败时，平台会向第三方应用推送通知消息。 接口功能 支
消息结构体说明 转发设备上报的属性 根据定义的产品模型，上报设备属性至平台。结构体描述如下： 表1 属性上报规则转发结构体 参数名称 类型 描述 device_id String 设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 services services[]
软件升级状态变更通知 典型场景 第三方应用在物联网平台订阅了软件升级状态变更通知后（订阅的通知类型为swUpgradeStateChangeNotify），当设备进行软件升级，升级任务的状态发生变化时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了软件升级状态变更通知的第三方应用推送通知消息。
软件升级状态变更通知 典型场景 第三方应用在物联网平台订阅了软件升级状态变更通知后（订阅的通知类型为swUpgradeStateChangeNotify），当设备进行软件升级，升级任务的状态发生变化时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了软件升级状态变更通知的第三方应用推送通知消息。
固件升级状态变更通知 典型场景 第三方应用在物联网平台订阅了固件升级状态变更通知后（订阅的通知类型为fwUpgradeStateChangeNotify），当设备进行固件升级，升级任务的状态发生变化时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了固件升级状态变更通知的第三方应用推送通知消息。
批量查询订阅 典型场景 第三方应用可在物联网平台上创建多个订阅，以订阅不同类型的设备变更通知。第三方应用若需要查看本应用下所有订阅配置，或者查看某种订阅类型下的所有订阅配置，可调用此接口进行查询。 接口功能 支持第三方应用在物联网平台查询本应用下的所有订阅信息，或者某种订阅类型下的所有订阅信息。
设备命令响应通知 典型场景 第三方应用在物联网平台订阅了设备命令响应通知后（订阅的通知类型为commandRsp），当平台向设备下发命令，并收到设备返回的命令响应消息（如命令执行成功或者执行失败，设备要向平台返回指定内容响应）时，平台会向第三方应用推送通知消息。 接口功能 支持物
修改设备命令 典型场景 第三方应用向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行，此时第三方应用可调用此接口修改该命令的状态信息。当前仅支持把命令状态修改为CANCELED状态，即撤销命令的执行。 接口功能 支持第三方应用修改指定命令的状
增加设备模型通知 典型场景 第三方应用在物联网平台订阅了设备模型增加通知后（订阅的通知类型为deviceModelAdded），在物联网平台上新增设备Profile文件时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备模型增加通知的第三方应用推送通知消息。
删除设备模型通知 典型场景 第三方应用在物联网平台订阅了设备模型删除通知后（订阅的通知类型为deviceModelDeleted），在物联网平台上删除设备Profile文件时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备模型删除通知的第三方应用推送通知消息。
固件升级结果变更通知 典型场景 第三方应用在物联网平台订阅了固件升级结果通知后（订阅的通知类型为fwUpgradeResultNotify），当设备的固件升级任务执行完成时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了固件升级结果通知的第三方应用推送通知消息。
NB设备命令状态变化通知 典型场景 第三方应用通过物联网平台创建设备命令时，如果设置了callbackurl回调地址，当命令状态变化时（执行失败，执行成功，超时，发送，已送达），平台会向第三方应用推送通知消息。 接口功能 支持物联网平台在命令状态发生变化时向第三方应用推送通知消息。
软件升级结果变更通知 典型场景 第三方应用在物联网平台订阅了软件升级结果通知后（订阅的通知类型为swUpgradeResultNotify），当设备的软件升级任务执行完成时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了软件升级结果通知的第三方应用推送通知消息。
增加设备模型通知 典型场景 第三方应用在物联网平台订阅了设备模型增加通知后（订阅的通知类型为deviceModelAdded），在物联网平台上新增设备Profile文件时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备模型增加通知的第三方应用推送通知消息。
订阅平台业务数据 典型场景 第三方应用可在物联网平台订阅设备相关的业务数据，当物联网平台中设备的业务信息发生变化时（如设备注册、设备数据上报、设备状态变更等），平台会向第三方应用发送通知消息，通知其具体的变化信息。第三方应用可以调用此接口向物联网平台订阅不同类型的设备业务变更通知。
升级指导（联通用户专用） 概述 软件（Software）一般分为系统软件和应用软件，系统软件实现设备最基本的功能，比如编译工具、系统文件管理等；应用软件可以根据设备的特点，提供不同的功能，比如采集数据、数据分析处理等。 软件升级又称为SOTA（SoftWare Over The
查询设备命令 典型场景 第三方应用向设备下发命令后，可调用此接口在物联网平台查询下发命令的状态及内容信息，以了解命令的执行情况。 接口功能 支持第三方应用在物联网平台查询下发命令的状态和内容信息，可查询指定时间段内本应用下的所有下发命令，或者指定设备的所有下发命令。 接口描述 1
使用Java API Demo调测（联通用户专用） 本文档基于调用API接口的代码样例（Java）进行指导，接口信息详见API参考文档。 准备Java开发环境 本小节以Windows操作系统为例，介绍安装JDK1.8以及安装Eclipse的方法，如果您使用其它类型的开发环境，请根据自己的需要完成部署。
查询设备历史数据 典型场景 在日常运行中，物联网平台会收到并保存设备上报业务数据（默认保留时间为7天），第三方应用若需要查看某个设备上报到平台的历史数据，可调用此接口查询获取。 接口功能 支持第三方应用根据设备ID，查询指定设备上报到物联网平台的历史数据。 接口描述 1 def
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
