检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
物联网平台采用HTTPS协议向应用服务器进行消息推送时,物联网平台需要校验应用服务器的真实性,需要在物联网平台上加载CA证书,该证书由应用服务器侧提供(调测时可自行制作调测证书,商用时建议更换为商用证书,否则会带来安全风险)。 推送机制:物联网平台向应用服务器推送消息后,如果应用服务器接收消息成功,会向物联网平台返回200
程配置將直接失败。 平台感知设备是否在线,当设备在线时立即下发配置给设备。当设备不在线时,等待设备上线订阅远程配置Topic,平台感知设备上线后下发配置。在创建远程配置任务时可以选择配置超时时间(1-30天),默认30天。 设备完成配置更新后,调用远程配置响应接口向物联网平台反馈配置更新结果。
设备消息上报 接口说明 用于设备将自定义数据上报给平台,平台将设备上报的消息转发给应用服务器或华为云其他云服务上进行存储和处理。 URI 请求方法 POST URI /v5/devices/{device_id}/sys/messages/up 传输协议 HTTPS 请求参数 名称
status,Event:update)、创建规则动作并激活规则后,当命令状态变更时,物联网平台会根据规则将结果发送到规则指定的服务器,如用户自定义的HTTP服务器,AMQP服务器,以及华为云的其他存储服务器等, 详情参考设备命令状态变更通知。 注意: 此接口适用于NB设备异步命令下发,暂不支持其他协议类型设备命令下发。
查询设备影子数据 功能介绍 应用服务器可调用此接口查询指定设备的设备影子信息,包括对设备的期望属性信息(desired区)和设备最新上报的属性信息(reported区)。 设备影子介绍: 设备影子是一个用于存储和检索设备当前状态信息的JSON文档。 每个设备有且只有一个设备影子,由设备ID唯一标识
设备的产品模型中定义了物联网平台可向设备下发的命令,应用服务器可调用此接口向指定设备下发命令,以实现对设备的同步控制。平台负责将命令以同步方式发送给设备,并将设备执行命令结果同步返回, 如果设备没有响应,平台会返回给应用服务器超时,平台超时时间是20秒。如果命令下发需要超过20秒,建议采用消息下发。
需要由应用服务器实现对应逻辑。 设备接入服务提供规则引擎功能,平台上简单几步操作即可实现数据上报特定数据时平台自动下发指定命令,减少应用服务器开发工作量。 示例场景 本示例为设备自带的温度传感器上报的温度大于80度时,平台自动下发命令关闭设备。 操作步骤如下: 1.配置设备接入服
的服务,请根据界面提示,配置云服务访问授权。 存储桶 选择要存储数据的桶。若没有,请前往OBS服务创建桶。 图3 新建转发目标-转发至OBS-JSON格式 单击“启动规则”,激活配置好的数据转发规则。 图4 启动规则-转发至OBS 验证操作 您可以使用配置设备接入服务时注册的真实设备接入平台,上报任意数据。
用于设备向平台获取设备影子数据。用户可以通过应用服务器或物联网控制台配置设备影子预期数据,设备上线时订阅该topic,可以获取到平台设备影子数据,以此来同步设备属性期望值,从而完成设备属性值的修改。 简单交互逻辑介绍如下: ① 应用调用“配置设备影子预期数据”接口或在控制台配置设备影子数据; ② 设备侧
远程配置 平台下发配置通知 设备上报配置响应 父主题: 设备侧MQTT/MQTTS接口参考
设备上报配置响应 功能介绍 设备上报配置结果响应。创建远程配置任务时,可以配置超时时间(1-30天,不配置默认30天)。在超时时间内,平台每24小时向设备下发一次配置,直到设备上报配置响应。如果设备在超时时间内一直没有上报配置响应,则平台显示该设备配置任务超时失败。 Topic 上行:
创建设备代理 功能介绍 应用服务器可调用此接口在物联网平台创建一个动态设备代理规则,用于子设备自主选择网关设备上线和上报消息,即代理组下的任意网关下的子设备均可以通过代理组里其他设备上线(网关更新子设备状态 )然后进行数据上报(网关批量设备属性上报 )。 单实例最多可以配置10个设备代理 单账号调用该接口的
(FQDN)。使用自定义域名,用户可以管理自己的服务器证书,例如用于签署证书的根证书颁发机构 (CA)、签名算法、以及证书的生命周期。 使用场景 自己管理服务器证书的根证书颁发机构 (CA)、签名算法、以及证书的生命周期等。 出于品牌推广目的向客户公开公司自己的域名。 迁移场景继承自己原有的域名和服务器证书。 使用限制
平台下发配置通知 功能介绍 物联网平台向设备侧下发配置通知。物联网平台为用户提供远程配置功能,用户可以在不中断设备运行的情况下,远程更新设备的系统参数、运行参数等配置信息。例如:Windows的收银台机器,需要通过远程配置修改一些系统参数;车联网中的T-BOX,需要通过远程配置修改设备侧的一些数据上报频率等。
AT+HMPKS 该指令用于设置服务器或者客户端证书。 指令 参数 参数缺省处理 AT响应结果 使用示例 AT+HMPKS =type, para1,[para2] type=0,表示平台证书,证书在para1中。 type=1,表示设备公钥证书,证书在para1中。 type=
channel_detail ChannelDetail object 通道配置信息。 表20 ChannelDetail 参数 参数类型 描述 http_forwarding HttpForwarding object 参数说明:http服务器转发消息内容。当channel为HTTP_FORWARDING时,必填。
查询产品 功能介绍 应用服务器可调用此接口查询已在物联网平台的创建的指定产品模型详细信息,包括产品模型的服务、属性、命令等。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/products/{product_id} 表1 路径参数 参数
创建设备 功能介绍 应用服务器可调用此接口在物联网平台创建一个设备,仅在创建后设备才可以接入物联网平台。 该接口支持使用gateway_id参数指定在父设备下创建一个子设备,并且支持多级子设备,当前最大支持二级子设备。 该接口同时还支持对设备进行初始配置,接口会读取创建设备请求参
数据转发至Kafka存储 场景说明 对于设备上报的数据,可以选择让平台将设备上报数据推送给应用服务器,由应用服务器进行保存;还可以选择让平台将设备上报数据转发给分布式消息服务(Kafka),由Kafka进行存储。 本示例为将所有设备上报的数据转发至Kafka存储。 购买Kafka实例
查询规则条件 功能介绍 应用服务器可调用此接口查询物联网平台中指定规则条件的配置信息。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/routing-rule/rules/{rule_id} 表1 路径参数 参数 是否必选 参数类型 描述