检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
目标版本可以比当前版本低吗？ 可以。物联网平台会判断目标版本和当前版本是否一致：如果一致，任务详情显示“The current version is the same as the target version”，物联网平台不会发起升级任务；如果不一致，物联网平台则会启动升级任务。 父主题： 软/固件升级（联通用户专用）
使用API对接 API使用指导（联通用户专用） 使用Postman调测（联通用户专用） 使用Java API Demo调测（联通用户专用） 父主题： 应用侧开发
使用前必读 非联通用户请查看设备接入服务。 概述 物联网平台提供了Agent Lite SDK，帮助设备快速连接到物联网平台。支持TCP/IP协议栈的设备在集成Agent Lite SDK后，可以直接与物联网平台通信。不支持TCP/IP协议栈的设备例如蓝牙设备、ZigBee设备等，可以通过集成了Agent
t Lite SDK的网关将设备数据转发给物联网平台，与平台进行通信。 接口列表 Agent Lite提供的接口功能如下所示。 直连设备：通过设备绑定、设备登录流程直接接入物联网平台的设备。 非直连设备：通过网关设备接入物联网平台的设备。 功能 接口 说明 直连设备接入 IOTA_Init
设备服务能力删除通知 接口说明 应用服务器在物联网平台订阅了设备服务能力删除通知后（订阅的通知类型为deviceCapabilitiesDeleted），在物联网平台上删除设备Profile文件时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI
软件升级状态变更通知 典型场景 第三方应用在物联网平台订阅了软件升级状态变更通知后（订阅的通知类型为swUpgradeStateChangeNotify），当设备进行软件升级，升级任务的状态发生变化时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了软件升级状态变更通知的第三方应用推送通知消息。
软件升级状态变更通知 典型场景 第三方应用在物联网平台订阅了软件升级状态变更通知后（订阅的通知类型为swUpgradeStateChangeNotify），当设备进行软件升级，升级任务的状态发生变化时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了软件升级状态变更通知的第三方应用推送通知消息。
timeout是指超时时间，若设备在有效时间内未接入物联网平台，则平台会删除该设备的注册信息。 3~4. 设备第一次上电接入物联网平台时需要进行绑定操作，从而将设备与平台进行关联。设备携带nodeId和密钥进行平台绑定，平台返回设备ID、MQTT登录密钥、AppId、MQTT设备侧接入地址。
规则引擎（联通用户专用） 非联通用户请查看设备接入服务。 概述 规则引擎是指用户可以在物联网平台上可以对接入平台的设备设定相应的规则，在条件满足所设定的规则后，平台会触发相应的动作来满足用户需求。包含设备联动和数据转发两种类型。 设备联动规则 设备联动通过条件触发，基于预设的规则
典型场景 第三方应用在物联网平台订阅了设备事件通知后（订阅的通知类型为deviceEvent），当平台收到设备上报的事件消息时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备事件通知的第三方应用推送通知消息。 注意事项 1. 应用在订阅平台业务数据时需要订阅接口
典型场景 第三方应用在物联网平台订阅了设备事件通知后（订阅的通知类型为deviceEvent），当平台收到设备上报的事件消息时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备事件通知的第三方应用推送通知消息。 注意事项 应用在订阅平台业务数据时需要订阅接口描述
绑定和登录 设备或网关第一次接入物联网平台时需要进行绑定操作，从而将设备或网关与平台进行关联。开发者通过传入设备序列号以及设备信息，将设备或网关绑定到物联网平台。 设备或网关绑定成功后或重启后，需要进行登录的流程，在设备或网关成功登录物联网平台后，才可以进行其它服务操作，比如接入其
设备服务能力变化通知 接口说明 应用服务器在物联网平台订阅了设备服务能力变化通知后（订阅的通知类型为deviceCapabilitiesChanged），在物联网平台上设备Profile文件中的服务和属性被修改时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。
设备激活通知 接口说明 应用服务器在物联网平台订阅了设备激活通知后（订阅的资源为device，事件为activate），当设备首次接入物联网平台并激活时，平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时，请务必返回响应码。 URI 请求方法 POST URI
String 协议类型 ：Z-Wave。 bridgeId 可选 String 表示设备通过哪个Bridge接入平台。 status 可选 String 表示设备是否在线。 ONLINE 在线。 OFFLINE 离线。 statusDetail 可选 String 状态详情，如果pcStatus不为空，则该参数必选。
String 协议类型 ：Z-Wave。 bridgeId 可选 String 表示设备通过哪个Bridge接入平台。 status 可选 String 表示设备是否在线。 ONLINE：在线。 OFFLINE：离线。 statusDetail 可选 String 状态详情，如果pcStatus不为空，则该参数必选。
固件升级状态变更通知 典型场景 第三方应用在物联网平台订阅了固件升级状态变更通知后（订阅的通知类型为fwUpgradeStateChangeNotify），当设备进行固件升级，升级任务的状态发生变化时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了固件升级状态变更通知的第三方应用推送通知消息。
使用SDK对接 Java SDK使用指南（联通用户专用） Python SDK使用指南（联通用户专用） 父主题： 应用侧开发
刷新设备密钥 典型场景 已在物联网平台注册的设备，若设备的唯一标识码发生变更（如更换设备等场景），第三方应用需要调用此接口在物联网平台更新设备的唯一标识，并重新绑定设备。 仅当设备处于离线状态时，才能进行刷新设备密钥操作。 接口功能 支持第三方应用在物联网平台更新已注册设备的nodeId
设备影子状态变更通知 接口说明 应用服务器在物联网平台订阅了设备影子状态变更通知后（订阅的通知类型为deviceDesiredPropertiesModifyStatusChanged），当平台中的设备影子向设备同步数据成功或失败时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
