检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
查询批量任务的子任务信息 典型场景 第三方应用通过“创建批量任务”接口创建了设备的批量操作任务后,可调用此接口查询该批量任务中子任务的详情信息,如任务的执行状态、任务内容等。 接口功能 支持第三方应用根据条件查询批量任务中子任务的详情信息,支持查询本应用创建的批量任务信息。
批量查询订阅 接口说明 应用服务器可在物联网平台上创建多个订阅,以订阅不同类型的设备变更通知。应用服务器若需要查看本应用下所有订阅配置,或者查看某种订阅类型下的所有订阅配置,可调用此接口进行查询。
创建项目时,物联网平台会分配一个应用ID(接口调用时参数名为appId)作为项目的唯一标识。若应用服务器需要调用物联网平台的API接口进行一些业务处理,请求中必须携带appId以接入对应的项目空间,鉴权接口携带在Body中,其他接口的appId的值一般携带在Header中。
给使用MQTT协议接入的设备,例如集成了AgentLite SDK的设备下发命令时需要使用设备服务调用接口,如果调用接口失败请参考接口文档的错误码描述修改请求重新发送。
创建软件升级任务 接口说明 若需要对设备进行软件版本升级,应用服务器可调用此接口为多个设备创建软件升级任务,升级前请确保目标版本包已上传到物联网平台。 注意事项 仅支持对使用LWM2M协议接入的设备进行软件升级。
查询设备影子历史数据 典型场景 第三方应用通过“修改设备影子”接口修改设备影子的配置时,物联网平台会保存修改记录。当第三方应用需要查看设备影子的历史配置记录时,可调用此接口查询获取。 接口功能 支持第三方应用根据设备ID,在物联网平台查询指定设备影子的历史配置数据。
设备绑定 接口功能 设备第一次接入物联网平台时需要进行绑定操作,上层应用通过调用该接口传入设备序列号或者MAC地址以及设备信息来绑定到物联网平台。
接入流程 Agent Lite SDK提供相关的接口,开发者调用这些接口网关实现与物联网平台的对接。
刷新设备密钥 接口说明 已在物联网平台注册的设备,若设备的唯一标识码发生变更(如更换设备等场景),应用服务器需要调用此接口在物联网平台更新设备的唯一标识,并重新绑定设备。 注意事项 仅当设备处于离线状态时,才能进行刷新设备密钥操作。
创建设备命令撤销任务 接口说明 应用服务器向设备下发命令后,如果由于命令排队、设备不在线等原因,物联网平台还未把命令下发给设备执行(PENDING状态),此时应用服务器可调用此接口撤销指定设备的所有未下发的命令,对于已下发成功的命令不可撤销。
查询单个设备信息 接口说明 已在物联网平台注册的设备,应用服务器若需要查看某个设备的详细信息(如厂商、型号、版本、状态和服务属性等信息),可调用此接口在物联网平台查询获取。
批量查询设备信息 接口说明 已在物联网平台注册的设备,应用服务器若需要根据条件查看多个设备的详细信息(如厂商、型号、版本、状态和服务属性等信息),可调用此接口在物联网平台查询获取。
处理建议:请检查接口调用请求中携带参数的合法性。 403 1010009 app throttle exceed. 应用调用接口过于频繁,超过流控值(默认值是100次/60s)。 处理建议:联系物联网平台维护人员调大流控阈值或者控制接口的调用频率。
设备绑定 接口功能 设备第一次接入物联网平台时需要进行绑定操作,上层应用通过调用该接口传入设备序列号或者MAC地址以及设备信息来绑定到物联网平台。 在绑定前需要调用BindConfig.setConfig接口设置物联网平台的IP与端口。
父主题: 如何调用API
修改设备命令 接口说明 应用服务器向设备下发命令后,如果由于命令排队、设备不在线等原因,物联网平台还未把命令下发给设备执行,此时应用服务器可调用此接口修改该命令的状态信息。
通过Agent Lite的接口添加子设备时,接口参数携带的设备信息需要与子设备在物联网平台上定义的产品模型一致,否则会因为匹配不上产品而导致子设备所属产品为空。请删除所属产品为空的子设备后重新添加,并保证设备信息无误。 父主题: 产品模型/Profile(联通用户专用)
如果回调地址不是应用服务器本身的地址,则第三方应用需要自己实现原始回调接口,接口内容请参考物联网平台API参考中的消息推送章节。
如果回调地址不是应用服务器本身的地址,则第三方应用需要自己实现原始回调接口,接口内容请参考物联网平台API参考中的消息推送章节。
有以下几种方式: 应用服务器调用查询设备历史数据接口,主动从物联网平台获取设备上报的数据。 应用服务器调用订阅平台业务数据接口,使物联网平台在设备上报数据时,主动将数据推送给应用服务器。 通过规则引擎数据转发规则,通过DIS或者DMS转发至应用服务器。