检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
物联网平台支持设备数据上报和设备命令下发,但若要将两者联动起来,一般需要由应用服务器实现对应逻辑。 设备管理服务提供规则引擎功能,平台上简单几步操作即可实现数据上报特定数据时平台自动下发指定命令,减少应用服务器开发工作量。 本示例为设备自带的温度传感器上报的温度大于80度时,平台自动下发命令关闭设备。
对于设备上报的数据,即使创建应用时开启了存储数据能力,设备管理服务也只保存7天的历史数据。 若您希望长期保存数据,可以选择让平台将设备上报数据推送给应用服务器,由应用服务器进行保存;还可以选择让平台将设备上报数据转发给对象存储服务(OBS),由OBS进行存储。 本示例为将所有设备上报的数据转发至OBS存储。
查询设备激活状态 接口说明 应用服务器通过“注册设备”接口在物联网平台注册设备后,在设备首次接入平台之前,设备的激活状态为false;当设备首次接入平台后,设备的激活状态为true(无论设备接入后是处于在线、离线或异常状态)。应用服务器可调用此接口查询设备在物联网平台的激活状态,确定设备是否已接入平台。
绑定设备通知 接口说明 应用服务器在物联网平台订阅了绑定设备通知后(订阅的通知类型为bindDevice),当设备接入并绑定物联网平台时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
删除设备组成员 接口说明 若设备组中的一个或多个设备不再归属于该设备组,应用服务器可调用此接口从设备组删除设备成员。 URI 请求方法 POST URI /iocm/app/dm/v1.1.0/devices/deleteDevGroupTagFromDevices 传输协议 HTTPS
设备信息变化通知 接口说明 应用服务器在物联网平台订阅了设备信息变化通知后(订阅的通知类型为deviceInfoChanged),当设备的配置或状态信息(如设备厂商信息、位置信息、版本信息、在线状态信息等)发生变化时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。
设备消息确认通知 接口说明 应用服务器在物联网平台订阅了设备消息确认通知后(订阅的通知类型为messageConfirm),当平台向设备下发命令,并收到设备返回的命令确认消息(如命令已送达、已执行等)时,平台会向应用服务器推送通知消息。 仅适用于使用MQTT协议接入的设备,例如集成了AgentLite
删除单个订阅 接口说明 应用服务器若不再需要接收物联网平台推送的某个订阅通知消息时,可调用此接口删除指定的订阅配置,取消订阅。 URI 请求方法 DELETE URI /iocm/app/sub/v1.2.0/subscriptions/{subscriptionId} 传输协议
设备Profile文件中定义了物联网平台可向设备下发的命令,应用服务器可调用此接口向设备下发命令,配置或修改设备的服务属性,以实现对设备的控制。 物联网平台不对设备命令进行缓存而是直接下发命令,设备不在线时命令下发失败。下发命令的具体格式需要应用服务器与设备自定义,物联网平台在接口中直接进行封装,透传。
修改规则 接口说明 应用服务器可调用此接口修改物联网平台中指定规则的配置。 调试 您可以在API Explorer中直接运行调试该接口。 URI 请求方法 PUT URI /v5/iot/{project_id}/rules/{rule_id} 传输协议 HTTPS 请求参数 名称
设备能力)查询。 当应用服务器向平台查询设备的历史数据和历史命令时,这些数据已经存储在物联网平台上,因此与设备是否在线无关。 订阅管理 物联网平台允许应用服务器订阅其所关注的事件,每一种事件的每一次订阅都会生成一个subscriptionId,应用服务器可以使用subscript
如何设置设备名称? 在开发中心注册设备时,支持设置设备名称。 在设备接入和设备管理的控制台中注册设备时,不支持设置设备名称,您可在设备注册成功后,进入设备详情中新增/修改设备名称。 使用API注册/创建设备时,设备接入、设备管理和开发中心都支持在注册/创建设备时设置设备名称。 父主题:
修改订阅 接口说明 应用服务器可调用此接口修改物联网平台中的指定订阅配置,当前仅支持修改订阅回调地址(callbackurl)。 URI 请求方法 PUT URI /v5/iot/{project_id}/subscriptions/{subscription_id} 传输协议 HTTPS
查询规则 接口说明 应用服务器可调用此接口查询物联网平台中指定规则的配置信息。 调试 您可以在API Explorer中直接运行调试该接口。 URI 请求方法 GET URI /v5/iot/{project_id}/rules/{rule_id} 传输协议 HTTPS 请求参数
设备命令响应通知 接口说明 应用服务器在物联网平台订阅了设备命令响应通知后(订阅的通知类型为commandRsp),当平台向设备下发命令,并收到设备返回的命令响应消息(如命令执行成功或者执行失败,设备要向平台返回指定内容响应)时,平台会向应用服务器推送通知消息。 仅适用于使用MQ
信息,默认0,查询第一页,建议通过设置pageNo和pageSize做分页查询。 pageSize 可选 Integer query 分页查询参数,查询结果分页显示时每页显示的记录数,默认1,最大值2000,建议根据设备上报数据的平均大小来设置,保证单次查询返回的包大小不超过16
查询指定设备组成员 接口说明 应用服务器若需要查看某个设备组中的设备成员分布情况,可调用此接口查询指定设备组的设备成员列表信息。 URI 请求方法 GET URI /iocm/app/dm/v1.2.0/devices/ids 传输协议 HTTPS 请求参数 参数 必选/可选 类型
修改设备组 接口说明 若因业务变更需要修改设备组的信息,如设备组名称、设备组的设备数量限制等,应用服务器可调用此接口修改指定设备组的信息。 URI 请求方法 PUT URI /iocm/app/devgroup/v1.3.0/devGroups/{devGroupId} 传输协议
回调路径已在SDK中设置好了,所以在订阅时要注意设置对应的回调地址。回调的IP地址则是服务器的地址,需要是公网地址,端口自行配置。 回调证书制作 本章节以自签名证书为例。如果是使用商用证书,请直接向CA机构申请。 注:每个步骤的创建证书请求中的配置,请自行设置。“Common Name
物联网平台支持创建设备的“影子”。设备影子是一个JSON文件,用于存储设备的在线状态、设备最近一次上报的设备属性值、应用服务器期望下发的配置。每个设备有且只有一个设备影子,设备可以获取和设置设备影子以此来同步设备属性值,这个同步可以是影子同步给设备,也可以是设备同步给影子。 设备影子上有desired区和report区。