检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
增加设备组成员 接口说明 若需要把新增的设备或已有设备增加到某个设备组中,应用服务器可调用此接口向指定设备组添加设备成员。在向设备组添加设备前,建议通过“查询指定设备组”接口查询该设备组的当前设备数量及最大设备数量限制,确保设备组中还有足够的可添加成员数量。 注意事项 一个设备只能归属一个设备组
修改设备命令 典型场景 第三方应用向设备下发命令后,如果由于命令排队、设备不在线等原因,物联网平台还未把命令下发给设备执行,此时第三方应用可调用此接口修改该命令的状态信息。当前仅支持把命令状态修改为CANCELED状态,即撤销命令的执行。 接口功能 支持第三方应用修改指定命令的状态信息
修改设备组 典型场景 若因业务变更需要修改设备组的信息,如设备组名称、设备组的设备数量限制等,第三方应用可调用此接口修改指定设备组的信息。 接口功能 支持第三方应用在物联网平台修改指定设备组的信息。 接口描述 1 ModifyDeviceGroupOutDTO modifyDeviceGroup
刷新token 接口说明 应用服务器通过鉴权接口获取到的accessToken是有效时间的,在accessToken快过期时,应用服务器通过调用此接口,获取新的accessToken。 URI 请求方法 POST URI /iocm/app/sec/v1.1.0/refreshToken
订阅平台管理数据 典型场景 第三方应用可向物联网平台订阅设备相关的管理数据,当物联网平台中设备进行版本升级等相关操作时,平台会向第三方应用发送通知消息,知会其具体的操作状态或操作结果信息。第三方应用可以调用此接口向物联网平台订阅不同类型的设备升级操作通知。 接口功能 支持第三方应用向物联网平台订阅设备的升级操作信息
修改设备信息 典型场景 第三方应用在物联网平台注册设备后,若设备的基本信息发生变更,也可调用此接口在物联网平台修改设备的信息。 接口功能 支持第三方应用修改设备的基本信息,包括设备类型、设备模型、厂商信息、接入协议等。 接口描述 1 def modifyDeviceInfo(self
设备影子(联通用户专用) 非联通用户请查看设备接入服务。 概述 物联网平台支持创建设备的“影子”。设备影子是一个JSON文件,用于存储设备的在线状态、设备最近一次上报的设备属性值、应用服务器期望下发的配置。每个设备有且只有一个设备影子,设备可以获取和设置设备影子以此来同步设备属性值
批量删除订阅 典型场景 第三方应用若不再需要接收物联网平台推送的订阅通知消息,或者不再需要接收某类订阅通知消息,可调用此接口批量删除订阅配置,取消订阅。 接口功能 支持第三方应用在物联网平台批量删除订阅配置,可删除全部订阅,或删除指定订阅类型的所有订阅,或删除指定回调URL地址的所有订阅
刷新token 典型场景 第三方应用通过鉴权接口获取到的accessToken是有有效时间的,在accessToken快过期时,第三方应用通过调用此接口,获取新的accessToken。 接口功能 支持第三方应用在accessToken到期前,从物联网平台获取新的accessToken
刷新token 典型场景 第三方应用通过鉴权接口获取到的accessToken是有有效时间的,在accessToken快过期时,第三方应用通过调用此接口,获取新的accessToken。 接口功能 支持第三方应用在accessToken到期前,从物联网平台获取新的accessToken
删除设备组成员 典型场景 若设备组中的一个或多个设备不再归属于该设备组,第三方应用可调用此接口从设备组删除设备成员。 接口功能 支持第三方应用在物联网平台从指定设备组删除设备。 接口描述 1 void deleteDevicesFromGroup(DeviceGroupWithDeviceListDTO
修改设备信息 典型场景 第三方应用在物联网平台注册设备后,若设备的基本信息发生变更,也可调用此接口在物联网平台修改设备的信息。 接口功能 支持第三方应用修改设备的基本信息,包括设备类型、设备模型、厂商信息、接入协议等。 接口描述 1 void modifyDeviceInfo(ModifyDeviceInforInDTO
创建设备命令撤销任务 典型场景 第三方应用向设备下发命令后,如果由于命令排队、设备不在线等原因,物联网平台还未把命令下发给设备执行(DEFAULT状态),此时第三方应用可调用此接口撤销指定设备的所有未下发的命令,对于已下发成功的命令不可撤销。 接口功能 支持第三方应用创建设备命令撤销任务
删除设备 典型场景 已在物联网平台注册的设备,若不再需要接入平台时,第三方应用可调用此接口在物联网平台删除设备。后续若设备要再次接入平台,第三方应用需要在物联网平台重新注册设备。 接口功能 支持第三方应用在物联网平台删除已注册的设备,使设备无法再接入平台。 接口描述 1 void
鉴权 典型场景 第三方应用首次访问物联网平台的开放API时,需调用此接口完成接入认证;第三方应用在物联网平台的认证过期后,需调用此接口重新进行认证,才能继续访问物联网平台的开放API。 接口功能 支持第三方应用在首次访问物联网平台的开放API之前,完成在物联网平台的接入认证。 注意事项
删除设备 典型场景 已在物联网平台注册的设备,若不再需要接入平台时,第三方应用可调用此接口在物联网平台删除设备。后续若设备要再次接入平台,第三方应用需要在物联网平台重新注册设备。 接口功能 支持第三方应用在物联网平台删除已注册的设备,使设备无法再接入平台。 接口描述 1 def deleteDirectDevice
创建设备命令 典型场景 设备Profile文件中定义了物联网平台可向设备下发的命令,第三方应用可调用此接口向设备下发命令,配置或修改设备的服务属性,以实现对设备的控制。 物联网平台有两种命令下发机制: 立即下发:平台收到命令后立即下发给设备,保证实时性,不保证串行性。 缓存下发:平台收到命令后缓存起来
创建设备命令 典型场景 设备Profile文件中定义了物联网平台可向设备下发的命令,第三方应用可调用此接口向设备下发命令,配置或修改设备的服务属性,以实现对设备的控制。 物联网平台有两种命令下发机制: 立即下发:平台收到命令后立即下发给设备,保证实时性,不保证串行性。 缓存下发:平台收到命令后缓存起来
查询设备激活状态 典型场景 第三方应用通过“注册设备”接口在物联网平台注册设备后,在设备首次接入平台之前,设备的激活状态为false;当设备首次接入平台后,设备的激活状态为true(无论设备接入后是处于在线、离线或异常状态)。第三方应用可调用此接口查询设备在物联网平台的激活状态,确定设备是否已接入平台
删除设备组 典型场景 若因分组变更,第三方应用不再需要使用某个设备组,且不想在物联网平台上继续保存该设备组信息时,可调用此接口在物联网平台删除指定设备组。 接口功能 支持第三方应用在物联网平台根据设备组ID删除指定设备组。 接口描述 1 def deleteDeviceGroup(