检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
什么是Profile(联通用户专用) 非联通用户请查看设备接入服务。 Profile(即产品模型)是用来描述一款产品中的设备“是什么”、“能做什么”以及“如何控制该设备”的文件。在物联网平台集成对接中需要先创建Profile,因为Profile里面定义了设备上报的数据和应用服务器下发的命令包含了哪些字段。
可选 Integer(>=0) query 分页查询参数,查询结果分页显示时指定要查看的页信息,默认值0,查询第一页,取值范围为大于等于0的整数。 pageSize 可选 Integer[1,100] query 分页查询参数,查询结果分页显示时每页显示的记录数,默认值为10,取值范围为1-100的整数。
Integer query 分页查询参数,查询结果分页显示时指定要查看的页信息,默认0,查询第一页,取值范围为大于等于0的整数。 “gatewayId”与“pageNo”不能同时为空。 pageSize 可选 Integer query 分页查询参数,查询结果分页显示时每页显示的记录
查询单个设备信息 接口说明 已在物联网平台注册的设备,应用服务器若需要查看某个设备的详细信息(如厂商、型号、版本、状态和服务属性等信息),可调用此接口在物联网平台查询获取。 URI 请求方法 GET URI /iocm/app/dm/v1.4.0/devices/{deviceId}
数据转发至OBS长期储存(联通用户专用) 非联通用户请查看设备接入服务。 场景说明 对于设备上报的数据,即使创建应用时开启了存储数据能力,设备管理服务也只保存7天的历史数据。 若您希望长期保存数据,可以选择让平台将设备上报数据推送给应用服务器,由应用服务器进行保存;还可以选择让平台将设备上报数据
温度过高时自动关闭设备(联通用户专用) 非联通用户请查看设备接入服务。 场景说明 物联网平台支持设备数据上报和设备命令下发,但若要将两者联动起来,一般需要由应用服务器实现对应逻辑。 设备管理服务提供规则引擎功能,平台上简单几步操作即可实现数据上报特定数据时平台自动下发指定命令,减少应用服务器开发工作量。 本示例
查询指定版本包 接口说明 在进行设备版本升级前,应用服务器可调用此接口在物联网平台查询某个版本升级包的信息,确保设备要升级的版本包已上传到平台,可根据版本包ID查询指定版本包信息,在调用该接口前需要通过“查询版本包列表”接口查询获得版本包ID。 URI 请求方法 GET URI /iodm/northbound/v1
pem)、应用服务器证书(server.cer/server.crt/server.pem)和私钥文件(server_private.key)。其中CA证书用于加载到物联网平台,应用服务器证书和私钥文件用于加载到应用服务器。 加载证书 物联网平台采用HTTPS协议向应用服务器推送消息时
修改设备命令 接口说明 应用服务器向设备下发命令后,如果由于命令排队、设备不在线等原因,物联网平台还未把命令下发给设备执行,此时应用服务器可调用此接口修改该命令的状态信息。仅能修改还处于PENDING状态的命令,且当前仅支持把命令状态修改为CANCELED状态,即撤销命令的执行。
绑定设备通知 接口说明 应用服务器在物联网平台订阅了绑定设备通知后(订阅的通知类型为bindDevice),当设备接入并绑定物联网平台时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
设备信息变化通知 接口说明 应用服务器在物联网平台订阅了设备信息变化通知后(订阅的通知类型为deviceInfoChanged),当设备的配置或状态信息(如设备厂商信息、位置信息、版本信息、在线状态信息等)发生变化时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。
设备消息确认通知 接口说明 应用服务器在物联网平台订阅了设备消息确认通知后(订阅的通知类型为messageConfirm),当平台向设备下发命令,并收到设备返回的命令确认消息(如命令已送达、已执行等)时,平台会向应用服务器推送通知消息。 仅适用于使用MQTT协议接入的设备,例如集成了AgentLite
应用的应用详情页。 查看应用 创建应用后,用户可根据实际情况查看或者修改应用信息。在“应用列表”中单击应用,可查看该应用的详细信息。 参数类型 参数说明 基本 可查询应用的基本信息,包括应用名称、应用ID、创建时间以及该应用所属的行业,应用ID用于应用服务器接入物联网平台。其中用户可根据实际变更修改应用所属的行业。
应用集成(联通用户专用) 非联通用户请查看设备接入服务。 如何获取证书? 如何获取应用ID和应用密钥?如何重置应用密钥? 应用服务器如何获取设备上报到物联网平台的数据? 应用服务器调用接口失败怎么处理? 应用服务器下发命令失败,收到403的错误,提示回调地址冲突? 应用服务器如何获取设备的IMEI号?
以通道ID参数值为准。通过调用DIS服务 查询通道列表接口获取。 stream_id 可选 String(256) DIS服务对应的通道ID,和通道名称参数中至少一个不为空,和通道名称参数都存在时,以本参数值为准。通过调用DIS服务 查询通道详情接口获取。 表10 ActionObsForwarding
子任务状态,不指定,则查询该任务下所有子任务执行详情。 wait:等待 processing:正在执行 fail:失败 success:成功 stop:停止 pageNo 可选 Integer(>=0) query 分页查询参数,查询结果分页显示时指定要查看的页信息,默认值0,查询第一页,取值范围为大于等于0的整数。
批量删除订阅 接口说明 应用服务器若不再需要接收物联网平台推送的订阅通知消息,或者不再需要接收某类订阅通知消息,可调用此接口批量删除订阅配置,取消订阅,可删除全部订阅,或删除指定订阅类型的所有订阅,或删除指定回调URL地址的所有订阅。 URI 请求方法 DELETE URI /iocm/app/sub/v1
删除单个订阅 接口说明 应用服务器若不再需要接收物联网平台推送的某个订阅通知消息时,可调用此接口删除指定的订阅配置,取消订阅。 URI 请求方法 DELETE URI /iocm/app/sub/v1.2.0/subscriptions/{subscriptionId} 传输协议
订阅推送(联通用户专用) 调用订阅接口时,回调地址如何获取? 应用服务器如何收到命令状态变化的通知? 如何获取证书? 回调地址可以使用域名吗? 订阅后消息推送失败,例如提示503如何处理? 应用服务器收到数据,但是平台显示推送失败? 应用服务器只有内网地址,能否订阅成功? 调用订阅接口时,提示回调地址不合法?
设备命令响应通知 接口说明 应用服务器在物联网平台订阅了设备命令响应通知后(订阅的通知类型为commandRsp),当平台向设备下发命令,并收到设备返回的命令响应消息(如命令执行成功或者执行失败,设备要向平台返回指定内容响应)时,平台会向应用服务器推送通知消息。 仅适用于使用MQ