检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
查询设备消息 功能介绍 应用服务器可调用此接口查询平台下发给设备的消息,平台为每个设备默认最多保存20条消息,超过20条后, 后续的消息会替换下发最早的消息。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/devices/{device_id}/messages
查询数据流转流控策略列表 功能介绍 应用服务器可调用此接口查询在物联网平台设置的数据流转流控策略列表。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/routing-rule/flowcontrol-policy 表1 路径参数 参数
List<EventService> 参数解释: 事件服务列表。 EventService定义表 字段名 必选/可选 类型 参数描述 service_id 必选 String 参数解释: 系统字段。 取值范围: 固定为:"$sub_device_manager"。 event_type
创建网桥 功能介绍 应用服务器可调用此接口在物联网平台创建一个网桥,仅在创建后的网桥才可以接入物联网平台。 一个实例最多支持20个网桥。 仅标准版实例、企业版实例支持该接口调用,基础版不支持。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/bridges
当规则引擎将消息转发至第三方应用服务器时,若该服务器故障导致消息无法及时处理,IoT物联网平台将会积压数据。考虑到用户对数据实时性的要求,我们支持清理积压在转发通道中的数据,以确保数据的及时处理和传输。 例如:当定时上报用户使用量的水表将数据发送至目标服务器时,由于服务器出现故障导致数据积压
数据转发至OBS长期存储 场景说明 对于设备上报的数据,可以选择让平台将设备上报数据推送给应用服务器,由应用服务器进行保存;还可以选择让平台将设备上报数据转发给对象存储服务(OBS),由OBS进行存储。 本示例为将所有设备上报的数据转发至OBS存储。 创建OBS桶 登录华为云官方网站,访问对象存储服务。
数据转发至Kafka存储 场景说明 对于设备上报的数据,可以选择让平台将设备上报数据推送给应用服务器,由应用服务器进行保存;还可以选择让平台将设备上报数据转发给分布式消息服务(Kafka),由Kafka进行存储。 本示例为将所有设备上报的数据转发至Kafka存储。 购买Kafka实例
将设备上报的二进制码流解码成JSON格式的数据,发送给应用服务器。 将应用服务器响应的JSON格式数据编码成二进制码流,下发给设备。 命令下发流程 图2 命令下发编解码插件流程 在命令下发流程中,有两处需要用到编解码插件: 将应用服务器下发的JSON格式数据编码成二进制码流,下发给设备。
重置设备密钥 功能介绍 应用服务器可调用此接口重置设备密钥,携带指定密钥时平台将设备密钥重置为指定的密钥,不携带密钥时平台将自动生成一个新的随机密钥返回。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/devices/{device_id}/action
修改规则触发条件 功能介绍 应用服务器可调用此接口修改物联网平台中指定规则条件的配置参数。 调用方法 请参见如何调用API。 URI PUT /v5/iot/{project_id}/routing-rule/rules/{rule_id} 表1 路径参数 参数 是否必选 参数类型
List<ServiceEvent> 参数解释: 事件服务列表。 ServiceEvent定义表 字段名 必选/可选 类型 参数描述 service_id 必选 String 参数解释: 系统字段。 取值范围: 固定为:"$device_config"。 event_type 必选
连接成功。 连接成功。 0x01 请求拒绝,协议版本错误。 服务器不支持客户端请求MQTT协议版本。 0x02 请求拒绝,无效的客户端标识符。 clientId不符合格式要求或者心跳时间间隔不满足平台要求。 0x03 请求拒绝,服务器不可用。 平台服务不可用。 0x04 请求拒绝,用户名或密码错误。
设备的产品模型中定义了物联网平台可向设备下发的命令,应用服务器可调用此接口向指定设备下发命令,以实现对设备的同步控制。平台负责将命令以同步方式发送给设备,并将设备执行命令结果同步返回, 如果设备没有响应,平台会返回给应用服务器超时,平台超时时间是20秒。如果命令下发需要超过20秒,建议采用消息下发。
设备消息上报 接口说明 用于设备将自定义数据上报给平台,平台将设备上报的消息转发给应用服务器或华为云其他云服务上进行存储和处理。 URI 请求方法 POST URI /v5/devices/{device_id}/sys/messages/up 传输协议 HTTPS 请求参数 名称
转发两种类型。 订阅推送 订阅:是指应用服务器通过调用物联网平台的API接口,向平台获取发生变更的设备业务信息(如设备注册、设备数据上报、设备状态等)和管理信息(软固件升级状态和升级结果)。 推送:是指订阅成功后,物联网平台根据应用服务器订阅的数据类型,将对应的变更信息推送给指定的URL地址或AMQP消息队列。
查询设备 功能介绍 应用服务器可调用此接口查询物联网平台中指定设备的详细信息。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/devices/{device_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id
全新升级后的设备接入服务获取设备数据,需要通过规则引擎,将数据转发至其他服务获取。例如转发至OBS存储,转发至DIS或DMS后再发送至应用服务器。 父主题: 方案咨询
创建并初始化函数 创建证书策略使用云证书时,需要去云证书管理服务创建云证书 云证书管理服务(Cloud Certificate Manager Service,CCM) 创建私有CA 父主题: 产品介绍
绑定设备策略 功能介绍 应用服务器可调用此接口在物联网平台上为批量设备绑定目标策略,目前支持绑定目标类型为:设备、产品,当目标类型为产品时,该产品下所有设备都会生效。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/device-po
重试批量任务 功能介绍 应用服务器可调用此接口重试批量任务,目前只支持task_type为firmwareUpgrade,softwareUpgrade。如果task_id对应任务已经成功、停止、正在停止、等待中或初始化中,则不可以调用该接口。如果请求Body为{},则调用该接口