检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
设备影子状态变更通知 接口说明 应用服务器在物联网平台订阅了设备影子状态变更通知后(订阅的通知类型为deviceDesiredPropertiesModifyStatusChanged),当平台中的设备影子向设备同步数据成功或失败时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。
接口说明 应用服务器在物联网平台订阅了设备数据批量变化通知后(订阅的通知类型为deviceDatasChanged),当设备同时上报多个服务属性数据时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
修改设备命令 接口说明 应用服务器向设备下发命令后,如果由于命令排队、设备不在线等原因,物联网平台还未把命令下发给设备执行,此时应用服务器可调用此接口修改该命令的状态信息。仅能修改还处于PENDING状态的命令,且当前仅支持把命令状态修改为CANCELED状态,即撤销命令的执行。
物联网平台采用HTTPS协议向应用服务器进行消息推送时,物联网平台需要校验应用服务器的真实性,需要在物联网平台上加载CA证书,该证书由应用服务器侧提供(调测时可自行制作调测证书,商用时建议更换为商用证书,否则会带来安全风险)。 推送机制:物联网平台向应用服务器推送消息后,如果应用服务器接收消息成功,会向物联网平台返回200
台向应用侧开放了丰富的Restful API。本文档以Postman为例,模拟应用服务器以HTTPS协议为例接入物联网平台。 前提条件 已经注册华为云官方帐号,可点击注册页面完成注册。 已经在华为云上完成实名制认证,可点击实名认证完成认证。 已开通设备管理服务,可访问设备管理服务,点击“立即使用”后开通服务。
删除设备组成员 接口说明 若设备组中的一个或多个设备不再归属于该设备组,应用服务器可调用此接口从设备组删除设备成员。 URI 请求方法 POST URI /iocm/app/dm/v1.1.0/devices/deleteDevGroupTagFromDevices 传输协议 HTTPS
若子设备不再需要接入物联网平台,应用服务器可调用此接口解绑网关下的子设备。 此功能通过设备命令下发接口向网关下发命令实现,具体删除子设备命令需网关提前实现(即网关收到什么命令会触发删除子设备的流程),并已在设备的Profile文件中定义。当网关收到平台下发的删除子设备命令时,则启动内部业务流程,删除子设备。
查询设备激活状态 接口说明 应用服务器通过“注册设备”接口在物联网平台注册设备后,在设备首次接入平台之前,设备的激活状态为false;当设备首次接入平台后,设备的激活状态为true(无论设备接入后是处于在线、离线或异常状态)。应用服务器可调用此接口查询设备在物联网平台的激活状态,确定设备是否已接入平台。
绑定设备通知 接口说明 应用服务器在物联网平台订阅了绑定设备通知后(订阅的通知类型为bindDevice),当设备接入并绑定物联网平台时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
pem)、应用服务器证书(server.cer/server.crt/server.pem)和私钥文件(server_private.key)。其中CA证书用于加载到物联网平台,应用服务器证书和私钥文件用于加载到应用服务器。 加载证书 物联网平台采用HTTPS协议向应用服务器推送消息时
应用服务器如何获取物联网平台推送消息时使用的地址? 物联网平台订阅推送是否具有重推机制? 为什么设备上报一条数据后应用服务器会收到多条推送? 在同一个应用下,平台可以将不同设备上报的数据,推送到两个服务器吗? NB-IoT设备已订阅消息确认和命令响应通知,为何应用服务器收不到推送消息?
设备Profile文件中定义了物联网平台可向设备下发的命令,应用服务器可调用此接口向设备下发命令,配置或修改设备的服务属性,以实现对设备的控制。 物联网平台不对设备命令进行缓存而是直接下发命令,设备不在线时命令下发失败。下发命令的具体格式需要应用服务器与设备自定义,物联网平台在接口中直接进行封装,透传。
如何获取应用ID和应用密钥?如何重置应用密钥? 应用服务器如何获取设备上报到物联网平台的数据? 应用服务器调用接口失败怎么处理? 应用服务器下发命令失败,收到403的错误,提示回调地址冲突? 应用服务器如何获取设备的IMEI号? 应用服务器如何下发缓存命令? 开发中心应用模拟器下发命令失败?
设备信息变化通知 接口说明 应用服务器在物联网平台订阅了设备信息变化通知后(订阅的通知类型为deviceInfoChanged),当设备的配置或状态信息(如设备厂商信息、位置信息、版本信息、在线状态信息等)发生变化时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。
设备消息确认通知 接口说明 应用服务器在物联网平台订阅了设备消息确认通知后(订阅的通知类型为messageConfirm),当平台向设备下发命令,并收到设备返回的命令确认消息(如命令已送达、已执行等)时,平台会向应用服务器推送通知消息。 仅适用于使用MQTT协议接入的设备,例如集成了AgentLite
信息,默认0,查询第一页,建议通过设置pageNo和pageSize做分页查询。 pageSize 可选 Integer query 分页查询参数,查询结果分页显示时每页显示的记录数,默认1,最大值2000,建议根据设备上报数据的平均大小来设置,保证单次查询返回的包大小不超过16
删除单个订阅 接口说明 应用服务器若不再需要接收物联网平台推送的某个订阅通知消息时,可调用此接口删除指定的订阅配置,取消订阅。 URI 请求方法 DELETE URI /iocm/app/sub/v1.2.0/subscriptions/{subscriptionId} 传输协议
修改设备组 接口说明 若因业务变更需要修改设备组的信息,如设备组名称、设备组的设备数量限制等,应用服务器可调用此接口修改指定设备组的信息。 URI 请求方法 PUT URI /iocm/app/devgroup/v1.3.0/devGroups/{devGroupId} 传输协议
数据转发规则 规则管理为应用服务器提供物联网平台的规则引擎功能,通过设置规则实现业务的联动变化。 规则引擎包含触发源、条件、动作三部分。规则引擎接收触发源事件,满足规则配置的条件后触发相应动作。 触发源:表示触发规则的事件源,当前支持的触发源有设备数据上报和时间。 条件:表示规则
推送通知 应用服务器向物联网平台订阅设备信息,当设备信息发生变更时,物联网平台向应用服务器推送此消息,应用服务器根据通知类型对消息分派处理。需要配合订阅管理接口使用。 注册设备通知 绑定设备通知 设备信息变化通知 设备数据变化通知 设备数据批量变化通知 设备服务能力变化通知 设备服务能力增加通知