检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
对于设备上报的数据,即使创建应用时开启了存储数据能力,设备管理服务也只保存7天的历史数据。 若您希望长期保存数据,可以选择让平台将设备上报数据推送给应用服务器,由应用服务器进行保存;还可以选择让平台将设备上报数据转发给对象存储服务(OBS),由OBS进行存储。 本示例为将所有设备上报的数据转发至OBS存储。
物联网平台支持设备数据上报和设备命令下发,但若要将两者联动起来,一般需要由应用服务器实现对应逻辑。 设备管理服务提供规则引擎功能,平台上简单几步操作即可实现数据上报特定数据时平台自动下发指定命令,减少应用服务器开发工作量。 本示例为设备自带的温度传感器上报的温度大于80度时,平台自动下发命令关闭设备。
删除设备组 接口说明 若因分组变更,应用服务器不再需要使用某个设备组,且不想在物联网平台上继续保存该设备组信息时,可调用此接口在物联网平台删除指定设备组。 URI 请求方法 DELETE URI /iocm/app/devgroup/v1.3.0/devGroups/{devGroupId}
设备消息确认通知 接口说明 应用服务器在物联网平台订阅了设备消息确认通知后(订阅的通知类型为messageConfirm),当平台向设备下发命令,并收到设备返回的命令确认消息(如命令已送达、已执行等)时,平台会向应用服务器推送通知消息。 仅适用于使用MQTT协议接入的设备,例如集成了AgentLite
绑定设备通知 接口说明 应用服务器在物联网平台订阅了绑定设备通知后(订阅的通知类型为bindDevice),当设备接入并绑定物联网平台时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
设备信息变化通知 接口说明 应用服务器在物联网平台订阅了设备信息变化通知后(订阅的通知类型为deviceInfoChanged),当设备的配置或状态信息(如设备厂商信息、位置信息、版本信息、在线状态信息等)发生变化时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。
设备命令响应通知 接口说明 应用服务器在物联网平台订阅了设备命令响应通知后(订阅的通知类型为commandRsp),当平台向设备下发命令,并收到设备返回的命令响应消息(如命令执行成功或者执行失败,设备要向平台返回指定内容响应)时,平台会向应用服务器推送通知消息。 仅适用于使用MQ
创建批量任务 接口说明 应用服务器若需要对多个设备进行批量操作时,可调用此接口创建设备的批量操作任务,当前仅支持给批量设备下发缓存命令。 URI 请求方法 POST URI /iocm/app/batchtask/v1.1.0/tasks 传输协议 HTTPS 请求参数 参数 必选/可选
删除设备 接口说明 已在物联网平台注册的设备,若不再需要接入平台时,应用服务器可调用此接口在物联网平台删除设备,使设备无法再接入平台。后续设备若需要再次接入平台,则需重新注册设备。 URI 请求方法 DELETE URI /iocm/app/dm/v1.4.0/devices/{deviceId}
查询设备服务能力 接口说明 应用服务器若需要了解设备可上报哪些服务属性数据,以及设备支持下发哪些命令,可调用此接口在物联网平台查询设备的Profile文件中定义的设备服务能力信息。 URI 请求方法 GET URI /iocm/app/data/v1.1.0/deviceCapabilities
应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址,回调地址中的server与port为应用服务器公网地址与服务器配置中指定的端口 2. 应用通过继承PushMessageReceiver类并重写回调接口接收推送消息的内容 3. 如果回调地址不是应用服务器本身的地址,则第三方应用需要自己实现原始回调接口,接
应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址,回调地址中的server与port为应用服务器公网地址与服务器配置中指定的端口。 应用通过PushMessageReceiver类并重写回调接口接收推送消息的内容。 如果回调地址不是应用服务器本身的地址,则第三方应用需要自己实现原始回调接口,接口内容
修改设备信息 接口说明 应用服务器在物联网平台注册设备后,若设备的基本信息发生变更,可调用此接口在物联网平台修改设备的基本信息,包括设备类型、设备模型、厂商信息、接入协议等。 URI 请求方法 PUT URI /iocm/app/dm/v1.4.0/devices/{deviceId}
查询批量任务的子任务信息 接口说明 应用服务器通过“创建批量任务”接口创建了设备的批量操作任务后,可调用此接口查询该批量任务中子任务的详情信息,如任务的执行状态、任务内容等。 URI 请求方法 GET URI /iocm/app/batchtask/v1.1.0/taskDetails
接口说明 对于不需要继续使用和保留的设备版本包,应用服务器可调用此接口在物联网平台上删除指定的版本包,可根据版本包ID删除指定的版本包文件,在调用该接口前需要通过“查询版本包列表”接口查询获得要删除的版本包ID。 URI 请求方法 DELETE URI /iodm/northbound/v1
批量删除订阅 接口说明 应用服务器若不再需要接收物联网平台推送的订阅通知消息,或者不再需要接收某类订阅通知消息,可调用此接口批量删除订阅配置,取消订阅,可删除全部订阅,或删除指定订阅类型的所有订阅,或删除指定回调URL地址的所有订阅。 URI 请求方法 DELETE URI /iocm/app/sub/v1
查询版本包列表 接口说明 在进行设备版本升级前,应用服务器可调用此接口查询已经上传到物联网平台的版本升级包列表信息,确保设备要升级的版本包已上传到平台,可根据条件查询满足要求的版本包。 URI 请求方法 GET URI /iodm/northbound/v1.5.0/category
查询指定任务信息 接口说明 在创建了设备软件升级任务或固件升级任务后,应用服务器可调用此接口查询某个升级任务详细信息,以查看升级任务的配置信息和执行情况等。 URI 请求方法 GET URI /iodm/northbound/v1.5.0/operations/{operationId}
应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址,回调地址中的server与port为应用服务器公网地址与服务器配置中指定的端口。 应用通过PushMessageReceiver类并重写回调接口接收推送消息的内容。 如果回调地址不是应用服务器本身的地址,则第三方应用需要自己实现原始回调接口,接口内容
如何设置设备名称? 在开发中心注册设备时,支持设置设备名称。 在设备接入和设备管理的控制台中注册设备时,不支持设置设备名称,您可在设备注册成功后,进入设备详情中新增/修改设备名称。 使用API注册/创建设备时,设备接入、设备管理和开发中心都支持在注册/创建设备时设置设备名称。 父主题: