检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
修改设备影子 典型场景 物联网平台支持创建设备的“影子”。设备影子用于存储设备最新上报的服务属性数据,以及第三方应用对服务属性的配置(服务属性为设备Profile文件中定义的service属性)。若设备处于离线或异常状态时,第三方应用无法通过命令下发的方式向设备下发配置,此时可把要下发的配置设置到设备影子
设备事件通知 典型场景 第三方应用在物联网平台订阅了设备事件通知后(订阅的通知类型为deviceEvent),当平台收到设备上报的事件消息时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备事件通知的第三方应用推送通知消息。 注意事项 应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址
删除指定版本包 典型场景 对于不需要继续使用和保留的设备版本包,第三方应用可调用此接口在物联网平台上删除指定的版本包。 接口功能 支持第三方应用在物联网平台根据版本包ID删除指定的版本包文件,在调用该接口前需要通过“查询版本包列表”接口查询获得要删除 接口描述 1 def deleteUpgradePackage
创建软件升级任务 典型场景 若需要对设备进行软件版本升级,第三方应用可调用此接口为多个设备创建软件升级任务,升级前请确保目标版本包已上传到物联网平台。当前仅支持对NB-IoT设备进行软件版本升级。 接口功能 支持第三方应用在物联网平台为多个设备进行软件版本升级,当前仅支持对NB-IoT
创建固件升级任务 典型场景 若需要对设备进行固件版本升级,第三方应用可调用此接口为多个设备创建固件升级任务,升级前请确保目标版本包已上传到物联网平台。当前仅支持对NB-IoT设备进行固件版本升级。 接口功能 支持第三方应用在物联网平台为多个设备进行固件版本升级,当前仅支持对NB-IoT
注册设备(验证码方式) 典型场景 在设备接入物联网平台前,第三方应用需要调用此接口在物联网平台注册设备,并把设备的唯一标识码(如IMEI)设置为设备接入平台的验证码。在设备接入物联网平台时携带设备唯一标识,完成设备的接入认证。 接口功能 支持第三方应用在物联网平台注册设备,完成注册后设备方可接入物联网平台
查询设备命令撤销任务 典型场景 第三方应用创建了设备命令撤销任务后,可调用此接口查询设备命令撤销任务的详细信息和执行状态,以了解撤销任务的执行情况。 接口功能 支持第三方应用在物联网平台查询设备命令撤销任务信息和状态,可指定条件查询单个或多个撤销任务。 接口描述 1 QueryDeviceCmdCancelTaskOutDTO2
查询指定设备组 典型场景 第三方应用若需要查看某个设备组的信息,以了解该设备组的使用情况,可调用此接口查询指定设备组的信息。 接口功能 支持第三方应用在物联网平台根据设备组ID查询指定设备组的信息。 接口描述 1 QuerySingleDeviceGroupOutDTO querySingleDeviceGroup
设备影子状态变更通知 典型场景 第三方应用在物联网平台订阅了设备影子状态变更通知后(订阅的通知类型为deviceDesiredPropertiesModifyStatusChanged),当平台中的设备影子向设备同步数据成功或失败时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备影子状态变更通知的第三方应用推送通知消息
创建设备命令撤销任务 典型场景 第三方应用向设备下发命令后,如果由于命令排队、设备不在线等原因,物联网平台还未把命令下发给设备执行(DEFAULT状态),此时第三方应用可调用此接口撤销指定设备的所有未下发的命令,对于已下发成功的命令不可撤销。 接口功能 支持第三方应用创建设备命令撤销任务
创建设备命令撤销任务 典型场景 第三方应用向设备下发命令后,如果由于命令排队、设备不在线等原因,物联网平台还未把命令下发给设备执行(DEFAULT状态),此时第三方应用可调用此接口撤销指定设备的所有未下发的命令,对于已下发成功的命令不可撤销。 接口功能 支持第三方应用创建设备命令撤销任务
查询设备命令撤销任务 典型场景 第三方应用创建了设备命令撤销任务后,可调用此接口查询设备命令撤销任务的详细信息和执行状态,以了解撤销任务的执行情况。 接口功能 支持第三方应用在物联网平台查询设备命令撤销任务信息和状态,可指定条件查询单个或多个撤销任务。 接口描述 1 def queryDeviceCmdCancelTask
设备接收解绑定命令 接口功能 注册设备解绑定接收广播来接收处理平台下发的直连设备解绑定命令,开发者收到该广播后需要删除直连设备的配置信息并且释放所有资源,下一次重启后需要重新进行绑定。 接口描述 1 HubService.TOPIC_UNBINDDEVICE; 接口所属类 HubService
设备接收解绑定命令 接口功能 注册设备解绑定接收广播来接收处理平台下发的直连设备解绑定命令,开发者收到该广播后需要删除直连设备的配置信息并且释放所有资源,下一次重启后需要重新进行绑定。 接口描述 1 IOTA_TOPIC_CMD_UNBIND_RECEIVE; 示例 1 2 3
设备接收解绑定命令 接口功能 被动接收平台下发的解绑定命令,删除直连设备的配置信息并且释放所有资源。(接收到此命令说明设备已经从平台侧删除。) 接口描述 1 HubService.TOPIC_UNBINDDEVICE; 接口所属类 HubService。 示例 调用该接口需要实现
查询设备激活状态 典型场景 第三方应用通过“注册设备”接口在物联网平台注册设备后,在设备首次接入平台之前,设备的激活状态为false;当设备首次接入平台后,设备的激活状态为true(无论设备接入后是处于在线、离线或异常状态)。第三方应用可调用此接口查询设备在物联网平台的激活状态,确定设备是否已接入平台
查询指定设备组 典型场景 第三方应用若需要查看某个设备组的信息,以了解该设备组的使用情况,可调用此接口查询指定设备组的信息。 接口功能 支持第三方应用在物联网平台根据设备组ID查询指定设备组的信息。 接口描述 1 def querySingleDeviceGroup(self, devGroupId
添加设备 接口功能 当有新设备接入网关后,通过调用设备添加接口将非直连设备接入物联网平台,并且获得平台分配的唯一设备逻辑ID。 接口描述 1 public static boolean addDevice(int cookie, IotaDeviceInfo deviceInfo)
查询设备影子 典型场景 若设备处于离线或异常状态时,第三方应用无法通过命令下发的方式向设备下发配置。此时可把要下发的配置设置到设备影子,当设备重新上线时,设备影子会把配置下发给设备。第三方应用可调用此接口查看设备影子上的设备配置信息及最新的设备上报数据信息。 接口功能 支持第三方应用查询单个设备的设备影子信息
软件升级结果变更通知 典型场景 第三方应用在物联网平台订阅了软件升级结果通知后(订阅的通知类型为swUpgradeResultNotify),当设备的软件升级任务执行完成时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了软件升级结果通知的第三方应用推送通知消息。