检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
安全认证。在物联网平台的使用中,可用于物联网平台向应用服务器采用HTTPS协议推送数据时,物联网平台认证应用服务器的合法性。本文以Windows环境为例,介绍通过Openssl工具制作调测证书的方法,生成的证书为PEM编码格式的证书,后缀为.cer。 常见的证书存储格式如下表所示。
下发设备命令 功能介绍 设备的产品模型中定义了物联网平台可向设备下发的命令,应用服务器可调用此接口向指定设备下发命令,以实现对设备的同步控制。平台负责将命令以同步方式发送给设备,并将设备执行命令结果同步返回, 如果设备没有响应,平台会返回给应用服务器超时,平台超时时间是20秒。如
获取IAM用户Token接口获取,接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 Instance-Id 否 String 参数说明:实例ID。物理多租下各实例的唯一标识,一般华为云租户无需携带该参数,
属性“W”才可下发 该接口仅支持配置单个设备的设备影子的预期数据,如需多个设备的设备影子配置,请参见 创建批量任务。 限制: 设备影子JSON文档中的key不允许特殊字符:点(.)、dollar符号($)、空char(十六进制的ASCII码为00)。如果包含了以上特殊字符则无法正常刷新影子文档。
选择“对象存储服务(OBS)” 区域 选择OBS服务的所在区域。若未授权访问此区域的服务,请根据界面提示,配置云服务访问授权。 存储桶 选择要存储数据的桶。若没有,请前往OBS服务创建桶。 图3 新建转发目标-转发至OBS-JSON格式 单击“启动规则”,激活配置好的数据转发规则。 图4 启动规则-转发至OBS
设备侧获取平台的设备影子数据 功能介绍 用于设备向平台获取设备影子数据。用户可以通过应用服务器或物联网控制台配置设备影子预期数据,设备上线时订阅该topic,可以获取到平台设备影子数据,以此来同步设备属性期望值,从而完成设备属性值的修改。 简单交互逻辑介绍如下: ① 应用调用“配置设备影
“动作类型”选择“下发命令”,下发设备选择步骤6创建的设备; 服务选择“deviceSwitch”,命令选择“ON_OFF”,单击“参数配置”,“power”的值选择“OFF”,然后单击“确定”。 验证操作 您可以使用配置设备接入服务时注册的真实设备接入平台,上报“temperature”大于80的数据。 您也可以使用模拟器模拟设备订阅Topic:
查询产品 功能介绍 应用服务器可调用此接口查询已在物联网平台的创建的指定产品模型详细信息,包括产品模型的服务、属性、命令等。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/products/{product_id} 表1 路径参数 参数
参数说明:OBS服务对应的projectId信息 bucket_name String 参数说明:OBS服务对应的桶名称 location String 参数说明:OBS服务对应桶的区域 file_path String 参数说明:OBS服务中存储通道文件的自定义目录,多级目录可用
查询规则条件 功能介绍 应用服务器可调用此接口查询物联网平台中指定规则条件的配置信息。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/routing-rule/rules/{rule_id} 表1 路径参数 参数 是否必选 参数类型 描述
平台下发配置通知 功能介绍 物联网平台向设备侧下发配置通知。物联网平台为用户提供远程配置功能,用户可以在不中断设备运行的情况下,远程更新设备的系统参数、运行参数等配置信息。例如:Windows的收银台机器,需要通过远程配置修改一些系统参数;车联网中的T-BOX,需要通过远程配置修改设备侧的一些数据上报频率等。
0版本请求和响应模式中的相关数据,可选。用户可以通过该参数配置MQTT协议请求和响应模式中的相关数据。 取值范围:长度不超过128,只允许字母、数字、下划线(_)、连接符(-)的组合。 response_topic String 参数说明:MQTT 5.0版本请求和响应模式中的响应主题,可
pulse:设备上报的数据满足条件则触发,不判断上一次上报的数据。 reverse:设备上一次上报的数据不满足条件,本次上报的数据满足条件则触发。 event_valid_time Integer 参数说明:设备数据的有效时间,单位为秒,设备数据的产生时间以上报数据中的eventTime为基准。
pulse:设备上报的数据满足条件则触发,不判断上一次上报的数据。 reverse:设备上一次上报的数据不满足条件,本次上报的数据满足条件则触发。 event_valid_time 否 Integer 参数说明:设备数据的有效时间,单位为秒,设备数据的产生时间以上报数据中的eventTime为基准。
规则名称 创建的规则名称。 规则描述 对该规则的描述。 数据来源 设备:将操作设备的信息,如设备添加、设备删除、设备更新设置为数据来源。当数据来源选择“设备”时,不支持快速配置。 设备属性:将归属在某个资源空间下的设备上报给平台的属性值设置为数据来源。单击右侧的“快速配置”勾选需要转发的产品、属性、服务等数据。
修改规则触发条件 功能介绍 应用服务器可调用此接口修改物联网平台中指定规则条件的配置参数。 调用方法 请参见如何调用API。 URI PUT /v5/iot/{project_id}/routing-rule/rules/{rule_id} 表1 路径参数 参数 是否必选 参数类型
设备上报配置响应 功能介绍 设备上报配置结果响应。创建远程配置任务时,可以配置超时时间(1-30天,不配置默认30天)。在超时时间内,平台每24小时向设备下发一次配置,直到设备上报配置响应。如果设备在超时时间内一直没有上报配置响应,则平台显示该设备配置任务超时失败。 Topic 上行:
创建设备代理 功能介绍 应用服务器可调用此接口在物联网平台创建一个动态设备代理规则,用于子设备自主选择网关设备上线和上报消息,即代理组下的任意网关下的子设备均可以通过代理组里其他设备上线(网关更新子设备状态 )然后进行数据上报(网关批量设备属性上报 )。 单实例最多可以配置10个设备代理 单账号调用该接口的
远程配置 平台下发配置通知 设备上报配置响应 父主题: 设备侧MQTT/MQTTS接口参考
自定义域名允许设备指定要连接到 IoTDA 的自定义完全限定域名 (FQDN)。使用自定义域名,用户可以管理自己的服务器证书,例如用于签署证书的根证书颁发机构 (CA)、签名算法、以及证书的生命周期。 使用场景 自己管理服务器证书的根证书颁发机构 (CA)、签名算法、以及证书的生命周期等。 出于品牌推广目的向客户公开公司自己的域名。