检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
软件升级结果变更通知 典型场景 第三方应用在物联网平台订阅了软件升级结果通知后（订阅的通知类型为swUpgradeResultNotify），当设备的软件升级任务执行完成时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了软件升级结果通知的第三方应用推送通知消息。
固件升级状态变更通知 典型场景 第三方应用在物联网平台订阅了固件升级状态变更通知后（订阅的通知类型为fwUpgradeStateChangeNotify），当设备进行固件升级，升级任务的状态发生变化时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了固件升级状态变更通知的第三方应用推送通知消息
查询设备历史数据 典型场景 在日常运行中，物联网平台会收到并保存设备上报业务数据（默认保留时间为7天），第三方应用若需要查看某个设备上报到平台的历史数据，可调用此接口查询获取。 接口功能 支持第三方应用根据设备ID，查询指定设备上报到物联网平台的历史数据。 接口描述 1 def queryDeviceDataHistory
查询设备激活状态 典型场景 第三方应用通过“注册设备”接口在物联网平台注册设备后，在设备首次接入平台之前，设备的激活状态为false；当设备首次接入平台后，设备的激活状态为true（无论设备接入后是处于在线、离线或异常状态）。第三方应用可调用此接口查询设备在物联网平台的激活状态，确定设备是否已接入平台
设备影子状态变更通知 典型场景 第三方应用在物联网平台订阅了设备影子状态变更通知后（订阅的通知类型为deviceDesiredPropertiesModifyStatusChanged），当平台中的设备影子向设备同步数据成功或失败时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备影子状态变更通知的第三方应用推送通知消息
创建设备命令撤销任务 典型场景 第三方应用向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行（DEFAULT状态），此时第三方应用可调用此接口撤销指定设备的所有未下发的命令，对于已下发成功的命令不可撤销。 接口功能 支持第三方应用创建设备命令撤销任务
删除设备组 典型场景 若因分组变更，第三方应用不再需要使用某个设备组，且不想在物联网平台上继续保存该设备组信息时，可调用此接口在物联网平台删除指定设备组。 接口功能 支持第三方应用在物联网平台根据设备组ID删除指定设备组。 接口描述 1 void deleteDeviceGroup
创建设备命令撤销任务 典型场景 第三方应用向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行（DEFAULT状态），此时第三方应用可调用此接口撤销指定设备的所有未下发的命令，对于已下发成功的命令不可撤销。 接口功能 支持第三方应用创建设备命令撤销任务
修改设备组 典型场景 若因业务变更需要修改设备组的信息，如设备组名称、设备组的设备数量限制等，第三方应用可调用此接口修改指定设备组的信息。 接口功能 支持第三方应用在物联网平台修改指定设备组的信息。 接口描述 1 def modifyDeviceGroup(self, mdgInDTO
设备注册鉴权（联通用户专用） 非联通用户请查看设备接入服务。 概述 设备注册鉴权是指物联网平台对接入平台的设备进行注册鉴权。对于不同接入方式的设备，注册鉴权方式不同。 接入类型 注册鉴权方式 使用LWM2M/CoAP协议接入的设备 在设备接入物联网平台前，用户通过应用服务器调用注册设备
更新设备状态 接口功能 通过该接口更新设备的状态信息，包括直连设备与所管理的非直连设备。设备离线、上线均可通过该接口刷新设备状态信息。 直连设备状态通过设备的登录状态进行管理，当直连设备连接断开则表示设备离线，当直连设备连接或重连成功，则表示设备上线，无需通过该接口进行刷新。故建议开发者使用该接口刷新非直连设备的状态
注册设备（验证码方式） 典型场景 在设备接入物联网平台前，第三方应用需要调用此接口在物联网平台注册设备，并把设备的唯一标识码（如IMEI）设置为设备接入平台的验证码。在设备接入物联网平台时携带设备唯一标识，完成设备的接入认证。 接口功能 支持第三方应用在物联网平台注册设备，完成注册后设备方可接入物联网平台
查询指定设备组 典型场景 第三方应用若需要查看某个设备组的信息，以了解该设备组的使用情况，可调用此接口查询指定设备组的信息。 接口功能 支持第三方应用在物联网平台根据设备组ID查询指定设备组的信息。 接口描述 1 QuerySingleDeviceGroupOutDTO querySingleDeviceGroup
查询升级任务列表 典型场景 第三方应用可调用此接口查询已创建的升级任务列表信息，以了解当前已有的升级任务信息及各个任务的执行情况。 接口功能 支持第三方应用在物联网平台查询升级任务的列表信息，可根据条件查询满足要求的升级任务信息。 接口描述 1 def queryUpgradeTaskList
使用LoRaWAN协议接入（联通用户专用） 非联通用户请查看设备接入服务。 概述 LoRa（Long Range Radio）是当前应用较广的一种物联网无线接入技术，它最大的特点就是在同样功耗条件下比其他无线接入方式传播的距离更远，实现了低功耗和远距离的统一，它在同样的功耗下比传统的无线射频通信距离扩大
查询版本包列表 典型场景 在进行设备版本升级前，第三方应用可调用此接口查询已经上传到物联网平台的版本升级包列表信息，确保设备要升级的版本包已上传到平台。 接口功能 支持第三方应用在物联网平台查询已上传的版本包列表信息，可根据条件查询满足要求的版本包。 接口描述 1 QueryUpgradePackageListOutDTO
查询指定升级任务结果 典型场景 在创建了设备软件升级任务或固件升级任务后，第三方应用可调用此接口查询某个升级任务详细信息，以查看升级任务的配置信息和执行情况等。 接口功能 支持第三方应用在物联网平台查询单个固件或软件升级任务的详细信息，包括升级任务的配置信息和执行情况等。 接口描述
查询设备激活状态 典型场景 第三方应用通过“注册设备”接口在物联网平台注册设备后，在设备首次接入平台之前，设备的激活状态为false；当设备首次接入平台后，设备的激活状态为true（无论设备接入后是处于在线、离线或异常状态）。第三方应用可调用此接口查询设备在物联网平台的激活状态，确定设备是否已接入平台
设备影子状态变更通知 典型场景 第三方应用在物联网平台订阅了设备影子状态变更通知后（订阅的通知类型为deviceDesiredPropertiesModifyStatusChanged），当平台中的设备影子向设备同步数据成功或失败时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备影子状态变更通知的第三方应用推送通知消息
设备接收解绑定命令 接口功能 注册设备解绑定接收广播来接收处理平台下发的直连设备解绑定命令，开发者收到该广播后需要删除直连设备的配置信息并且释放所有资源，下一次重启后需要重新进行绑定。 接口描述 1 HubService.TOPIC_UNBINDDEVICE; 接口所属类 HubService
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
