检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
我是设备用户（联通用户专用） 非联通用户请查看设备接入服务。 作为设备用户，您既是设备的购买者，又可能是设备的实际管理者，通常您需要考虑两件事： 在采购设备时，如何评估设备满足您的业务需求并且具备接入物联网平台的能力。关于此方面的知识，您可以参考设备能力评估。 在进行日常管理时，
设备数据变化通知 接口说明 应用服务器在物联网平台订阅了设备数据变化通知后（订阅的通知类型为deviceDataChanged），当设备上报单个服务属性数据时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI 请求方法 POST URI 由
查询指定任务的子任务详情 接口说明 在创建了设备软件升级任务或固件升级任务后，任务中涉及的每个设备的升级是一个子任务（即升级任务中涉及多少个设备，就有多少个子任务）。应用服务器可调用此接口查询某个升级任务中各个子任务的详细信息，以查看子任务的具体执行情况。 URI 请求方法 GET
设备数据批量变化通知 接口说明 应用服务器在物联网平台订阅了设备数据批量变化通知后（订阅的通知类型为deviceDatasChanged），当设备同时上报多个服务属性数据时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI 请求方法 POST
查询设备命令撤销任务 接口说明 应用服务器创建了设备命令撤销任务后，可调用此接口查询设备命令撤销任务的详细信息和执行状态，以了解撤销任务的执行情况，可指定条件查询单个或多个撤销任务。 URI 请求方法 GET URI /iocm/app/cmd/v1.4.0/deviceCommandCancelTasks
设备消息确认通知 接口说明 应用服务器在物联网平台订阅了设备消息确认通知后（订阅的通知类型为messageConfirm），当平台向设备下发命令，并收到设备返回的命令确认消息（如命令已送达、已执行等）时，平台会向应用服务器推送通知消息。 仅适用于使用MQTT协议接入的设备，例如集成了AgentLite
查询设备历史数据 接口说明 在日常运行中，物联网平台会收到并保存设备上报业务数据，应用服务器若需要查看某个设备上报到平台的历史数据，可调用此接口查询获取。 URI 请求方法 GET URI /iocm/app/data/v1.2.0/deviceDataHistory 传输协议 HTTPS
设备信息变化通知 典型场景 第三方应用在物联网平台订阅了设备信息变化通知后（订阅的通知类型为deviceInfoChanged），当设备的配置或状态信息（如设备厂商信息、位置信息、版本信息、在线状态信息等）发生变化时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订
命令下发（联通用户专用） 非联通用户请查看设备接入服务。 概述 为能有效地对设备进行管理，设备的产品模型中定义了物联网平台可向设备下发的命令，应用服务器可以调用物联网平台开放的API接口向单个设备或批量设备下发命令，或者用户通过物联网平台直接向单个设备下发命令，以实现对设备的远程控制。
批量查询设备信息列表 典型场景 已在物联网平台注册的设备，第三方应用若需要根据条件查看多个设备的详细信息（如厂商、型号、版本、状态和服务属性等信息），可调用此接口在物联网平台查询获取。 接口功能 支持第三方应用在物联网平台根据条件查询多个设备的详细信息，包括配置信息、状态信息、服务属性信息等。
批量查询设备信息列表 典型场景 已在物联网平台注册的设备，第三方应用若需要根据条件查看多个设备的详细信息（如厂商、型号、版本、状态和服务属性等信息），可调用此接口在物联网平台查询获取。 接口功能 支持第三方应用在物联网平台根据条件查询多个设备的详细信息，包括配置信息、状态信息、服务属性信息等。
查询指定版本包 接口说明 在进行设备版本升级前，应用服务器可调用此接口在物联网平台查询某个版本升级包的信息，确保设备要升级的版本包已上传到平台，可根据版本包ID查询指定版本包信息，在调用该接口前需要通过“查询版本包列表”接口查询获得版本包ID。 URI 请求方法 GET URI /iodm/northbound/v1
固件升级（联通用户专用） 概述 固件（Firmware）一般是指设备硬件的底层“驱动程序”，承担着一个系统最基础最底层工作的软件，比如计算机主板上的基本输入/输出系统BIOS（Basic Input/output System)。 固件升级又称为FOTA（Firmware Over
绑定设备通知 典型场景 第三方应用在物联网平台订阅了绑定设备通知后（订阅的通知类型为bindDevice），当直连设备接入并绑定物联网平台时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了绑定设备通知的第三方应用推送通知消息。 注意事项 1. 应用在订阅平台业
修改设备影子 接口说明 物联网平台支持创建设备的“影子”。设备影子用于存储设备最新上报的服务属性数据，以及应用服务器对服务属性的配置（服务属性为设备Profile文件中定义的service属性）。若设备处于离线或异常状态时，应用服务器无法通过命令下发的方式向设备下发配置，此时可把
创建软件升级任务 接口说明 若需要对设备进行软件版本升级，应用服务器可调用此接口为多个设备创建软件升级任务，升级前请确保目标版本包已上传到物联网平台。 注意事项 仅支持对使用LWM2M协议接入的设备进行软件升级。 URI 请求方法 POST URI /iodm/northbound/v1
创建固件升级任务 接口说明 若需要对设备进行固件版本升级，应用服务器可调用此接口为多个设备创建固件升级任务，升级前请确保目标版本包已上传到物联网平台。 注意事项 仅支持对使用LWM2M协议接入的设备进行固件升级。 URI 请求方法 POST URI /iodm/northbound/v1
添加设备 接口功能 当有新设备接入网关后，通过调用设备添加接口将非直连设备接入物联网平台，并且获得平台分配的唯一设备逻辑ID。 接口描述 1 public static boolean addDevice(int cookie, IotaDeviceInfo deviceInfo);
API使用指导（联通用户专用） 非联通用户请查看设备接入服务。 为了降低应用侧的开发难度、提升应用侧开发效率，物联网平台向应用侧开放了丰富的Restful API（Application Programming Interface）。您可以调用开放的API，快速集成物联网平台的功
消息结构体说明 转发设备上报的属性 根据定义的产品模型，上报设备属性至平台。结构体描述如下： 表1 属性上报规则转发结构体 参数名称 类型 描述 device_id String 设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 services services[]
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
