检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
查询设备激活状态 典型场景 第三方应用通过“注册设备”接口在物联网平台注册设备后，在设备首次接入平台之前，设备的激活状态为false；当设备首次接入平台后，设备的激活状态为true（无论设备接入后是处于在线、离线或异常状态）。第三方应用可调用此接口查询设备在物联网平台的激活状态，确定设备是否已接入平台。
查询设备激活状态 接口说明 应用服务器通过“注册设备”接口在物联网平台注册设备后，在设备首次接入平台之前，设备的激活状态为false；当设备首次接入平台后，设备的激活状态为true（无论设备接入后是处于在线、离线或异常状态）。应用服务器可调用此接口查询设备在物联网平台的激活状态，确定设备是否已接入平台。
什么是Profile（联通用户专用） 非联通用户请查看设备接入服务。 Profile（即产品模型）是用来描述一款产品中的设备“是什么”、“能做什么”以及“如何控制该设备”的文件。在物联网平台集成对接中需要先创建Profile，因为Profile里面定义了设备上报的数据和应用服务器
删除设备组成员 典型场景 若设备组中的一个或多个设备不再归属于该设备组，第三方应用可调用此接口从设备组删除设备成员。 接口功能 支持第三方应用在物联网平台从指定设备组删除设备。 接口描述 1 def deleteDevicesFromGroup(self, dgwdlDTO, accessAppId
删除子设备 若子设备不再需要接入物联网平台，应用服务器可调用此接口解绑网关下的子设备。 此功能通过设备命令下发接口向网关下发命令实现，具体删除子设备命令需网关提前实现（即网关收到什么命令会触发删除子设备的流程），并已在设备的Profile文件中定义。当网关收到平台下发的删除子设备
修订记录 发布日期 修订记录 2019-05-28 第三次正式发布 新增 设备侧MQTT接口参考 2019-05-13 第二次正式发布 修改 查询设备历史数据，删除serviceId和property可选参数。 2018-12-20 第一次正式发布 新增 应用侧API参考
增加设备组成员 典型场景 若需要把新增的设备或已有设备增加到某个设备组中，第三方应用可调用此接口向指定设备组添加设备成员。在向设备组添加设备前，建议通过“查询指定设备组”接口查询该设备组的当前设备数量及最大设备数量限制，确保设备组中还有足够的可添加成员数量。 接口功能 支持第三方应用在物联网平台向指定设备组添加设备。
批量删除订阅 典型场景 第三方应用若不再需要接收物联网平台推送的订阅通知消息，或者不再需要接收某类订阅通知消息，可调用此接口批量删除订阅配置，取消订阅。 接口功能 支持第三方应用在物联网平台批量删除订阅配置，可删除全部订阅，或删除指定订阅类型的所有订阅，或删除指定回调URL地址的所有订阅。
设备接收命令 接口说明 设备接收物联网平台下发的控制命令。 Topic Topic /huawei/v1/devices/{deviceId}/command/{codecMode} 消息发送方 物联网平台 消息接收方 设备 参数说明 参数 必选/可选 类型 描述 msgType
创建批量任务 典型场景 第三方应用若需要对多个设备进行批量操作时，可调用此接口创建设备的批量操作任务，当前仅支持给批量设备下发缓存命令。 接口功能 支持第三方应用在物联网平台创建设备的批量操作任务。 接口描述 1 def createBatchTask(self, btcInDTO
订阅平台业务数据 典型场景 第三方应用可在物联网平台订阅设备相关的业务数据，当物联网平台中设备的业务信息发生变化时（如设备注册、设备数据上报、设备状态变更等），平台会向第三方应用发送通知消息，通知其具体的变化信息。第三方应用可以调用此接口向物联网平台订阅不同类型的设备业务变更通知。
Json组件使用说明 该组件为Agent Lite提供给开发者的工具组件，如果开发者无法进行Json格式的编码和解码，则可以使用该组件进行编码和解码。主要用于上报数据组装与下发命令解析。 1. Json编码 使用Json组件进行编码的流程。 创建Json编码对象。 1 HW_JSONOBJ
在开发中心上传Profile，弹窗提示“文件输入格式有误”？ 检查每个json文件的格式是否正确，可以使用W3Cschool的在线JSON校验格式化工具。 检查servicetype-capability.json中commands/properties的值是否为数组格式（值是否包含在中括号之内）。
常见的软/固件升级错误有哪些？ 在软/固件升级时，可以在“执行详情”的任务列表中查看错误描述，常见错误描述如下： 失败原因 原因解释 处理建议 Device Abnormal is not online 设备未在线 请检查设备侧是否在线。 Task Conflict 任务冲突 请
温度过高时自动关闭设备（联通用户专用） 非联通用户请查看设备接入服务。 场景说明 物联网平台支持设备数据上报和设备命令下发，但若要将两者联动起来，一般需要由应用服务器实现对应逻辑。 设备管理服务提供规则引擎功能，平台上简单几步操作即可实现数据上报特定数据时平台自动下发指定命令，减少应用服务器开发工作量。
查询单个订阅 接口说明 应用服务器可在物联网平台上创建多个订阅，以订阅不同类型的设备变更通知。应用服务器若需要查看某个订阅的配置信息，可调用此接口进行查询。 URI 请求方法 GET URI /iocm/app/sub/v1.2.0/subscriptions/{subscriptionId}
创建设备组 典型场景 第三方应用可调用此接口在物联网平台上创建设备组，并把设备归类到不同的设备组内，进行分组管理。一个设备可以归属到多个设备组内。 在对设备进行某些操作时（如升级设备软固件、批量下发命令等），可通过设备组来指定要进行操作的设备。 接口功能 支持第三方应用在物联网平台创建设备组，用于对设备进行分组管理。
创建设备组 典型场景 第三方应用可调用此接口在物联网平台上创建设备组，并把设备归类到不同的设备组内，进行分组管理。一个设备可以归属到多个设备组内。 在对设备进行某些操作时（如升级设备软固件、批量下发命令等），可通过设备组来指定要进行操作的设备。 接口功能 支持第三方应用在物联网平台创建设备组，用于对设备进行分组管理。
离线开发的插件包通过了工具检测，上传到平台时，提示找不到插件？ 使用反编译工具打开preload文件夹下jar包，检查OSGI-INF->CodecProvideHandler.xml是否为xml格式，且不存在乱码。 图1 CodecProvideHandler.xml样例 检查name和implementation
固件升级状态变更通知 接口说明 应用服务器在物联网平台订阅了固件升级状态变更通知后（订阅的通知类型为fwUpgradeStateChangeNotify），当设备进行固件升级，升级任务的状态发生变化时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
