检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
查询设备激活状态 接口说明 应用服务器通过“注册设备”接口在物联网平台注册设备后，在设备首次接入平台之前，设备的激活状态为false；当设备首次接入平台后，设备的激活状态为true（无论设备接入后是处于在线、离线或异常状态）。应用服务器可调用此接口查询设备在物联网平台的激活状态，确定设备是否已接入平台
批量删除订阅 接口说明 应用服务器若不再需要接收物联网平台推送的订阅通知消息，或者不再需要接收某类订阅通知消息，可调用此接口批量删除订阅配置，取消订阅，可删除全部订阅，或删除指定订阅类型的所有订阅，或删除指定回调URL地址的所有订阅。 URI 请求方法 DELETE URI /iocm
查询设备组详情 典型场景 第三方应用可调用此接口查询当前已创建的所有设备组列表信息，以了解当前设备组的分组和使用情况。 接口功能 支持第三方应用在物联网平台查询已创建的所有设备组信息。 接口描述 1 QueryDeviceGroupsOutDTO queryDeviceGroups
修改设备组 典型场景 若因业务变更需要修改设备组的信息，如设备组名称、设备组的设备数量限制等，第三方应用可调用此接口修改指定设备组的信息。 接口功能 支持第三方应用在物联网平台修改指定设备组的信息。 接口描述 1 def modifyDeviceGroup(self, mdgInDTO
构造请求 请求URI 请求URI由如下部分组成。 {URI-scheme}://{Endpoint}/{resource-path}?{query-string} 参数 说明 URI-scheme 传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint 承载REST
离线开发插件（联通用户专用） 非联通用户请查看设备接入服务。 编解码插件实现二进制消息转JSON格式的功能，Profile定义了该JSON格式的具体内容。因此，编解码插件开发前需要先编写设备的Profile。 为了提高离线开发的集成效率，我们提供了编解码插件的编解码插件开发样例，建议您基于
查询设备组列表 接口说明 应用服务器可调用此接口查询当前已创建的所有设备组列表信息，以了解当前设备组的分组和使用情况。 URI 请求方法 GET URI /iocm/app/devgroup/v1.3.0/devGroups 传输协议 HTTPS 请求参数 参数 必选/可选 类型
订阅推送（联通用户专用） 调用订阅接口时，回调地址如何获取？ 应用服务器如何收到命令状态变化的通知？ 如何获取证书？ 回调地址可以使用域名吗？ 订阅后消息推送失败，例如提示503如何处理？ 应用服务器收到数据，但是平台显示推送失败？ 应用服务器只有内网地址，能否订阅成功？ 调用订阅接口时
修改设备组 典型场景 若因业务变更需要修改设备组的信息，如设备组名称、设备组的设备数量限制等，第三方应用可调用此接口修改指定设备组的信息。 接口功能 支持第三方应用在物联网平台修改指定设备组的信息。 接口描述 1 ModifyDeviceGroupOutDTO modifyDeviceGroup
订阅平台业务数据 典型场景 第三方应用可在物联网平台订阅设备相关的业务数据，当物联网平台中设备的业务信息发生变化时（如设备注册、设备数据上报、设备状态变更等），平台会向第三方应用发送通知消息，通知其具体的变化信息。第三方应用可以调用此接口向物联网平台订阅不同类型的设备业务变更通知。
基于软件开发平台构建应用服务器（联通用户专用） 非联通用户请查看设备接入服务。 场景说明 线下开发一个物联网应用，您需要一个代码库用于管理应用代码，还需要一个可与外网通信的服务器用于部署应用，准备和维护这两者都需要一定的成本。 华为云物联网平台提供基于软件开发平台的托管式应用开发与部署服务
设备快速接入（联通用户专用） 非联通用户请查看设备接入服务。 本文档以MQTT.fx为例，介绍以MQTT原生协议接入物联网平台。MQTT.fx是目前主流的MQTT客户端，可以快速验证是否可以与物联网平台服务交互发布或订阅消息。 前提条件 已经注册华为云官方帐号，可点击注册页面完成注册
定时刷新token 典型场景 第三方应用通过调用此接口，定期刷新accessToken，刷新周期为鉴权方法返回值中的expiresIn，以保证accessToken不过期。accessToken由SDK管理，调用其他业务接口，accessToken可以直接传入null。 接口功能
软件升级状态变更通知 接口说明 应用服务器在物联网平台订阅了软件升级状态变更通知后（订阅的通知类型为swUpgradeStateChangeNotify），当设备进行软件升级，升级任务的状态发生变化时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。
固件升级状态变更通知 接口说明 应用服务器在物联网平台订阅了固件升级状态变更通知后（订阅的通知类型为fwUpgradeStateChangeNotify），当设备进行固件升级，升级任务的状态发生变化时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。
Agent Lite SDK使用指南（Java）（联通用户专用） 非联通用户请查看设备接入服务。 按照本文档的指导，开发者可以体验直连设备通过集成Agent Lite快速接入平台，体验“数据上报”、“命令接收”、“添加非直连设备”等功能。 Agent Lite以SDK的形式嵌入第三方软件中
绑定设备通知 典型场景 第三方应用在物联网平台订阅了绑定设备通知后（订阅的通知类型为bindDevice），当直连设备接入并绑定物联网平台时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了绑定设备通知的第三方应用推送通知消息。 注意事项 应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址
创建设备命令 接口说明 设备Profile文件中定义了物联网平台可向设备下发的命令，应用服务器可调用此接口向设备下发命令，配置或修改设备的服务属性，以实现对设备的控制。 物联网平台有两种命令下发机制： 立即下发：平台收到命令后立即下发给设备，保证实时性，不保证串行性。 缓存下发：平台收到命令后缓存起来
设备接收解绑定命令 接口功能 被动接收平台下发的解绑定命令，删除直连设备的配置信息并且释放所有资源。(接收到此命令说明设备已经从平台侧删除。) 接口描述 1 HubService.TOPIC_UNBINDDEVICE; 接口所属类 HubService。 示例 调用该接口需要实现
绑定设备通知 接口说明 应用服务器在物联网平台订阅了绑定设备通知后（订阅的通知类型为bindDevice），当设备接入并绑定物联网平台时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
