检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
修改设备命令 典型场景 第三方应用向设备下发命令后,如果由于命令排队、设备不在线等原因,物联网平台还未把命令下发给设备执行,此时第三方应用可调用此接口修改该命令的状态信息。当前仅支持把命令状态修改为CANCELED状态,即撤销命令的执行。 接口功能 支持第三方应用修改指定命令的状态信息
设备服务调用 典型场景 设备Profile文件中定义了物联网平台可向设备下发的命令,第三方应用可调用此接口向设备下发命令,配置或修改设备的服务属性,以实现对设备的控制。 物联网平台不对设备命令进行缓存而是直接下发命令,设备不在线时命令下发失败。下发命令的具体格式需要第三方应用与设备自定义
鉴权 典型场景 第三方应用首次访问物联网平台的开放API时,需调用此接口完成接入认证;第三方应用在物联网平台的认证过期后,需调用此接口重新进行认证,才能继续访问物联网平台的开放API。 接口功能 支持第三方应用在首次访问物联网平台的开放API之前,完成在物联网平台的接入认证。 注意事项
删除设备 典型场景 已在物联网平台注册的设备,若不再需要接入平台时,第三方应用可调用此接口在物联网平台删除设备。后续若设备要再次接入平台,第三方应用需要在物联网平台重新注册设备。 接口功能 支持第三方应用在物联网平台删除已注册的设备,使设备无法再接入平台。 接口描述 1 def deleteDirectDevice
批量查询订阅 典型场景 第三方应用可在物联网平台上创建多个订阅,以订阅不同类型的设备变更通知。第三方应用若需要查看本应用下所有订阅配置,或者查看某种订阅类型下的所有订阅配置,可调用此接口进行查询。 接口功能 支持第三方应用在物联网平台查询本应用下的所有订阅信息,或者某种订阅类型下的所有订阅信息
注册设备通知 典型场景 第三方应用在物联网平台订阅了注册设备通知后(订阅的通知类型为deviceAdded),当第三方应用通过“注册直连设备”接口在平台注册设备时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了注册设备通知的第三方应用推送通知消息。 注意事项 应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址
绑定设备通知 典型场景 第三方应用在物联网平台订阅了绑定设备通知后(订阅的通知类型为bindDevice),当直连设备接入并绑定物联网平台时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了绑定设备通知的第三方应用推送通知消息。 注意事项 应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址
删除设备通知 典型场景 第三方应用在物联网平台订阅了删除设备通知后(订阅的通知类型为deviceDeleted),当设备在物联网平台中被删除后,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了删除设备通知的第三方应用推送通知消息。 注意事项 应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址
刷新设备密钥 典型场景 已在物联网平台注册的设备,若设备的唯一标识码发生变更(如更换设备等场景),第三方应用需要调用此接口在物联网平台更新设备的唯一标识,并重新绑定设备。 仅当设备处于离线状态时,才能进行刷新设备密钥操作。 接口功能 支持第三方应用在物联网平台更新已注册设备的nodeId
查询设备影子 典型场景 若设备处于离线或异常状态时,第三方应用无法通过命令下发的方式向设备下发配置。此时可把要下发的配置设置到设备影子,当设备重新上线时,设备影子会把配置下发给设备。第三方应用可调用此接口查看设备影子上的设备配置信息及最新的设备上报数据信息。 接口功能 支持第三方应用查询单个设备的设备影子信息
软件升级结果变更通知 典型场景 第三方应用在物联网平台订阅了软件升级结果通知后(订阅的通知类型为swUpgradeResultNotify),当设备的软件升级任务执行完成时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了软件升级结果通知的第三方应用推送通知消息。
查询设备历史数据 典型场景 在日常运行中,物联网平台会收到并保存设备上报业务数据(历史数据默认保留7天),第三方应用若需要查看某个设备上报到平台的历史数据,可调用此接口查询获取。 接口功能 支持第三方应用根据设备ID,查询指定设备上报到物联网平台的历史数据。 接口描述 1 QueryDeviceDataHistoryOutDTO
修改设备影子 典型场景 物联网平台支持创建设备的“影子”。设备影子用于存储设备最新上报的服务属性数据,以及第三方应用对服务属性的配置(服务属性为设备Profile文件中定义的service属性)。若设备处于离线或异常状态时,第三方应用无法通过命令下发的方式向设备下发配置,此时可把要下发的配置设置到设备影子
批量设备数据变化通知 典型场景 第三方应用在物联网平台订阅了设备数据批量变化通知后(订阅的通知类型为deviceDatasChanged),当设备同时上报多个服务属性数据时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备数据批量变化通知的第三方应用推送通知消息
增加设备模型通知 典型场景 第三方应用在物联网平台订阅了设备模型增加通知后(订阅的通知类型为deviceModelAdded),在物联网平台上新增设备Profile文件时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备模型增加通知的第三方应用推送通知消息。
软件升级结果变更通知 典型场景 第三方应用在物联网平台订阅了软件升级结果通知后(订阅的通知类型为swUpgradeResultNotify),当设备的软件升级任务执行完成时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了软件升级结果通知的第三方应用推送通知消息。
固件升级状态变更通知 典型场景 第三方应用在物联网平台订阅了固件升级状态变更通知后(订阅的通知类型为fwUpgradeStateChangeNotify),当设备进行固件升级,升级任务的状态发生变化时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了固件升级状态变更通知的第三方应用推送通知消息
查询设备历史数据 典型场景 在日常运行中,物联网平台会收到并保存设备上报业务数据(默认保留时间为7天),第三方应用若需要查看某个设备上报到平台的历史数据,可调用此接口查询获取。 接口功能 支持第三方应用根据设备ID,查询指定设备上报到物联网平台的历史数据。 接口描述 1 def queryDeviceDataHistory
创建软件升级任务 典型场景 若需要对设备进行软件版本升级,第三方应用可调用此接口为多个设备创建软件升级任务,升级前请确保目标版本包已上传到物联网平台。当前仅支持对NB-IoT设备进行软件版本升级。 接口功能 支持第三方应用在物联网平台为多个设备进行软件版本升级,当前仅支持对NB-IoT
创建固件升级任务 典型场景 若需要对设备进行固件版本升级,第三方应用可调用此接口为多个设备创建固件升级任务,升级前请确保目标版本包已上传到物联网平台。当前仅支持对NB-IoT设备进行固件版本升级。 接口功能 支持第三方应用在物联网平台为多个设备进行固件版本升级,当前仅支持对NB-IoT