检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
设备Profile文件中定义了物联网平台可向设备下发的命令，应用服务器可调用此接口向设备下发命令，配置或修改设备的服务属性，以实现对设备的控制。 物联网平台不对设备命令进行缓存而是直接下发命令，设备不在线时命令下发失败。下发命令的具体格式需要应用服务器与设备自定义，物联网平台在接口中直接进行封装，透传。
查询设备组列表 接口说明 应用服务器可调用此接口查询当前已创建的所有设备组列表信息，以了解当前设备组的分组和使用情况。 URI 请求方法 GET URI /iocm/app/devgroup/v1.3.0/devGroups 传输协议 HTTPS 请求参数 参数 必选/可选 类型
备进行相同命令的下发。应用服务器可以调用创建批量任务接口，对批量设备下发控制指令。 批量任务下发之后，可以登录物联网平台控制台，点击右上角“进入设备管理服务”。在“批量任务”->“批量命令下发”界面查看任务执行的状态和结果，如果成功率低于100%，则可以单击具体的任务名称，进入任务详情，查看执行失败的原因。
次上报数据都会上报这两个服务的数据。 如果订阅deviceDatachanged（设备数据变化通知），则物联网平台分两次将数据推送到应用服务器，第一次推送Battery服务数据，第二次推送Connectivity服务数据。例如： { "notifyType":"deviceDataChanged"
创建批量任务 接口说明 应用服务器若需要对多个设备进行批量操作时，可调用此接口创建设备的批量操作任务，当前仅支持给批量设备下发缓存命令。 URI 请求方法 POST URI /iocm/app/batchtask/v1.1.0/tasks 传输协议 HTTPS 请求参数 参数 必选/可选
查询设备历史数据 接口说明 在日常运行中，物联网平台会收到并保存设备上报业务数据，应用服务器若需要查看某个设备上报到平台的历史数据，可调用此接口查询获取。 URI 请求方法 GET URI /iocm/app/data/v1.2.0/deviceDataHistory 传输协议 HTTPS
在设备管理服务上传固件包时需要填写的支持设备源版本是什么？ 源版本就是设备当前版本是源版本中的一个，才允许升级。设备的当前版本号可以在控制台的“所有设备 > 设备详情 > 设备信息”中获取。 父主题： 软/固件升级（联通用户专用）
删除设备 接口说明 已在物联网平台注册的设备，若不再需要接入平台时，应用服务器可调用此接口在物联网平台删除设备，使设备无法再接入平台。后续设备若需要再次接入平台，则需重新注册设备。 URI 请求方法 DELETE URI /iocm/app/dm/v1.4.0/devices/{deviceId}
回调地址可以使用域名吗？ 可以，IP和域名都支持。 使用域名时，如果域名绑定多个IP，需要做好DNS解析，确保DNS解析后的IP地址可达。这种情况下，推荐使用IP地址作为回调地址。 父主题： 订阅推送（联通用户专用）
查询批量任务的子任务信息 接口说明 应用服务器通过“创建批量任务”接口创建了设备的批量操作任务后，可调用此接口查询该批量任务中子任务的详情信息，如任务的执行状态、任务内容等。 URI 请求方法 GET URI /iocm/app/batchtask/v1.1.0/taskDetails
增加设备组成员 接口说明 若需要把新增的设备或已有设备增加到某个设备组中，应用服务器可调用此接口向指定设备组添加设备成员。在向设备组添加设备前，建议通过“查询指定设备组”接口查询该设备组的当前设备数量及最大设备数量限制，确保设备组中还有足够的可添加成员数量。 注意事项 一个设备只能归属一个设备组。
取升级结果后，向终端设备取消订阅升级状态通知，并向控制台应用服务器通知升级的结果。 MQTT协议固件升级流程 MQTT协议FOTA升级流程的详细说明： 1～2. 用户在设备管理服务的控制台上传软件包，并在控制台或者应用服务器上创建软件升级任务。 3. 平台感知设备是否在线，当设备
目标版本可以比当前版本低吗？ 可以。物联网平台会判断目标版本和当前版本是否一致：如果一致，任务详情显示“The current version is the same as the target version”，物联网平台不会发起升级任务；如果不一致，物联网平台则会启动升级任务。
查询设备服务能力 接口说明 应用服务器若需要了解设备可上报哪些服务属性数据，以及设备支持下发哪些命令，可调用此接口在物联网平台查询设备的Profile文件中定义的设备服务能力信息。 URI 请求方法 GET URI /iocm/app/data/v1.1.0/deviceCapabilities
订阅推送（联通用户专用） 调用订阅接口时，回调地址如何获取？ 应用服务器如何收到命令状态变化的通知？ 如何获取证书？ 回调地址可以使用域名吗？ 订阅后消息推送失败，例如提示503如何处理？ 应用服务器收到数据，但是平台显示推送失败？ 应用服务器只有内网地址，能否订阅成功？ 调用订阅接口时，提示回调地址不合法？
批量删除订阅 接口说明 应用服务器若不再需要接收物联网平台推送的订阅通知消息，或者不再需要接收某类订阅通知消息，可调用此接口批量删除订阅配置，取消订阅，可删除全部订阅，或删除指定订阅类型的所有订阅，或删除指定回调URL地址的所有订阅。 URI 请求方法 DELETE URI /iocm/app/sub/v1
API。本文档以Postman为例，模拟应用服务器以HTTPS协议为例接入物联网平台。 前提条件 已经注册华为云官方帐号，可点击注册页面完成注册。 已经在华为云上完成实名制认证，可点击实名认证完成认证。 已开通设备管理服务，可访问设备管理服务，点击“立即使用”后开通服务。 获取应用接入信息 在设备接入服务控制台获取应用接入所需的信息。
向物联网平台反馈升级的结果。 15. 物联网平台向控制台/应用服务器通知升级的结果。 MQTT协议软件升级流程 MQTT协议SOTA升级流程的详细说明： 1～2. 用户在设备管理服务的控制台上传软件包，并在控制台或者应用服务器上创建软件升级任务。 3. 平台感知设备是否在线，当设
https推送的前提是先在平台上上传应用服务器的CA证书。 命令下发 本部分接口提供命令的创建、删除、查询、批量创建等功能。 批量处理 目前仅支持创建批量下发缓存命令任务，您也可以查询批量任务信息。 设备组管理 应用服务器可以通过本部分接口在物联网平台上管理设备组。设备组是把设备进行分组管理。一个设备可以归属到多个设备组内。
通知类型，比如设备业务数据、设备告警等，接口信息详见API参考文档。 在订阅场景下，物联网平台是客户端，应用服务器是服务端，物联网平台调用应用服务器的接口，并向应用服务器推送消息。在Java API Demo中，使用HTTP协议接收物联网平台的推送消息，不需要在物联网平台加载CA证书。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
