检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
修改设备信息 典型场景 第三方应用在物联网平台注册设备后,若设备的基本信息发生变更,也可调用此接口在物联网平台修改设备的信息。 接口功能 支持第三方应用修改设备的基本信息,包括设备类型、设备模型、厂商信息、接入协议等。 接口描述 1 void modifyDeviceInfo(ModifyDeviceInforInDTO
设备信息变化通知 典型场景 第三方应用在物联网平台订阅了设备信息变化通知后(订阅的通知类型为deviceInfoChanged),当设备的配置或状态信息(如设备厂商信息、位置信息、版本信息、在线状态信息等)发生变化时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备信息变化通知的第三方应用推送通知消息
设备命令响应通知 典型场景 第三方应用在物联网平台订阅了设备命令响应通知后(订阅的通知类型为commandRsp),当平台向设备下发命令,并收到设备返回的命令响应消息(如命令执行成功或者执行失败,设备要向平台返回指定内容响应)时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备命令响应通知的第三方应用推送通知消息
查询单个设备信息 典型场景 已在物联网平台注册的设备,第三方应用若需要查看某个设备的详细信息(如厂商、型号、版本、状态和服务属性等信息),可调用此接口在物联网平台查询获取。 接口功能 支持第三方应用在物联网平台根据设备ID查询指定设备的详细信息,包括配置信息、状态信息、服务属性信息等
订阅平台业务数据 典型场景 第三方应用可在物联网平台订阅设备相关的业务数据,当物联网平台中设备的业务信息发生变化时(如设备注册、设备数据上报、设备状态变更等),平台会向第三方应用发送通知消息,通知其具体的变化信息。第三方应用可以调用此接口向物联网平台订阅不同类型的设备业务变更通知。
设备信息变化通知 典型场景 第三方应用在物联网平台订阅了设备信息变化通知后(订阅的通知类型为deviceInfoChanged),当设备的配置或状态信息(如设备厂商信息、位置信息、版本信息、在线状态信息等)发生变化时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备信息变化通知的第三方应用推送通知消息
设备数据变化通知 典型场景 第三方应用在物联网平台订阅了设备数据变化通知后(订阅的通知类型为deviceDataChanged),当设备上报单个服务属性数据时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备数据变化通知的第三方应用推送通知消息。 注意事项 应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址
设备消息确认通知 典型场景 第三方应用在物联网平台订阅了设备消息确认通知后(订阅的通知类型为messageConfirm),当平台向设备下发命令,并收到设备返回的命令确认消息(如命令已送达、已执行等)时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备消息确认通知的第三方应用推送通知消息
删除设备模型通知 典型场景 第三方应用在物联网平台订阅了设备模型删除通知后(订阅的通知类型为deviceModelDeleted),在物联网平台上删除设备Profile文件时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备模型删除通知的第三方应用推送通知消息
创建设备命令 典型场景 设备Profile文件中定义了物联网平台可向设备下发的命令,第三方应用可调用此接口向设备下发命令,配置或修改设备的服务属性,以实现对设备的控制。 物联网平台有两种命令下发机制: 立即下发:平台收到命令后立即下发给设备,保证实时性,不保证串行性。 缓存下发:平台收到命令后缓存起来
查询单个设备信息 典型场景 已在物联网平台注册的设备,第三方应用若需要查看某个设备的详细信息(如厂商、型号、版本、状态和服务属性等信息),可调用此接口在物联网平台查询获取。 接口功能 支持第三方应用在物联网平台根据设备ID查询指定设备的详细信息,包括配置信息、状态信息、服务属性信息等
查询版本包列表 典型场景 在进行设备版本升级前,第三方应用可调用此接口查询已经上传到物联网平台的版本升级包列表信息,确保设备要升级的版本包已上传到平台。 接口功能 支持第三方应用在物联网平台查询已上传的版本包列表信息,可根据条件查询满足要求的版本包。 接口描述 1 QueryUpgradePackageListOutDTO
查询指定升级任务结果 典型场景 在创建了设备软件升级任务或固件升级任务后,第三方应用可调用此接口查询某个升级任务详细信息,以查看升级任务的配置信息和执行情况等。 接口功能 支持第三方应用在物联网平台查询单个固件或软件升级任务的详细信息,包括升级任务的配置信息和执行情况等。 接口描述
查询设备激活状态 典型场景 第三方应用通过“注册设备”接口在物联网平台注册设备后,在设备首次接入平台之前,设备的激活状态为false;当设备首次接入平台后,设备的激活状态为true(无论设备接入后是处于在线、离线或异常状态)。第三方应用可调用此接口查询设备在物联网平台的激活状态,确定设备是否已接入平台
设备影子状态变更通知 典型场景 第三方应用在物联网平台订阅了设备影子状态变更通知后(订阅的通知类型为deviceDesiredPropertiesModifyStatusChanged),当平台中的设备影子向设备同步数据成功或失败时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备影子状态变更通知的第三方应用推送通知消息
定时刷新token 典型场景 第三方应用通过调用此接口,定期刷新accessToken,刷新周期为鉴权方法返回值中的expiresIn,以保证accessToken不过期。accessToken由SDK管理,调用其他业务接口,accessToken可以直接传入null。 接口功能
查询指定批量任务信息 典型场景 第三方应用通过“创建批量任务”接口创建了设备的批量操作任务后,可调用此接口查询该批量任务的信息,包括任务的当前状态、子任务完成情况等。 接口功能 支持第三方应用通过任务ID查询单个批量任务的信息。 接口描述 1 QueryOneTaskOutDTO
批量设备数据变化通知 典型场景 第三方应用在物联网平台订阅了设备数据批量变化通知后(订阅的通知类型为deviceDatasChanged),当设备同时上报多个服务属性数据时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备数据批量变化通知的第三方应用推送通知消息
固件升级状态变更通知 典型场景 第三方应用在物联网平台订阅了固件升级状态变更通知后(订阅的通知类型为fwUpgradeStateChangeNotify),当设备进行固件升级,升级任务的状态发生变化时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了固件升级状态变更通知的第三方应用推送通知消息
创建软件升级任务 典型场景 若需要对设备进行软件版本升级,第三方应用可调用此接口为多个设备创建软件升级任务,升级前请确保目标版本包已上传到物联网平台。当前仅支持对NB-IoT设备进行软件版本升级。 接口功能 支持第三方应用在物联网平台为多个设备进行软件版本升级,当前仅支持对NB-IoT