检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
创建软件升级任务 接口说明 若需要对设备进行软件版本升级，应用服务器可调用此接口为多个设备创建软件升级任务，升级前请确保目标版本包已上传到物联网平台。 注意事项 仅支持对使用LWM2M协议接入的设备进行软件升级。 URI 请求方法 POST URI /iodm/northbound/v1
创建固件升级任务 接口说明 若需要对设备进行固件版本升级，应用服务器可调用此接口为多个设备创建固件升级任务，升级前请确保目标版本包已上传到物联网平台。 注意事项 仅支持对使用LWM2M协议接入的设备进行固件升级。 URI 请求方法 POST URI /iodm/northbound/v1
查询任务列表 接口说明 应用服务器可调用此接口查询已创建的升级任务列表信息，以了解当前已有的升级任务信息及各个任务的执行情况，可根据条件查询满足要求的升级任务信息。 URI 请求方法 GET URI /iodm/northbound/v1.5.0/operations 传输协议 HTTPS
推送通知 设备激活通知 设备状态变化结果通知 设备数据变化通知 设备消息状态变更通知 批量任务状态变更通知 设备消息上报通知 父主题： 订阅管理-V5
创建订阅 接口说明 应用服务器可调用此接口订阅物联网平台资源的变化事件，当资源发生变化时（如设备激活，设备数据更新等），平台会向应用服务器发送通知消息。 URI 请求方法 POST URI /v5/iot/{project_id}/subscriptions 传输协议 HTTPS
删除单个订阅 接口说明 应用服务器若不再需要接收物联网平台推送的某个订阅通知消息时，可调用此接口删除指定的订阅配置，取消订阅。 URI 请求方法 DELETE URI /iocm/app/sub/v1.2.0/subscriptions/{subscriptionId} 传输协议
查询单个LoRa网关信息 接口说明 查询单个LoRa网关信息。 注意事项 应用已鉴权，在header中携带参数app_key和Authorization: Bearer {accessToken} URI 请求方法 GET URI /api/v3.0/devices/lora/gateway/{deviceId}
删除设备组 接口说明 若因分组变更，应用服务器不再需要使用某个设备组，且不想在物联网平台上继续保存该设备组信息时，可调用此接口在物联网平台删除指定设备组。 URI 请求方法 DELETE URI /iocm/app/devgroup/v1.3.0/devGroups/{devGroupId}
查询版本包列表 接口说明 在进行设备版本升级前，应用服务器可调用此接口查询已经上传到物联网平台的版本升级包列表信息，确保设备要升级的版本包已上传到平台，可根据条件查询满足要求的版本包。 URI 请求方法 GET URI /iodm/northbound/v1.5.0/category
修订记录 发布日期 修订记录 2019-05-28 第三次正式发布 新增 设备侧MQTT接口参考 2019-05-13 第二次正式发布 修改 查询设备历史数据，删除serviceId和property可选参数。 2018-12-20 第一次正式发布 新增 应用侧API参考
设备激活通知 接口说明 应用服务器在物联网平台订阅了设备激活通知后（订阅的资源为device，事件为activate），当设备首次接入物联网平台并激活时，平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时，请务必返回响应码。 URI 请求方法 POST URI
Json组件使用说明 该组件为Agent Lite提供给开发者的工具组件，如果开发者无法进行Json格式的编码和解码，则可以使用该组件进行编码和解码。主要用于上报数据组装与下发命令解析。 1. Json编码 使用Json组件进行编码的流程。 创建Json编码对象。 1 HW_JSONOBJ
查询设备激活状态 接口说明 应用服务器通过“注册设备”接口在物联网平台注册设备后，在设备首次接入平台之前，设备的激活状态为false；当设备首次接入平台后，设备的激活状态为true（无论设备接入后是处于在线、离线或异常状态）。应用服务器可调用此接口查询设备在物联网平台的激活状态，确定设备是否已接入平台。
查询单个订阅 接口说明 应用服务器可在物联网平台上创建多个订阅，以订阅不同类型的设备变更通知。应用服务器若需要查看某个订阅的配置信息，可调用此接口进行查询。 URI 请求方法 GET URI /iocm/app/sub/v1.2.0/subscriptions/{subscriptionId}
创建设备命令撤销任务 接口说明 应用服务器向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行（PENDING状态），此时应用服务器可调用此接口撤销指定设备的所有未下发的命令，对于已下发成功的命令不可撤销。 URI 请求方法 POST URI /iocm/app/cmd/v1
查询单个LoRa节点信息 接口说明 查询单个LoRa节点关信息。 注意事项 应用已鉴权，在header中携带参数app_key和Authorization: Bearer {accessToken} URI 请求方法 GET URI /api/v3.0/devices/lora/node/{deviceId}
查询设备影子历史数据 接口说明 应用服务器通过“修改设备影子”接口修改设备影子的配置时，物联网平台会保存修改记录。当应用服务器需要查看设备影子的历史配置记录时，可调用此接口查询获取。 URI 请求方法 GET URI /iocm/app/shadow/v1.5.0/deviceDesiredHistory
查询指定任务的子任务详情 接口说明 在创建了设备软件升级任务或固件升级任务后，任务中涉及的每个设备的升级是一个子任务（即升级任务中涉及多少个设备，就有多少个子任务）。应用服务器可调用此接口查询某个升级任务中各个子任务的详细信息，以查看子任务的具体执行情况。 URI 请求方法 GET
规则事件通知 接口说明 应用服务器在物联网平台订阅了规则事件通知后（订阅的通知类型为ruleEvent），当平台中配置的规则触发时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
软件升级结果通知 接口说明 应用服务器在物联网平台订阅了软件升级结果通知后（订阅的通知类型为swUpgradeResultNotify），当设备的软件升级任务执行完成时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI 请求方法 POST URI
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
