检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
查询设备下队列中的命令 功能介绍 查询设备下队列中的命令(处理中的命令),包含PENDING、SENT、DELIVERED三种状态,注意:DELIVERED状态的命令经过系统设定的一段时间(具体以系统配置为准)仍然没有更新,就会从队列中移除,变为历史命令。 调用方法 请参见如何调用API。
网关批量设备属性上报 功能介绍 用于批量设备上报属性数据给平台。网关设备可以用此接口同时上报多个子设备的属性数据。网关与子设备关系,请查看网关与子设备。 属性上报和消息上报的区别,请查看消息通信说明。 网关批量设备属性上报,单批次最多可上报100个子设备的属性数据。如果子设备数量超过100个,建议分不同批次进行上报。
错误码 当您调用API时,如果遇到“APIGW”开头的错误码,请参见API网关错误码进行处理。 更多服务错误码请参见API错误中心。 状态码 错误码 错误信息 描述 处理措施 200 IOTDA.014111 Command request timed out. Check whether
下发异步设备命令 功能介绍 设备的产品模型中定义了物联网平台可向设备下发的命令,应用服务器可调用此接口向指定设备下发异步命令,以实现对设备的控制。平台负责将命令发送给设备,并将设备执行命令结果异步通知应用服务器。 命令执行结果支持灵活的数据流转,应用服务器通过调用物联网平台的创建
Topic通信场景迁移实践 本文以自建MQTT Broker的空调控制设备迁移到华为云IoT为例,介绍如何进行Topic通信场景的设备迁移。 业务场景说明 自建MQTT Broker基于MQTT协议的上行数据和下行指令的业务定义如下: 表1 业务场景 业务场景 通信Topic 报文Payload
数据转发至MySQL存储 场景说明 对于平台的流转数据可以选择让平台将设备上报数据转发给云数据库(MySQL),由MySQL进行存储,用户无需做额外的数据存储代码开发即可使用设备数据进行业务处理。 本示例为将流转数据转发至MySQL存储。 前提条件 已购买设备接入服务的企业版实例或标准版实例。
设备集成相关问题 如何获取设备对接地址? 登录设备接入服务控制台,在左侧菜单栏单击“IoTDA实例”,选择您的实例并单击实例卡片进入。 图1 实例管理-切换实例 在左侧导航栏单击总览,单击“接入信息”,找到您的设备对接地址。 图2 总览-获取接入信息 使用X.509方式接入的设备,证书必须是权威机构认证的吗?
设备认证凭证管理 认证凭证介绍 当设备接入物联网平台时,设备需要携带认证凭证在平台鉴权。当前平台支持的认证凭证有: 密钥认证:注册设备时在物联网平台提前预置的设备密钥,平台会使用在注册设备时预置的密钥对设备进行认证。认证通过后,设备完成激活,然后与平台进行通信。在平台预置的密钥分为:
产品规格 基础版、标准版和企业版的对比 设备接入服务(IoTDA)提供基础版(2023年1月1日前)、标准版(标准实例)和企业版(专享实例)三种实例类型。开通设备接入服务后,默认开通标准版免费单元S0,按需付费使用,标准版更多规格和企业版需要您购买对应实例。详细差异请参考下表。 表1
查询设备列表 功能介绍 应用服务器可调用此接口查询物联网平台中的设备信息列表。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/devices 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数说明:项目ID。获取方法请参见
查询设备组设备列表 功能介绍 应用服务器可调用此接口查询指定设备组下的设备列表。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/device-group/{group_id}/devices 表1 路径参数 参数 是否必选 参数类型 描述
添加标签 给IoTDA实例添加标签有以下两种方法。 在实例详情页添加标签 在标签管理页面添加标签 预定义标签的使方法请参考预定义标签的使用方法。 在实例详情页添加标签 访问设备接入服务,单击“管理控制台 ”进入设备接入控制台。 选择左侧导航栏“IoTDA实例”,单击企业版实例对应的“详情”进入实例详情页面。
数据转发至MongoDB存储 场景说明 对于平台的流转数据可以选择让平台将设备上报数据转发给文档数据库服务(DDS),由DDS进行存储(华为云DDS完全兼容MongoDB协议),用户无需做额外的数据存储代码开发即可使用设备数据进行业务处理。本示例为将流转数据转发至文档数据库服务存储。
非托管部署 通过泛协议SDK开发的插件镜像可以通过华为云的ECS服务器或者云容器实例进行部署和自运维。本章节介绍如何用华为云的云容器实例(CCI)进行 泛协议镜像的部署。 创建命名空间 登录云容器实例管理控制台。 在左侧导航栏中选择“命名空间”,在右侧页面中“通用计算型”命名空间下单击“创建”。
文件上传 概述 华为物联网平台支持设备将运行日志,配置信息等文件上传至平台,便于用户进行日志分析、故障定位、设备数据备份等。当设备采用HTTPS方式将文件上传到OBS服务进行备份时,您可以在OBS服务管理已上传的设备文件。 业务流程 图1 文件上传流程图 1. 授权物联网平台访问OBS服务。
创建产品 在物联网平台中,某一类具有相同能力或特征的设备的合集被称为一款产品。 操作步骤 访问设备接入服务,单击“管理控制台”进入设备接入控制台。选择您的实例,单击实例卡片进入。 单击左侧导航栏“产品”,单击页面左侧的“创建产品”。根据页面提示填写参数,然后单击“确定”,完成产品的创建。
产品删除通知 功能介绍 应用服务器在调用物联网平台的创建规则触发条件(Resource:product,Event:delete)、创建规则动作、修改规则触发条件接口配置并激活规则后,当物联网平台中的产品删除时,物联网平台会向应用服务器推送通知消息。 URI POST /由应用服务器创建产品删除通知规则的转发目标决定
设备属性上报 接口说明 用于设备按产品模型中定义的格式将属性数据上报给平台。 URI 请求方法 POST URI /v5/devices/{device_id}/sys/properties/report 传输协议 HTTPS 请求参数 名称 必选 类型 位置 说明 access_token
创建规则 功能介绍 应用服务器可调用此接口在物联网平台创建一条规则。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/rules 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数说明:项目ID。获取方法请参见
设备更新通知 功能介绍 应用服务器在调用物联网平台的创建规则触发条件(Resource:device,Event:update)、创建规则动作、修改规则触发条件接口配置并激活规则后,当物联网平台中的设备更新时,物联网平台会向应用服务器推送通知消息。 URI POST /由应用服务器创建设备更新通知规则的转发目标决定