# 设备接入 IoTDA > 安全可靠接入海量设备 ## 功能总览 - [功能总览](https://support.huaweicloud.com/function-iothub/index.md): 设备接入服务(IoTDA)是华为云的物联网平台,提供海量设备连接上云、设备和云端双向消息通信、批量设备管理、远程控制和监控、OTA升级、设备联动规则等能力,并可将设备数据灵活流转到华为云其他服务。 ## 服务公告 - [漏洞修复策略](https://support.huaweicloud.com/bulletin-iothub/iot_oo2.md): IoTDA漏洞修复周期SDK漏洞:针对IoTDA提供的SDK所涉及的漏洞会根据风险等级在修复时间内对外发布修复版本,由客户自行升级SDK版本进行修复。针对IoTDA提供的SDK所涉及的漏洞会根据风险等级在修复时间内对外发布修复版本,由客户自行升级SDK版本进行修复。其他漏洞:按照版本正常升级流程解决。按照版本正常升级流程解决。修复声明为了 ## 计费说明 - [计费概述](https://support.huaweicloud.com/price-iothub/iot_price_00001.md): 通过阅读本文,您可以快速了解设备接入服务的计费模式、计费项、续费、欠费等主要计费信息。计费模式设备接入服务提供包年/包月和按需计费两种计费模式,以满足不同场景下的用户需求。包年/包月是一种预付费模式,即先付费再使用,按照订单的购买周期进行结算,因此在购买之前,您必须确保账户余额充足。按需计费是一种后付费模式,即先使用再付费,按照实际产生的 - [计费模式概述](https://support.huaweicloud.com/price-iothub/iot_price_00011.md): 设备接入服务提供按需计费、包年/包月两种计费模式,以满足不同场景下的用户需求。包年/包月:一种预付费模式,即先付费再使用,按照订单的购买周期进行结算。购买周期越长,享受的折扣越大。一般适用于设备需求量长期稳定的成熟业务。按需计费:一种后付费模式,即先使用再付费,按照实际使用时长计费。按需计费模式允许您根据实际业务需求灵活地调整资源使用。表 - [包年/包月](https://support.huaweicloud.com/price-iothub/iot_price_00012.md): 包年/包月是一种先付费再使用的计费模式,适用于对资源需求稳定且希望降低成本的用户。通过选择包年/包月的计费模式,您可以预先购买云服务资源并获得一定程度的价格优惠。本文将介绍包年/包月设备接入服务的计费规则。包年/包月计费模式需要用户预先支付一定时长的费用,适用于长期、稳定的业务需求。以下是一些适用于包年/包月计费模式的业务场景:稳定业务需 - [按需计费](https://support.huaweicloud.com/price-iothub/iot_price_00013.md): 按需计费是一种先使用再付费的计费模式,适用于无需任何预付款或长期承诺的用户。本文将介绍按需计费设备接入资源的计费规则。按需计费适用于具有不能中断的短期、突增或不可预测的应用或服务,例如电商抢购、临时测试、科学计算。以下计费项支持按需计费。按需计费设备接入标准版资源按小时计费,不足1小时按实际使用时长计算,每小时0分结算一次费用,结算完毕后 - [计费项](https://support.huaweicloud.com/price-iothub/iot_price_00020.md): 设备接入服务的计费项具体内容如表1所示。表2说明了哪些消息会作为计费消息数算入实例的每日消息数和消息上下行TPS。 - [计费样例](https://support.huaweicloud.com/price-iothub/iot_price_00030.md): 某用户于2023/03/18 15:30:00开通了包月计费标准版实例,实例规格配置如下:服务单元类型:低频单元S1服务单元数量:5个购买时长:5个月用了一段时间后,用户发现实例当前规格无法满足业务需要,于2023/05/20 9:00:00扩容规格为中频单元S2,单元数量10个。至5个月购买时长到期。共产生多少费用呢?可以将这一设备接入 - [按需转包年/包月](https://support.huaweicloud.com/price-iothub/iot_price_00091.md): 如果您需要长期使用设备接入标准版服务,可以将设备接入标准版实例转为包年/包月计费模式,以节省开支。按需计费变更为包年/包月会生成新的订单,用户支付订单后,包年/包月资源将立即生效。假设用户于2023/04/18 15:29:16开通了按需计费的标准版低频单元S1实例,由于业务需要,于2023/04/18 16:30:30执行按需转包年/包 - [包年/包月转按需](https://support.huaweicloud.com/price-iothub/iot_price_00092.md): 购买包年/包月设备接入实例后,您可以将该设备接入实例的计费模式转为按需计费,回收部分成本,同时更加灵活地使用设备接入服务。包年/包月转按需,支持两种方式:即时转按需:按需的计费模式立即生效。到期转按需:包年/包月计费模式到期后,按需的计费模式才会生效。当前只有设备接入标准版实例支持包年/包月转按需。只有通过实名认证的客户,才可以执行包年/ - [续费概述](https://support.huaweicloud.com/price-iothub/iot_price_00041.md): 设备接入实例到期后会影响实例正常使用。如果您想继续使用,需要在指定的时间内为设备接入实例续费,否则资源会自动释放,数据丢失且不可恢复。续费操作仅适用于包年/包月设备接入实例。按需计费设备接入实例不需要续费,只需要保证账户余额充足即可。设备接入实例在到期前续费成功,所有资源得以保留,且实例运行不受影响。设备接入实例到期后的状态说明,请参见到 - [手动续费](https://support.huaweicloud.com/price-iothub/iot_price_00042.md): 可在“手动续费项”、“自动续费项”、“到期转按需项”、“到期不续费项”页签查询全部待续费资源,对资源进行手动续费的操作。所有需手动续费的资源都可归置到“手动续费项”页签,具体操作请参见如何恢复为手动续费。单个续费:在资源页面找到需要续费的资源,单击操作列的“续费”。单个资源续费批量续费:在资源页面勾选需要续费的资源,单击列表左上角的“批量 - [自动续费](https://support.huaweicloud.com/price-iothub/iot_price_00043.md): 自动续费可以减少手动续费的管理成本,避免因忘记手动续费而导致设备接入实例被自动删除。自动续费的规则如下所述:设备接入实例自动续费周期根据您开通自动续费的途径不同,遵循不同的规则。在设备接入实例到期前均可开通自动续费,到期前7日凌晨3:00首次尝试自动续费,如果扣款失败,每天凌晨3:00尝试一次,直至设备接入实例到期或者续费成功。开通自动续 - [费用账单](https://support.huaweicloud.com/price-iothub/iot_price_00050.md): 您可以在“费用 > 费用账单”查看资源的费用账单,以了解该资源在某个时间段的使用量和计费信息。包年/包月计费模式的资源完成支付后,会实时上报一条账单到计费系统进行结算。按需计费模式的资源按照固定周期上报使用量到计费系统进行结算。按需计费模式产品根据使用量类型的不同,分为按小时和按月两种周期进行结算,具体扣费规则可以参考按需产品周期结算说明 - [欠费说明](https://support.huaweicloud.com/price-iothub/iot_price_00060.md): 用户在使用云服务时,账户的可用额度小于待结算的账单,即被判定为账户欠费。欠费后,可能会影响云服务资源的正常运行,请及时充值。在按需计费模式下账户的余额不足。包年/包月对于包年/包月设备接入资源,用户已经预先支付了资源费用,因此在账户出现欠费的情况下,已有的包年/包月设备接入资源仍可正常使用。对于包年/包月设备接入资源,用户已经预先支付了资 - [停止计费](https://support.huaweicloud.com/price-iothub/iot_price_00070.md): 对于包年/包月计费模式的资源,例如包年/包月的设备接入实例,用户在购买时会一次性付费,服务将在到期后自动停止使用。如果在计费周期内不再使用包年/包月资源,您可以执行退订操作,系统将根据资源是否属于五天无理由退订、是否使用代金券和折扣券等条件返还一定金额到您的账户。详细的退订规则请参见云服务退订规则概览。如果您已开启“自动续费”功能,为避免 - [成本管理](https://support.huaweicloud.com/price-iothub/iot_price_00080.md): 随着上云企业越来越多,企业对用云成本问题也越发重视。如何进行成本管理,减轻业务负担呢?本文将从成本构成、成本分配、成本分析和成本优化四个维度介绍成本管理,帮助您通过成本管理节约成本,在保障业务快速发展的同时获得最大成本收益。华为云成本中心可以帮助您更高效地管理资源成本,但运维成本需要您自行识别、管理和优化。成本管理的基础是树立成本责任制, - [计费FAQ](https://support.huaweicloud.com/price-iothub/iot_price_00100.md): 什么情况下客户的华为云业务会被冻结?资源冻结的类型有哪些?冻结后对续费、退订有什么影响?如果是客户购买的IoTDA欠费了,会先冻结实例。另外,华为侧会根据云服务欠费的场景人工决定是否冻结客户账号。客户可以查看已购买的实例,设备的连接和上报数据不受影响。客户无法购买新的设备接入实例。客户无法对已购买的实例进行任何操作,包括变更规格、按需转包 ## 产品介绍 - [什么是设备接入IoTDA](https://support.huaweicloud.com/productdesc-iothub/iot_04_0002.md): 华为云物联网平台设备接入云服务(IoTDA)提供海量设备的接入和管理能力,将物理设备连接到云,支撑设备数据采集上云和云端下发命令给设备进行远程控制,配合华为云其他产品,帮助您快速构筑物联网解决方案。使用物联网平台构建一个完整的物联网解决方案主要包括3部分:物联网平台、业务应用和设备。物联网平台作为连接业务应用和设备的中间层,屏蔽了各种复杂 - [产品优势](https://support.huaweicloud.com/productdesc-iothub/iothub_04_0003.md): 随着业务的发展,越来越多的企业选择结合物联网技术来实现自身效益增长。相比企业自建MQTT集群,使用华为云IoT服务低成本构建物联网解决方案,在能力、成本、运维、安全、生态等诸多方面具有突出优势。 - [应用场景](https://support.huaweicloud.com/productdesc-iothub/iot_04_0044.md): 华为云物联网平台提供海量设备的接入和管理能力,支持设备数据采集上云和云端下发消息给设备,本文将介绍华为云物联网平台的典型应用场景。需求场景:汽车厂商通过车联网平台实现车辆的便捷接入和管理,需要支持JT/T808、MQTT等协议传输数据到云端,并做数据清洗处理,便于后续做大数据分析和数据挖掘。解决方案:华为云物联网平台支持安全可靠、低时延的 - [产品规格](https://support.huaweicloud.com/productdesc-iothub/iot_04_0014.md): 设备接入服务(IoTDA)提供基础版(2023年1月1日前)、标准版(标准实例)和企业版(专享实例)三种实例类型。开通设备接入服务后,默认开通标准版免费单元S0,按需付费使用,标准版更多规格和企业版需要您购买对应实例。详细差异请参考下表。设备接入的基础版、标准版和企业版,它们之间在功能上的异同点如下表所示。设备接入服务(IoTDA)基础版 - [使用限制](https://support.huaweicloud.com/productdesc-iothub/iot_04_0010.md): 用户在IoT物联网平台开发或使用时有以下技术规格限制,如果限制数量不能满足您的业务需求,请提交工单说明您的需求。应用侧API使用限制如下:单个账号调用API的每秒最大次数:基础版、标准版:100/s、企业版请参考企业版规格。 - [身份认证与访问控制](https://support.huaweicloud.com/productdesc-iothub/iot_04_00114.md): 用户访问IoTDA的所有接口都需要携带身份凭证,并进行身份的合法性校验。IoTDA不同的接入场景需要携带不同的身份凭证,主要有如下四种场景:IoTDA应用侧接口支持IAM Token认证和访问密钥(AK/SK)认证两种认证方式进行认证鉴权,关于Token和访问密钥的详细介绍和获取方式,请参考认证鉴权。设备侧MQTT连接鉴权,需要携带Cli - [数据保护技术](https://support.huaweicloud.com/productdesc-iothub/iot_04_00115.md): 责任共担模式适用于IoTDA的数据保护,如该模式中所述,IoTDA负责服务自身的安全,提供安全的数据保护机制。用户负责安全地使用IoTDA服务,包括使用时的安全参数配置以及维护使用IoTDA及其依赖的其他云服务权限的控制。 - [审计与日志](https://support.huaweicloud.com/productdesc-iothub/iot_04_00116.md): 云审计服务(Cloud Trace Service,CTS),是华为云安全解决方案中专业的日志审计服务,提供对各种云资源操作记录的收集、存储和查询功能,可用于支撑安全分析、合规审计、资源跟踪和问题定位等常见应用场景。CTS的详细介绍和开通配置方法,请参见CTS入门指引。用户在使用物联网平台的过程中,通过云审计服务(Cloud Trace - [监控安全风险](https://support.huaweicloud.com/productdesc-iothub/iot_04_00117.md): IoTDA提供了多个维度的监控运维能力,包括设备消息跟踪,查看报表,告警管理以及设备异常检测,方便用户实时掌握所有接入IoTDA的设备信息。设备消息跟踪:在设备鉴权,命令下发,数据上报,平台数据转发等业务场景发生故障时,可以通过消息跟踪进行快速定位和原因分析。查看报表:IoTDA为用户提供了丰富的报表功能,用户可以通过不同维度查看各类报表 - [认证证书](https://support.huaweicloud.com/productdesc-iothub/iot_04_00118.md): 华为云服务及平台通过了多项国内外权威机构(ISO/SOC/PCI等)的安全合规认证,用户可自行申请下载合规资质证书。合规证书下载华为云还提供以下资源来帮助用户满足合规性要求,具体请查看资源中心。资源中心华为云安全服务提供了网络安全专用产品安全检测证书、软件著作权等证书,供用户下载和参考。具体请查看合规资质证书。合规资质证书 - [基础概念](https://support.huaweicloud.com/productdesc-iothub/iot_04_0011.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [权限管理](https://support.huaweicloud.com/productdesc-iothub/iot_04_0013.md): 如果您使用设备接入服务后,需要为企业中的员工设置不同的用户访问权限,以达到不同员工之间的权限隔离,您可以使用统一身份认证服务(Identity and Access Management,简称IAM)进行精细的权限管理。该服务提供用户身份认证、权限分配、访问控制等功能,可以帮助您安全的控制云服务资源的访问。IAM是华为云提供权限管理的基础 ## 快速入门 - [开通服务](https://support.huaweicloud.com/qs-iothub/iot_05_00017.md): 本章节介绍如何在“华北-北京四”区域开通一个标准版免费实例单元,以进行IoTDA平台快速入门的体验。 - [向导式体验智慧烟感接入平台](https://support.huaweicloud.com/qs-iothub/iot_05_00010.md): 如果您没有IoT设备,但想快速体验设备数据采集和接收控制命令,可以用Windows或者Linux个人计算机作为虚拟设备,体验设备与云端的双向通信。本文以一款虚拟的智慧烟感器为例,带您快速体验平台的三个基本功能:设备连接平台,设备上报数据到平台,平台下发命令给设备。已注册华为云官方账号。未注册可单击注册页面完成注册。已完成实名制认证。未完成 - [MQTT.fx模拟智慧路灯与平台通信](https://support.huaweicloud.com/qs-iothub/iot_05_00121.md): 本文以“智慧路灯”为示例,通过MQTT.fx设备模拟器模拟智慧路灯,给您介绍基于IoTDA平台实现一款智慧路灯连接到平台、上报光照强度数据、以及平台下发开灯命令给智慧路灯三个场景。已注册华为云官方账号。未注册可单击注册页面完成注册。已完成实名制认证。未完成可在华为云上单击实名认证完成认证,否则无法使用设备接入功能。已开通设备接入服务。未开 - [智慧路灯设备SDK与平台通信(Java)](https://support.huaweicloud.com/qs-iothub/iot_05_00122.md): 本文基于Java代码演示设备通过MQTTS/MQTT协议接入华为云物联网平台,通过设备侧MQTT/MQTTS接口实现南向数据上报、命令下发的功能,通过应用侧的示例代码接收北向服务端订阅的消息示例。以智慧路灯为例,设备将光照强度等信息上报到IoT平台,应用服务器再接收从平台推送来的设备数据。确保开发环境为JDK 1.8及以上版本。已安装In - [智慧路灯设备SDK与平台通信(C)](https://support.huaweicloud.com/qs-iothub/iot_05_00123.md): 本文章节基于C代码演示设备通过MQTTS/MQTT协议接入华为云物联网平台,通过平台接口实现南向数据上报、命令下发的功能,通过应用侧的示例代码接收北向服务端订阅的消息示例。以智慧路灯为例,设备将光照强度等信息上报到IoT平台,应用服务器再接收从平台推送来的设备数据。Linux操作系统,且已安装好gcc(建议4.8及以上版本)。产品模型是用 - [入门指引](https://support.huaweicloud.com/qs-iothub/iot_05_0007.md): IoTDA服务支持设备使用MQTTS/MQTT协议接入平台并进行消息收发,本文分别以MQTT.fx和Java SDK为例介绍设备基于MQTTS/MQTT协议进行消息收发的流程。具体操作步骤如下:开通服务。您可以根据需求选择需要的实例规格和单元数量购买实例。注册设备。在设备接入服务控制台创建产品和注册设备。产品:产品是设备的集合,是指某一类 - [开通服务](https://support.huaweicloud.com/qs-iothub/iot_05_0008.md): 本章节介绍如何在“华北-北京四”区域开通一个标准版免费实例单元,以进行IoTDA平台快速入门的体验。 - [注册设备](https://support.huaweicloud.com/qs-iothub/iot_05_0009.md): 在使用IoTDA进行收发消息前,您需要创建产品和设备。 - [使用MQTT.fx进行消息收发](https://support.huaweicloud.com/qs-iothub/iot_05_0010.md): MQTT.fx是一款基于Eclipse Paho、使用Java语言编写的MQTT客户端。支持Windows、Mac和Linux操作系统,可用于模拟设备通过MQTTS/MQTT协议连接华为云IoTDA并通过Topic发布和订阅消息。本文以Windows系统为例,介绍如何使用MQTT.fx接入华为云IoTDA并进行消息收发。已注册华为云官方账 - [使用设备SDK进行消息收发](https://support.huaweicloud.com/qs-iothub/iot_05_0011.md): 设备可以通过SDK快速连接华为云IoTDA并进行消息上下行通信,本文基于Java示例代码演示设备通过MQTTS/MQTT协议接入华为云IoTDA服务并通过Topic发布和订阅消息。已注册华为云官方账号。未注册可单击注册页面完成注册。已完成实名制认证。未完成可在华为云上单击实名认证完成认证,否则无法使用设备接入功能。已开通设备接入服务。操作 - [应用快速接入](https://support.huaweicloud.com/qs-iothub/iot_05_0004.md): 为了降低应用侧的开发难度、提升应用侧开发效率,物联网平台向应用侧开放了丰富的API。本文档以在线调试(即API Explorer)和本地调试(Postman)为例,模拟应用服务器以HTTPS协议为例接入物联网平台。API Explorer提供在线API检索及接口调试,您可以使用在线调试快速接入物联网平台。使用API Explorer可以无 ## 用户指南 - [概述](https://support.huaweicloud.com/usermanual-iothub/iot_01_0015.md): 物联网平台提供海量设备的接入和管理能力,配合华为云其他产品同时使用,帮助快速构筑物联网应用,简化海量设备管理复杂性,节省人工操作,提升管理效率。使用设备接入控制台,可以实现对产品的创建、开发、调试,设备的注册、管理、鉴权、软固件升级。在设备接入控制台,可以创建规则引擎,满足用户实现设备联动和数据转发的需求;还可以存储产品和设备数据及生成相 - [实例介绍](https://support.huaweicloud.com/usermanual-iothub/iot_01_0076.md): 华为物联网平台提供实例助力解决数据和资源隔离等问题,当前华为云物联网平台提供标准版(标准实例)和企业版(专享实例)两种实例类型供您选择。标准版在标准实例下,平台提供更多的扩展功能,支持更多的服务组合能力以及行业解决方案集成适配。标准版是逻辑多租架构,不同租户之间的实例或者同一个租户的多个标准版实例之间的计算存储资源是共享的,数据是隔离的。 - [购买实例](https://support.huaweicloud.com/usermanual-iothub/iot_01_0078.md): 购买企业版实例,可以享受更好的资源隔离和管控策略。购买的资源独享,具有更高的数据可靠性和安全性。开通之前,请浏览整体开通流程,以便提高操作效率。标准实例提供灵活可配置的实例规格,适用于各类企业客户场景,可根据业务模型选购更经济的平台实例。开通之前,请浏览整体开通流程,以便提高操作效率。操作步骤 - [实例管理](https://support.huaweicloud.com/usermanual-iothub/iot_01_0079.md): 实例创建成功后,需要先切换到该实例,才可以在该实例下创建产品、设备和进行其他功能设置等。IoTDA实例购买成功后,您可以进入实例详情页面查看实例的详情信息,包括实例Id,实例名称,实例规格配置等信息。IoTDA实例创建成功后,您可以根据业务需要,升级实例规格,实例规格变更不会对业务产生影响。当实例快到期需要续费继续使用的时候,您可以单击对 - [企业版实例特殊管理](https://support.huaweicloud.com/usermanual-iothub/iot_01_01211.md): IoTDA企业版实例创建成功后,您可以根据自己的业务情况对IoTDA企业版实例的部分参数进行调整,包括实例名称、描述等信息。单击实例名称后的,修改实例名称。实例名称支持中文汉字、英文字母、数字、下划线(_)、中划线(-)。长度不能超过64个字符,一个中文汉字计一个字符。为了助力企业快速迁移上云,物联网平台提供通过公网、私网、专线等接入形式 - [标签概述](https://support.huaweicloud.com/usermanual-iothub/iot_01_0151.md): 对于拥有大量云资源的用户,可以通过给云资源打标签,快速查找具有某标签的云资源,可对这些资源标签统一进行检视、修改、删除等操作,方便用户对云资源的管理。还可利用标签功能实现基于业务维度的资源成本统计。每个标签由一对键值对(Key-Value)组成。每个IoTDA实例最多可以添加20个标签。对于每个资源,每个标签键(Key)都必须是唯一的,每 - [添加标签](https://support.huaweicloud.com/usermanual-iothub/iot_01_0152.md): 给IoTDA实例添加标签有以下两种方法。在实例详情页添加标签在标签管理页面添加标签预定义标签的使方法请参考预定义标签的使用方法。此方法适用于为多个资源统一添加拥有同样标签键的标签。如果有多种云资源需要添加同一标签,为了避免重复输入标签键和值,您可以在标签管理服务中预定义标签,然后在添加标签时直接选择键和值。具体步骤如下: - [删除标签](https://support.huaweicloud.com/usermanual-iothub/iot_01_0153.md): 如果某个标签已经不再适用于您的资源管理,您可以删除资源标签。有三种途径删除资源标签:在实例详情页删除标签在标签管理页面单个删除在标签管理页面批量删除 - [使用标签检索资源](https://support.huaweicloud.com/usermanual-iothub/iot_01_0154.md): 为云资源添加标签后,您可以通过本文所述的方法使用标签检索资源。 - [资源空间](https://support.huaweicloud.com/usermanual-iothub/iot_01_0006.md): 指在物联网平台中为您的业务划分的一个资源空间,您在平台中创建的资源(如产品、设备等)都需要归属到某个资源空间,您可以基于资源空间实现多业务应用的分域管理。物联网平台允许用户最多创建10个资源空间,并默认首次开通服务时平台为用户自动创建的空间为默认资源空间。创建资源空间时,物联网平台会分配一个app_id(接口调用时参数名为app_id)作 - [概述](https://support.huaweicloud.com/usermanual-iothub/iot_01_01271.md): 华为云物联网平台支持多种接入方式和接入协议,满足各类设备和接入场景要求。请根据设备类型,选择合适方式接入到平台。第三方协议由生态伙伴基于华为云IoT泛协议设备端SDK开发。需至云商店单独购买协议解析插件,加载到设备侧网关,再结合IoTDA共同使用。通过网关来完成协议转换,将第三方协议转成MQTT协议,从而实现泛协议接入华为物联网平台。原理 - [概述](https://support.huaweicloud.com/usermanual-iothub/iot_01_0206.md): 设备鉴权是指物联网平台对接入平台的设备进行身份认证。对于不同接入方式的设备,鉴权方式不同。 - [LwM2M/CoAP协议鉴权](https://support.huaweicloud.com/usermanual-iothub/iot_01_0208.md): LwM2M/CoAP协议鉴权支持加密与非加密两种接入方式,若设备采用非加密方式接入时,非加密端口为5683,在设备接入物联网平台时携带设备唯一标识nodeId,完成设备的接入鉴权;当设备采用加密方式接入时,加密业务数据交互端口为5684,使用DTLS/DTLS+传输层安全协议通道接入,并携带nodeId和密钥以完成设备的接入鉴权。通过调用 - [HTTPS协议鉴权](https://support.huaweicloud.com/usermanual-iothub/iot_01_0218.md): HTTPS协议鉴权是指设备通过调用HTTPS协议设备鉴权接口并携带设备ID和使用算法加密后的密钥,以完成设备的接入鉴权。鉴权成功后可以建立设备与平台间的连接,并且平台会返回用于业务处理的access_token。在调用属性上报、消息上报等其他HTTPS协议接口时,都需要携带access_token信息。如果access_token超期,需 - [MQTT(S)协议-密钥鉴权](https://support.huaweicloud.com/usermanual-iothub/iot_01_0210.md): MQTT(S)协议-密钥鉴权是指设备在接入物联网平台时,携带设备ID和密钥以完成设备的接入鉴权。对于使用MQTTS协议接入的设备,需要在设备侧预置CA证书;对于使用MQTT非安全协议接入的设备,无需在设备侧预置CA证书。通过调用注册接口向物联网平台发送注册请求或者在控制台上注册设备。注册时需要填写设备标识码,通常使用MAC地址,Seria - [MQTT(S)协议-证书鉴权](https://support.huaweicloud.com/usermanual-iothub/iot_01_0211.md): MQTT(S)协议-证书鉴权是指在设备接入物联网平台前,用户通过控制台上传设备的CA证书,然后应用服务调用创建设备接口或通过控制台在物联网平台注册设备,获取设备ID。在设备接入物联网平台时携带设备侧X.509证书(一种用于通信实体鉴别的数字证书),完成设备的接入鉴权。当前物联网平台只支持基于MQTT协议接入的设备使用X.509证书进行设备 - [自定义鉴权概述](https://support.huaweicloud.com/usermanual-iothub/iot_01_0212.md): 自定义鉴权是指用户可以通过函数服务自定义实现鉴权逻辑,以对接入平台的设备进行身份认证。在设备接入物联网平台前,用户可以通过应用服务调用控制台配置自定义鉴权信息,然后通过调用函数服务(FunctionGraph)配置自定义鉴权函数。在设备接入物联网平台时,物联网平台会获取设备ID和自定义鉴权函数名称等参数,并向FunctionGraph发起 - [自定义鉴权使用说明](https://support.huaweicloud.com/usermanual-iothub/iot_01_0213.md): username格式如下。参数传值时需去掉大括号“{}”,username的每个参数需采用分隔符“|”分隔,各参数具体内容不要出现“|”,否则可能导致鉴权失败。{device-identifier}|authorizer-name={authorizer-name}|authorizer-signature={token-signatur - [自定义模板鉴权概述](https://support.huaweicloud.com/usermanual-iothub/iot_01_0217.md): 自定义模板鉴权是指用户可以使用平台提供的内部函数实现自定义的鉴权方式,而不需使用平台默认鉴权方式,对接入平台的设备进行身份认证,用户可以通过平台预置的函数灵活编排鉴权方式。迁移场景:当设备从第三方物联网平台迁移到华为云IoTDA时,通过配置平台提供的自定义鉴权模板可以兼容原来的鉴权方式,设备侧无需改动实现无缝迁移。原生场景:自定义模板鉴权 - [自定义模板鉴权使用说明](https://support.huaweicloud.com/usermanual-iothub/iot_01_0215.md): 模板整体内容如下:设备调试成功后单击激活启用模板,一旦激活模板所有设备鉴权将使用该模板,且已激活状态下的模板不能修改,后续修改模板建议新创建一个副本模板进行调试,确认无误后进行模板切换。 - [自定义模板示例](https://support.huaweicloud.com/usermanual-iothub/iot_01_0235.md): 证书认证设备,不限制UserName与ClientId参数取值,从设备证书通用名称(Common Name)中取值设备ID。鉴权模板:设备ID格式为:${ProductId}_${NodeId}。鉴权模板:设备ID格式为:${productId}${nodeId}。鉴权模板: - [内部函数](https://support.huaweicloud.com/usermanual-iothub/iot_01_0216.md): 华为云IoTDA提供了多个内部函数供用户在模板中使用,使用时请认真阅读每个函数的功能定义,包括入参类型,参数长度,返回值类型等。整个函数必须是合法的Json格式。函数中可使用${}变量占位符或者"Ref"函数引用入参定义的参数值。函数所使用的参数必须在模板参数中声明。单一入参的函数后面直接跟参数,比如:"Fn::Base64Decode" - [LwM2M/CoAP协议接入](https://support.huaweicloud.com/usermanual-iothub/iot_01_0138.md): LwM2M(Lightweight M2M,轻量级M2M),由开发移动联盟(OMA)提出,是一种轻量级的、标准通用的物联网设备管理协议,可用于快速部署客户端/服务器模式的物联网业务。LwM2M为物联网设备的管理和应用建立了一套标准,它提供了轻便小巧的安全通信接口及高效的数据模型,以实现M2M设备管理和服务支持。物联网平台支持加密与非加密两 - [HTTPS协议接入](https://support.huaweicloud.com/usermanual-iothub/iot_01_00129.md): HTTPS是基于HTTP协议,通过SSL加密的一种安全通信协议。物联网平台支持HTTPS协议通信。物联网平台的Endpoint请参见:平台接入地址。使用“设备接入-> HTTPS(443)”对应的Endpoint,端口为443。设备使用HTTPS协议接入平台时,平台和设备通过HTTPS接口调用通信。通过这些接口,平台和设备可以实现设备鉴权 - [MQTT(S)协议接入](https://support.huaweicloud.com/usermanual-iothub/iot_01_0128.md): MQTT消息由固定报头(Fixed header)、可变报头(Variable header)和有效载荷(Payload)三部分组成。其中固定报头(Fixed header)和可变报头(Variable header)格式的填写请参考MQTT标准规范,有效载荷(Payload)的格式(须使用UTF-8编码格式)由应用定义,即由设备和物联网 - [概述](https://support.huaweicloud.com/usermanual-iothub/iot_02_0125.md): 目前平台支持基于MQTT/HTTP/LwM2M等标准协议接入,为解决用户自定义协议设备快速接入IoT平台的诉求。华为云IoT提供泛协议适配机制,您可使用泛协议对接SDK,快速构建协议插件,进行设备或平台与IoT的双向数据通信。泛协议插件开发指导可参见泛协议插件开发。设备只支持某种类型协议,而平台目前不支持该协议。设备与其接入服务器之间已有 - [JT808协议说明](https://support.huaweicloud.com/usermanual-iothub/iot_01_0142.md): JT808插件基于IoTDA泛协议插件框架开发,为终端设备提供JT808的协议接入能力。JT808泛协议插件把与JT808协议的终端设备的交互,转换为IoTDA产品中定义的属性、命令等,用户可通过IoTDA应用侧接口与JT808协议的终端设备进行交互。遵循的协议版本为JT/T 808-2019。支持的消息类型为终端管理、位置类、电子围栏、 - [设备侧对接](https://support.huaweicloud.com/usermanual-iothub/iot_02_14.md): 在左侧导航栏选择设备所有设备,单击注册设备,如下图:设备ID为“00000000000012345678”。选择产品为创建产品中的产品。IoTDA平台通过设备ID唯一标识设备,在JT808场景,使用终端设备的终端手机号作为设备ID,使终端设备与IoTDA平台的设备相对应。JT/T 808-2019协议约定终端手机号数据类型为BCD[10] - [应用侧对接](https://support.huaweicloud.com/usermanual-iothub/iot_02_15.md): 以下消息转换为IoTDA平台的属性,应用可以通过查询设备影子或者数据转发接收属性上报消息。上报位置信息对应的消息ID:0x0200推送样例:以下消息类型,应用可以通过下发同步命令的方式,给终端设备发送消息,参考下发同步命令。请使用API接口做业务调测,部分命令目前不能通过界面下发。接口说明请求对应的消息ID:0x8103响应对应的消息ID - [SL651协议说明](https://support.huaweicloud.com/usermanual-iothub/iot_01_0141.md): SL651插件支持国标SL651协议遥测站的接入和管理,IoTDA作为SL651协议中的中心站,该插件基于IoTDA泛协议插件框架开发。该插件支持将对SL651遥测站的鉴权、消息接入、命令下发等交互流程,将SL651协议消息转换为IoTDA物模型中定义的属性、命令等,用户可通过IoTDA应用侧接口与SL651协议的终端设备进行交互。遵循的 - [部署插件](https://support.huaweicloud.com/usermanual-iothub/iot_01_0134.md): 防火墙和安全组需要放通8898端口(TCP)。 - [设备侧对接](https://support.huaweicloud.com/usermanual-iothub/iot_01_0135.md): 具体步骤:IoTDA平台通过设备ID标识设备。SL651遥测站接入平台请使用SL651消息中的“遥测站地址”字段作为设备ID,使终端设备与IoTDA平台的设备相对应。设备标识码根据平台建设方和应用侧需求填写,比如根据《深圳市水务对象分类与编码规则》填写,如无特殊要求,建议和设备ID保持一致。SL651-2014协议中密码固定为4位,IoT - [HJ212协议说明](https://support.huaweicloud.com/usermanual-iothub/iot_01_0140.md): HJ212插件基于IoTDA泛协议插件框架开发,为终端设备提供HJ212的接入能力。HJ212泛协议插件把与HJ212的终端设备的交互,转换为IoTDA产品中定义的属性、命令等,用户可通过IoTDA应用侧接口与HJ212协议的终端设备进行交互。遵循的协议版本:HJ 212-2017,国家地表水自动监测系统通信协议技术要求(修改升级版)。支 - [部署插件](https://support.huaweicloud.com/usermanual-iothub/iot_01_0136.md): 具体操作:防火墙放通8890端口(TCP)。 - [设备侧对接](https://support.huaweicloud.com/usermanual-iothub/iot_01_0137.md): IoTDA平台通过设备ID标识设备。在HJ212场景中,使用HJ212消息中的MN字段作为设备ID,使终端设备与IoTDA平台的设备相对应。PW字段作为密钥和确认密钥。建议设备标识码与设备ID相同。HJ 212-2017协议规定密码最多为9位,IoTDA的设备密码至少是8位。终端设备按照协议发送心跳包(消息CN:9015),表明终端在线。 - [自定义设备侧域名](https://support.huaweicloud.com/usermanual-iothub/iot_01_0089.md): 自定义域名允许设备指定要连接到 IoTDA 的自定义完全限定域名 (FQDN)。使用自定义域名,用户可以管理自己的服务器证书,例如用于签署证书的根证书颁发机构 (CA)、签名算法、以及证书的生命周期。自己管理服务器证书的根证书颁发机构 (CA)、签名算法、以及证书的生命周期等。出于品牌推广目的向客户公开公司自己的域名。迁移场景继承自己原有 - [概述](https://support.huaweicloud.com/usermanual-iothub/iot_01_0045_2.md): 当设备和物联网平台完成对接后,设备可通过以下方式发送数据到物联网平台:资源受限或者对网络流量有要求的设备,不适合直接构造JSON数据与物联网平台通信时,可将原始二进制数据透传到物联网平台。通过开发编解码插件实现二进制数据到平台定义JSON格式的转换。若发送到平台的数据需要发到华为云其他云服务上进行存储和处理,可以通过数据转发流程功能进行转 - [设备消息上报](https://support.huaweicloud.com/usermanual-iothub/iot_01_0322.md): 消息上报是设备直接将数据传到云端,通过数据流转功能将数据转发到应用侧或华为云其他云服务的一种方式。平台对设备上报的消息不进行解析和存储,不需要建立产品模型便可以使用。平台对设备上报的数据不进行解析和存储,需要通过数据转发流程转发到华为云其他云服务上进行存储和处理的场景。单个消息内容不大于1M。单个MQTT连接最大带宽1MB/s。单个MQT - [设备属性上报](https://support.huaweicloud.com/usermanual-iothub/iot_01_0326.md): 属性上报是一种需要平台解析、缓存,通过数据流转功能将数据转发到应用侧或华为云其他云服务的一种方式。需要在平台建立产品模型。对于属性上报的数据,平台会记录属性的最新一次上报值,对符合产品模型定义的属性数据进行存储。设备可以通过设备侧获取平台的设备影子数据向平台获取最新的设备属性值。设备端及应用端需要平台进行转换、管理、缓存的数据。需要通过数 - [概述](https://support.huaweicloud.com/usermanual-iothub/iot_01_0050.md): 当设备和物联网平台完成对接后,物联网平台可通过以下方式发送数据到设备:配置且资源受限或者对网络流量有要求的设备,不适合直接接收JSON数据时,通过开发编解码插件实现应用侧JSON数据转换为设备侧二进制数据。下发设备消息查询设备消息查询设备属性修改设备属性下发同步设备命令下发异步设备命令查询命令详情平台命令下发平台消息下发平台命令下发 - [消息下发](https://support.huaweicloud.com/usermanual-iothub/iot_01_0331.md): 消息下发不依赖产品模型,提供给设备的单向通知,具有消息缓存功能;云端消息下发中,平台会以异步方式(消息下发后无需等待设备侧回复响应)下发消息给设备;若设备不在线,则在设备上线后发送数据(支持配置,最长缓存时间24小时)。平台对每个设备默认只保存20条消息,超过20条后,后续的消息会替换下发最早的消息。同时,消息下发支持使用自定义Topic - [属性下发](https://support.huaweicloud.com/usermanual-iothub/iot_01_0335.md): 属性下发分为查询设备属性和修改属性参数两种,查询设备属性用于应用侧或平台主动获取设备属性数据,修改属性参数用于应用侧或平台设置设备属性值并同步到设备侧。设备接收到属性下发指令后需要立即响应,如果设备没有响应,平台会认为属性下发执行超时。用于平台主动获取或修改设备属性值。平台规范、解析、过滤的数据。单个消息内容不大于64K。需要定义产品模型 - [命令下发](https://support.huaweicloud.com/usermanual-iothub/iot_01_0339.md): 为能有效地对设备进行管理,设备的产品模型中定义了物联网平台可向设备下发的命令,应用服务器可以调用物联网平台应用侧API接口向设备下发命令,以实现对设备的远程控制。物联网平台有同步命令下发和异步命令下发两种命令下发机制,如下表所示。具体使用流程请见:同步命令下发概述、异步命令下发概述。同步下发适合对命令实时性有要求的场景。异步用于实现对设备 - [自定义Topic通信概述](https://support.huaweicloud.com/usermanual-iothub/iot_02_9997.md): 使用MQTT协议接入的设备,平台和设备之间基于Topic进行通信。Topic分为系统Topic和自定义Topic。系统Topic为平台预置的基本通信Topic,自定义Topic是可以根据实际业务需要用户自行定义的Topic,客户可根据使用场景进行选择使用。值得注意的是,自定义Topic与系统Topic的消息上报一样,在平台都进行透传(平台 - [$oc开头自定义Topic通信使用说明](https://support.huaweicloud.com/usermanual-iothub/iot_02_9998.md): 选择MQTT协议类产品,在产品详情页中,选择Topic管理自定义Topic,单击“新增自定义Topic”。Topic管理-自定义Topic在弹出的页面中,选择设备操作权限,填写Topic名称。Topic管理-新增自定义Topic页面参数说明参数名称描述Topic名称Topic的前缀已经规定好,固定为:$oc/devices/{device - [非$oc开头自定义Topic通信使用说明](https://support.huaweicloud.com/usermanual-iothub/iot_02_9999.md): 为了适配新老客户的使用,策略默认放通所有“非$oc开头的自定义Topic通信”。新增的资源空间会默认加入策略“system_default_policy”,system_default_policy策略会允许所有Topic的订阅与发布。当业务场景不适用时,可以删除该策略。值得注意的是,策略只会限制“非$oc开头的自定义Topic通信”。“ - [设备间消息通信概述](https://support.huaweicloud.com/usermanual-iothub/iot_02_9994.md): M2M(Machine-to-Machine),物联网平台支持基于MQTT协议实现设备间的消息通信。设备的连接和通信请求都交由平台承担,客户只需要关注自己的业务实现。可以实现设备间1到1、1到N、N到N的使用。IoT环境具有规模巨大的特点,设备之间通信没有限制、通信混乱,将产生巨大的安全隐患;特别是在比较复杂的环境下,没有对设备进行发布与 - [设备间消息通信使用说明](https://support.huaweicloud.com/usermanual-iothub/iot_02_9995.md): 以下流程主要以设备间一对一为例:以下示例主要针对平台中创建流转规则配置。通过修改流转规则可以实现不同场景的应用。 - [设备间消息通信使用示例](https://support.huaweicloud.com/usermanual-iothub/iot_02_9996.md): 参考创建产品创建产品。参考注册单个设备创建设备。图2的设置代表:在资源空间XXX中的所有设备,Topic中包含/test/M2M/的消息上报,都会触发该流转规则,转发到设置的转发目标。若希望指定某个设备上报的数据进行流转,可在SQL语句中添加:AND notify_data.header.device_id='${对应的设备ID}'。若希 - [设备Topic策略概述](https://support.huaweicloud.com/usermanual-iothub/iot_01_1111.md): 设备策略主要用于对发布/订阅的非$oc开头自定义topic中的数据进行传输限制。通过灵活访问的控制模型,提供了基于用户角色的访问控制,能够管理客户端发布/订阅主题的授权。借助策略功能,可以用于管理一个或多个设备/产品/群组发布、订阅的权限,以保证非$oc开头的自定义Topic的通信安全。设备Topic策略用于发布、订阅机制的协议,比如说设 - [设备Topic策略使用前必读](https://support.huaweicloud.com/usermanual-iothub/iot_01_1114.md): 设备策略主要用于对发布/订阅的非$oc开头自定义topic中的数据进行传输限制。能够管理客户端发布/订阅主题的授权。借助策略功能,可以保证非$oc开头的自定义Topic的通信安全。设备Topic策略用于发布、订阅机制的协议,比如说设备侧的MQTT、MQTTS协议。策略中具有不同的通配符,使用前需注意。在策略中,“*”表示字符的任意组合,问 - [设备策略使用说明](https://support.huaweicloud.com/usermanual-iothub/iot_01_1112.md): 以下示例主要针对MQTT设备的订阅及发布。在设备接入控制台中可以进行策略的配置及策略目标的绑定。访问设备接入服务,单击管理控制台进入设备接入控制台。选择您的实例,单击实例卡片进入。进入策略页面。在左侧导航栏“设备”中单击“策略”,可到策略界面。设备策略-进入界面创建策略。在策略界面单击“创建策略”,按照业务具体填写策略参数,填写完成后单击 - [设备策略使用示例](https://support.huaweicloud.com/usermanual-iothub/iot_01_1113.md): 场景一: 策略允许OR禁止发布某Topic场景二: 端到端(M2M)+策略创建产品和设备参考创建产品创建产品。参考注册单个设备创建设备。参考创建产品创建产品。参考注册单个设备创建设备。生成策略访问设备接入服务,单击管理控制台进入设备接入控制台。选择您的实例,单击实例卡片进入。左侧导航栏单击设备 > 策略,进入策略界面。设备策略-进入界面在 - [广播通信概述](https://support.huaweicloud.com/usermanual-iothub/iot_01_00120.md): 广播通信常用于一对多的消息通信。多个设备订阅相同的广播Topic,应用服务器调用广播消息下发的接口指定广播Topic的名称,就可以给已订阅该广播Topic的所有在线设备发布消息。广播模式的典型用途是根据设备的类别向设备发送通知。例如,地震局给指定区域内的所有公民发送地震预警信息。广播通信场景样例群组通信场景给指定群组内的设备下发广播消息。 - [广播通信使用说明](https://support.huaweicloud.com/usermanual-iothub/iot_01_00121.md): 这里Topic必须为“$oc/broadcast/”前缀,消息内容需要使用BASE64编码。 - [广播通信使用示例](https://support.huaweicloud.com/usermanual-iothub/iot_01_00122.md): 本文介绍如何使用JAVA SDK进行广播通信的开发。本示例使用的开发环境为JDK 1.8及以上版本。配置Maven依赖。 com.huaweicloud.sdk huaweicloud-sdk-core - [编解码插件](https://support.huaweicloud.com/usermanual-iothub/iot_02_9990.md): 编解码插件是供物联网平台调用,可以完成二进制格式与JSON格式相互转换、也可以完成JSON格式之间的转换。MQTT协议的设备建议使用JS插件、FunctionGraph、LwM2M协议的设备建议使用图形化插件、离线开发插件。以NB-IoT场景为例,NB-IoT设备和物联网平台之间采用CoAP协议通讯,CoAP消息的payload为应用层数 - [创建产品](https://support.huaweicloud.com/usermanual-iothub/iot_01_0054.md): 使用物联网平台的第一步就是在控制台创建产品。产品是设备的集合,是指某一类具有相同能力或特征的设备的合集。产品创建成功后,您可以单击“更多-删除”删除不再使用的产品。删除产品后,该产品下的产品模型、编解码插件等资源将被清空,请谨慎操作。在产品列表中,单击对应的产品,进入产品详情页。您可以查看产品ID、产品名称、设备类型、数据格式、所属资源空 - [注册单个设备](https://support.huaweicloud.com/usermanual-iothub/iot_01_0031.md): 归属于某个产品下的设备实体,每个设备具有一个唯一的标识码。设备可以是直连物联网平台的设备,也可以是代理子设备连接物联网平台的网关。您可以在物联网平台注册您的实体设备,通过平台分配的设备ID和密钥,在集成了SDK后,您的设备可以接入到物联网平台,实现与平台的通信及交互。物联网平台支持通过应用服务器调用创建设备接口,或者在控制台上注册单个设备 - [批量注册设备](https://support.huaweicloud.com/usermanual-iothub/iot_01_0032.md): 物联网平台支持通过应用服务器调用创建批量任务接口,或者在控制台上批量注册设备。本文介绍如何在控制台上批量注册设备。创建设备查询批量任务列表创建批量任务查询批量任务 - [注册X.509证书认证的设备](https://support.huaweicloud.com/usermanual-iothub/iot_01_0055.md): X.509是一种用于通信实体鉴别的数字证书,物联网平台支持设备使用自己的X.509证书进行认证鉴权。使用X.509认证技术时,设备无法被仿冒,避免了密钥被泄露的风险。注册X.509证书认证的设备前,您需要先在物联网平台上传设备的CA证书,然后在注册设备时将设备证书同设备进行绑定。本文介绍如何在物联网平台上传设备CA证书,以及注册X.509 - [设备自注册](https://support.huaweicloud.com/usermanual-iothub/iot_01_0115.md): 设备自注册功能可以让用户没有在物联网平台上注册设备的前提下,在设备首次接入平台时自动完成设备的注册 ,设备自注册基于证书认证实现,通过设备证书携带设备信息。自动注册设备:适用于不能提前在控制台(console)或通过调用API创建设备的场景,设备可以直接完成注册。车联网场景:在车机启动时,设备连接平台会自动注册,上报数据,从而简化车端应用 - [管理设备](https://support.huaweicloud.com/usermanual-iothub/iot_01_0065.md): 在物联网平台成功创建设备后,您可以在控制台管理、查看具体设备信息,也可以冻结设备。在控制台上可以查看设备当前状态,如在线、离线、未激活、异常、冻结。用户也可以通过订阅方式获取设备的状态信息。设备状态定义如下:在设备列表中,单击具体的设备进入到设备详情页面。设备接入控制台也支持批量删除设备操作。操作方法如下:界面列表显示任务执行的状态和结果 - [群组和标签](https://support.huaweicloud.com/usermanual-iothub/iot_01_0020.md): 群组是一系列设备的集合,用户可以对资源空间下所有设备,根据区域、类型等不同规则进行分类建立群组,以便处理对海量设备的批量操作。例如,对资源空间下所有水表设备的群组进行固件升级。平台支持群组的增删改查操作,支持给群组绑定和解绑设备,支持一个设备被添加到多个群组中。动态规则语法可参考设备高级搜索。动态群组规则与高级搜索支持字段的不同点:动态群 - [设备高级搜索](https://support.huaweicloud.com/usermanual-iothub/iot_01_0111.md): 在海量设备场景下,您可以通过高级搜索功能,通过类SQL语句快速组装灵活的检索条件搜索满足条件的设备,例如:通过前缀模糊搜索设备名称、标签搜索在线设备列表等。本文将介绍高级搜索操作方式以及类SQL语法使用。仅标准版、企业版实例支持该接口调用,基础版实例不支持。单账号调用该接口的 TPS 限制最大为1/S(每秒1次请求数)。设备检索:在所有设 - [设备影子](https://support.huaweicloud.com/usermanual-iothub/iot_01_0049.md): 物联网平台支持创建设备的影子。设备影子是一个JSON文件,用于存储设备的在线状态、设备最近一次上报的设备属性值、应用服务器期望下发的配置。每个设备有且只有一个设备影子,设备可以获取和设置设备影子以此来同步设备属性值,这个同步可以是影子同步给设备,也可以是设备同步给影子。设备影子上有desired区和reported区。desired区用于 - [软固件包上传](https://support.huaweicloud.com/usermanual-iothub/iot_01_0155.md): 软件(Software)一般分为系统软件和应用软件,系统软件实现设备最基本的功能,比如编译工具、系统文件管理等;应用软件可以根据设备的特点,提供不同的功能,比如采集数据、数据分析处理等。软件升级又称为SOTA(SoftWare Over The Air),是指用户可以通过OTA的方式支持对LwM2M协议和MQTT协议的设备进行软件升级。基 - [NB-IoT设备OTA升级](https://support.huaweicloud.com/usermanual-iothub/iot_01_0027.md): LwM2M协议SOTA升级流程的详细说明:1~2. 用户在设备管理服务的控制台上传软件包,并在控制台或者应用服务器上创建软件升级任务。3. LwM2M设备上报数据,平台感知设备上线,触发升级协商流程。(超时时间为24小时)4~5. 物联网平台向设备下发查询设备软件版本的命令,查询成功后,物联网平台根据升级的目标版本判断设备是否需要升级。( - [MQTT设备OTA升级](https://support.huaweicloud.com/usermanual-iothub/iot_01_0047.md): MQTT协议SOTA升级流程的详细说明:1~2. 用户在设备管理服务的控制台上传软件包,并在控制台或者应用服务器上创建软件升级任务。3. 平台感知设备是否在线,当设备在线时立即触发升级协商流程。当设备不在线时,等待设备上线订阅升级Topic,平台感知设备上线,触发升级协商流程。4~5. 平台向设备下发查询设备软件版本号的命令,查询成功后, - [批量设备OTA升级](https://support.huaweicloud.com/usermanual-iothub/iot_01_01553.md): 创建批量设备软件、固件升级任务前需要上传软件升级包,平台支持两种方式上传软件、固件包:应用服务器通过调用“创建OTA升级包”API接口,创建OTA升级包,详情请参考创建OTA升级包。通过控制台,在软固件升级页面上传软件、固件升级包,详情请参考软固件包上传。通过API接口创建的OTA升级包,只支持MQTT协议设备升级。升级包为OBS对象时, - [文件上传](https://support.huaweicloud.com/usermanual-iothub/iot_01_0033.md): 华为物联网平台支持设备将运行日志,配置信息等文件上传至平台,便于用户进行日志分析、故障定位、设备数据备份等。当设备采用HTTPS方式将文件上传到OBS服务进行备份时,您可以在OBS服务管理已上传的设备文件。1. 授权物联网平台访问OBS服务。2. 配置OBS桶。3~4. 设备请求上传文件URL,平台下发文件上传URL,格式请参考设备上报获 - [网关与子设备](https://support.huaweicloud.com/usermanual-iothub/iot_01_0052.md): 物联网平台设备分为直连设备和非直连设备。直连设备:通过平台支持的协议,直接连接到平台的设备称为直连设备。平台支持直连的协议请参考概述中类型为通用协议,子类型为直连云端中的协议。非直连设备:针对未实现TCP/IP协议栈的设备,由于无法直接同物联网平台通信,它需要通过网关进行数据转发。网关设备为直连设备,当前仅支持通过mqtt协议直连到平台的 - [设备代理](https://support.huaweicloud.com/usermanual-iothub/iot_01_0113.md): 在网关和子设备的拓扑关系不是固定的场景下,平台目前的固定的拓扑关系难以适配。基于此情况,平台目前推出设备代理功能。将设备拓扑与数据转发能力解耦,子设备可以选择非拓扑关系的设备进行数据转发。网关高可用方案中,主备网关的切换。如在隧道场景,设置主网关和备用网关,可在主网关网络不好或者故障时切换至备用网关进行数据传输,达到不影响数据传输,保障及 - [设备认证凭证管理](https://support.huaweicloud.com/usermanual-iothub/iot_01_0114.md): 当设备接入物联网平台时,设备需要携带认证凭证在平台鉴权。当前平台支持的认证凭证有:密钥认证:注册设备时在物联网平台提前预置的设备密钥,平台会使用在注册设备时预置的密钥对设备进行认证。认证通过后,设备完成激活,然后与平台进行通信。在平台预置的密钥分为:主密钥:设备密钥鉴权优先使用的密钥,当设备接入物联网平台时,平台将优先使用主密钥进行校验。 - [设备证书](https://support.huaweicloud.com/usermanual-iothub/iot_01_0116.md): 设备证书是指设备使用MQTTS协议X.509证书双向认证时设备侧的证书,设备第一次连接物联网平台时,物联网平台使用用户上传已验证的CA证书对设备证书进行认证,认证通过后物联网平台会自动保存设备证书。物联网平台提供了对设备证书查看、停用、过期预警等功能。物联网平台会对30天内即将过期的设备证书进行告警,请及时更新证书防止接入失败。物联网平台 - [鸿蒙设备管理](https://support.huaweicloud.com/usermanual-iothub/iot_02_2154.md): 鸿蒙分布式软总线是一种可以将不同设备利用局域网串联,实现设备内和设备间高吞吐、低时延、高可靠的流畅连接体验,为设备互联互通提供了统一的分布式通信能力。实现近场设备间统一的分布式通信能力,提供不区分链路的设备发现和传输接口,具备快速发现并连接设备,高效分发任务和传输数据的能力。对开发者而言,无需关注组网方式与底层协议。软总线通过封装open - [规则引擎介绍](https://support.huaweicloud.com/usermanual-iothub/iot_01_0022.md): 规则引擎是指用户可以在物联网平台上对接入平台的设备设定相应的规则,在条件满足所设定的规则后,平台会触发相应的动作来满足用户需求。包含设备联动和数据转发两种类型。设备联动设备联动指通过条件触发,基于预设的规则,引发多设备的协同反应,实现设备联动、智能控制。目前物联网平台支持两种联动规则:云端规则和端侧规则。例如,当用户选择云端规则,执行动作 - [数据转发流程](https://support.huaweicloud.com/usermanual-iothub/iot_01_0024.md): 数据转发功能用于提供IoTDA与其他第三方以及华为云服务的连接通道,从而实现将设备数据平滑流转至消息中间件、存储、数据分析、业务应用。各转发方式在各规格的支持情况,详见产品规格说明中 基础版、标准版与企业版实例功能差异。当前物联网平台支持如下转发方式:通过公网进行数据转发流量限制不超过1M/s,超过后消息会直接丢弃。如果要使用更大的流量进 - [SQL语句](https://support.huaweicloud.com/usermanual-iothub/iot_01_0025.md): 创建数据转发规则时,需要编写SQL来解析和处理设备上报的JSON数据,JSON数据具体格式参考数据流转。本文主要介绍如何编写数据转发规则的SQL表达式。SQL语句由SELECT子句和WHERE子句组成,每个子句不能大于500个字符,暂不支持中文等其他字符集。SELECT子句和WHERE子句里的内容大小写敏感,SELECT和WHERE,AS - [连通性测试](https://support.huaweicloud.com/usermanual-iothub/iot_01_0036.md): 物联网平台提供规则动作转发目标连通性测试功能。在业务对接调测阶段,您可使用连通性测试功能模拟业务数据调测规则动作的可用性及转发数据的业务一致性;在业务运行阶段数据转发出现故障时,您可使用连通性测试功能进行简单的问题复现及定位。1、创建转发规则及动作后,单击待调测转发目标中的"测试"。2、在连通性测试对话框的测试数据页签下,输入用于转发的测 - [数据转发至DIS](https://support.huaweicloud.com/usermanual-iothub/iot_01_1001.md): 将数据流转到DIS云服务,可让您轻松收集、处理和分发实时流数据,以便您对新信息快速做出响应。DIS对接多种第三方数据采集工具,提供丰富的云服务Connector及Agent/SDK。也可以通过转储任务进一步将数据转发到其他云服务进行数据存储、分析,便于客户灵活使用。在设备接入服务中设置数据转发规则,实现当设备上报数据时将数据转发至DIS。 - [数据转发至RocketMQ](https://support.huaweicloud.com/usermanual-iothub/iot_01_1003.md): 将数据流转到RocketMQ云服务,兼容开源RocketMQ客户端。提供顺序、延迟、定时、重投、死信、事务消息等功能,更好的适配电商、金融等多样的业务场景。提供消息追踪、消息溯源、链路诊断、死信导出、监控告警等能力,帮助您全方面的了解服务状况,保证业务正常运行。在设备接入服务中设置数据转发规则,实现当设备上报数据时将数据转发至Rocket - [数据转发至GeminiDB Influx](https://support.huaweicloud.com/usermanual-iothub/iot_01_1005.md): 将数据流转到influxDB,兼容InfluxDB生态的云原生时序数据库。提供高性能读写、高压缩率、冷热分层存储以及弹性扩容、监控告警等服务能力,可以实现大并发的时序数据读写,压缩存储和类SQL查询等功能,支持多维聚合计算和数据可视化分析能力。广泛应用于资源监控、业务监控分析、物联网设备实时监控、工业生产监控、生产质量评估和故障回溯等。提 - [数据转发至Kafka存储](https://support.huaweicloud.com/usermanual-iothub/iot_bp_00012.md): 对于设备上报的数据,可以选择让平台将设备上报数据推送给应用服务器,由应用服务器进行保存;还可以选择让平台将设备上报数据转发给分布式消息服务(Kafka),由Kafka进行存储。本示例为将所有设备上报的数据转发至Kafka存储。登录华为云网站,访问分布式消息服务Kafka。单击“进入控制台”进入分布式消息服务管理控制台。单击右上角“购买Ka - [数据转发至FunctionGraph函数工作流](https://support.huaweicloud.com/usermanual-iothub/iot_bp_00013.md): 对于设备上报到平台的数据,使用函数工作流FunctionGraph处理实时流数据。通过函数服务,用户只需编写业务函数代码并设置运行的条件,无需配置和管理服务器等基础设施,即可跟踪设备的设备属性、消息上报,状态变更,分析、整理和计量数据流。本示例为将所有设备上报的属性转发至FunctionGraph函数工作流,根据设备资源空间Id的不同推送 - [数据转发至MySQL存储](https://support.huaweicloud.com/usermanual-iothub/iot_bp_00014.md): 对于平台的流转数据可以选择让平台将设备上报数据转发给云数据库(MySQL),由MySQL进行存储,用户无需做额外的数据存储代码开发即可使用设备数据进行业务处理。本示例为将流转数据转发至MySQL存储。已购买设备接入服务的企业版实例或标准版实例。已购买云数据库MySQL实例。设备接入服务企业版实例支持通过内网连接MySQL,标准版实例仅支持 - [数据转发至OBS长期存储](https://support.huaweicloud.com/usermanual-iothub/iot_bp_0001.md): 对于设备上报的数据,可以选择让平台将设备上报数据推送给应用服务器,由应用服务器进行保存;还可以选择让平台将设备上报数据转发给对象存储服务(OBS),由OBS进行存储。本示例为将所有设备上报的数据转发至OBS存储。在设备接入服务中创建产品模型、注册设备并设置数据转发规则,实现当设备上报数据时将数据转发至OBS。您可以使用配置设备接入服务时注 - [数据转发至BCS可信上链](https://support.huaweicloud.com/usermanual-iothub/iot_bp_00015.md): 通过IoTDA规则流转能力实现自动调用合约将数据流转到BCS区块链服务实现数据可信上链,助力客户构建可信多方协作平台,使用区块链可减少人为纠纷,提高交易效率;区块链的不可篡改性降低了欺诈和网络错误的发生;共享的账本、流程、记录增进参与方之间的可信度;审计机构可随时对不可篡改的账本进行审计。IoTDA企业版实例支持将数据流转到BCS华为云区 - [数据转发至MongoDB存储](https://support.huaweicloud.com/usermanual-iothub/iot_bp_00016.md): 对于平台的流转数据可以选择让平台将设备上报数据转发给文档数据库服务(DDS),由DDS进行存储(华为云DDS完全兼容MongoDB协议),用户无需做额外的数据存储代码开发即可使用设备数据进行业务处理。本示例为将流转数据转发至文档数据库服务存储。在设备接入服务中创建产品模型、注册设备并设置数据转发规则,实现当设备上报数据时将数据转发至Mon - [数据转发至PostgreSQL存储](https://support.huaweicloud.com/usermanual-iothub/iot_bp_00018.md): 平台支持将设备上报的数据转发至云数据库(PostgreSQL),由PostgreSQL进行存储,用户无需做额外的数据存储代码开发即可使用设备数据进行业务处理。已购买设备接入服务企业版实例。已购买云数据库PostgreSQL实例。设备接入服务企业版实例支持通过内网连接PostgreSQL,支持通过公网连接PostgreSQL。在设备接入服务 - [转发方式概述](https://support.huaweicloud.com/usermanual-iothub/iot_01_00140.md): 设备接入到物联网平台后,便可与物联网平台进行通信。设备通过自定义Topic或产品模型方式将数据上报到平台,在控制台设置后,通过订阅推送的方式,将设备生命周期变更、设备属性上报、设备消息上报、设备消息状态变更、设备状态变更、批量任务状态变更等消息转发到您指定的服务器。当前华为物联网平台支持HTTP/HTTPS、AMQP、MQTT和设备间通信 - [使用HTTP/HTTPS转发](https://support.huaweicloud.com/usermanual-iothub/iot_01_0001.md): 订阅推送的示意图如下图所示:物联网平台采用HTTPS协议向应用服务器进行消息推送时,物联网平台需要校验应用服务器的真实性,需要在物联网平台上加载CA证书,该证书由应用服务器侧提供(调测时可自行制作调测证书,商用时建议更换为商用证书,否则会带来安全风险)。推送机制:物联网平台向应用服务器推送消息后,如果应用服务器接收消息成功,会向物联网平台 - [AMQP转发](https://support.huaweicloud.com/usermanual-iothub/iot_01_0003.md): 订阅推送的示意图如下图所示:推送机制:物联网平台向用户推送消息后,如果用户接收成功,会向物联网平台回复响应(推荐自动响应方式)。如果用户建立链接后不拉取数据,则会导致数据积压在服务端。服务端仅保存24小时以内,且占用磁盘容量小于1GB的数据,若用户超过24小时没有拉取数据,则平台会清理所有积压数据。若用户收到消息后来不及响应,长连接中断, - [配置AMQP服务端](https://support.huaweicloud.com/usermanual-iothub/iot_01_00101.md): 本文介绍如何在物联网平台设置和管理AMQP服务端订阅。 - [AMQP队列告警配置](https://support.huaweicloud.com/usermanual-iothub/iot_01_0039.md): 用户在订阅AMQP队列进行消费时,由于网络通信问题、未及时对已经收到的消息进行确认等可能导致消费端离线、消息消费速度变慢,造成消息积压,影响消息实时性。华为云物联网平台支持AMQP队列告警配置,用户可以通过设置告警规则来监控AMQP队列消息的积压以及队列消费速度的情况,规则触发后立即把告警信息推送给用户,方便用户及时发现故障恢复业务。本文 - [AMQP客户端接入说明](https://support.huaweicloud.com/usermanual-iothub/iot_01_00100_2.md): 在调用创建规则触发条件、创建规则动作、修改规则触发条件配置并激活规则后,您需要参考本文将AMQP客户端接入物联网平台,成功接入后,在您的服务端运行AMQP客户端,即可接收订阅的消息。华为云物联网平台服务端订阅仅支持AMQP 1.0版的协议标准。AMQP客户端与物联网平台建立TCP连接,然后进行TLS握手校验。为了保障安全,接收方必须使用T - [Java SDK接入示例](https://support.huaweicloud.com/usermanual-iothub/iot_01_00100_3.md): 本文介绍使用AMQP协议的JMS客户端接入华为云物联网平台,接收服务端订阅消息的示例。本示例使用的开发环境为JDK 1.8及以上版本。AMQP SDK为开源SDK。如果您使用Java开发语言,推荐使用Apache Qpid JMS客户端。请访问Qpid JMS下载客户端和查看使用说明。您可以单击这里获取Java SDK接入示例,Demo中 - [Node.js SDK接入示例](https://support.huaweicloud.com/usermanual-iothub/iot_01_00100_4.md): 本文介绍使用Node.js语言的AMQP SDK接入华为云物联网平台,接收服务端订阅消息的示例。本示例所使用的开发环境为Node.js 8.0.0及以上版本。请前往Node.js官网下载。安装成功之后可以通过以下命令查看node版本。如果能够查询到node版本,且版本高于8.0.0则代表安装成功。在本地计算机创建一个JavaScript文 - [C# SDK接入示例](https://support.huaweicloud.com/usermanual-iothub/iot_01_00100_5.md): 本文介绍使AMQPNetLite客户端接入华为云物联网平台,接收服务端订阅消息的示例。本示例使用的开发环境为.NETFramework V4.6及以上版本。1、在工程目录上单击鼠标右键打开"管理NuGet程序包"2、在"NuGet管理器"中搜索到"AmqpNetLite"后安装所需版本Demo中涉及的参数说明,请参考AMQP客户端接入说明 - [Android SDK接入示例](https://support.huaweicloud.com/usermanual-iothub/iot_01_00100_6.md): 本文介绍Android系统如何通过Amqp接入华为云物联网平台,接收服务端订阅消息的示例。安装android studio。访问android studio官网,选择合适系统的版本下载并安装。(本文以windows 64-bit系统Android Studio 4.1.1为例)。下载android studio安装JDK(也可以使用IDE - [Python SDK接入示例](https://support.huaweicloud.com/usermanual-iothub/iot_01_00100_7.md): 本文介绍使用Python3 SDK通过AMQP接入华为云物联网平台,接收服务端订阅消息的示例。Python 3.0及更高版本。本示例使用了Python 3.9版本。本示例使用的Python语言的AMQP SDK为python-qpid-proton(本示例使用版本为0.37.0),可以通过以下命令安装最新版本SDK。也可以参考(Insta - [GO SDK接入示例](https://support.huaweicloud.com/usermanual-iothub/iot_01_00100_8.md): 本文介绍使用GO SDK通过AMQP接入华为云物联网平台,接收服务端订阅消息的示例。本示例使用的开发环境为Go 1.16及以上版本。在go.mod中添加以下依赖。 - [MQTT转发](https://support.huaweicloud.com/usermanual-iothub/iot_01_00111.md): 订阅推送的示意图如下图所示:推送机制:物联网平台向用户推送Qos0的消息,如果用户未建链或者建链后未订阅Topic,服务端仅保存24小时以内,且占用磁盘容量小于1GB的数据,若用户超过24小时没有拉取数据,则平台会清理所有积压数据。在物联网平台创建规则、添加转发目标为MQTT消息队列后实现数据订阅,详情请参考配置MQTT服务端。通过调用A - [配置MQTT服务端](https://support.huaweicloud.com/usermanual-iothub/iot_01_00112.md): 本文介绍如何在物联网平台设置和管理MQTT服务端订阅。 - [MQTT客户端接入说明](https://support.huaweicloud.com/usermanual-iothub/iot_01_00113.md): 在调用创建规则触发条件、创建规则动作和修改规则触发条件配置并激活规则后,您需要参考本文将MQTT客户端接入物联网平台,成功接入后,在您的服务端运行MQTT客户端,即可接收订阅的消息。MQTT客户端接入物联网平台的连接地址和连接认证参数说明如下:MQTT接入域名每个账号会自动生成,请前往管理控制台-接入信息页面获取。接入信息-应用侧MQTT - [Java Demo使用说明](https://support.huaweicloud.com/usermanual-iothub/iot_01_00114.md): 本文以Java语言为例,介绍应用通过MQTTS协议接入平台,接收服务端订阅消息的示例。已安装IntelliJ IDEA开发工具。若未安装请参考安装IntelliJ IDEA。访问IntelliJ IDEA官网,选择合适系统的版本下载。(本文以windows 64-bit系统IntelliJ IDEA 2019.2.3 Ultimate为例 - [Python Demo使用说明](https://support.huaweicloud.com/usermanual-iothub/iot_01_00115.md): 本文以Python语言为例,介绍应用通过MQTTS协议接入平台,接收服务端订阅消息的示例。熟悉Python语言开发环境配置,熟悉Python语言基本语法。本示例使用了Python 3.8.8版本。本示例使用的Python语言的Mqtt依赖为paho-mqtt(本示例使用版本为2.0.0),可以通过以下命令下载依赖。ClientConf代码 - [GO Demo使用说明](https://support.huaweicloud.com/usermanual-iothub/iot_01_00116.md): 本文以Go语言为例,介绍应用通过MQTTS协议接入平台,接收服务端订阅消息的示例。熟悉Go语言开发环境配置,熟悉Go语言基本语法。本示例使用了Go 1.18版本。本示例使用的Go语言的Mqtt依赖为paho.mqtt.golang(本示例使用版本为v1.4.3),在go.mod中添加依赖的代码如下:接入成功后,客户端打印信息如下: - [Node.js Demo使用说明](https://support.huaweicloud.com/usermanual-iothub/iot_01_00117.md): 本文以Node.js语言为例,介绍应用通过MQTTS协议接入平台,接收服务端订阅消息的示例。熟悉Node.js语言开发环境配置,熟悉Node.js语言基本语法。本示例所使用的开发环境为Node.js v13.14.0版本。请前往Node.js官网下载。安装成功之后可以通过以下命令查看node版本。本示例使用的Node.js语言的Mqtt依 - [C# Demo使用说明](https://support.huaweicloud.com/usermanual-iothub/iot_01_00118.md): 本文以C#语言为例,介绍应用通过MQTTS协议接入平台,接收服务端订阅消息的示例。熟悉.NETFramework开发环境配置,熟悉C#语言基本语法。本示例所使用的开发环境为.NETFramework 4.6.2版本,.Net SDK 6.0.421版本。请前往.NET官网下载。安装成功之后可以通过以下命令查看.Net SDK版本。本示例使 - [设备间通信](https://support.huaweicloud.com/usermanual-iothub/iot_01_00119.md): 订阅:物联网平台支持基于MQTT协议实现设备间的消息通信,用户可通过控制台创建规则,也可以通过调用物联网平台的创建规则触发条件、创建规则动作、修改规则触发条件接口配置并激活规则,向平台获取设备上报的消息。设备订阅只支持消息上报。推送:订阅成功后,物联网平台会将设备上报的消息推送到指定的MQTT Topic,当设备接入平台后,可以通过订阅该 - [查看数据转发通道详情](https://support.huaweicloud.com/usermanual-iothub/iot_01_1011.md): 在使用数据转发能力时,可以根据数据转发通道的使用情况,推断出转发目标(如第三方应用服务器等)的性能是否满足业务需求。例如,物联网平台的流转数据因为转发目标(第三方应用服务器)性能等问题无法快速处理时,这些数据会被积压(缓存)在IoT物联网平台中。此时,通过观察数据转发通道的详细信息,我们可以发现消息生产速率一直高于消息推送速率,同时消息积 - [数据转发积压策略配置](https://support.huaweicloud.com/usermanual-iothub/iot_01_0038.md): 当转发目标(如第三方应用服务器等)由于性能等原因无法快速处理IoT物联网平台流转数据时,未能及时处理的流转数据会积压(缓存)在IoT物联网平台。目前IoT物联网平台默认配置单个转发规则流转数据的最大积压(缓存)大小为1GB,最大积压(缓存)时间为24小时,超过最大积压(缓存)大小或积压(缓存)时间时,最早未被处理的流转数据会被丢弃直至满足 - [数据转发流控策略配置](https://support.huaweicloud.com/usermanual-iothub/iot_01_0037.md): 客户可以根据自身的业务场景以及转发目标(如第三方应用服务器等)的性能等情况,在IoT物联网平台上创建不同维度的流控策略,控制IoT物联网平台数据转发到转发目标(如第三方应用服务器等)的流量限制。流控策略创建成功后,不支持修改流控策略类型。超出实例和转发规则级别流控的数据会被丢弃,请慎重考虑后再使用。同时创建多个不同类型的流控策略,以最先达 - [异常数据转发目标](https://support.huaweicloud.com/usermanual-iothub/iot_01_0048.md): 在数据被转发至华为云其他服务或第三方应用时,若由于云服务权限不足、 华为云其他服务或第三方应用不可用等原因导致目标服务器不可达,物联网平台会停止消息的推送,并每三分钟进行一次通道恢复探测,若探测成功,通道将恢复正常使用。如果用户消息实时性要求高,为降低通道故障对业务的影响,用户可通过配置异常数据转发目标来获取异常转发数据,以便继续进行业务 - [云端规则](https://support.huaweicloud.com/usermanual-iothub/iot_01_0023.md): 当用户设置云端规则时,物联网平台会判断是否满足规则触发条件,在条件满足时,平台会执行用户预设的动作。比如:事件告警、主题通知、设备命令下发等。查询规则列表创建规则查询规则修改规则删除规则修改规则状态 - [端侧规则](https://support.huaweicloud.com/usermanual-iothub/iot_01_0041.md): 在云端规则中,用户创建的规则的解析及执行均在云端完成,云平台需要判断条件是否满足并触发相应的设备联动操作。端侧规则是指用户在云平台创建的设备联动规则,可以下发到端侧设备,该设备上会运行端侧规则引擎,对云端下发的规则进行解析并执行。端侧规则可以在网络中断或设备无法与云端交互情况下,继续在端侧执行指定规则。端侧规则可以扩展用户应用场景,提升端 - [设备消息跟踪](https://support.huaweicloud.com/usermanual-iothub/iot_01_0030_0.md): 在设备鉴权、命令下发、数据上报、平台数据转发等业务场景中出现故障时,物联网平台可以通过消息跟踪功能进行快速的故障定位和原因分析。目前物联网平台支持NB-IoT设备和MQTT设备的消息跟踪,单个用户下,最多支持同时进行跟踪的设备数上限为10。如果跟踪的结果中数据量较多时,您可以根据“消息状态”、“业务类型”和“记录时间”进行过滤;如果对跟踪 - [查看报表](https://support.huaweicloud.com/usermanual-iothub/iot_01_0030_1.md): 物联网平台为用户提供了丰富的报表功能,能够将数据直观地呈现出来。总览页面的报表统计实例维度的数据,报表数据有效时间为一个月。在控制台左侧导航栏,选择"总览"进入总览页面,报表名称及功能详细说明如下表所示。监控运维下统计报表中默认统计实例维度的数据,同时支持查看不同资源空间下的统计数据,单击报表右上角"+"可选择查看不同资源空间的数据,报表 - [告警管理](https://support.huaweicloud.com/usermanual-iothub/iot_01_0030_3.md): 当物联网平台监控到满足用户通过规则设置的告警触发条件时或设备消息上行的速度超过平台预设的阈值,平台就会上报告警。用户需要密切关注告警并及时进行处理,确保设备的正常运行。告警分为规则类告警、系统告警和自定义指标告警。规则类告警:如果用户在控制台上设置设备联动类的规则引擎时,定义了响应动作为上报告警,且定义了告警属性、告警级别等,则当满足触发 - [查看审计日志](https://support.huaweicloud.com/usermanual-iothub/iot_01_0030_2.md): 用户进入云审计服务创建管理类追踪器后,系统开始记录云服务资源的操作。在创建数据类追踪器后,系统开始记录用户对OBS桶中数据的操作。云审计服务管理控制台会保存最近7天的操作记录。本节介绍如何在云审计服务管理控制台查看或导出最近7天的操作记录:在新版事件列表查看审计事件在旧版事件列表查看审计事件单账号跟踪的事件可以通过云审计控制台查询。多账号 - [查看运行日志(旧版)](https://support.huaweicloud.com/usermanual-iothub/iot_01_0030_4.md): 华为云物联网平台支持记录平台与设备端,周边应用系统之间的对接情况,并以日志的形式上报到云日志服务(LTS),由LTS提供实时查询、海量存储、结构化处理和可视化图表分析能力,LTS每月免费赠送500M额度,超过后按需收费。LTS服务介绍和计费说明参见云日志服务LTS。目前仅支持记录MQTT设备的业务运行日志,详细请参考下表。选择左侧导航栏的 - [查看运行日志(新版)](https://support.huaweicloud.com/usermanual-iothub/iot_01_0030_8.md): 华为云物联网平台支持记录平台与应用侧及平台与设备侧之间的消息交互情况,并以日志的形式上报到云日志服务(LTS),由LTS提供实时查询、海量存储、结构化处理和可视化图表分析能力。与旧版运行日志相比,使用新版运行日志时,不需要您手动创建日志组、日志流、流转规则及动作,平台将自动为您完成相关配置,并且您可以直接在华为云物联网平台中查看运行日志的 - [设备异常检测](https://support.huaweicloud.com/usermanual-iothub/iot_01_0030_5.md): 物联网平台提供设备异常检测功能,当前主要有安全检测和离线分析功能。异常检测功能已合并到安全态势感知,详细请参考安全态势感知。物联网平台提供安全检测能力,可持续检测设备的安全威胁。本文介绍具体的安全检测项,及如何查看并处理检测出的安全风险。上述通用异常检测功能检测项开关默认开启,同时设备异常检测包括一些非公共检测项,用户可以根据需求进行检测 - [设备远程登录](https://support.huaweicloud.com/usermanual-iothub/iot_01_00301.md): 物联网平台提供远程登录功能,支持通过控制台远程SSH登录设备,可在控制台输入设备支持的命令,进行功能调试及问题定位,从而方便地实现设备管理及远程运维。下面介绍远程登录的具体使用方法。设备使用的是linux操作系统;设备上已安装SSH Server 应用;设备已集成物联网平台官方SDK(IoT Device SDK C v1.1.1及以后版 - [安全态势感知](https://support.huaweicloud.com/usermanual-iothub/iot_01_00303.md): 安全态势感知是对物联网平台资产的统一风险监控管理系统,通过仪表盘,图表等方式实现安全可视化,安全统计提升治理效率。单实例下安全态势配置配额为100个。同一个设备相同检测项告警抑制时间为1小时,即告警触发上报最短周期为1小时。物联网平台安全检测分为设备侧检测与平台侧检测两种,设备侧检测即在平台开启并配置检测项参数,平台下发给设备,由设备侧主 - [设备远程配置](https://support.huaweicloud.com/usermanual-iothub/iot_01_00302.md): 物联网平台为用户提供远程配置功能,用户可以在不中断设备运行的情况下,远程更新设备的系统参数、运行参数等配置信息。例如:Windows的收银台机器,需要通过远程配置修改一些系统参数;车联网中的T-BOX,需要通过远程配置修改设备侧的一些数据上报频率等。设备远程配置流程详细说明:用户在设备接入服务的控制台上创建远程配置任务。一个应用下最多同时 - [智能助手](https://support.huaweicloud.com/usermanual-iothub/toctopics/zh-cn_topic_0000002518400015.md): IoTDA支持通过云宝助手进行安全与运维的自助智能诊断能力,目的帮助用户快速发现问题,并给出解决方案,提升IoTDA的运维效率。目前实现设备接入异常诊断、设备端侧安全隐患诊断、设备调试故障分析、实例资源使用量与告警分析、云服务资源查询与诊断等能力。通过AI助手友好的对话方式,打破技术壁垒,以自然语言对话替代复杂命令行操作,将用户物联网平台 - [使用前必读](https://support.huaweicloud.com/usermanual-iothub/iot_03_0001.md): MQTT标准规范参见《mqtt-v3.1.1-os.pdf》。MQTT的语法和接口细节,请以此标准为准。设备发放目前仅支持MQTTS/HTTPS这种安全接入的设备进行发放,暂不支持MQTT/HTTP这种非安全接入的设备进行发放。MQTT消息分为固定报头(Fixed header)、可变报头(Variable header)和有效载荷(Pa - [设备安全认证](https://support.huaweicloud.com/usermanual-iothub/iot_03_00017.md): 设备接入设备发放和接入平台之前,需要通过身份认证。当前,物联网平台支持密钥认证和X.509证书认证两种认证方式进行设备身份认证。创建设备时,认证方式选择密钥认证,用户为设备指定或者平台自动生成设备密钥。设备接入平台时,携带密钥(为避免密钥在通信链路中直接传输,实际传输值为密钥衍生内容,衍生方式参见MQTT CONNECT连接鉴权章节中的P - [使用场景](https://support.huaweicloud.com/usermanual-iothub/iot_02_0004.md): 无需人工干预,在设备出厂时对设备的接入信息进行硬编码,设备统一烧录全球统一的设备发放接入信息,通过全球统一的设备发放服务实现跨区域的自动发放能力。设备出厂前统一在设备发放管理和接入,根据配置实现出厂后接入到不同用户的IoT平台。当不同型号的设备在首次连接设备接入时需要具备不同的初始化状态,可以通过设备发放完成不同批次设备初始化配置。具体使 - [设备发放业务流程](https://support.huaweicloud.com/usermanual-iothub/iot_02_0005.md): 设备启动后,通过Bootstrap流程(设备出厂时预置设备发放平台地址作为引导服务器地址),引导物联网设备在初次上电时获得正确的目标物联网平台地址,继而完成设备与平台的建链过程。保证设备安全可靠的按业务目标上线,最大程度上减少人为干预的错误可能。流程如下:首先确认用户是否开通设备接入服务(物联网平台)。 - [使用限制](https://support.huaweicloud.com/usermanual-iothub/iot_02_0002.md): 设备发放服务具有以下使用限制。 - [和其他服务的关系](https://support.huaweicloud.com/usermanual-iothub/iot_02_0003.md): 设备发放服务与其他服务的关系如表1所示。 - [证书管理](https://support.huaweicloud.com/usermanual-iothub/iot_09_0173.md): 本文以Windows环境为例,介绍通过Openssl工具制作CA证书,验证证书和设备的方法。以及更新与删除CA证书的操作。以下“生成密钥对(rootCA.key)”和“生成CA证书(rootCA.crt)”为操作过程中需要使用到的两个文件。生成“密钥对”时输入的密码在生成“证书签名请求文件”、“CA证书”,“验证证书”以及“设备证书”时需 - [授权策略](https://support.huaweicloud.com/usermanual-iothub/iot_09_0174.md): 授权,即授权关系,是两个租户在设备发放中建立的一种租户间单向的资源共享的关系。通过授权功能,授权租户向被授权租户共享授权租户下的设备接入实例,被授权租户可使用授权租户的设备接入实例作为发放策略的目的接入点,从而实现跨账号发放设备的能力。被授权方进入“授权”界面,单击在“被授权列表”下的“发起授权请求”。发起授权请求被授权方填写授权方的账号 - [自定义策略](https://support.huaweicloud.com/usermanual-iothub/iot_09_0176.md): 函数服务对函数有明确的接口定义。以java语言为例,接口定义为:作用域返回参数函数名(函数参数,Context参数)。作用域:提供给FunctionGraph调用的用户函数必须定义为public。返回参数:用户定义,FunctionGraph负责转换为字符串,作为HTTP Response返回。对于返回参数对象类型,HTTP Respon - [证书策略](https://support.huaweicloud.com/usermanual-iothub/iot_01_0100.md): 证书策略,即通过平台认证设备的设备CA证书匹配的发放策略。每条证书策略实例指:匹配上该策略实例的设备,将会被发放到该策略实例关联的设备接入实例的对应资源空间(即应用)下。设备匹配证书策略实例的机制为:设备的发放策略指定为“证书策略”时,其认证方式也必须为X.509证书认证且同时指定了认证设备的设备CA证书,当设备关联的设备CA证书与证书策 - [静态策略](https://support.huaweicloud.com/usermanual-iothub/iot_01_0101.md): 静态策略,即设备关键字模糊匹配的发放策略。每条静态策略实例指:匹配上该策略实例的设备,将会被发放到该条策略实例关联的设备接入实例的对应资源空间(即应用)下。设备匹配静态策略实例的机制为:设备的发放策略为“静态策略”,设备的关键字来源字符串包含某一静态策略实例的关键字,即被认为该设备匹配上该条策略实例。关键字来源有以下两种来源类型:设备名称 - [设备注册](https://support.huaweicloud.com/usermanual-iothub/iot_09_0177.md): 注册设备用于将设备基本信息导入设备发放平台中,用于后续发放至不同的物联网平台,支持批量注册和单个注册。设备注册成功后,可在“设备-注册”中查看设备的详细信息。所需“产品”来自 设备接入服务 创建的产品,相关信息参见 创建产品。本文以注册3个MQTT设备,发放到中国站“华北-北京四”为例演示如何发放MQTT设备。前提条件已在中国站“华北-北 - [MQTT 密钥设备使用静态策略发放示例](https://support.huaweicloud.com/usermanual-iothub/iot_03_0006.md): 添加静态策略,根据关键字发放到指定的IoTDA。在设备发放控制台,注册MQTT设备,其中安全模式选择密钥模式(如果需要下发初始化配置,那么对应在初始设备配置选项中填写对应的JSON字符串,设备发放不理解该字段,只是透传该JSON字符串,由设备理解解析。如果不需要下发该字段则不填)。此处注册设备的设备名称需与添加静态策略步骤的策略实例关键字 - [MQTT X.509证书认证设备使用证书策略发放示例](https://support.huaweicloud.com/usermanual-iothub/iot_03_0007.md): 生成“密钥对”时输入的密码在生成“证书签名请求文件”、“CA证书”,“验证证书”以及“设备证书”时需要用到,请妥善保存。生成证书签名请求文件时,要求填写证书唯一标识名称(Distinguished Name,DN)信息,参数说明如下表1所示。“-days”后的参数值指定了该证书的有效天数,此处示例为50000天,您可根据实际业务场景和需要 - [MQTT 注册组自定义策略发放示例](https://support.huaweicloud.com/usermanual-iothub/iot_03_0008.md): 生成“密钥对”时输入的密码在生成“证书签名请求文件”、“CA证书”,“验证证书”以及“设备证书”时需要用到,请妥善保存。生成证书签名请求文件时,要求填写证书唯一标识名称(Distinguished Name,DN)信息,参数说明如下表1所示。“-days”后的参数值指定了该证书的有效天数,此处示例为50000天,您可根据实际业务场景和需要 - [MQTT 华为云X.509证书认证设备使用证书策略发放示例](https://support.huaweicloud.com/usermanual-iothub/iot_03_0009.md): 根据云证书与管理服务的指导说明,在云证书与管理服务控制台创建根CA证书。采用华为云证书认证的设备,三种策略都支持引导,以“证书策略”为例,在“设备发放”创建对应“华为云证书”的证书策略。在设备发放控制台,注册MQTT设备,其中安全模式选择X.509认证模式,证书类型选择云证书,填写设备证书名称,注册X.509认证设备。设备注册成功后,单击 - [MQTT 华为云证书注册组发放示例](https://support.huaweicloud.com/usermanual-iothub/iot_03_00010.md): 根据云证书与管理服务的指导说明,在云证书与管理服务控制台创建根CA证书。设备证书创建成功后,单击“下载”设备证书和私钥,并烧录到设备。MQTT.fx 是目前主流的MQTT桌面客户端,它支持 Windows, Mac, Linux,可以快速验证是否可以与设备发放服务进行连接并发布或订阅消息。本文主要介绍 MQTT.fx 如何与华为设备发放交 - [MQTT 注册组静态策略发放示例](https://support.huaweicloud.com/usermanual-iothub/iot_03_00011.md): 生成“密钥对”时输入的密码在生成“证书签名请求文件”、“CA证书”,“验证证书”以及“设备证书”时需要用到,请妥善保存。生成证书签名请求文件时,要求填写证书唯一标识名称(Distinguished Name,DN)信息,参数说明如下表1所示。“-days”后的参数值指定了该证书的有效天数,此处示例为50000天,您可根据实际业务场景和需要 - [MQTT 注册组密钥认证静态策略发放示例](https://support.huaweicloud.com/usermanual-iothub/iot_03_00018.md): 有些设备可能没有证书,又需要使用设备发放功能。对于此类设备,设备发放提供密钥注册组功能。密钥认证类型的设备组是一个安全性不完备的方案,建议使用证书作为注册组的认证方式。每个设备的设备代码应该只包含该设备的相应派生设备密钥。 不要在设备代码中包含您的注册组密钥。 泄露的注册组密钥可能会危及所有使用该密钥进行身份验证的设备的安全。“关键字”为 - [MQTT 密钥设备跨账号使用静态策略发放示例](https://support.huaweicloud.com/usermanual-iothub/iot_03_00013.md): 进入授权关系界面,发起授权请求。填写发起授权请求相关信息,单击“确定”。可以在被授权列表看到刚刚授权给本账号的用户账号信息。添加静态策略,根据关键字发放到指定的IoTDA。发放方式选择“跨账号”,授权账号选择步骤3中授权给本账号的用户账号。在设备发放控制台,注册MQTT设备,其中安全模式选择密钥模式(如果需要下发初始化配置,那么对应在初始 - [MQTT 密钥设备使用静态策略发放](https://support.huaweicloud.com/usermanual-iothub/iot_03_00015.md): 添加静态策略,根据关键字发放到指定的IoTDA。在设备发放控制台,注册MQTT设备,其中安全模式选择密钥模式。此处注册设备的设备名称需与添加静态策略步骤的策略实例关键字相匹配,方能触发该静态策略。下载并修改华为SDK示例代码进行设备引导(这里以java sdk代码为示例)。用IDEA/Eclipse打开SDK代码工程,修改DEMO示例Bo - [MQTT 注册组静态策略发放示例](https://support.huaweicloud.com/usermanual-iothub/iot_03_00016.md): 生成“密钥对”时输入的密码在生成“证书签名请求文件”、“CA证书”,“验证证书”以及“设备证书”时需要用到,请妥善保存。生成证书签名请求文件时,要求填写证书唯一标识名称(Distinguished Name,DN)信息,参数说明如下表1所示。“-days”后的参数值指定了该证书的有效天数,此处示例为50000天,您可根据实际业务场景和需要 - [MQTT CONNECT连接鉴权](https://support.huaweicloud.com/usermanual-iothub/iot_03_0003.md): 设备发放平台设备侧支持MQTT协议的connect消息接口,接口规范参考MQTT标准规范,鉴权通过后建立设备与平台间的MQTT连接。设备发放平台目前只支持MQTTS接入,设备通过connect消息接口和平台建立MQTT连接时,需要使用服务端CA证书验证服务端证书。服务端CA证书单击huaweicloud-iot-root-ca-list获 - [设备请求引导消息](https://support.huaweicloud.com/usermanual-iothub/iot_03_0004.md): 设备向发放服务请求对应设备接入实例的引导信息。设备向发放服务发送的payload为空。 - [设备接收引导信息](https://support.huaweicloud.com/usermanual-iothub/iot_03_0005.md): 设备接收发放服务下发的引导信息。发放设备成功的返回参数样例发放设备失败的返回参数样例:发放设备自定义策略失败的返回参数样例: - [创建用户并授权使用IoTDA](https://support.huaweicloud.com/usermanual-iothub/iot_01_0231.md): 如果您需要对您所拥有的IoTDA进行精细的权限管理,您可以使用统一身份认证服务(Identity and Access Management,简称IAM),通过IAM,您可以:根据企业的业务组织,在您的华为云账号中,给企业中不同职能部门的员工创建IAM用户,让员工拥有唯一安全凭证,并使用IoTDA资源。根据企业用户的职能,设置不同的访问权 - [IoTDA自定义策略](https://support.huaweicloud.com/usermanual-iothub/iot_01_0232.md): 如果系统预置的IoTDA权限,不满足您的授权要求,可以创建自定义策略。自定义策略中可以添加的授权项(Action)请参考授权项列表。目前华为云支持以下两种方式创建自定义策略:可视化视图创建自定义策略:无需了解策略语法,按可视化视图导航栏选择云服务,操作、资源、条件等策略内容,可自动生成策略。JSON视图创建自定义策略:可以在选择策略模板后 - [IoTDA资源](https://support.huaweicloud.com/usermanual-iothub/iot_01_0233.md): 资源是服务中存在的对象。在IoTDA中,资源包括:实例(instance)和资源空间(app),您可以在创建自定义策略时,通过指定资源路径来选择特定资源。 - [委托授权](https://support.huaweicloud.com/usermanual-iothub/iot_01_0203.md): IoTDA服务提供的部分功能需要访问用户的资源,需要用户创建委托授权,具体功能请参考表1首次使用表1涉及的业务场景时,控制台会自动弹出创建委托授权的界面,并提示授权的功能清单和授权范围,用户同意授权后,IoTDA将在统一身份认证服务为您创建名为iotda_admin_trust的委托,授权成功后,您可以在IAM控制台的委托列表中查看已创建 ## 最佳实践 - [概述](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0022.md): 现在您应该对物联网平台有了初步的认识,那也许您会问,如何给您带来价值?哪些业务场景可以通过平台来实现?怎样接入到平台?接下来,通过最佳实践,我们把平台的业务流转串起来,把物模型等概念引进来,通过业务场景示例来呈现平台能力和价值,供您参考。场景简介:路灯管理系统通过接入物联网平台,监控路灯状态,控制路灯开关(集成了NB模组的智慧路灯)。该场 - [在线开发MQTT协议的模拟智慧路灯](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_00016.md): 本文以“智慧路灯”为示例,通过设备模拟器替代真实的设备,带您快速体验设备上报数据到物联网平台和远程下发控制命令到设备的全过程。您可以选择MQTT.fx工具或MQTT_Simulator两种设备模拟器,推荐使用MQTT.fx工具进行模拟。假设:路灯设备上报一条光照强度(luminance)消息;支持远程控制路灯开关状态的命令(switch) - [基于NB-IoT小熊派开发智慧路灯](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0007.md): 智慧路灯是城市智能化道路上重要一环,智慧路灯的实施具有节约公共照明能耗、减少因照明引起的交通事故等多种社会意义。路灯也是大家在日常生活中可以强烈感知到的公共设施,更易理解其智能化的场景。在该文档中,我们基于华为一站式开发工具平台(VS code工具IoTlink插件),从设备(小熊派开发套件)、平台(IoTDA华为物联网平台)、端到端构建 - [基于NB-IoT小熊派的智慧烟感](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0024.md): 近年来,火灾频发,造成很大的人员及财产损失,国家高度重视,陆续出台相关文件,明确相关要求,落实消防安全责任。同时,人民消防意识逐渐提高,独立烟感得到一定程度的普及,在防火减灾方面起到一定的作用。但由于独立烟感产品存在一定的局限,例如人不在场收不到报警信息,工作状态不能实时掌握,独立烟感没有完全解决这些问题。NB-IoT智慧烟感解决了传统烟 - [模拟NB设备智慧路灯的接入与调试](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0014.md): 本文以“智慧路灯”为示例,通过设备接入控制台提供的设备模拟器和应用模拟器替代真实的设备和应用,带您快速体验设备上报数据到物联网平台和远程下发控制命令到设备的全过程。假设:路灯设备上报一条数据消息,包含路灯的光照强度(light_intensity)和路灯的开关状态(light_status);支持远程控制路灯开关状态的命令(SWITCH_ - [通过协议转换网关实现泛协议设备接入](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0009.md): 目前平台只支持MQTT/HTTP/LWM2M等标准协议接入,如果设备是其他协议(统称为第三方协议),怎么接入平台?由于第三方协议设备不能直接接入平台,需要在平台外部完成协议转换。我们推荐使用网关来完成协议转换,将第三方协议转成MQTT协议。我们把用来进行协议转换的网关叫做协议转换网关。方案总体架构框图如下:协议转换网关是一个网关,可以部署 - [基于MQTT.fx的X.509证书接入](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0077.md): 本文档以MQTT.fx为例,介绍以MQTT原生协议接入物联网平台。MQTT.fx是目前主流的MQTT客户端,可以快速验证是否可以与物联网平台服务交互发布或订阅消息。X.509是一种用于通信实体鉴别的数字证书,物联网平台支持设备使用自己的X.509证书进行认证鉴权。使用X.509认证技术时,设备无法被仿冒,避免了密钥被泄露的风险。已注册华为 - [路灯通过微信小程序接入到平台](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0050.md): 平台支持基于WebSocket的MQTT协议,使基于浏览器的应用程序或者小程序可以快速接入到物联网平台。本文以“智慧路灯”为示例,通过微信小程序模拟设备,带您体验设备通过MQTT over WebSocket协议连接到物联网平台、上报数据和接收命令的全过程。假设:路灯设备上报一条包含光照强度(luminance)的消息;路灯支持远程控制开 - [基于BearPi-HM_Nano开发板和OpenHarmony对接IoTDA](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0079.md): 本文主要介绍基于OpenHarmony 3.0来接入IoTDA,以BearPi-HM_Nano开发板为例,使用huaweicloud_iot_link SDK对接华为云物联网平台的简单流程。基于OpenHarmony 3.1及更高版本参考链接。已注册华为云官方账号。未注册可单击注册页面完成注册。已完成实名制认证。未完成可在华为云上单击实名 - [设备按网络信号情况选网](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0025.md): 使用全球SIM联接服务的设备接入到物联网平台时,可能会面临网络信号强度弱,信号有时延等问题。当应用服务器接收到设备上报的网络信号强度数据时,您可以通过命令下发的方式切换运营商网络。按需选网整体流程如下图所示。设备在集成SDK Tiny后,还需要完成切换网络命令转换成AT指令的开发,以完成设备网络的自动切换。当设备接入到物联网平台时,便可实 - [基于Jmeter工具进行MQTT性能测试](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0020.md): 随着物联网技术的发展,全球物联网设备连接规模与日俱增。大量设备接入和设备管理对网络带宽、通信协议以及平台服务架构都带来了很大挑战。IoT架构选型时,对平台进行性能测试显得尤为重要。本文介绍如何使用JMeter工具对平台的MQTT协议接入能力进行性能压测。本文描述的测试方案如下:测试场景:模拟1万个设备同时在线,验证平台长连接的稳定性。模拟 - [利用工业网关(包含RS485、AI、DO口设备)进行环境监测](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0037.md): 微型气象是不可预测的,基本上不能通过人工手段来分析其变化,因此必须运用新技术,对气象进行实时监测,以便采取相应的措施来避免或解决事故的发生。而常规气象环境数据采集容易造成数据损失、人力成本高、数据安全性差、可追踪性差等问题。为解决上述问题,可以通过网关将设备采集的数据上报到华为云IoT平台,实现对现场设备数据的实时监控,您可通过华为云Io - [预置设备影子自动调节空调温度](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0023.md): 通过恒温控制系统,不论空调是否开机,都可以调整空调默认温度,待空调上电开机后,自动按默认温度调节。空调接入到物联网平台后,用户可以在应用侧或者设备接入控制台设置设备影子,将预置的温度通过设备影子下达属性修改给空调。空调收到修改属性的要求后,自动调节温度。用户可以选择在应用侧调用配置设备影子预期数据接口设置设备影子,也可以在设备接入控制台设 - [使用自定义Topic管理室内空调](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0019.md): 自定义Topic功能用于MQTT协议设备接入物联网平台的场景,支持设备消息上报、平台消息下发的Topic进行自定义。根据Topic不同,应用侧可实现不同的业务逻辑处理,也适用于应用侧和设备侧之间,设备无法按照产品模型中定义的属性上报或命令下发的场景。本示例中,应用服务器收到设备上报Topic为室内温度的数据,判断是否开启或关闭室内空调。已 - [MQTT协议设备OTA固件升级](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0039.md): MQTT(Message Queuing Telemetry Transport)是一个基于客户端-服务器的消息发布/订阅传输协议,主要应用于计算能力有限,且工作在低带宽、不可靠的网络的远程传感器和控制设备,适合长连接的场景,如智能路灯等。固件升级功能是网络设备所必须支持的基础服务。在设备固件出现安全漏洞、软件bug维护、自身功能优化、以 - [车联网消息上下行保序](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0038.md): 华为云IoTDA服务在满足高可靠、高并发的同时可按需开启设备维度的消息上下行保序功能。本文以MQTT协议为例介绍基于IoTDA的上、下行消息的保序方案。典型如车联网场景中:高速行驶中的车辆会实时上报自身的GPS位置数据(通常1~5秒/条数据),IoT平台接收该数据并转发给云端应用,应用侧根据上报的位置数据绘制实时轨迹地图,车辆端上报的轨迹 - [整体方案说明](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0092.md): 为满足企业多云容灾和第三方云IoT迁移至华为云IoT的需求,华为云IoT从设备端、平台端、应用端提供了低成本、零改造的迁移方案,可以支持设备端完全不用改造或最小成本改造从原有IoT平台迁移到华为云IoT平台。迁移总体方案分为下面四个步骤:IoT场景设备量大,设备能力弱。IoT的迁移需尽量减少对设备侧的改动。华为云IoT提供多种技术方案来解 - [Topic通信场景迁移实践](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0093.md): 本文以自建MQTT Broker的空调控制设备迁移到华为云IoT为例,介绍如何进行Topic通信场景的设备迁移。自建MQTT Broker基于MQTT协议的上行数据和下行指令的业务定义如下:设备使用一机一密的认证方式。设备通过Topic上报数据,通过消息流转功能将数据转发到后端服务。服务端通过消息下发接口下发消息给设备。Topic通信场景 - [物模型通信场景迁移实践](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0094.md): 本文以第三方云智慧路灯设备迁移到华为云IoT为例,介绍如何进行物模型场景的设备迁移。假设路灯设备上报一条光照强度(luminance)消息;支持远程控制路灯开关状态的命令(switch)。设备使用一机一密的认证方式。设备集成了第三方云SDK,采用物模型通信进行属性上报。服务端集成了第三方云SDK,进行指令下发。物模型通通信场景的迁移方案分 - [零代码搭建物联网监控大屏](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0222.md): 物联网解决方案中,作为数据主体的“物”可能数量会非常大,产生的数据已经无法通过传统的数据处理服务进行处理。如何分析与利用这庞大的物联网设备数据对物联网企业来说又是一个新的挑战。华为云物联网平台提供规则引擎能力,支持将设备上报的数据转发至华为云其他云服务,可实现将海量数据通过对象存储服务(OBS)存储,再由数据可视化服务(DLV)读取数据呈 - [IoTDA结合DLI+DWS+Astro实现大数据分析](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0223.md): 在物联网解决方案中,设备产生庞大的数据,使用传统的Mysql数据库已经无法达到要求,为了降低存储成本,提高数据查询效率,华为云物联网平台可以通过规则引擎,将数据转发到华为云其他云服务,例如可以将海量数据经过数据湖探索服务(DLI)进行数据清洗,再由云数据仓库(DWS)进行存储,再由Astro大屏应用读取数据进行可视化展示。实现数据一站式存 - [IoTDA结合ModelArts实现预测分析](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0224.md): 在物联网解决方案中,针对庞大的数据进行自动学习时,需要对海量数据进行标注、训练,按照传统的方式进行标注、训练不仅耗时耗力,而且对资源消耗也非常巨大。华为云物联网平台可以通过规则引擎,将获取的海量数据流转到华为云其他云服务,从而实现将海量数据通过函数工作流(FunctionGraph)进行预处理,再将清洗后的数据流入AI开发平台(Model - [指标数据推送至DMS Kafka最佳实践](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0225.md): 物联网平台为用户提供了丰富的报表功能,能够将数据直观地呈现出来,当您想将报表中的数据集成到自己的运维系统时,可以使用AOM的订阅功能将IoTDA推送的指标数据推送至DMS Kafka,您可以消费DMS Kafka中的指标数据展示在您自己的运维系统中。已注册华为官方账号。未注册可参考注册华为账户注册华为账户完成注册。已完成实名制认证。未完成 - [设备触发告警并邮件或短信通知](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0003.md): 很多物联网设备24小时运行,设备管理者并不需要知道设备每一刻的状态,只需要设备在上报某些特定状态时能通知到管理者。设备接入服务提供规则引擎功能可以满足该诉求,您可以通过设置规则简单实现当设备上报的数据满足某个条件时,物联网平台触发指定动作进行通知。本示例为设备上报的电池电量小于20%时,物联网平台会上报告警并发送邮件或短信通知给指定的手机 - [温度过高时自动关闭设备](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0004.md): 物联网平台支持设备数据上报和设备命令下发,但若要将两者联动起来,一般需要由应用服务器实现对应逻辑。设备接入服务提供规则引擎功能,平台上简单几步操作即可实现数据上报特定数据时平台自动下发指定命令,减少应用服务器开发工作量。本示例为设备自带的温度传感器上报的温度大于80度时,平台自动下发命令关闭设备。操作步骤如下:1.配置设备接入服务(IoT - [煤气浓度过高自动打开推窗器](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0021.md): 煤气安全关系到千家万户的生命财产安全。本示例基于华为物联网平台提供的设备接入服务,通过触发设备联动规则,自动打开推窗器。本示例场景是煤气监测器将煤气浓度数值上报到物联网平台,当煤气浓度超标时,会触发设置好的设备联动规则,物联网平台会下发打开窗户的命令到无线推窗器,无线推窗器收到命令后,自动把窗户打开。操作步骤如下:1.创建煤气监测产品。2 - [监测设备状态变化情况并发送通知](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0043.md): 在物联网场景下,部分设备具备重要的应用场景,比如物联网网关等,设备管理者需要感知这些设备的上下线情况。设备接入服务提供规则引擎功能可以满足该诉求,您可以通过简单的操作实现当设备状态满足某个条件时,物联网平台触发指定动作进行通知。某企业的网关产品下有一批网关设备,单个网关设备下挂载了约400个子设备,用户需要实时关注这批网关设备的状态,确保 - [设备厂商多实例接入方案](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0030.md): 随着厂商IoT设备的不断增加,或者厂商设备本来就面向多个销售中心(不同的销售中心有着自己的IoT接入实例),面对这样的场景,厂商在设备出厂的时候不知道设备最终需要连接到哪个IoT接入实例,设备出厂后不希望再对设备进行二次烧录。为此,华为IoT解决方案推出设备发放服务,设备出厂统一烧录设备发放的地址,通过在设备发放服务预置不同的发放策略,设 - [结合函数服务通过自定义策略发放证书认证的设备](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0041.md): 本文以MQTT.fx的设备模拟器替代真实的设备,结合函数工作流服务(FunctionGraph),带您快速体验结合函数服务使用设备发放服务,通过自定义策略将设备发放到指定的物联网平台(设备接入实例)上。使用证书认证的设备采用自定义策略发放设备操作流程如下图所示。通过自定义策略发放设备功能流程图如下图所示。自定义策略的函数代码编写指南参见创 - [设备自动注册安全接入示例](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0042.md): 平台基于客户业务安全考虑,只有将设备的基本信息(例如设备ID、鉴权信息)注册到平台后,设备才能使用成功注册后的设备ID和鉴权信息接入物联网平台。当用户注册的设备不断增多时,如何安全且高效地注册设备变得尤为关键。一种方案是,使用批量注册模板或者循环调用平台应用侧注册设备的API,实现高效地批量注册设备。此方案能够满足客户对批量注册设备的大部 - [通过设备发放实现批量设备自动注册](https://support.huaweicloud.com/bestpractice-iothub/iot_bp_0045.md): 当前物联网平台基于安全考虑,需要将设备的基本信息(例如设备ID、鉴权信息)注册到平台后,设备才能连接上平台。当用户的设备数不断增多时,如何安全且快速的注册设备尤为关键,需要采用安全的批量注册的场景。本文基于设备发放注册组功能,使用证书策略,带您快速体验设备批量自注册场景,并成功发放到指定的设备接入区域(本文以“华南-广州-友好用户环境”为 ## 开发指南 - [开发前必读](https://support.huaweicloud.com/devg-iothub/iot_02_9994.md): 基于IoT平台实现一个物联网解决方案,需要完成以下操作:开通设备接入服务后,使用设备接入服务的完整流程如下图所示,主要分为产品开发、应用侧开发、设备侧开发和日常管理。产品开发:开发者在进行设备接入前,基于控制台进行相应的开发工作,包括创建产品、创建设备、在线开发产品模型、在线开发插件和在线调试。应用侧开发:通过API的形式对外开放物联网平 - [资源获取](https://support.huaweicloud.com/devg-iothub/iot_02_1004.md): 进入IoTDA的管理控制台界面,选择左侧导航栏IoTDA实例,单击您需要的实例卡片进入实例。实例管理-切换实例选择左侧导航栏总览页签,在选择的实例基本信息中,单击接入信息。总览-获取接入信息物联网平台支持设备通过MQTT协议、LWM2M/CoAP协议和HTTPS协议进行接入,也可以通过IoTEdge将Modbus、OPC-UA、OPC-D - [设备接入引导](https://support.huaweicloud.com/devg-iothub/iot_02_0170.md): 华为云IoTDA支持使用多种协议接入平台,包括:常规的原生协议直连:MQTT(S)、HTTPS、LwM2M/CoAP(S)。通过网关/IoTEdge接入的标准协议:Modbus、 OPC-UA、OPC-DA、Onvif、GB28181、LoRa等。部分行业通用协议:JT808(车载终端通信协议)、SL651(水文监测数据通信协议)、HJ2 - [产品开发指引](https://support.huaweicloud.com/devg-iothub/iot_01_0058.md): 在物联网平台集成解决方案中,物联网平台作为承上启下的中间部分,向应用服务器开放API接口,向各种协议的设备提供API对接。为了提供更加丰富的设备管理能力,物联网平台需要理解接入设备具备的能力以及设备上报数据的格式,因此,您需要在控制台上完成产品模型和插件的开发。产品模型是用来描述设备能力的文件,通过JSON的格式定义了设备的基本属性、上报 - [创建产品](https://support.huaweicloud.com/devg-iothub/iot_01_0053.md): 在物联网平台中,某一类具有相同能力或特征的设备的合集被称为一款产品。产品创建成功后,您可以单击“更多-删除”删除不再使用的产品。删除产品后,该产品下的产品模型、编解码插件等资源将被清空,请谨慎操作。在产品列表中,单击对应的产品,进入产品详情页。您可以查看产品ID、产品名称、设备类型、数据格式、所属资源空间、协议类型等产品基本信息。产品-产 - [什么是产品模型](https://support.huaweicloud.com/devg-iothub/iot_01_0017.md): 产品模型用于描述设备具备的能力和特性。开发者通过定义产品模型,在物联网平台构建一款设备的抽象模型,使平台理解该款设备支持的服务、属性、命令等信息,如开关等。当定义完一款产品模型后,在进行注册设备时,就可以使用在控制台上定义的产品模型。产品模型定义了服务能力:服务能力描述设备具备的业务能力。将设备业务能力拆分成若干个服务后,再定义每个服务具 - [在线开发产品模型](https://support.huaweicloud.com/devg-iothub/iot_02_0005.md): 在线开发产品模型前需要创建产品。创建产品需要输入产品名称、协议类型、数据格式、所属行业和设备类型等信息,产品模型会使用这些信息作为设备能力字段取值。物联网平台提供了标准模型和厂商模型,这些模型涉及多个领域,模型中提供了已经编辑好的产品模型文件,您可以根据自己的需要对产品模型中的字段进行修改和增删;如果选择自定义产品模型,则需要完整定义产品 - [离线开发产品模型](https://support.huaweicloud.com/devg-iothub/iot_02_4012.md): 产品模型本质上就是一个devicetype-capability.json文件和若干个serviceType-capability.json文件,其中devicetype-capability.json是描述产品模型包含的服务能力的文件,serviceType-capability.json文件是用于描述devicetype-capabi - [导出和导入产品模型](https://support.huaweicloud.com/devg-iothub/iot_02_9995.md): 产品模型作为一种资源,可以从物联网平台导出,也可以导入到物联网平台。当产品开发完成并测试验证后,需要将在线开发的产品模型移植时,则可以将产品模型导出到本地。当您已经有完备的产品模型(线下开发或从其他项目/平台导出),或者使用excel编辑开发产品模型时,可以将产品模型直接导入到物联网平台。当产品开发完成并测试验证后,需要将在线开发的产品模 - [什么是编解码插件](https://support.huaweicloud.com/devg-iothub/iot_02_9990.md): 编解码插件是供物联网平台调用的数据格式转换插件,可以对设备上报给平台的数据、和平台要下发给设备的数据进行二进制格式与JSON格式之间的转换,或JSON格式之间的转换。以NB-IoT场景为例,编解码插件将设备上报的二进制数据解码为JSON格式供应用服务器“阅读”,将应用服务器下行的JSON格式命令编码为二进制格式数据供终端设备(UE)“理解 - [图形化开发插件](https://support.huaweicloud.com/devg-iothub/iot_02_0008.md): 当前在华为物联网平台上,使用图形化开发的编解码插件只适用于上报数据格式为二进制的设备。在设备接入控制台,我们可以通过可视化的方式快速开发一款产品的编解码插件。本节首先以一个NB-IoT烟感设备的例子讲解如何开发一个支持数据上报和命令下发的编解码插件,并且支持上报命令执行结果,然后再以两个场景举例说明如何完成复杂的插件开发以及调试。数据上报 - [使用JavaScript开发插件](https://support.huaweicloud.com/devg-iothub/iot_02_0009.md): 物联网平台支持JavaScript脚本编解码的功能,根据您提交的脚本文件,实现设备二进制格式与JSON格式相互转换或JSON格式之间的转换。本文以烟感设备为例,介绍如何开发一个支持设备属性上报和命令下发的JavaScript编解码脚本,并介绍JavaScript脚本开发编解码插件的格式转换要求和调试方法。2024年12月1日后新用户不再提 - [FunctionGraph开发说明](https://support.huaweicloud.com/devg-iothub/iot_02_0011.md): 物联网平台支持使用FunctionGraph编解码的功能,根据您提交的脚本文件,实现设备二进制格式与JSON格式相互转换。常在设备能力比较弱,只能上报简单的二进制数据的设备场景下使用。FunctionGraph的函数托管计算服务支持Node.js、Python、Java、Go、C#、PHP、Cangjie和定制运行时语言,可以满足多种开发 - [MQTT(S)-编解码插件样例](https://support.huaweicloud.com/devg-iothub/iot_02_0012.md): 本文以烟感设备为例,介绍如何使用JavaScript语言开发一个支持MQTT/MQTTS协议的设备进行属性上报和命令下发编解码的FunctionGraph函数插件。并介绍从二进制数据到JSON数据格式的转换及其调试方法。场景说明有一款烟感设备,具有如下特征:具有烟雾报警功能(火灾等级)和温度上报功能。支持远程控制命令,可远程打开报警功能。 - [NB-IoT(CoAP)- 编解码插件样例](https://support.huaweicloud.com/devg-iothub/iot_02_0013.md): 本文以烟感设备为例,介绍如何使用JavaScript语言开发一个支持CoAP协议的设备进行属性上报和命令下发编解码的FunctionGraph函数插件。并介绍从二进制数据到JSON数据格式的转换及其调试方法。场景说明有一款烟感设备,具有如下特征:具有烟雾报警功能(火灾等级)和温度上报功能。支持远程控制命令,可远程打开报警功能。比如火灾现场 - [离线开发插件](https://support.huaweicloud.com/devg-iothub/iot_02_4020.md): 编解码插件实现二进制格式与JSON格式相互转换或JSON格式之间的转换,产品模型定义了该JSON格式的具体内容。因此,编解码插件开发前需要先编写设备的产品模型。为了提高离线开发的集成效率,我们提供了编解码插件的编解码插件样例,建议您基于DEMO工程进行二次开发。2023年8月1日后新用户不再提供离线插件功能。由于插件离线开发较为复杂,且耗 - [下载和上传插件](https://support.huaweicloud.com/devg-iothub/iot_02_9989.md): 在线开发完成编解码插件后,可以将插件下载到本地。2023年8月1日后新用户不再提供离线插件功能。当本地已经准备好编解码插件(如线下开发)时,则可以通过插件开发的离线开发方式上传至物联网平台。插件包的设备类型、型号、厂商ID等信息需要与该产品保持一致,才可以成功上传。当界面提示“上传离线插件成功”,表示插件已部署到物联网平台。 - [在线调试](https://support.huaweicloud.com/devg-iothub/iot_02_9988.md): 当产品模型和编解码插件开发完成后,应用服务器就可以通过物联网平台接收设备上报的数据以及向设备下发命令。设备接入控制台提供了在线调试的功能,您可以根据自己的业务场景,在开发真实应用和真实设备之前,使用应用模拟器和设备模拟器对数据上报和命令下发等场景进行调试;也可以在真实设备开发完成后使用应用模拟器验证业务流。目前仅基础版和标准版支持MQTT - [注册单个设备](https://support.huaweicloud.com/devg-iothub/iot_01_0031.md): 归属于某个产品下的设备实体,每个设备具有一个唯一的标识码。设备可以是直连物联网平台的设备,也可以是代理子设备连接物联网平台的网关。您可以在物联网平台注册您的实体设备,通过平台分配的设备ID和密钥,在集成了SDK后,您的设备可以接入到物联网平台,实现与平台的通信及交互。物联网平台支持通过应用服务器调用创建设备接口,或者在控制台上注册单个设备 - [批量注册设备](https://support.huaweicloud.com/devg-iothub/iot_01_0032.md): 物联网平台支持通过应用服务器调用创建批量任务接口,或者在控制台上批量注册设备。本文介绍如何在控制台上批量注册设备。创建设备查询批量任务列表创建批量任务查询批量任务 - [注册X.509证书认证的设备](https://support.huaweicloud.com/devg-iothub/iot_01_0055.md): X.509是一种用于通信实体鉴别的数字证书,物联网平台支持设备使用自己的X.509证书进行认证鉴权。使用X.509认证技术时,设备无法被仿冒,避免了密钥被泄露的风险。注册X.509证书认证的设备前,您需要先在物联网平台上传设备的CA证书,然后在注册设备时将设备证书同设备进行绑定。本文介绍如何在物联网平台上传设备的CA证书,以及注册X.50 - [设备自注册](https://support.huaweicloud.com/devg-iothub/iot_01_0115.md): 设备自注册功能可以让用户没有在物联网平台上注册设备的前提下,在设备首次接入平台时自动完成设备的注册 ,设备自注册基于证书认证实现,通过设备证书携带设备信息。自动注册设备:适用于不能提前在控制台(console)或通过调用API创建设备的场景,设备可以直接完成注册。车联网场景:在车机启动时,设备连接平台会自动注册,上报数据,从而简化车端应用 - [设备集成设备端SDK接入](https://support.huaweicloud.com/devg-iothub/iot_02_0200.md): 华为云设备接入云服务(IoTDA)是提供海量设备的接入和管理能力的物联网平台,将物理设备连接到云,支撑设备数据采集上云和云端下发命令给设备进行远程控制。IoTDA配合华为云其他产品,可以帮助您快速构筑物联网解决方案。接下来,将以Java SDK为例,体验如何使用IoT Device SDK进行代码场景适配、并将该SDK集成入IoT设备实现 - [协议介绍](https://support.huaweicloud.com/devg-iothub/iot_02_0202.md): MQTT(Message Queuing Telemetry Transport)是一个基于客户端-服务器的消息发布/订阅传输协议,主要应用于计算能力有限且工作在低带宽、不可靠的网络的远程传感器和控制设备,适合设备与云端保持长连接的场景,如智能路灯等。MQTT 客户端通过主题(Topic)发布或订阅消息,由MQTT Broker集中管理消 - [密钥鉴权](https://support.huaweicloud.com/devg-iothub/iot_02_0203.md): MQTT(S)协议-密钥鉴权是指设备在接入物联网平台时,携带设备ID和密钥以完成设备的接入鉴权。对于使用MQTTS协议接入的设备,需要在设备侧预置CA证书;对于使用MQTT非安全协议接入的设备,无需在设备侧预置CA证书。通过调用注册接口向物联网平台发送注册请求,或者在控制台上注册设备。注册时需要填写设备标识码,通常使用MAC地址,Seri - [证书鉴权使用说明](https://support.huaweicloud.com/devg-iothub/iot_02_0205.md): MQTT(S)协议-证书鉴权是指在设备接入物联网平台前,用户通过控制台上传设备的CA证书,然后应用服务调用创建设备接口或通过控制台在物联网平台注册设备,获取设备ID。在设备接入物联网平台时携带设备侧X.509证书(一种用于通信实体鉴别的数字证书),完成设备的接入鉴权。当前物联网平台只支持基于MQTT(S)协议接入的设备使用X.509证书进 - [证书有效性验证(OCSP)](https://support.huaweicloud.com/devg-iothub/iot_02_0206.md): IoTDA平台使用OCSP协议对设备侧和服务器侧证书的有效性进行校验。OCSP是在线证书状态协议(Online Certificate Status Protocol)的缩写,OCSP在传输安全层(TLS)握手期间检查证书吊销状态,对证书进行实时验证,与传统的证书吊销列表(CRL)相比,CRL更新频率较低,文件更大,而OCSP扩展性更强, - [自定义鉴权](https://support.huaweicloud.com/devg-iothub/iot_02_0207.md): 自定义鉴权是指用户可以通过函数工作流(FunctionGraph)服务实现自定义鉴权逻辑,以对接入平台的设备进行身份认证。在设备接入物联网平台前,用户可以通过应用服务调用控制台配置自定义鉴权信息,然后通过调用函数工作流(FunctionGraph)配置自定义鉴权函数。在设备接入物联网平台时,物联网平台会获取设备ID和自定义鉴权函数名称等参 - [自定义模板使用说明](https://support.huaweicloud.com/devg-iothub/iot_02_0209.md): 自定义模板鉴权是指用户可以使用平台提供的内部函数实现自定义的鉴权方式,而不需使用平台默认鉴权方式,对接入平台的设备进行身份认证,用户可以通过平台预置的函数灵活编排鉴权方式。迁移场景:当设备从第三方物联网平台迁移到华为云IoTDA时,通过配置平台提供的自定义鉴权模板可以兼容原来的鉴权方式,设备侧无需改动实现无缝迁移。原生场景:自定义模板鉴权 - [自定义模板鉴权示例](https://support.huaweicloud.com/devg-iothub/iot_02_0210.md): 证书认证设备,不限制UserName与ClientId参数取值,从设备证书通用名称(Common Name)中取值设备ID。鉴权模板:当设备ID格式为:${ProductId}_${NodeId},鉴权参数格式如下表所示时,自定义鉴权模板配置如下代码所示:鉴权模板:当设备ID格式为:${productId}${nodeId},鉴权参数格式 - [自定义模板内部函数](https://support.huaweicloud.com/devg-iothub/iot_02_0211.md): 华为云IoTDA提供了多个内部函数供用户在模板中使用,使用时请认真阅读每个函数的功能定义,包括入参类型,参数长度,返回值类型等。整个函数必须是合法的Json格式。函数中可使用${}变量占位符或者"Ref"函数引用入参定义的参数值。函数所使用的参数必须在模板参数中声明。单一入参的函数后面直接跟参数,比如:"Fn::Base64Decode" - [HTTP(S)协议接入](https://support.huaweicloud.com/devg-iothub/iot_02_0212.md): HTTPS是基于HTTP协议,通过SSL加密的一种安全通信协议。IoTDA物联网平台支持HTTPS协议通信。该协议多使用在需要进行数据采集和分析的场景中,因为HTTP协议能够高效地传输和处理结构化数据;或应用在设备需要采用短连接且仅需单向上传数据的场景。HTTPS协议鉴权是指设备通过调用HTTPS协议设备鉴权接口并携带设备ID和使用算法加 - [LwM2M/CoAP协议接入](https://support.huaweicloud.com/devg-iothub/iot_02_0213.md): LwM2M(Lightweight M2M,轻量级M2M),由开发移动联盟(OMA)提出,是一种轻量级的、标准通用的物联网设备管理协议,可用于快速部署客户端/服务器模式的物联网业务。LwM2M为物联网设备的管理和应用建立了一套标准,它提供了轻便小巧的安全通信接口及高效的数据模型,以实现M2M设备管理和服务支持。LwM2M/CoAP协议鉴权 - [SDK介绍](https://support.huaweicloud.com/devg-iothub/iot_02_0128.md): 基于SDK实现泛协议设备接入的业务流程:泛协议接入相关问题通过协议转换网关实现泛协议设备接入 - [代码开发](https://support.huaweicloud.com/devg-iothub/iot_02_0129.md): 开发环境要求:已经安装JDK(版本1.8.以上)和maven。已下载泛协议SDK和样例。项目结构说明创建BridgeBootstrap对象实例,调用initBridge方法,在该方法中会读取环境变量的配置信息,并同IoT平台建立网桥连接。环境变量说明:初始化成功后,需要设置平台下行数据的监听器,监听平台的下行数据。代码样例:设备登录上线的 - [测试验证](https://support.huaweicloud.com/devg-iothub/iot_02_3.md): 代码调试时,需要获取对应的网桥接入信息,并配置到对应的环境变量中。网桥接入信息,环境变量配置参考:NET_BRIDGE_ID与NET_BRIDGE_SECRET在标准版和企业版支持在界面配置和获取,获取方式如下:进入泛协议接入页面:登录管理控制台,单击左侧导航栏“IoTDA实例”,选择对应实例,单击右侧“详情”进入实例,选择“泛协议接入” - [镜像制作](https://support.huaweicloud.com/devg-iothub/iot_02_7.md): 将jar文件打包成镜像文件,请参照制作镜像包或插件包。dockerfile内容参照如下(具体可参考编写高效的Dockerfile )。 - [非托管部署](https://support.huaweicloud.com/devg-iothub/iot_02_9.md): 通过泛协议SDK开发的插件镜像可以通过华为云的ECS服务器或者云容器实例进行部署和自运维。本章节介绍如何用华为云的云容器实例(CCI)进行 泛协议镜像的部署。设置VPC,选择使用已有VPC或新建VPC,新建VPC需要填写VPC网段,建议使用网段:10.0.0.0/8~22,172.16.0.0/12~22,192.168.0.0/16~2 - [IoTEdge接入概述](https://support.huaweicloud.com/devg-iothub/iot_02_0215.md): 在某些行业(例如工业、制造)的实际物联网应用场景中,常常会需要接入IoT平台未原生支持的行业协议设备,或需要接入只支持近场协议(例如蓝牙)、有线等方式联网的设备。这类场景下需要先将设备接入边缘网关,再通过网关连接至IoTDA平台完成设备接入。本章节以使用OPC-UA工业协议的OT设备(Operational Technology)接入Io - [准备IoTEdge边缘节点](https://support.huaweicloud.com/devg-iothub/iot_02_0216.md): 在安装部署节点前,请确认已开启机器的IP转发和自启动,以及开放7883和8943端口。检查机器ip_forward in/proc文件系统的值,若值等于0,则需要添加配置IP转发规则。cat /proc/sys/net/ipv4/ip_forward检查配置文件/etc/sysctl.conf是否包含net.ipv4.ip_forward - [准备设备数据源](https://support.huaweicloud.com/devg-iothub/iot_02_0217.md): 对于不同的接入类型,接入方式不同,在IoTEdge中有不同的应用插件及接入模式。MQTT(S)协议可以通过透传网关模式接入到物联网平台,而对于非标准TCP/IP协议无法直接与互联网平台通信的协议(如ZigBee、Modbus、OPC-UA协议),可以通过在IoTEdge部署边缘节点(边缘网关)实现其他行业数据标准格式转换为物联网平台可识别 - [配置设备数采](https://support.huaweicloud.com/devg-iothub/iot_02_0218.md): 将点位上报转换为设备属性上报,将设备属性读写转换为点位读写操作,将设备命令转化为点位写操作。如果需要修改点位信息,需修改后重新下发配置,配置才会生效。当启用了数采连接后,模块会显示为运行中。一个设备只能配置一个数采连接。同一数采连接下的多个点位不能配置相同设备属性。数据源模板描述了数据源配置项的元数据,用户在配置数据源之前,需要先导入数据 - [通过华为认证模组接入](https://support.huaweicloud.com/devg-iothub/iot_02_2134.md): 认证模组是指通过预集成IoT Device SDK Tiny,并且通过华为测试认证,遵循华为指定AT命令规范的模组。使用华为认证的模组可以带来以下好处:设备厂商在MCU上无需关心如何连接到华为云IoT(例如,MQTT建链时密钥的加密算法,clientID的组成方式等),只通过调用该模组提供的AT指令对接华为IoT平台,可以节约设备对接工作 - [MQTT使用指导](https://support.huaweicloud.com/devg-iothub/iot_02_2200.md): MQTT(Message Queuing Telemetry Transport)是一个基于客户端-服务器的消息发布/订阅传输协议,主要应用于计算能力有限且工作在低带宽、不可靠的网络的远程传感器和控制设备,适合设备与云端保持长连接的场景,如智能路灯等。MQTT 客户端通过主题(Topic)发布或订阅消息,由MQTT Broker集中管理消 - [使用MQTT.fx调测](https://support.huaweicloud.com/devg-iothub/iot_01_2127.md): 本文档以MQTT.fx为例,介绍以MQTT原生协议接入物联网平台。MQTT.fx是目前主流的MQTT客户端,可以快速验证是否可以与物联网平台服务交互发布或订阅消息。已注册华为云官方账号。未注册可单击注册页面完成注册。已完成实名制认证。未完成可在华为云上单击实名认证完成认证,否则无法使用设备接入功能。已开通设备接入服务。未开通则访问设备接入 - [Java Demo使用说明](https://support.huaweicloud.com/devg-iothub/iot_02_2128.md): 本文以Java语言为例,介绍通过MQTTS/MQTT协议接入平台,基于平台接口实现属性上报、订阅接收命令等功能。本文中使用的代码为样例代码,仅用于体验平台通信功能,如需进行商用,可以参考资源获取获取对应语言的IoT Device SDK进行集成。已在管理控制台获取设备接入地址。获取地址的操作步骤,请参考平台对接信息。已在管理控制台创建产品 - [Python Demo使用说明](https://support.huaweicloud.com/devg-iothub/iot_02_2129.md): 本文以Python语言为例,介绍通过MQTTS/MQTT协议接入平台,基于平台接口实现属性上报、订阅接收命令等功能。本文中使用的代码为样例代码,仅用于体验平台通信功能,如需进行商用,可以参考资源获取获取对应语言的IoT Device SDK进行集成。已安装python,若未安装请参考安装python。已安装开发工具(本文以Pycharm为 - [Android Demo使用说明](https://support.huaweicloud.com/devg-iothub/iot_02_2130.md): 本文以Android语言为例,介绍通过MQTTS/MQTT协议接入平台,基于平台接口实现属性上报、订阅接收命令等功能。本文中使用的代码为样例代码,仅用于体验平台通信功能,如需进行商用,可以参考资源获取获取对应语言的IoT Device SDK进行集成。已安装Android,若未安装请参考安装android studio,还需要安装JDK。 - [C Demo使用说明](https://support.huaweicloud.com/devg-iothub/iot_02_2131.md): 本文以C语言为例,介绍通过MQTTS/MQTT协议接入平台,基于平台接口实现属性上报、订阅接收命令等功能。本文中使用的代码为样例代码,仅用于体验平台通信功能,如需进行商用,可以参考资源获取获取对应语言的IoT Device SDK进行集成。环境要求:Linux操作系统上,并安装好gcc(建议4.8及以上版本)。库依赖:openssl库(M - [C# Demo使用说明](https://support.huaweicloud.com/devg-iothub/iot_02_2132.md): 本文以C#语言为例,介绍通过MQTTS/MQTT协议接入平台,基于平台接口实现属性上报、订阅接收命令等功能。本文中使用的代码为样例代码,仅用于体验平台通信功能,如需进行商用,可以参考资源获取获取对应语言的IoT Device SDK进行集成。已安装Microsoft Visual Studio,若未安装请参考安装Microsoft Vis - [Node.js Demo使用说明](https://support.huaweicloud.com/devg-iothub/iot_02_2133.md): 本文以Node.js为例,介绍通过MQTTS/MQTT协议接入平台,基于平台接口实现属性上报、订阅接收命令等功能。本文中使用的代码为样例代码,仅用于体验平台通信功能,如需进行商用,可以参考资源获取获取对应语言的IoT Device SDK进行集成。已安装Node.js,若未安装请参考安装Node.js。已在管理控制台获取设备接入地址。获取 - [MQTT over WebSocket 使用说明](https://support.huaweicloud.com/devg-iothub/iot_02_2136.md): 本文以JavaScript为例,介绍基于WebSocket的MQTTS/MQTT协议接入平台,使应用程序或者小程序可以快速接入到平台,通过平台接口实现属性上报、订阅接收命令等功能。本文中使用的代码为样例代码,仅用于体验平台通信功能,如需进行商用,可以参考资源获取获取对应语言的IoT Device SDK进行集成。MQTT over Web - [设备侧适配开发指导](https://support.huaweicloud.com/devg-iothub/iot_01_0047_2.md): 设备的OTA软件升级是基于华为定义的PCP协议进行的,设备侧需根据PCP协议定义的交互流程进行适配开发。下面我们将结合物联网平台与设备的软件升级交互流程,介绍终端设备将如何基于PCP协议构建交互过程中的请求消息和应答消息,帮助您更好的根据PCP协议进行终端侧的软件升级功能开发。下面我们先了解下PCP消息的结构,PCP协议的请求消息和应答消 - [PCP协议介绍](https://support.huaweicloud.com/devg-iothub/iot_01_0047_3.md): 平台升级协议(PCP协议)规定了设备和平台之间升级的通信内容与格式。本协议规定设备和IoT平台(以下简称平台)之间的应用层升级协议(简称PCP协议),用于实现设备的升级。PCP协议运行在应用层,底层可以是LwM2M/CoAP/MQTT或者其他非流式协议。由于PCP协议消息没有使用单独的端口号,并且不依赖于底层协议,为了和设备业务消息区分, - [API使用指导](https://support.huaweicloud.com/devg-iothub/iot_02_9981.md): 为了降低应用侧的开发难度、提升应用侧开发效率,物联网平台向应用侧开放了API(Application Programming Interface)。您可以调用开放的API,快速集成物联网平台的功能,如产品管理、设备管理、订阅管理、设备命令、规则管理等功能。应用侧需要通过IAM服务鉴权,获取token,详细步骤可参考调测“获取IAM用户To - [使用Postman调测](https://support.huaweicloud.com/devg-iothub/iot_02_4008.md): Postman是网页调试与辅助接口调用的工具,具有界面简洁清晰、操作方便快捷的特性,可以处理用户发送的HTTP请求,例如:GET,PUT、POST,DELETE等,支持用户修改HTTP请求中的参数并返回响应数据。为充分了解接口,建议提前获取应用侧API参考查阅。我们已经写好了Postman的collection,在Collection中接 ## API参考 - [使用前必读](https://support.huaweicloud.com/api-iothub/iot_06_v5_0001.md): 物联网平台把自身丰富的管理能力通过API的形式对外开放,包括产品管理、设备管理、设备组管理、标签管理、设备CA证书管理、设备影子、设备命令、设备消息、设备属性、订阅管理、规则管理、批量任务等,帮助用户快速构筑基于物联网平台的行业应用。您可以根据本文档提供的API来使用物联网平台的服务,平台支持的全部API请参见API。物联网平台提供了RE - [构造请求](https://support.huaweicloud.com/api-iothub/iot_06_v5_0090.md): 本节介绍REST API请求的组成,并以调用物联网平台的查询产品 - ShowProduct和创建产品 - CreateProduct接口说明如何调用API,该API可用于获取用户的指定产品信息。请求URI由如下部分组成。{URI-scheme} :// {Endpoint} / {resource-path} ? {query-stri - [认证鉴权](https://support.huaweicloud.com/api-iothub/iot_06_v5_0091.md): 调用接口有如下两种认证方式,您可以选择其中一种进行认证鉴权。Token认证:通过Token认证通用请求。Token认证:通过Token认证通用请求。AK/SK认证:通过AK(Access Key ID)/SK(Secret Access Key)加密调用请求。AK/SK认证:通过AK(Access Key ID)/SK(Secret Ac - [返回结果](https://support.huaweicloud.com/api-iothub/iot_06_v5_0092.md): 请求发送以后,您会收到响应,包含状态码、响应消息头和消息体。状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。对于创建产品 - CreateProduct接口,如果调用后返回状态码为“201”,则表示请求成功。对应请求消息头,响应同样也有消息头,如“Content-type”等。对于创建产品 - [API概览](https://support.huaweicloud.com/api-iothub/iot_06_v5_0003.md): 调用以下接口前,请先参考认证鉴权完成认证鉴权操作。 - [创建产品 - CreateProduct](https://support.huaweicloud.com/api-iothub/iot_06_v5_0050.md): 应用服务器可调用此接口创建产品。此接口仅创建了产品,没有创建和安装插件,如果需要对数据进行编解码,还需要在平台开发和安装插件。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需 - [查询产品列表 - ListProducts](https://support.huaweicloud.com/api-iothub/iot_06_v5_0080.md): 应用服务器可调用此接口查询已导入物联网平台的产品模型信息列表,了解产品模型的概要信息。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源 - [查询产品 - ShowProduct](https://support.huaweicloud.com/api-iothub/iot_06_v5_0052.md): 应用服务器可调用此接口查询已在物联网平台的创建的指定产品模型详细信息,包括产品模型的服务、属性、命令等。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。 - [修改产品 - UpdateProduct](https://support.huaweicloud.com/api-iothub/iot_06_v5_0054.md): 应用服务器可调用此接口修改已导入物联网平台的指定产品模型,包括产品模型的服务、属性、命令等。此接口仅修改了产品,未修改和安装插件,如果修改了产品中的service定义,且在平台中有对应的插件,请修改并重新安装插件。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需 - [删除产品 - DeleteProduct](https://support.huaweicloud.com/api-iothub/iot_06_v5_0056.md): 应用服务器可调用此接口删除已导入物联网平台的指定产品模型。此接口仅删除了产品,未删除关联的插件,在产品下存在设备时,该产品不允许删除。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略 - [创建设备 - AddDevice](https://support.huaweicloud.com/api-iothub/iot_06_v5_0046.md): 应用服务器可调用此接口在物联网平台创建一个设备,仅在创建后设备才可以接入物联网平台。该接口支持使用gateway_id参数指定在父设备下创建一个子设备,并且支持多级子设备,当前最大支持二级子设备。该接口支持使用gateway_id参数指定在父设备下创建一个子设备,并且支持多级子设备,当前最大支持二级子设备。该接口同时还支持对设备进行初始配 - [查询设备列表 - ListDevices](https://support.huaweicloud.com/api-iothub/iot_06_v5_0048.md): 应用服务器可调用此接口查询物联网平台中的设备信息列表。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的 - [查询设备 - ShowDevice](https://support.huaweicloud.com/api-iothub/iot_06_v5_0055.md): 应用服务器可调用此接口查询物联网平台中指定设备的详细信息。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依 - [修改设备 - UpdateDevice](https://support.huaweicloud.com/api-iothub/iot_06_v5_1079.md): 应用服务器可调用此接口修改物联网平台中指定设备的基本信息。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依 - [删除设备 - DeleteDevice](https://support.huaweicloud.com/api-iothub/iot_06_v5_0041.md): 应用服务器可调用此接口在物联网平台上删除指定设备。若设备下连接了非直连设备,则必须把设备下的非直连设备都删除后,才能删除该设备。该接口仅支持删除单个设备,如需批量删除设备,请参见 创建批量任务。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色 - [重置设备密钥 - ResetDeviceSecret](https://support.huaweicloud.com/api-iothub/iot_06_v5_0093.md): 应用服务器可调用此接口重置设备密钥,携带指定密钥时平台将设备密钥重置为指定的密钥,不携带密钥时平台将自动生成一个新的随机密钥返回。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权 - [冻结设备 - FreezeDevice](https://support.huaweicloud.com/api-iothub/iot_06_v5_0094.md): 应用服务器可调用此接口冻结设备,设备冻结后不能再连接上线,可以通过解冻设备接口解除设备冻结。注意,当前仅支持冻结与平台直连的设备。该接口仅支持冻结单个设备,如需批量冻结设备,请参见 创建批量任务。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角 - [解冻设备 - UnfreezeDevice](https://support.huaweicloud.com/api-iothub/iot_06_v5_0095.md): 应用服务器可调用此接口解冻设备,解除冻结后,设备可以连接上线。该接口仅支持解冻单个设备,如需批量解冻设备,请参见 创建批量任务。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权, - [重置设备指纹 - ResetFingerprint](https://support.huaweicloud.com/api-iothub/iot_06_v5_0196.md): 应用服务器可调用此接口重置设备指纹。携带指定设备指纹时将之重置为指定值;不携带时将之置空,后续设备第一次接入时,该设备指纹的值将设置为第一次接入时的证书指纹。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和 - [修改设备网关 - ChangeGateway](https://support.huaweicloud.com/api-iothub/ChangeGateway.md): 应用服务器可调用此接口在物联网平台修改子设备网关。只允许子设备修改网关。只允许子设备修改网关。目标网关必须和当前设备在同一个资源空间。目标网关必须和当前设备在同一个资源空间。网关id不能和当前子设备网关id相同。网关id不能和当前子设备网关id相同。设备如果有下级子设备,则不允许切换网关。设备如果有下级子设备,则不允许切换网关。支持多级子 - [灵活搜索设备列表 - SearchDevices](https://support.huaweicloud.com/api-iothub/SearchDevices.md): 接口说明应用服务器使用SQL语句调用该接口,灵活的搜索所需要的设备资源列表限制仅标准版实例、企业版实例支持该接口调用,基础版不支持。仅标准版实例、企业版实例支持该接口调用,基础版不支持。单账号调用该接口的 TPS 限制最大为1/S(每秒1次请求数)单账号调用该接口的 TPS 限制最大为1/S(每秒1次请求数)类SQL语法使用说明类SQL语 - [查询指定设备加入的设备组列表 - ListDeviceGroupsByDevice](https://support.huaweicloud.com/api-iothub/ListDeviceGroupsByDevice.md): 应用服务器可调用此接口查询物联网平台中的某个设备加入的设备组信息列表。仅标准版实例、企业版实例支持该接口调用,基础版不支持。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具 - [下发设备消息 - CreateMessage](https://support.huaweicloud.com/api-iothub/iot_06_v5_0059.md): 应用服务器可通过物联网平台的下发接口,向指定设备发送控制指令,实现远程设备管理。消息下发流程应用调用接口:应用服务器将消息发送至物联网平台。应用调用接口:应用服务器将消息发送至物联网平台。平台确认接收:平台收到消息后,立即向应用返回一个响应结果,表示平台已成功接收到该消息。平台确认接收:平台收到消息后,立即向应用返回一个响应结果,表示平台 - [查询设备消息 - ListDeviceMessages](https://support.huaweicloud.com/api-iothub/iot_06_v5_0058.md): 应用服务器可调用此接口查询平台下发给设备的消息,平台为每个设备默认最多保存20条消息,超过20条后, 后续的消息会替换下发最早的消息。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略 - [查询指定消息id的消息 - ShowDeviceMessage](https://support.huaweicloud.com/api-iothub/iot_06_v5_0057.md): 应用服务器可调用此接口查询平台下发给设备的指定消息id的消息。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别 - [删除指定消息id的消息 - DeleteDeviceMessage](https://support.huaweicloud.com/api-iothub/DeleteDeviceMessage.md): 应用服务器可调用此接口删除平台下发给设备的指定消息id的消息。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别 - [下发设备命令 - CreateCommand](https://support.huaweicloud.com/api-iothub/iot_06_v5_0038.md): 设备的产品模型中定义了物联网平台可向设备下发的命令,应用服务器可调用此接口向指定设备下发命令,以实现对设备的同步控制。平台负责将命令以同步方式发送给设备,并将设备执行命令结果同步返回, 如果设备没有响应,平台会返回给应用服务器超时,平台超时时间是20秒。如果命令下发需要超过20秒,建议采用消息下发。注意:此接口适用于MQTT设备同步命令下 - [下发异步设备命令 - CreateAsyncCommand](https://support.huaweicloud.com/api-iothub/iot_06_v5_0040.md): 设备的产品模型中定义了物联网平台可向设备下发的命令,应用服务器可调用此接口向指定设备下发异步命令,以实现对设备的控制。平台负责将命令发送给设备,并将设备执行命令结果异步通知应用服务器。 命令执行结果支持灵活的数据流转,应用服务器通过调用物联网平台的创建规则触发条件(Resource:device.command.status,Event: - [查询设备下队列中的命令 - ListAsyncCommands](https://support.huaweicloud.com/api-iothub/ListAsyncCommands.md): 查询设备下队列中的命令(处理中的命令),包含PENDING、SENT、DELIVERED三种状态,注意:DELIVERED状态的命令经过系统设定的一段时间(具体以系统配置为准)仍然没有更新,就会从队列中移除,变为历史命令。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用A - [查询设备下的历史命令 - ListAsyncHistoryCommands](https://support.huaweicloud.com/api-iothub/ListAsyncHistoryCommands.md): 查询设备下发的历史异步命令,包含EXPIRED、SUCCESSFUL、FAILED、TIMEOUT、DELIVERED五种状态。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权, - [统计设备下的历史命令总数 - CountAsyncHistoryCommands](https://support.huaweicloud.com/api-iothub/CountAsyncHistoryCommands.md): 统计设备下的历史命令总数。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项iotda:histo - [查询指定id的命令 - ShowAsyncDeviceCommand](https://support.huaweicloud.com/api-iothub/iot_06_v5_0042.md): 物联网平台可查询指定id的命令。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项iotda:as - [修改设备属性 - UpdateProperties](https://support.huaweicloud.com/api-iothub/iot_06_v5_0035.md): 设备的产品模型中定义了物联网平台可向设备下发的属性,应用服务器可调用此接口向指定设备下发属性。平台负责将属性以同步方式发送给设备,并将设备执行属性结果同步返回,如果设备没有响应,平台会返回给应用服务器超时,平台超时时间是20秒。注意:此接口适用于MQTT设备,暂不支持NB-IoT设备。请参见如何调用API。账号具备所有API的调用权限,如 - [查询设备属性 - ListProperties](https://support.huaweicloud.com/api-iothub/iot_06_v5_0034.md): 设备的产品模型中定义了物联网平台可向设备下发的属性,应用服务器可调用此接口向设备发送指令用以查询设备的实时属性, 并由设备将属性查询的结果同步返回给应用服务器。注意:此接口适用于MQTT设备,暂不支持NB-IoT设备。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API - [创建AMQP队列 - AddQueue](https://support.huaweicloud.com/api-iothub/iot_06_v5_0103.md): 应用服务器可调用此接口在物联网平台创建一个AMQP队列。每个租户只能创建100个队列,若超过规格,则创建失败,若队列名称与已有的队列名称相同,则创建失败。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权 - [查询AMQP列表 - BatchShowQueue](https://support.huaweicloud.com/api-iothub/iot_06_v5_0102.md): 应用服务器可调用此接口查询物联网平台中的AMQP队列信息列表。可通过队列名称作模糊查询,支持分页。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项 - [查询单个AMQP队列 - ShowQueue](https://support.huaweicloud.com/api-iothub/iot_06_v5_0104.md): 应用服务器可调用此接口查询物联网平台中指定队列的详细信息。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依 - [删除AMQP队列 - DeleteQueue](https://support.huaweicloud.com/api-iothub/iot_06_v5_0105.md): 应用服务器可调用此接口在物联网平台上删除指定AMQP队列。若当前队列正在使用,则会删除失败。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级 - [生成接入凭证 - CreateAccessCode](https://support.huaweicloud.com/api-iothub/iot_06_v5_0111.md): 接入凭证是用于客户端使用AMQP等协议与平台建链的一个认证凭据。只保留一条记录,如果重复调用只会重置接入凭证,使得之前的失效。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需 - [创建规则触发条件 - CreateRoutingRule](https://support.huaweicloud.com/api-iothub/iot_06_v5_01307.md): 应用服务器可调用此接口在物联网平台创建一条规则触发条件。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖 - [查询规则条件列表 - ListRoutingRules](https://support.huaweicloud.com/api-iothub/iot_06_v5_01306.md): 应用服务器可调用此接口查询物联网平台中设置的规则条件列表。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依 - [查询规则条件 - ShowRoutingRule](https://support.huaweicloud.com/api-iothub/iot_06_v5_01308.md): 应用服务器可调用此接口查询物联网平台中指定规则条件的配置信息。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别 - [修改规则触发条件 - UpdateRoutingRule](https://support.huaweicloud.com/api-iothub/iot_06_v5_01309.md): 应用服务器可调用此接口修改物联网平台中指定规则条件的配置参数。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别 - [删除规则触发条件 - DeleteRoutingRule](https://support.huaweicloud.com/api-iothub/iot_06_v5_01310.md): 应用服务器可调用此接口删除物联网平台中的指定规则条件。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的 - [创建规则动作 - CreateRuleAction](https://support.huaweicloud.com/api-iothub/iot_06_v5_01302.md): 应用服务器可调用此接口在物联网平台创建一条规则动作。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授 - [查询规则动作列表 - ListRuleActions](https://support.huaweicloud.com/api-iothub/iot_06_v5_01301.md): 应用服务器可调用此接口查询物联网平台中设置的规则动作列表。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依 - [查询规则动作 - ShowRuleAction](https://support.huaweicloud.com/api-iothub/iot_06_v5_01303.md): 应用服务器可调用此接口查询物联网平台中指定规则动作的配置信息。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别 - [修改规则动作 - UpdateRuleAction](https://support.huaweicloud.com/api-iothub/iot_06_v5_01304.md): 应用服务器可调用此接口修改物联网平台中指定规则动作的配置。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依 - [删除规则动作 - DeleteRuleAction](https://support.huaweicloud.com/api-iothub/iot_06_v5_01305.md): 应用服务器可调用此接口删除物联网平台中的指定规则动作。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的 - [设备状态变更通知](https://support.huaweicloud.com/api-iothub/iot_06_v5_01201.md): 应用服务器在调用物联网平台的创建规则触发条件 - CreateRoutingRule(Resource:device.status,Event:update)、创建规则动作 - CreateRuleAction、修改规则触发条件 - UpdateRoutingRule接口配置并激活规则后,当物联网平台中的设备状态发生变更时,物联网平台会向 - [设备属性上报通知](https://support.huaweicloud.com/api-iothub/iot_06_v5_01202.md): 应用服务器在调用物联网平台的创建规则触发条件 - CreateRoutingRule(Resource:device.property,Event:report)、创建规则动作 - CreateRuleAction、修改规则触发条件 - UpdateRoutingRule接口配置并激活规则后,当设备上报属性数据时,物联网平台会向应用服务器 - [设备消息状态变更通知](https://support.huaweicloud.com/api-iothub/iot_06_v5_01203.md): 应用服务器在调用物联网平台的创建规则触发条件 - CreateRoutingRule(Resource:device.message.status,Event:update)、创建规则动作 - CreateRuleAction、修改规则触发条件 - UpdateRoutingRule接口配置并激活规则后,当设备消息状态变更时,物联网平台会 - [批量任务状态变更通知](https://support.huaweicloud.com/api-iothub/iot_06_v5_01204.md): 应用服务器在调用物联网平台创建规则触发条件 - CreateRoutingRule(Resource:batchtask,Event:update)、创建规则动作 - CreateRuleAction、修改规则触发条件 - UpdateRoutingRule接口配置并激活规则后,当批量任务状态变更时,物联网平台会向应用服务器推送通知消息。 - [设备消息上报通知](https://support.huaweicloud.com/api-iothub/iot_06_v5_01205.md): 应用服务器在调用物联网平台的创建规则触发条件 - CreateRoutingRule(Resource:device.message,Event:report)、创建规则动作 - CreateRuleAction、修改规则触发条件 - UpdateRoutingRule接口配置并激活规则后,当设备上报消息数据时,物联网平台会向应用服务器推 - [设备添加通知](https://support.huaweicloud.com/api-iothub/iot_06_v5_01206.md): 应用服务器在调用物联网平台的创建规则触发条件 - CreateRoutingRule(Resource:device,Event:create)、创建规则动作 - CreateRuleAction、修改规则触发条件 - UpdateRoutingRule接口配置并激活规则后,当物联网平台中的设备添加时,物联网平台会向应用服务器推送通知消息 - [设备更新通知](https://support.huaweicloud.com/api-iothub/iot_06_v5_01207.md): 应用服务器在调用物联网平台的创建规则触发条件 - CreateRoutingRule(Resource:device,Event:update)、创建规则动作 - CreateRuleAction、修改规则触发条件 - UpdateRoutingRule接口配置并激活规则后,当物联网平台中的设备更新时,物联网平台会向应用服务器推送通知消息 - [设备删除通知](https://support.huaweicloud.com/api-iothub/iot_06_v5_01208.md): 应用服务器在调用物联网平台的创建规则触发条件 - CreateRoutingRule(Resource:device,Event:delete)、创建规则动作 - CreateRuleAction、修改规则触发条件 - UpdateRoutingRule接口配置并激活规则后,当物联网平台中的设备删除时,物联网平台会向应用服务器推送通知消息 - [产品添加通知](https://support.huaweicloud.com/api-iothub/iot_06_v5_01209.md): 应用服务器在调用物联网平台的创建规则触发条件 - CreateRoutingRule(Resource:product,Event:create)、创建规则动作 - CreateRuleAction、修改规则触发条件 - UpdateRoutingRule接口配置并激活规则后,当物联网平台中的产品添加时,物联网平台会向应用服务器推送通知消 - [产品更新通知](https://support.huaweicloud.com/api-iothub/iot_06_v5_01210.md): 应用服务器在调用物联网平台的创建规则触发条件 - CreateRoutingRule(Resource:product,Event:update)、创建规则动作 - CreateRuleAction、修改规则触发条件 - UpdateRoutingRule接口配置并激活规则后,当物联网平台中的产品更新时,物联网平台会向应用服务器推送通知消 - [产品删除通知](https://support.huaweicloud.com/api-iothub/iot_06_v5_01211.md): 应用服务器在调用物联网平台的创建规则触发条件 - CreateRoutingRule(Resource:product,Event:delete)、创建规则动作 - CreateRuleAction、修改规则触发条件 - UpdateRoutingRule接口配置并激活规则后,当物联网平台中的产品删除时,物联网平台会向应用服务器推送通知消 - [设备异步命令状态变更通知](https://support.huaweicloud.com/api-iothub/iot_06_v5_01212.md): 应用服务器在调用物联网平台的创建规则触发条件 - CreateRoutingRule(Resource:device.command.status,Event:update)、创建规则动作 - CreateRuleAction、修改规则触发条件 - UpdateRoutingRule接口配置并激活规则后,当命令状态变更时,物联网平台会向应 - [创建规则 - CreateRule](https://support.huaweicloud.com/api-iothub/iot_06_v5_0084.md): 应用服务器可调用此接口在物联网平台创建一条规则。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项 - [查询规则列表 - ListRules](https://support.huaweicloud.com/api-iothub/iot_06_v5_0082.md): 应用服务器可调用此接口查询物联网平台中设置的规则列表。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的 - [修改规则 - UpdateRule](https://support.huaweicloud.com/api-iothub/iot_06_v5_0085.md): 应用服务器可调用此接口修改物联网平台中指定规则的配置。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的 - [查询规则 - ShowRule](https://support.huaweicloud.com/api-iothub/iot_06_v5_0087.md): 应用服务器可调用此接口查询物联网平台中指定规则的配置信息。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依 - [删除规则 - DeleteRule](https://support.huaweicloud.com/api-iothub/iot_06_v5_0086.md): 应用服务器可调用此接口删除物联网平台中的指定规则。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权 - [修改规则状态 - ChangeRuleStatus](https://support.huaweicloud.com/api-iothub/iot_06_v5_0088.md): 应用服务器可调用此接口修改物联网平台中指定规则的状态,激活或者去激活规则。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必 - [查询设备影子数据 - ShowDeviceShadow](https://support.huaweicloud.com/api-iothub/iot_06_v5_0079.md): 应用服务器可调用此接口查询指定设备的设备影子信息,包括对设备的期望属性信息(desired区)和设备最新上报的属性信息(reported区)。设备影子介绍:设备影子是一个用于存储和检索设备当前状态信息的JSON文档。每个设备有且只有一个设备影子,由设备ID唯一标识每个设备有且只有一个设备影子,由设备ID唯一标识设备影子用于存储设备上报的( - [删除设备影子数据 - DeleteDeviceShadow](https://support.huaweicloud.com/api-iothub/DeleteDeviceShadow.md): 应用服务器可调用此接口删除指定设备的设备影子信息,包括对设备的期望属性信息(desired区)和设备最新上报的属性信息(reported区)中的所有数据。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权 - [配置设备影子预期数据 - UpdateDeviceShadowDesiredData](https://support.huaweicloud.com/api-iothub/iot_06_v5_0072.md): 应用服务器可调用此接口配置设备影子的预期属性(desired区),当设备上线或者设备上报属性时把属性下发给设备。设备影子介绍:设备影子是一个用于存储和检索设备当前状态信息的JSON文档。每个设备有且只有一个设备影子,由设备ID唯一标识每个设备有且只有一个设备影子,由设备ID唯一标识设备影子用于存储设备上报的(状态)属性和应用程序期望的设备 - [添加设备组 - AddDeviceGroup](https://support.huaweicloud.com/api-iothub/iot_06_v5_0051.md): 应用服务器可调用此接口新建设备组,一个账号下最多可有1,000个设备组,包括父设备组和子设备组。设备组的最大层级关系不超过5层,即群组形成的关系树最大深度不超过5。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见 - [查询设备组列表 - ListDeviceGroups](https://support.huaweicloud.com/api-iothub/iot_06_v5_0053.md): 应用服务器可调用此接口查询物联网平台中的设备组信息列表。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖 - [查询设备组 - ShowDeviceGroup](https://support.huaweicloud.com/api-iothub/iot_06_v5_0075.md): 应用服务器可调用此接口查询指定设备组详情。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项iot - [修改设备组 - UpdateDeviceGroup](https://support.huaweicloud.com/api-iothub/iot_06_v5_0073.md): 应用服务器可调用此接口修改物联网平台中指定设备组。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权 - [删除设备组 - DeleteDeviceGroup](https://support.huaweicloud.com/api-iothub/iot_06_v5_0071.md): 应用服务器可调用此接口删除指定设备组。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项iotda - [管理设备组中的设备 - CreateOrDeleteDeviceInGroup](https://support.huaweicloud.com/api-iothub/iot_06_v5_0070.md): 应用服务器可调用此接口管理设备组中的设备。单个设备组内最多添加20,000个设备,一个设备最多可以被添加到10个设备组中。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备 - [查询设备组设备列表 - ShowDevicesInGroup](https://support.huaweicloud.com/api-iothub/iot_06_v5_0074.md): 应用服务器可调用此接口查询指定设备组下的设备列表。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权 - [绑定标签 - TagDevice](https://support.huaweicloud.com/api-iothub/iot_06_v5_0009.md): 应用服务器可调用此接口为指定资源绑定标签。当前支持标签的资源有Device(设备)。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类 - [解绑标签 - UntagDevice](https://support.huaweicloud.com/api-iothub/iot_06_v5_0010.md): 应用服务器可调用此接口为指定资源解绑标签。当前支持标签的资源有Device(设备)。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类 - [按标签查询资源 - ListResourcesByTags](https://support.huaweicloud.com/api-iothub/iot_06_v5_0030.md): 应用服务器可调用此接口查询绑定了指定标签的资源。当前支持标签的资源有Device(设备)。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别 - [创建设备接入实例 - CreateInstance](https://support.huaweicloud.com/api-iothub/CreateInstance.md): 用户可以调用此接口创建一个设备接入实例。支持的实例规格请参见产品规格说明。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必 - [查询实例列表 - ListInstances](https://support.huaweicloud.com/api-iothub/ListInstances.md): 用户可以调用此接口查询设备接入实例列表。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项iotd - [查询实例详情 - ShowInstance](https://support.huaweicloud.com/api-iothub/ShowInstance.md): 查询设备接入实例详情。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项iotda:instanc - [修改实例信息 - UpdateInstance](https://support.huaweicloud.com/api-iothub/UpdateInstance.md): 修改设备接入实例信息。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项iotda:instanc - [删除实例 - DeleteInstance](https://support.huaweicloud.com/api-iothub/DeleteInstance.md): 删除设备接入实例。约束:此接口仅支持删除按需计费的实例。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖 - [修改实例规格信息 - ResizeInstance](https://support.huaweicloud.com/api-iothub/ResizeInstance.md): 修改设备接入实例的规格。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项iotda:instan - [修改实例计费模式 - ChangeInstanceChargeMode](https://support.huaweicloud.com/api-iothub/ChangeInstanceChargeMode.md): 修改设备接入实例的计费模式,支持将按需计费模式修改为包年/包月计费模式。接口约束:当前实例的规格支持包年/包月计费模式时,才可以修改实例的计费模式为包年/包月。支持的实例规格请参见产品规格说明。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色 - [添加实例标签 - BindInstanceTags](https://support.huaweicloud.com/api-iothub/BindInstanceTags.md): 添加实例标签。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项iotda:instance:op - [删除实例标签 - UnbindInstanceTags](https://support.huaweicloud.com/api-iothub/UnbindInstanceTags.md): 删除实例标签。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,当前API调用无需身份策略权限。POST /v5/iot/{project_id}/iotda-instances - [查询实例规格列表 - ListInstanceFlavors](https://support.huaweicloud.com/api-iothub/ListInstanceFlavors.md): 用户可以调用此接口查询设备接入服务支持的实例规格列表。支持的实例规格请参见产品规格说明。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,当前API调用无需身份策略权限。GET - [查询实例任务列表 - ListInstanceTasks](https://support.huaweicloud.com/api-iothub/ListInstanceTasks.md): 用户可以调用此接口查询设备接入实例任务列表。接口约束:仅支持查询180天内的实例任务,实例任务的最大数量为20条。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份 - [查询实例任务详情 - ShowInstanceTask](https://support.huaweicloud.com/api-iothub/ShowInstanceTask.md): 用户可以调用此接口查询设备接入实例任务详情。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项io - [重试实例任务 - RetryInstanceTask](https://support.huaweicloud.com/api-iothub/RetryInstanceTask.md): 用户可以调用此接口对运行失败的实例任务进行重试。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项 - [查询资源空间列表 - ShowApplications](https://support.huaweicloud.com/api-iothub/iot_06_v5_6011.md): 资源空间对应的是物联网平台原有的应用,在物联网平台的含义与应用一致,只是变更了名称。应用服务器可以调用此接口查询资源空间列表。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需 - [创建资源空间 - AddApplication](https://support.huaweicloud.com/api-iothub/iot_06_v5_6012.md): 资源空间对应的是物联网平台原有的应用,在物联网平台的含义与应用一致,只是变更了名称。应用服务器可以调用此接口创建资源空间。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备 - [查询资源空间 - ShowApplication](https://support.huaweicloud.com/api-iothub/iot_06_v5_6013.md): 资源空间对应的是物联网平台原有的应用,在物联网平台的含义与应用一致,只是变更了名称。应用服务器可以调用此接口查询指定资源空间详情。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权 - [删除资源空间 - DeleteApplication](https://support.huaweicloud.com/api-iothub/iot_06_v5_6014.md): 删除指定资源空间。删除资源空间属于高危操作,删除资源空间后,该空间下的产品、设备等资源将不可用,请谨慎操作!请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权 - [更新资源空间 - UpdateApplication](https://support.huaweicloud.com/api-iothub/UpdateApplication.md): 应用服务器可以调用此接口更新资源空间的名称请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项iot - [创建批量任务 - CreateBatchTask](https://support.huaweicloud.com/api-iothub/iot_06_v5_0045.md): 应用服务器可调用此接口为创建批量处理任务,对多个设备进行批量操作。当前支持批量软固件升级、批量创建设备、批量修改设备、批量删除设备、批量冻结设备、批量解冻设备、批量创建命令、批量创建消息任务。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与 - [查询批量任务列表 - ListBatchTasks](https://support.huaweicloud.com/api-iothub/iot_06_v5_0028.md): 应用服务器可调用此接口查询物联网平台中批量任务列表,每一个任务又包括具体的任务内容、任务状态、任务完成情况统计等。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份 - [查询批量任务 - ShowBatchTask](https://support.huaweicloud.com/api-iothub/iot_06_v5_0017.md): 应用服务器可调用此接口查询物联网平台中指定批量任务的信息,包括任务内容、任务状态、任务完成情况统计以及子任务列表等。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身 - [删除批量任务 - DeleteBatchTask](https://support.huaweicloud.com/api-iothub/DeleteBatchTask.md): 应用服务器可调用此接口删除物联网平台中已经完成(状态为成功,失败,部分成功,已停止)的批量任务。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访 - [重试批量任务 - RetryBatchTask](https://support.huaweicloud.com/api-iothub/RetryBatchTask.md): 应用服务器可调用此接口重试批量任务,目前只支持task_type为firmwareUpgrade,softwareUpgrade。如果task_id对应任务已经成功、停止、正在停止、等待中或初始化中,则不可以调用该接口。如果请求Body为{},则调用该接口后会重新执行所有状态为失败、失败待重试和已停止的子任务。请参见如何调用API。账号具 - [停止批量任务 - StopBatchTask](https://support.huaweicloud.com/api-iothub/StopBatchTask.md): 应用服务器可调用此接口停止批量任务,目前只支持task_type为firmwareUpgrade,softwareUpgrade。如果task_id对应任务已经完成(成功、失败、部分成功,已经停止)或正在停止中,则不可以调用该接口。如果请求Body为{},则调用该接口后会停止所有正在执行中、等待中和失败待重试状态的子任务。请参见如何调用A - [确认执行批量任务 - ConfirmBatchTask](https://support.huaweicloud.com/api-iothub/ConfirmBatchTask.md): 应用服务器可调用此接口确认执行批量任务,目前只支持task_type为firmwareUpgrade、softwareUpgrade和moduleUpgrade。如果task_id对应任务已经完成(成功、失败、部分成功、已经停止)或正在停止中,则不可以调用该接口。如果请求Body为{},则调用该接口后会确认执行所有处于等待中状态的子任务。 - [上传批量任务文件 - UploadBatchTaskFile](https://support.huaweicloud.com/api-iothub/iot_06_v5_0021.md): 应用服务器可调用此接口上传批量任务文件,用于创建批量任务。当前支持批量创建设备任务、批量删除设备任务、批量冻结设备任务、批量解冻设备任务的文件上传。批量注册设备模板批量删除设备模板批量冻结设备模板批量解冻设备模板请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的 - [查询批量任务文件列表 - ListBatchTaskFiles](https://support.huaweicloud.com/api-iothub/iot_06_v5_0015.md): 应用服务器可调用此接口查询批量任务文件列表。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项io - [删除批量任务文件 - DeleteBatchTaskFile](https://support.huaweicloud.com/api-iothub/iot_06_v5_0024.md): 应用服务器可调用此接口删除批量任务文件。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项iotd - [上传CA证书 - AddCertificate](https://support.huaweicloud.com/api-iothub/iot_06_v5_0014.md): 应用服务器可调用此接口在物联网平台上传CA证书,当用于设备身份认证时只有已验证状态的CA证书生效,用于数据转发则无此限制。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备 - [获取CA证书列表 - ListCertificates](https://support.huaweicloud.com/api-iothub/iot_06_v5_0099.md): 应用服务器可调用此接口在物联网平台获取CA证书列表请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权 - [删除CA证书 - DeleteCertificate](https://support.huaweicloud.com/api-iothub/iot_06_v5_0022.md): 应用服务器可调用此接口在物联网平台删除CA证书请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项i - [查询CA证书 - ShowCertificate](https://support.huaweicloud.com/api-iothub/ShowCertificate.md): 应用服务器可调用此接口在物联网平台查询CA证书请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项i - [更新CA证书 - UpdateCertificate](https://support.huaweicloud.com/api-iothub/UpdateCertificate.md): 应用服务器可调用此接口在物联网平台上更新CA证书。仅标准版实例、企业版实例支持该接口调用,基础版不支持。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。 - [验证CA证书 - CheckCertificate](https://support.huaweicloud.com/api-iothub/iot_06_v5_0016.md): 应用服务器可调用此接口在物联网平台验证CA证书,目的是为了验证用户持有CA证书的私钥,验证通过后才能开启自注册、OCSP功能与设备证书身份认证。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使 - [创建OTA升级包 - CreateOtaPackage](https://support.huaweicloud.com/api-iothub/CreateOtaPackage.md): 用户可调用此接口创建升级包关联OBS对象使用前提:使用该API需要您授权设备接入服务(IoTDA)的实例访问对象存储服务(OBS)以及 密钥管理服务(KMS Administrator)的权限,详细授权清单参考委托授权。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用AP - [查询OTA升级包列表 - ListOtaPackageInfo](https://support.huaweicloud.com/api-iothub/ListOtaPackageInfo.md): 用户可调用此接口查询关联OBS对象的升级包列表使用前提:使用该API需要您授权设备接入服务(IoTDA)的实例访问对象存储服务(OBS)以及 密钥管理服务(KMS Administrator)的权限,详细授权清单参考委托授权。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调 - [获取OTA升级包详情 - ShowOtaPackage](https://support.huaweicloud.com/api-iothub/ShowOtaPackage.md): 用户可调用此接口查询关联OBS对象的升级包详情使用前提:使用该API需要您授权设备接入服务(IoTDA)的实例访问对象存储服务(OBS)以及 密钥管理服务(KMS Administrator)的权限,详细授权清单参考委托授权。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调 - [删除OTA升级包 - DeleteOtaPackage](https://support.huaweicloud.com/api-iothub/DeleteOtaPackage.md): 用户可调用此接口删除关联OBS对象的升级包信息,不会删除OBS上对象使用前提:使用该API需要您授权设备接入服务(IoTDA)的实例访问对象存储服务(OBS)以及 密钥管理服务(KMS Administrator)的权限,详细授权清单参考委托授权。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API - [下发广播消息 - BroadcastMessage](https://support.huaweicloud.com/api-iothub/BroadcastMessage.md): 应用服务器可调用此接口向订阅了指定Topic的所有在线设备发布广播消息。应用将广播消息下发给平台后,平台会先返回应用响应结果,再将消息广播给设备。注意:此接口只适用于使用MQTT协议接入的设备。此接口只适用于使用MQTT协议接入的设备。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用 - [创建设备隧道 - AddTunnel](https://support.huaweicloud.com/api-iothub/AddTunnel.md): 用户可以通过该接口创建隧道(WebSocket协议),应用服务器和设备可以通过该隧道进行数据传输。该API接口在基础版不支持。该API接口在基础版不支持。该API调用后平台会向对应的MQTT/MQTTS设备下发隧道地址及密钥,同时给应用服务器也返回隧道地址及密钥,设备可以通过该地址及密钥创建WebSocket协议连接。该API调用后平台会 - [查询设备所有隧道 - ListDeviceTunnels](https://support.huaweicloud.com/api-iothub/ListDeviceTunnels.md): 用户可通过该接口查询某项目下的所有设备隧道,以实现对设备管理。应用服务器可通过此接口向平台查询设备隧道建立的情况。该API接口在基础版不支持。该API接口在基础版不支持。具体应用可见“设备远程登录”功能,请参见设备远程登录。具体应用可见“设备远程登录”功能,请参见设备远程登录。请参见如何调用API。账号具备所有API的调用权限,如果使用账 - [查询设备隧道 - ShowDeviceTunnel](https://support.huaweicloud.com/api-iothub/ShowDeviceTunnel.md): 用户可通过该接口查询某项目中的某个设备隧道,查看该设备隧道的信息与连接情况。应用服务器可调用此接口向平台查询设备隧道建立情况。该API接口在基础版不支持。该API接口在基础版不支持。具体应用可见“设备远程登录”功能,请参见设备远程登录。具体应用可见“设备远程登录”功能,请参见设备远程登录。请参见如何调用API。账号具备所有API的调用权限 - [关闭设备隧道 - UpdateDeviceTunnel](https://support.huaweicloud.com/api-iothub/CloseDeviceTunnel.md): 应用服务器可通过该接口关闭某个设备隧道。关闭后可以再次连接。该API接口在基础版不支持。该API接口在基础版不支持。具体应用可见“设备远程登录”功能,请参见设备远程登录。具体应用可见“设备远程登录”功能,请参见设备远程登录。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用 - [删除设备隧道 - DeleteDeviceTunnel](https://support.huaweicloud.com/api-iothub/DeleteDeviceTunnel.md): 用户可通过该接口删除某个设备隧道。删除后该通道不存在,无法再次连接。该API接口在基础版不支持。该API接口在基础版不支持。具体应用可见“设备远程登录”功能,请参见设备远程登录。具体应用可见“设备远程登录”功能,请参见设备远程登录。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需 - [新建数据流转积压策略 - CreateRoutingBacklogPolicy](https://support.huaweicloud.com/api-iothub/CreateRoutingBacklogPolicy.md): 应用服务器可调用此接口在物联网平台创建数据流转积压策略。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖 - [查询数据流转积压策略列表 - ListRoutingBacklogPolicy](https://support.huaweicloud.com/api-iothub/ListRoutingBacklogPolicy.md): 应用服务器可调用此接口查询在物联网平台设置的数据流转积压策略列表。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件 - [修改数据流转积压策略 - UpdateRoutingBacklogPolicy](https://support.huaweicloud.com/api-iothub/UpdateRoutingBacklogPolicy.md): 应用服务器可调用此接口在物联网平台修改指定数据流转积压策略。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名 - [查询数据流转积压策略 - ShowRoutingBacklogPolicy](https://support.huaweicloud.com/api-iothub/ShowRoutingBacklogPolicy.md): 应用服务器可调用此接口在物联网平台查询指定数据流转积压策略。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名 - [删除数据流转积压策略 - DeleteRoutingBacklogPolicy](https://support.huaweicloud.com/api-iothub/DeleteRoutingBacklogPolicy.md): 应用服务器可调用此接口在物联网平台删除指定数据流转积压策略。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名 - [新建数据流转流控策略 - CreateRoutingFlowControlPolicy](https://support.huaweicloud.com/api-iothub/CreateRoutingFlowControlPolicy.md): 应用服务器可调用此接口在物联网平台创建数据流转流控策略。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖 - [查询数据流转流控策略列表 - ListRoutingFlowControlPolicy](https://support.huaweicloud.com/api-iothub/ListRoutingFlowControlPolicy.md): 应用服务器可调用此接口查询在物联网平台设置的数据流转流控策略列表。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件 - [修改数据流转流控策略 - UpdateRoutingFlowControlPolicy](https://support.huaweicloud.com/api-iothub/UpdateRoutingFlowControlPolicy.md): 应用服务器可调用此接口在物联网平台修改指定数据流转流控策略。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名 - [查询数据流转流控策略 - ShowRoutingFlowControlPolicy](https://support.huaweicloud.com/api-iothub/ShowRoutingFlowControlPolicy.md): 应用服务器可调用此接口在物联网平台查询指定数据流转流控策略。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名 - [删除数据流转流控策略 - DeleteRoutingFlowControlPolicy](https://support.huaweicloud.com/api-iothub/DeleteRoutingFlowControlPolicy.md): 应用服务器可调用此接口在物联网平台删除指定数据流转流控策略。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名 - [创建设备代理 - CreateDeviceProxy](https://support.huaweicloud.com/api-iothub/CreateDeviceProxy.md): 应用服务器可调用此接口在物联网平台创建一个动态设备代理规则,用于子设备自主选择网关设备上线和上报消息,即代理组下的任意网关下的子设备均可以通过代理组里其他设备上线(网关更新子设备状态)然后进行数据上报(网关批量设备属性上报)。单实例最多可以配置10个设备代理单账号调用该接口的 TPS 限制最大为1/S(每秒1次请求数)单实例最多可以配置1 - [查询设备代理列表 - ListDeviceProxies](https://support.huaweicloud.com/api-iothub/ListDeviceProxies.md): 应用服务器可调用此接口查询物联网平台中的设备代理列表。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的 - [查询设备代理详情 - ShowDeviceProxy](https://support.huaweicloud.com/api-iothub/ShowDeviceProxy.md): 应用服务器可调用此接口查询物联网平台中指定设备代理的详细信息。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别 - [修改设备代理 - UpdateDeviceProxy](https://support.huaweicloud.com/api-iothub/UpdateDeviceProxy.md): 应用服务器可调用此接口修改物联网平台中指定设备代理的基本信息。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别 - [删除设备代理 - DeleteDeviceProxy](https://support.huaweicloud.com/api-iothub/DeleteDeviceProxy.md): 应用服务器可调用此接口在物联网平台上删除指定设备代理。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的 - [创建设备策略 - CreateDevicePolicy](https://support.huaweicloud.com/api-iothub/CreateDevicePolicy.md): 应用服务器可调用此接口在物联网平台创建一个策略,该策略需要绑定到设备和产品下才能生效。一个实例最多能创建50个设备策略。一个实例最多能创建50个设备策略。仅标准版实例、企业版实例支持该接口调用,基础版不支持。仅标准版实例、企业版实例支持该接口调用,基础版不支持。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户 - [查询设备策略列表 - ListDevicePolicies](https://support.huaweicloud.com/api-iothub/ListDevicePolicies.md): 应用服务器可调用此接口在物联网平台查询策略列表。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项 - [删除设备策略 - DeleteDevicePolicy](https://support.huaweicloud.com/api-iothub/DeleteDevicePolicy.md): 应用服务器可调用此接口在物联网平台上删除指定策略,注意:删除策略同时会解绑该策略下所有绑定对象。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访 - [查询设备策略详情 - ShowDevicePolicy](https://support.huaweicloud.com/api-iothub/ShowDevicePolicy.md): 应用服务器可调用此接口在物联网平台查询指定策略ID的详细信息。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别 - [更新设备策略信息 - UpdateDevicePolicy](https://support.huaweicloud.com/api-iothub/UpdateDevicePolicy.md): 应用服务器可调用此接口在物联网平台更新策略。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项io - [绑定设备策略 - BindDevicePolicy](https://support.huaweicloud.com/api-iothub/BindDevicePolicy.md): 应用服务器可调用此接口在物联网平台上为批量设备绑定目标策略,目前支持绑定目标类型为:设备、产品,当目标类型为产品时,该产品下所有设备都会生效。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用 - [解绑设备策略 - UnbindDevicePolicy](https://support.huaweicloud.com/api-iothub/UnbindDevicePolicy.md): 应用服务器可调用此接口在物联网平台上解除指定策略下绑定的目标对象。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件 - [查询设备策略绑定的目标列表 - ShowTargetsInDevicePolicy](https://support.huaweicloud.com/api-iothub/ShowTargetsInDevicePolicy.md): 应用服务器可调用此接口在物联网平台上查询指定策略ID下绑定的目标列表。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须) - [创建网桥 - AddBridge](https://support.huaweicloud.com/api-iothub/AddBridge.md): 应用服务器可调用此接口在物联网平台创建一个网桥,仅在创建后的网桥才可以接入物联网平台。一个实例最多支持20个网桥。一个实例最多支持20个网桥。仅标准版实例、企业版实例支持该接口调用,基础版不支持。仅标准版实例、企业版实例支持该接口调用,基础版不支持。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前AP - [查询网桥列表 - ListBridges](https://support.huaweicloud.com/api-iothub/ListBridges.md): 应用服务器可调用此接口在物联网平台查询网桥列表。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项 - [删除网桥 - DeleteBridge](https://support.huaweicloud.com/api-iothub/DeleteBridge.md): 应用服务器可调用此接口在物联网平台上删除指定网桥。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权 - [重置网桥密钥 - ResetBridgeSecret](https://support.huaweicloud.com/api-iothub/ResetBridgeSecret.md): 应用服务器可调用此接口在物联网平台上重置网桥密钥。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权 - [创建预调配模板 - CreateProvisioningTemplate](https://support.huaweicloud.com/api-iothub/CreateProvisioningTemplate.md): 应用服务器可调用此接口在物联网平台创建一个预调配模板。用户的设备未在平台注册时,可以通过预调配模板在设备首次接入物联网平台时将设备信息自动注册到物联网平台。该预调配模板至少需要绑定到一个设备CA证书下才能生效。该预调配模板至少需要绑定到一个设备CA证书下才能生效。一个实例最多可有10个预调配模板。一个实例最多可有10个预调配模板。仅标准版 - [查询预调配模板列表 - ListProvisioningTemplates](https://support.huaweicloud.com/api-iothub/ListProvisioningTemplates.md): 应用服务器可调用此接口在物联网平台查询预调配模板列表。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的 - [删除预调配模板 - DeleteProvisioningTemplate](https://support.huaweicloud.com/api-iothub/DeleteProvisioningTemplate.md): 应用服务器可调用此接口在物联网平台上删除指定预调配模板。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖 - [查询预调配模板详情 - ShowProvisioningTemplate](https://support.huaweicloud.com/api-iothub/ShowProvisioningTemplate.md): 应用服务器可调用此接口在物联网平台查询指定预调配模板ID的详细信息。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条 - [更新指定id的预调配模板信息 - UpdateProvisioningTemplate](https://support.huaweicloud.com/api-iothub/UpdateProvisioningTemplate.md): 应用服务器可调用此接口在物联网平台更新指定id的预调配模板。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名 - [创建自定义鉴权 - CreateDeviceAuthorizer](https://support.huaweicloud.com/api-iothub/CreateDeviceAuthorizer.md): 应用服务器可调用此接口在物联网平台创建一个自定义鉴权。自定义鉴权是指用户可以通过函数服务自定义实现鉴权逻辑,以对接入平台的设备进行身份认证。单个实例最大可配置10个自定义鉴权单个实例最大可配置10个自定义鉴权仅标准版实例、企业版实例支持该接口调用,基础版不支持。仅标准版实例、企业版实例支持该接口调用,基础版不支持。请参见如何调用API。账 - [查询自定义鉴权列表 - ListDeviceAuthorizers](https://support.huaweicloud.com/api-iothub/ListDeviceAuthorizers.md): 应用服务器可调用此接口在物联网平台查询自定义鉴权列表。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的 - [删除自定义鉴权 - DeleteDeviceAuthorizer](https://support.huaweicloud.com/api-iothub/DeleteDeviceAuthorizer.md): 应用服务器可调用此接口在物联网平台上删除指定自定义鉴权。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖 - [查询自定义鉴权详情 - ShowDeviceAuthorizer](https://support.huaweicloud.com/api-iothub/ShowDeviceAuthorizer.md): 应用服务器可调用此接口在物联网平台查询指定自定义鉴权ID的详细信息。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条 - [更新指定id的自定义鉴权 - UpdateDeviceAuthorizer](https://support.huaweicloud.com/api-iothub/UpdateDeviceAuthorizer.md): 应用服务器可调用此接口在物联网平台更新指定id的自定义鉴权。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名 - [创建编解码函数 - AddFunctions](https://support.huaweicloud.com/api-iothub/AddFunctions.md): 提供创建编解码函数的功能。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项iotda:produ - [查询编解码函数 - ListFunctions](https://support.huaweicloud.com/api-iothub/ListFunctions.md): 提供查询编解码函数的功能。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项iotda:produ - [删除编解码函数 - DeleteFunctions](https://support.huaweicloud.com/api-iothub/DeleteFunctions.md): 提供删除编解码函数的功能。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项iotda:produ - [查询安全态势感知配置信息列表 - ListSecurityProfiles](https://support.huaweicloud.com/api-iothub/ListSecurityProfiles.md): 接口说明:应用服务器调用该接口查询安全态势感知配置列表。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖 - [创建安全态势感知配置 - CreateSecurityProfile](https://support.huaweicloud.com/api-iothub/CreateSecurityProfile.md): 接口说明应用服务器调用该接口创建安全态势感知配置。限制目前支持的安全配置项有:请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(* - [查询某个具体id的安全态势感知配置详情 - ShowSecurityProfile](https://support.huaweicloud.com/api-iothub/ShowSecurityProfile.md): 应用服务器可调用此接口查询某个具体id的安全态势感知配置详情。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别 - [删除某个具体id的安全态势感知配置信息 - DeleteSecurityProfile](https://support.huaweicloud.com/api-iothub/DeleteSecurityProfile.md): 应用服务器可调用此接口删除某个具体id的安全态势感知配置信息。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别 - [更新某个具体id的安全态势感知配置信息 - UpdateSecurityProfile](https://support.huaweicloud.com/api-iothub/UpdateSecurityProfile.md): 应用服务器可调用此接口更新某个具体id的安全态势感知配置信息。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别 - [创建鸿蒙软总线 - AddHarmonySoftBus](https://support.huaweicloud.com/api-iothub/AddHarmonySoftBus.md): 应用服务器可调用此接口新建鸿蒙软总线。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项iotda - [查询鸿蒙软总线列表 - ListHarmonySoftBus](https://support.huaweicloud.com/api-iothub/ListHarmonySoftBus.md): 应用服务器可调用此接口查询鸿蒙软总线列表。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项iot - [查询鸿蒙软总线 - ShowHarmonySoftBus](https://support.huaweicloud.com/api-iothub/ShowHarmonySoftBus.md): 应用服务器可调用此接口查询指定ID的鸿蒙软总线。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项 - [删除鸿蒙软总线 - DeleteHarmonySoftBus](https://support.huaweicloud.com/api-iothub/DeleteHarmonySoftBus.md): 应用服务器可调用此接口删除指定鸿蒙软总线。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项iot - [同步鸿蒙软总线信息 - CreateSyncHarmonySoftBus](https://support.huaweicloud.com/api-iothub/CreateSyncHarmonySoftBus.md): 应用服务器可调用此接口向组内设备同步鸿蒙软总线信息。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授 - [重置鸿蒙软总线密钥 - ResetHarmonySoftBusKey](https://support.huaweicloud.com/api-iothub/ResetHarmonySoftBusKey.md): 应用服务器可调用此接口重置鸿蒙软总线密钥, 重置后状态变为未同步,需要用户调用同步接口向组内设备同步最新密钥。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略 - [查询设备证书列表 - ListDeviceCertificate](https://support.huaweicloud.com/api-iothub/ListDeviceCertificate.md): 应用服务器可调用此接口在物联网平台查询设备证书列表。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授 - [查询设备证书 - ShowDeviceCertificate](https://support.huaweicloud.com/api-iothub/ShowDeviceCertificate.md): 应用服务器可调用此接口在物联网平台更新一个设备证书状态。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖 - [更新设备证书 - UpdateDeviceCertificate](https://support.huaweicloud.com/api-iothub/UpdateDeviceCertificate.md): 应用服务器可调用此接口在物联网平台更新一个设备证书状态。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖 - [删除设备证书 - DeleteDeviceCertificate](https://support.huaweicloud.com/api-iothub/DeleteDeviceCertificate.md): 应用服务器可调用此接口在物联网平台删除一个设备证书。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授 - [查询使用指定设备证书的设备列表 - ListDeviceByDeviceCertificate](https://support.huaweicloud.com/api-iothub/ListDeviceByDeviceCertificate.md): 应用服务器可调用此接口在物联网平台查询使用指定设备证书的设备列表。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件 - [创建设备鉴权模板 - CreateDeviceAuthenticationTemplate](https://support.huaweicloud.com/api-iothub/CreateDeviceAuthenticationTemplate.md): 应用服务器可调用此接口在物联网平台创建一个设备鉴权模板。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖 - [查询设备鉴权模板列表 - ListDeviceAuthenticationTemplates](https://support.huaweicloud.com/api-iothub/ListDeviceAuthenticationTemplates.md): 应用服务器可调用此接口在物联网平台查询设备鉴权模板列表。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖 - [删除设备鉴权模板 - DeleteDeviceAuthenticationTemplate](https://support.huaweicloud.com/api-iothub/DeleteDeviceAuthenticationTemplate.md): 应用服务器可调用此接口在物联网平台上删除指定设备鉴权模板。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依 - [修改设备鉴权模板 - UpdateDeviceAuthenticationTemplate](https://support.huaweicloud.com/api-iothub/UpdateDeviceAuthenticationTemplate.md): 应用服务器可调用此接口在物联网平台上修改指定设备鉴权模板。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依 - [查询设备鉴权模板详情 - ShowDeviceAuthenticationTemplate](https://support.huaweicloud.com/api-iothub/ShowDeviceAuthenticationTemplate.md): 应用服务器可调用此接口在物联网平台查询指定设备鉴权模板ID的详细信息。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须) - [创建导出任务 - CreateExportTask](https://support.huaweicloud.com/api-iothub/CreateExportTask.md): 应用服务器可调用此接口创建资源导出任务。同一个条件创建任务将会覆盖之前条件的任务结果文件(为了方便任务未执行完就导出后想重新导出完成任务的结果)。同一个条件创建任务将会覆盖之前条件的任务结果文件(为了方便任务未执行完就导出后想重新导出完成任务的结果)。单用户最多支持有50个导出任务,超出后将删除最先创建的导出任务。单用户最多支持有50个导 - [查询导出任务列表 - ListExportTasks](https://support.huaweicloud.com/api-iothub/ListExportTasks.md): 应用服务器可调用此接口查询已创建的导出任务列表。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项 - [删除导出任务 - DeleteExportTask](https://support.huaweicloud.com/api-iothub/DeleteExportTask.md): 应用服务器可调用此接口删除在平台创建的导出任务。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项 - [下载导出文件 - ShowExportTask](https://support.huaweicloud.com/api-iothub/ShowExportTask.md): 应用服务器可调用此接口下载已经完成的导出任务生成的文件。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖 - [添加域配置 - CreateDomainConfiguration](https://support.huaweicloud.com/api-iothub/CreateDomainConfiguration.md): 应用服务器可调用此接口在物联网平台上添加域配置,域配置配额上限为:1个。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须 - [获取域配置列表 - ListDomainConfigurations](https://support.huaweicloud.com/api-iothub/ListDomainConfigurations.md): 应用服务器可调用此接口在物联网平台获取域配置列表请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项 - [删除域配置 - DeleteDomainConfiguration](https://support.huaweicloud.com/api-iothub/DeleteDomainConfiguration.md): 应用服务器可调用此接口在物联网平台删除域配置请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项io - [查询域配置 - ShowDomainConfiguration](https://support.huaweicloud.com/api-iothub/ShowDomainConfiguration.md): 应用服务器可调用此接口在物联网平台查询域配置请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项io - [更新域配置 - UpdateDomainConfiguration](https://support.huaweicloud.com/api-iothub/UpdateDomainConfiguration.md): 应用服务器可调用此接口在物联网平台上更新域配置。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项 - [创建OTA模块 - CreateOtaModule](https://support.huaweicloud.com/api-iothub/CreateOtaModule.md): 用户可调用此接口创建产品的OTA模块,同一产品下最多自定义10个OTA模块。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为 - [查询OTA模块列表 - ListOtaModules](https://support.huaweicloud.com/api-iothub/ListOtaModules.md): 用户可调用此接口查询指定产品的OTA模块列表请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项io - [查询OTA模块详情 - ShowOtaModule](https://support.huaweicloud.com/api-iothub/ShowOtaModule.md): 用户可调用此接口查询OTA模块详情请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项iotda:o - [删除OTA模块 - DeleteOtaModule](https://support.huaweicloud.com/api-iothub/DeleteOtaModule.md): 用户可调用此接口删除产品对应的OTA模块请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项iotd - [修改OTA模块 - UpdateOtaModule](https://support.huaweicloud.com/api-iothub/UpdateOtaModule.md): 用户可调用此接口修改对应的OTA模块的别名和描述。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权 - [添加服务器证书 - CreateServerCertificate](https://support.huaweicloud.com/api-iothub/CreateServerCertificate.md): 应用服务器可调用此接口在物联网平台上添加服务器证书,服务器证书配额限制为:2个。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型( - [获取服务器证书列表 - ListServerCertificate](https://support.huaweicloud.com/api-iothub/ListServerCertificate.md): 应用服务器可调用此接口在物联网平台上获取服务器证书列表请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的 - [删除服务端证书 - DeleteServerCertificate](https://support.huaweicloud.com/api-iothub/DeleteServerCertificate.md): 应用服务器可调用此接口在物联网平台删除服务器证书请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项 - [查询服务器证书 - ShowServerCertificate](https://support.huaweicloud.com/api-iothub/ShowServerCertificate.md): 应用服务器可调用此接口在物联网平台查询服务器证书请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项 - [创建泛协议配置 - CreateProtocolConfig](https://support.huaweicloud.com/api-iothub/CreateProtocolConfig.md): 提供创建泛协议配置的功能。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项iotda:proto - [查询泛协议配置列表 - ListProtocolConfigs](https://support.huaweicloud.com/api-iothub/ListProtocolConfigs.md): 提供查询泛协议配置列表的功能。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项iotda:pro - [删除泛协议配置 - DeleteProtocolConfig](https://support.huaweicloud.com/api-iothub/DeleteProtocolConfig.md): 提供删除泛协议配置的功能。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项iotda:proto - [查询泛协议配置详情 - ShowProtocolConfig](https://support.huaweicloud.com/api-iothub/ShowProtocolConfig.md): 提供查询泛协议配置详情的功能。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项iotda:pro - [更新泛协议配置 - UpdateProtocolConfig](https://support.huaweicloud.com/api-iothub/UpdateProtocolConfig.md): 提供更新泛协议配置的功能。请参见如何调用API。账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。如果使用角色与策略授权,具体权限要求请参见权限和授权项。如果使用身份策略授权,需具备如下身份策略权限。授权项访问级别资源类型(*为必须)条件键别名依赖的授权项iotda:proto - [权限与授权说明](https://support.huaweicloud.com/api-iothub/iot_06_v5_0202.md): 如果您需要对您所拥有的设备接入服务(IoTDA)进行精细的权限管理,您可以使用统一身份认证服务(Identity and Access Management,简称IAM),如果华为云账号已经能满足您的要求,不需要创建独立的IAM用户,您可以跳过本章节,不影响您使用设备接入服务(IoTDA)的其它功能。默认情况下,新建的IAM用户没有任何权 - [身份策略授权参考](https://support.huaweicloud.com/api-iothub/iot_06_v5_0203.md): 云服务在IAM预置了常用授权项,称为系统身份策略。如果IAM系统身份策略无法满足授权要求,管理员可以根据各服务支持的授权项,创建IAM自定义身份策略来进行精细的访问控制,IAM自定义身份策略是对系统身份策略的扩展和补充。除IAM服务外,Organizations服务中的服务控制策略(Service Control Policies,以下简 - [示例一:使用模板文件批量创建设备](https://support.huaweicloud.com/api-iothub/iot_06_v5_1501.md): 本章节指导用户通过API批量创建设备。API的调用方法参见如何调用API。物联网平台支持通过请求参数和模板文件两种方式批量创建设备。本节以模板文件的方式为例,介绍如何批量创建设备。查询产品列表 - ListProducts:确定待创建设备所属的产品。上传批量任务文件 - UploadBatchTaskFile:填写批量任务文件内容并上传, - [示例二:给指定设备下发消息](https://support.huaweicloud.com/api-iothub/iot_06_v5_1502.md): 本章节指导用户通过API给指定设备下发消息。API的调用方法参见如何调用API。查询设备列表 - ListDevices:确定待下发消息的设备。下发设备消息 - CreateMessage:给指定设备下发消息。查询指定消息id的消息 - ShowDeviceMessage:确认消息下发结果。查询设备列表接口信息URL:GET /v5/io - [示例三:在指定资源空间下创建设备](https://support.huaweicloud.com/api-iothub/iot_06_v5_1503.md): 本章节指导用户通过API在指定资源空间下创建设备。API的调用方法参见如何调用API。物联网平台默认为用户创建了一个资源空间,创建设备时默认将设备归属于默认资源空间,如果用户需要对设备分资源空间管理,可以指定资源空间创建设备。创建资源空间 - AddApplication:创建非系统默认的资源空间。创建产品 - CreateProduct - [状态码](https://support.huaweicloud.com/api-iothub/iot_06_v5_1000.md): 状态码如表1所示 - [获取项目ID](https://support.huaweicloud.com/api-iothub/iot_06_v5_1001.md): 在调用接口时,部分URI以及请求体中需要填入项目ID,项目ID获取步骤如下:在华为云首页右上角,单击“控制台”。在右上角的用户名中选择“我的凭证”。在“我的凭证”界面,API凭证页签中,查看项目ID。API凭证-获取项目ID项目ID还可以通过调用查询指定条件下的项目信息API获取。获取项目ID的接口为“GET https://{Endpo - [错误码](https://support.huaweicloud.com/api-iothub/ErrorCode.md): 当您调用API时,如果遇到“APIGW”开头的错误码,请参见API网关错误码进行处理。更多服务错误码请参见API错误中心。 - [使用前必读](https://support.huaweicloud.com/api-iothub/iot_06_v5_3002.md): MQTT是一种底层传输协议,一般用于网络通信,它提供有序的、可靠的、双向字节流传输,支持设备到云端和云端到设备之间的消息传递,是基于发布/订阅模式的“轻量级”通信协议。MQTT最大优点在于,可以以极少的代码和有限的带宽,为连接远程设备提供实时可靠的消息服务。作为一种低开销、低带宽占用的即时通讯协议,使其在物联网、小型设备、移动应用等方面有 - [通信方式概述](https://support.huaweicloud.com/api-iothub/iot_06_v5_3003.md): 设备接入物联网平台,通过物联网平台进行通信。设备、服务器和物联网平台的通信流程示意图如下。设备接入物联网平台后,便可与物联网平台进行通信。设备可通过以下方式发送数据到物联网平台:设备消息上报:设备无法按照产品模型中定义的属性格式进行数据上报时,将设备的自定义数据通过设备消息上报接口上报给平台,平台将设备上报的消息转发给应用服务器或华为云其 - [Topic定义](https://support.huaweicloud.com/api-iothub/iot_06_v5_3004.md): 设备使用MQTT协议接入平台时,平台和设备通过Topic进行通信。平台预置的topic列表如下:{device_id}用于标识Topic路由的目标设备,设备侧订阅该topic或往topic推送消息时,该值需要替换为设备与平台建立MQTT连接时使用的设备ID参数值。{request_id}用于唯一标识这次请求。设备侧发起的消息带该参数时,需 - [设备连接鉴权](https://support.huaweicloud.com/api-iothub/iot_06_v5_3009.md): IoT平台设备侧支持MQTT协议的connect消息接口,鉴权通过后建立设备与平台间的MQTT连接。设备通过MQTT协议的connect消息进行鉴权,对于构造ClientId的各个部分信息都必须包括进去,平台收到connect消息时,会判断设备的鉴权类型和密码摘要算法。当采用“HMACSHA256”校验时间戳方式时,会先校验消息时间戳与平 - [平台命令下发](https://support.huaweicloud.com/api-iothub/iot_06_v5_3014.md): 用于平台向设备下发设备控制命令。平台下发命令后,需要设备及时将命令的执行结果返回给平台,如果设备没回响应,平台会认为命令执行超时。命令下发和消息下发的区别,请查看数据下发概述。低配置且资源受限或者对网络流量有要求的设备,不适合直接构造JSON数据与物联网平台通信时,可将原始二进制数据透传到物联网平台。通过开发编解码插件实现二进制数据到平台 - [设备消息上报](https://support.huaweicloud.com/api-iothub/iot_06_v5_3016.md): 是指设备无法按照产品模型中定义的属性格式进行数据上报时,可调用此接口将设备的自定义数据格式上报给平台,平台对该消息不进行解析,该消息可以转发给应用服务器或华为云其他云服务上进行存储和处理。消息上报和属性上报的区别,请查看数据上报概述。低配置且资源受限或者对网络流量有要求的设备,不适合直接构造JSON数据与物联网平台通信时,可将原始二进制数 - [平台消息下发](https://support.huaweicloud.com/api-iothub/iot_06_v5_3017.md): 设备无法按照产品模型中定义的格式进行指令下发时,可使用此接口下发自定义格式的数据给设备。在此之上也可以使用平台封装的标准格式,即在应用侧API的下发设备消息 - CreateMessage中payload_format填写为“standard”,或者在设备详情页的云端下发 > 消息下发中下发时选择“按系统格式”。消息下发和命令下发的区别, - [设备属性上报](https://support.huaweicloud.com/api-iothub/iot_06_v5_3010.md): 用于设备按产品模型中定义的格式将属性数据上报给平台。属性上报和消息上报的区别,请查看数据上报概述。低配置且资源受限或者对网络流量有要求的设备,不适合直接构造JSON数据与物联网平台通信时,可将原始二进制数据透传到物联网平台。通过开发编解码插件实现二进制数据到平台定义JSON格式的转换。上行:$oc/devices/{device_id}/ - [网关批量设备属性上报](https://support.huaweicloud.com/api-iothub/iot_06_v5_3006.md): 用于批量设备上报属性数据给平台。网关设备可以用此接口同时上报多个子设备的属性数据。网关与子设备关系,请查看网关和子设备。属性上报和消息上报的区别,请查看数据上报概述。网关批量设备属性上报,单批次最多可上报100个子设备的属性数据。如果子设备数量超过100个,建议分不同批次进行上报。上行:$oc/devices/{device_id}/sy - [平台设置设备属性](https://support.huaweicloud.com/api-iothub/iot_06_v5_3008.md): 用于平台设置设备属性。设备的产品模型中定义了平台可向设备设置的属性,平台可调用此修改设备属性接口设置指定设备的属性数据。设备收到属性设置请求后,需要将执行结果返回给平台,如果设备没回响应平台会认为属性设置请求执行超时。低配置且资源受限或者对网络流量有要求的设备,不适合直接构造JSON数据与物联网平台通信时,可将原始二进制数据透传到物联网平 - [平台查询设备属性](https://support.huaweicloud.com/api-iothub/iot_06_v5_3011.md): 用于平台向设备查询属性信息。平台可调用查询设备属性接口查询设备的属性数据。设备收到属性查询请求后,需要将设备的属性数据返回给平台,如果设备没回响应平台会认为属性查询请求执行超时。低配置且资源受限或者对网络流量有要求的设备,不适合直接构造JSON数据与物联网平台通信时,可将原始二进制数据透传到物联网平台。通过开发编解码插件实现二进制数据到平 - [设备侧获取平台的设备影子数据](https://support.huaweicloud.com/api-iothub/iot_06_v5_3012.md): 用于设备向平台获取设备影子数据。用户可以通过应用服务器或物联网控制台配置设备影子预期数据,设备上线时订阅该topic,可以获取到平台设备影子数据,以此来同步设备属性期望值,从而完成设备属性值的修改。简单交互逻辑介绍如下:① 应用调用“配置设备影子预期数据”接口或在控制台配置设备影子数据;② 设备侧(已完成关联Topic订阅)主动上报请求, - [平台通知网关子设备新增](https://support.huaweicloud.com/api-iothub/iot_06_v5_3019.md): 平台将该网关新增的子设备列表信息通知给网关设备。网关与子设备关系,请查看网关和子设备。下行: $oc/devices/{device_id}/sys/events/downServiceEvent定义表paras参数列表DeviceInfo定义表 - [平台通知网关子设备删除](https://support.huaweicloud.com/api-iothub/iot_06_v5_3020.md): 平台将该网关删除的子设备信息通知给网关设备。网关与子设备关系,请查看网关和子设备。下行: $oc/devices/{device_id}/sys/events/downServiceEvent定义表paras参数列表DeviceInfo定义表 - [网关同步子设备列表](https://support.huaweicloud.com/api-iothub/iot_06_v5_3021.md): 网关设备从平台同步子设备列表。网关设备不在线时,平台无法将子设备新增和删除的信息及时通知到网关设备。网关设备离线再上线时,可以通过此接口从平台同步这段时间内新增或者删除的子设备信息。新增的子设备信息会通过平台通知网关子设备新增接口通知网关设备,删除的子设备信息会通过平台通知网关子设备删除通知网关设备。网关与子设备关系,请查看网关和子设备。 - [网关更新子设备状态](https://support.huaweicloud.com/api-iothub/iot_06_v5_3022.md): 网关更新子设备状态,更新结果通过网关更新子设备状态响应接口通知网关设备。网关与子设备关系,请查看网关和子设备。接口tps限制为直连设备并发建链的1.5倍。即为单个实例每秒最大建立请求连接数量为100*购买单元数量 *1.5。该接口1次调用的tps为1*上报子设备的数量。上行: $oc/devices/{device_id}/sys/eve - [网关更新子设备状态响应](https://support.huaweicloud.com/api-iothub/iot_06_v5_30233.md): 平台将该网关更新子设备状态结果以列表返回,平台收到网关更新子设备状态请求后会在30秒内通过此接口返回响应消息。网关与子设备关系,请查看网关和子设备。下行: $oc/devices/{device_id}/sys/events/downServiceEvent定义表paras参数列表DeviceStatus定义表Reason定义表 - [网关新增子设备请求](https://support.huaweicloud.com/api-iothub/iot_06_v5_30181.md): 网关主动新增其下接入的子设备,在平台上完成开户。网关与子设备关系,请查看网关和子设备。上行: $oc/devices/{device_id}/sys/events/upServiceEvent定义表paras参数列表DeviceInfo定义表 - [网关新增子设备请求响应](https://support.huaweicloud.com/api-iothub/iot_06_v5_30182.md): 平台将该网关新增的子设备列表信息通知给网关设备,平台收到网关新增子设备请求后会在30秒内通过此接口返回响应消息。网关与子设备关系,请查看网关和子设备。下行: $oc/devices/{device_id}/sys/events/downServiceEvent定义表paras参数列表DeviceInfo定义表Reason定义表 - [网关删除子设备请求](https://support.huaweicloud.com/api-iothub/iot_06_v5_30183.md): 网关主动删除其下接入的子设备,在平台上完成销户。网关与子设备关系,请查看网关和子设备。上行: $oc/devices/{device_id}/sys/events/upServiceEvent定义表paras参数列表 - [网关删除子设备请求响应](https://support.huaweicloud.com/api-iothub/iot_06_v5_30184.md): 平台将该网关删除的子设备列表信息通知给网关设备。平台收到网关删除子设备请求后会在30秒内通过此接口返回响应消息。网关与子设备关系,请查看网关和子设备。下行: $oc/devices/{device_id}/sys/events/downServiceEvent定义表paras参数列表Reason定义表 - [平台下发获取版本信息通知](https://support.huaweicloud.com/api-iothub/iot_06_v5_3028.md): 平台下发获取版本信息通知。下行: $oc/devices/{device_id}/sys/events/downServiceEvent定义表paras参数列表 - [设备上报软固件版本](https://support.huaweicloud.com/api-iothub/iot_06_v5_3029.md): 设备上报软固件版本信息。上行: $oc/devices/{device_id}/sys/events/upServiceEvent定义表paras参数列表 - [平台下发升级通知](https://support.huaweicloud.com/api-iothub/iot_06_v5_3030.md): 物联网平台向设备侧下发升级通知。下行: $oc/devices/{device_id}/sys/events/downServiceEvent定义表event_type为firmware_upgrade、software_upgrade时paras参数列表event_type为firmware_upgrade_v2、software_up - [设备上报升级状态](https://support.huaweicloud.com/api-iothub/iot_06_v5_3031.md): 设备上报升级状态。上行: $oc/devices/{device_id}/sys/events/upServiceEvent定义表paras参数列表 - [设备上报获取文件上传URL请求](https://support.huaweicloud.com/api-iothub/iot_06_v5_3033.md): 设备上报获取文件上传URL信息请求。上行: $oc/devices/{device_id}/sys/events/upServiceEvent定义表paras参数列表 - [平台下发文件上传临时URL](https://support.huaweicloud.com/api-iothub/iot_06_v5_3034.md): 平台下发文件上传临时URL。下行: $oc/devices/{device_id}/sys/events/downServiceEvent定义表paras参数列表 - [设备上报文件上传结果](https://support.huaweicloud.com/api-iothub/iot_06_v5_3035.md): 设备上报文件上传结果。上行: $oc/devices/{device_id}/sys/events/upServiceEvent定义表paras参数列表 - [设备上报获取文件下载URL请求](https://support.huaweicloud.com/api-iothub/iot_06_v5_3036.md): 设备上报获取文件下载URL信息请求到平台。上行: $oc/devices/{device_id}/sys/events/upServiceEvent定义表paras参数列表 - [平台下发文件下载临时URL](https://support.huaweicloud.com/api-iothub/iot_06_v5_3037.md): 平台下发文件下载临时URL给设备。下行: $oc/devices/{device_id}/sys/events/downServiceEvent定义表paras参数列表 - [设备上报文件下载结果](https://support.huaweicloud.com/api-iothub/iot_06_v5_3038.md): 设备上报文件下载结果。上行: $oc/devices/{device_id}/sys/events/upServiceEvent定义表paras参数列表 - [设备时间同步请求](https://support.huaweicloud.com/api-iothub/iot_06_v5_3040.md): 设备向平台发起时间同步请求。上行: $oc/devices/{device_id}/sys/events/upServiceEvent定义表paras参数列表 - [设备时间同步响应](https://support.huaweicloud.com/api-iothub/iot_06_v5_3041.md): 平台向设备发送时间同步响应,携带设备发送时间device_send_time。当平台收到时间server_recv_time 后,向设备发送时间server_send_time 。例如,设备收到的设备侧时间为device_recv_time ,则设备计算自己的准确时间为:(server_recv_time + server_send_ti - [设备信息上报](https://support.huaweicloud.com/api-iothub/iot_06_v5_3042.md): 设备向平台上报设备信息。上行: $oc/devices/{device_id}/sys/events/upServiceEvent定义表paras参数列表 - [平台下发日志收集通知](https://support.huaweicloud.com/api-iothub/iot_06_v5_1303.md): 下行: $oc/devices/{device_id}/sys/events/down用于平台下发日志收集通知给设备。EventService定义表paras参数列表 - [设备上报日志内容](https://support.huaweicloud.com/api-iothub/iot_06_v5_1302.md): 上行: $oc/devices/{device_id}/sys/events/up日志收集开关开启时设备使用该接口向平台上报日志内容,最大不超过1MB。ServiceEvent定义表paras参数列表 - [平台下发配置通知](https://support.huaweicloud.com/api-iothub/iot_0802.md): 物联网平台向设备侧下发配置通知。物联网平台为用户提供远程配置功能,用户可以在不中断设备运行的情况下,远程更新设备的系统参数、运行参数等配置信息。例如:Windows的收银台机器,需要通过远程配置修改一些系统参数;车联网中的T-BOX,需要通过远程配置修改设备侧的一些数据上报频率等。下行: $oc/devices/{device_id}/s - [设备上报配置响应](https://support.huaweicloud.com/api-iothub/iot_0803.md): 设备上报配置结果响应。创建远程配置任务时,可以配置超时时间(1-30天,不配置默认30天)。在超时时间内,平台每24小时向设备下发一次配置,直到设备上报配置响应。如果设备在超时时间内一直没有上报配置响应,则平台显示该设备配置任务超时失败。上行: $oc/devices/{device_id}/sys/events/upServiceEve - [平台下发隧道信息](https://support.huaweicloud.com/api-iothub/iot_06_v5_1436.md): 物联网平台向设备侧下发安全隧道信息。设备侧在接收到信息后,可以使用该安全隧道信息建立与物联网平台的WebSocket连接,用户可以在应用端远程登录使用基于安全隧道建链的设备(远程SSH登录服务),进行设备的更新配置、排查诊断、运维变更等操作。下行:$oc/devices/{device_id}/sys/events/downService - [设备获取全量安全态势感知配置](https://support.huaweicloud.com/api-iothub/iot_06_v5_1438.md): 上行: $oc/devices/{device_id}/sys/shadow/get/request_id={request_id}下行: $oc/devices/{device_id}/sys/shadow/get/response/request_id={request_id}ShadowData结构定义:PropertiesData - [设备监听安全态势感知配置变动](https://support.huaweicloud.com/api-iothub/iot_06_v5_1440.md): 下行: $oc/devices/{device_id}/sys/properties/set/request_id={request_id}ServiceProperty结构定义: - [设备上报安全态势感知告警](https://support.huaweicloud.com/api-iothub/iot_06_v5_1439.md): 上行: $oc/devices/{device_id}/sys/events/upServiceEvent定义表paras参数列表type为MEMORY_REPORT 时content参数列表type为PORT_REPORT 时content参数列表type为CPU_USAGE_REPORT 时content参数列表type为DISK_S - [使用https协议接入](https://support.huaweicloud.com/api-iothub/iot_06_v5_7002.md): HTTPS是基于HTTP协议,通过SSL加密的一种安全通信协议。物联网平台支持HTTPS协议通信。物联网平台的Endpoint请参见:如何获取平台接入地址。使用“设备接入-> HTTPS(443)”对应的Endpoint,端口为443。设备使用HTTPS协议接入平台时,平台和设备通过https接口调用通信。通过这些接口,平台和设备可以实现 - [API概览](https://support.huaweicloud.com/api-iothub/iot_06_v5_7003.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [设备鉴权](https://support.huaweicloud.com/api-iothub/iot_06_v5_7008.md): 设备鉴权接口,鉴权通过后建立设备与平台间才能处理业务连接。鉴权成功后平台返回access_token。调用属性上报、消息上报等其他接口时,都需要携带access_token信息。如果access_token超期,需要重新认证设备获取access_token。如果access_token未超期重复获取access_token,原access - [设备消息上报](https://support.huaweicloud.com/api-iothub/iot_06_v5_7009.md): 用于设备将自定义数据上报给平台,平台将设备上报的消息转发给应用服务器或华为云其他云服务上进行存储和处理。该接口支持设备将自定义数据通过请求中的body体上报给平台,平台收到该请求后会将body内容转发给应用服务器或华为云其他云服务上进行存储和处理。平台对body中的内容无具体格式限制,小于1MB的数据可以通过该接口携带。Status Co - [设备属性上报](https://support.huaweicloud.com/api-iothub/iot_06_v5_7010.md): 用于设备按产品模型中定义的格式将属性数据上报给平台。Status Code: 200 上报正常 - [网关上报子设备属性](https://support.huaweicloud.com/api-iothub/iot_06_v5_7011.md): 用于批量设备上报属性数据给平台。网关设备可以用此接口同时上报最多50个子设备的属性数据。Status Code: 200 上报正常 - [使用LwM2M协议接入](https://support.huaweicloud.com/api-iothub/iot_06_v5_1324.md): LwM2M(Lightweight M2M,轻量级M2M),由开发移动联盟(OMA)提出,是一种轻量级的、标准通用的物联网设备管理协议,可用于快速部署客户端/服务器模式的物联网业务。LwM2M为物联网设备的管理和应用建立了一套标准,它提供了轻便小巧的安全通信接口及高效的数据模型,以实现M2M设备管理和服务支持。物联网平台支持加密与非加密两 - [API概览](https://support.huaweicloud.com/api-iothub/iot_06_v5_1325.md): BinaryAppDataContainer对象:为简化设备厂商定义并使用LwM2M对象的复杂度,华为定义了19对象,由芯片或模组实现,设备只需要调用AT接口或函数接口来实现业务数据的收发,不需要关心LWM2M协议,参考此规范。 - [设备鉴权](https://support.huaweicloud.com/api-iothub/iot_06_v5_1326.md): 设备向物联网平台注册,物联网平台进行设备的身份认证。物联网平台向设备订阅资源,设备获取到物联网平台下发订阅时的token,调用属性上报等其他接口时,都需要携带token信息。 - [设备属性上报](https://support.huaweicloud.com/api-iothub/iot_06_v5_1327.md): 设备向物联网平台上报数据,设备携带物联网平台下发/19/0/0订阅时的token进行属性上报。设备通过LwM2M协议上报的数据都是二进制报文数据,一般都需要通过编解码插件进行解析,参考开发编解码插件。假设value为c4 0d 5a 6e 96 0b c3 0e 2b 30 37,则上报样例如下: - [设备命令下发](https://support.huaweicloud.com/api-iothub/iot_06_v5_1328.md): 物联网平台向设备设备异步命令,物联网平台通过LwM2M的/19/1/0资源对象将命令打包到LwM2M write消息的payload里下发给设备。1、使用LwM2M协议接入的设备,物联网平台只支持设备异步命令。2、物联网平台接收到命令之后会调用用户的在物联网平台上传的编解码插件进行编码后下发给设备,参考开发编解码插件。假设最终通过编解码插 - [使用安全隧道通信协议接入](https://support.huaweicloud.com/api-iothub/iot_06_v5_1331.md): 物联网平台提供了安全隧道功能,通过使用安全隧道通信协议,建立应用端与设备端间的WebSocket通道,可以实现远程连接企业内部网的物联网平台设备,有效解决了无法直接从外部登录部署在企业内部的设备的问题场景。当应用端与设备端都完成安全隧道的连接后,用户可以在应用端远程登录使用基于安全隧道建链的设备(远程SSH登录服务设备远程登录),进行设备 - [应用端](https://support.huaweicloud.com/api-iothub/iot_06_v5_1433.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [设备端](https://support.huaweicloud.com/api-iothub/iot_06_v5_1434.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [安全隧道协议消息交互说明](https://support.huaweicloud.com/api-iothub/iot_06_v5_1333.md): 当应用端与设备端建立安全隧道的WebSocket连接后,应用端与设备端将基于安全隧道协议进行消息通信,数据格式如下:平台通知应用端设备已连接Websocket:应用端下发ssh通道连接参数给设备:设备端上报连接响应给应用端:应用端下发ssh命令给设备:设备端上报ssh命令执行响应给应用端:平台正常断开Websocket连接时,发送数据给应 - [AT指令列表](https://support.huaweicloud.com/api-iothub/iot_06_v5_1401.md): 经过兼容性认证的模组,在AT命令以及格式规范上,基本和华为通用要求一致,部分模组厂家受限于自己的AT通道,实现稍有不同,可以参考模组厂家的特殊说明。 - [AT+HMVER](https://support.huaweicloud.com/api-iothub/iot_06_v5_1402.md): 该指令用于获取华为SDK的版本信息。 - [AT+HMCON](https://support.huaweicloud.com/api-iothub/iot_06_v5_1403.md): 该指令用于设置MQTT协议连接参数。 - [AT+HMDIS](https://support.huaweicloud.com/api-iothub/iot_06_v5_1404.md): 该指令用于关闭和华为IoT平台连接。 - [AT+HMPUB](https://support.huaweicloud.com/api-iothub/iot_06_v5_1405.md): 该指令用于发送MQTT数据到指定TOPIC。 - [+HMREC](https://support.huaweicloud.com/api-iothub/iot_06_v5_1406.md): 该指令用于将模组接收到的数据通过该方式传递给外部MCU。 - [+HMSTS](https://support.huaweicloud.com/api-iothub/iot_06_v5_1407.md): 该指令用于将模组连接或者断开的状态主动传递给外部MCU。 - [AT+HMSUB](https://support.huaweicloud.com/api-iothub/iot_06_v5_1408.md): 该指令用于订阅自定义主题。 - [AT+HMUNS](https://support.huaweicloud.com/api-iothub/iot_06_v5_1409.md): 该指令用于取消订阅自定义主题。 - [AT+HMPKS](https://support.huaweicloud.com/api-iothub/iot_06_v5_1410.md): 该指令用于设置服务器或者客户端证书。 - [修订记录](https://support.huaweicloud.com/api-iothub/iot_06_v5_7001.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 ## SDK参考 - [SDK概述](https://support.huaweicloud.com/sdkreference-iothub/iot_10_1002.md): 物联网平台提供应用侧SDK和设备侧SDK,方便设备通过集成SDK接入到平台,应用通过调用物联网平台的API,实现安全接入、设备管理、数据采集、命令下发等业务场景。如果无法正常打开GitHub仓库,请检查您所使用的网络是否可以正常访问公网。由于GitHub的服务器部署在国外,国内用户访问时容易遇到无法打开的情况,请切换网络后再尝试打开。 - [应用侧Java SDK使用指南](https://support.huaweicloud.com/sdkreference-iothub/iot_10_10002.md): 物联网平台提供Java语言的应用侧SDK供开发者使用。本文介绍应用侧 Java SDK的安装和配置,及使用Java SDK调用应用侧API的示例。访问Java官网,下载并说明安装Java开发环境。华为云Java SDK支持Java JDK 1.8及其以上版本。通过 Maven 安装项目依赖是使用 Java SDK 的推荐方法,首先您需要下 - [应用侧Python SDK使用指南](https://support.huaweicloud.com/sdkreference-iothub/iot_10_10003.md): 物联网平台提供Python语言的应用侧SDK供开发者使用。本文介绍应用侧 Python SDK的安装和配置,及使用Python SDK调用应用侧API的示例。访问Python官网,下载并按说明安装Python开发环境。华为云应用侧 Python SDK 支持 Python3 及以上版本。访问pip官网,下载并按说明安装pip工具。执行如下 - [应用侧.NET SDK使用指南](https://support.huaweicloud.com/sdkreference-iothub/iot_10_10004.md): 物联网平台提供C#语言的应用侧SDK供开发者使用。本文介绍应用侧 .NET SDK的安装和配置,及使用.NET SDK调用应用侧API的示例。访问.NET官网,下载并按说明安装.NET开发环境。华为云.NET SDK适用于:.NET Framework 4.5 及其以上版本。.NET Standard 2.0 及其以上版本。C# 4.0 - [应用侧Go SDK使用指南](https://support.huaweicloud.com/sdkreference-iothub/iot_10_10005.md): 物联网平台提供Go语言的应用侧SDK供开发者使用。本文介绍应用侧 Go SDK的安装和配置,及使用Go SDK调用应用侧API的示例。访问Go官网,下载并按说明安装Go开发环境。华为云 Go SDK 支持 Go 1.14 及以上版本。以调用查询设备列表接口为例,以下代码示例向您展示使用Go SDK的主要步骤:package main i - [应用侧Node.js SDK使用指南](https://support.huaweicloud.com/sdkreference-iothub/iot_10_10006.md): 物联网平台提供Node.js语言的应用侧SDK供开发者使用。本文介绍应用侧 Node.js SDK的安装和配置,及使用Node.js SDK调用应用侧API的示例。访问Node.js官网,下载并按说明安装Node.js开发环境。华为云 Node.js SDK 支持 Node 10.16.1 及以上版本。以调用查询设备列表接口为例,以下代码 - [应用侧PHP SDK使用指南](https://support.huaweicloud.com/sdkreference-iothub/iot_10_10007.md): 物联网平台提供PHP语言的应用侧SDK供开发者使用。本文介绍应用侧 PHP SDK的安装和配置,及使用PHP SDK调用应用侧API的示例。访问PHP官网,下载并按说明安装PHP开发环境。华为云PHP SDK支持PHP 5.6、PHP6、PHP7、PHP8版本,在运行前可执行 php --version 检查当前 Php 的版本信息,如果 - [应用侧C++ SDK使用指南](https://support.huaweicloud.com/sdkreference-iothub/iot_10_10008.md): 物联网平台提供C++语言的应用侧SDK供开发者使用。本文介绍应用侧 C++SDK的安装和配置,以及使用C++ SDK调用应用侧API的示例。所需的这些第三方软件包在大部分系统的包管理工具中都有提供,例如基于Debian/Ubuntu的系统。sudo apt-get install libcurl4-openssl-dev libboost - [设备侧IoT Device SDK介绍](https://support.huaweicloud.com/sdkreference-iothub/iot_02_0178.md): 为了帮助设备快速连接到物联网平台,华为提供了设备侧IoT Device SDK。支持TCP/IP协议栈的设备集成设备侧IoT Device SDK后,可以直接与物联网平台通信。不支持TCP/IP协议栈的设备,例如蓝牙设备、ZigBee设备等需要利用网关将设备数据转发给物联网平台,此时网关需要事先集成设备侧IoT Device SDK。设备 - [快速引用](https://support.huaweicloud.com/sdkreference-iothub/iot_02_00890.md): 开发环境要求:已经安装JDK(版本1.8以上)和maven。访问SDK下载页面,下载SDK,整个工程包含以下子工程:iot-device-sdk-java:sdk代码。iot-device-demo:普通直连设备的demo代码。iot-gateway-demo:网关设备的demo代码。iot-bridge-sdk:网桥的sdk代码。iot - [使用说明](https://support.huaweicloud.com/sdkreference-iothub/iot_02_00891.md): huaweicloud-iot-device-sdk-java提供设备接入华为云IoT物联网平台的Java版本的SDK,提供设备和平台之间通讯能力,以及设备服务、网关服务、OTA等高级服务,并且针对各种场景提供了丰富的demo代码。IoT设备开发者使用SDK可以大大简化开发复杂度,快速的接入平台。 - [快速接入](https://support.huaweicloud.com/sdkreference-iothub/iot_02_00892.md): 为了方便体验,提供了一个烟感的产品模型,烟感会上报烟雾值、温度、湿度、烟雾报警、还支持响铃报警命令。以烟感为例,体验消息上报、属性上报等功能。设备注册成功后保存设备标识码、设备ID、密钥。获取接入地址。可在控制台的“总览 > 接入信息”中查看。接入信息-设备侧MQTT接入地址输入设备对接信息。创建设备时,需要写入在注册设备时获取的设备ID - [使用代码生成器](https://support.huaweicloud.com/sdkreference-iothub/iot_02_00893.md): SDK提供了设备代码生成器,需要下载SDK源码。用户只需要提供产品模型文件,就能自动生成设备代码框架。代码生成器可以解析设备模型文件,然后对模型里定义的每个服务,生成对应的service类,然后生成一个设备主类,在main函数中创建设备并注册设备服务实例。生成物模型代码。下载huaweicloud-iot-device-sdk-java工 - [功能支持](https://support.huaweicloud.com/sdkreference-iothub/iot_02_00894.md): SDK面向运算、存储能力较强的嵌入式终端设备,开发者通过调用SDK接口,便可实现设备与物联网平台的上下行通讯。SDK当前支持的功能有: - [使用说明](https://support.huaweicloud.com/sdkreference-iothub/iot_02_00900.md): 设备侧 IoT Device C for Linux SDK提供设备接入华为云IoT物联网平台的C版本的SDK,提供设备和平台之间通讯能力,以及设备服务、网关服务、OTA等高级服务,并且针对各种场景提供了丰富的demo代码。相关集成指导请参考设备侧 IoT Device C SDK使用指南。SDK需运行在Linux操作系统上。SDK依赖o - [代码下载与编译](https://support.huaweicloud.com/sdkreference-iothub/iot_02_00901.md): SDK需运行在Linux操作系统上,并安装好gcc(建议4.8及以上版本)。SDK依赖openssl库和paho库,如果开发者有自己的编译链,需要自行编译openssl/paho库文件。 - [快速接入](https://support.huaweicloud.com/sdkreference-iothub/iot_02_00902.md): 为了方便体验,提供了一个烟感的产品模型,烟感会上报烟雾值、温度、湿度、烟雾报警、还支持响铃报警命令。以烟感为例,体验消息上报、属性上报等功能。设备注册成功后保存设备标识码、设备ID、密钥。平台的证书可以从源码中conf/rootcert.pem下载。SDK默认提供断线重连功能,当调用设备初始化后,当由于网络不稳定、网络不可达、平台主动断开 - [功能支持](https://support.huaweicloud.com/sdkreference-iothub/iot_02_00903.md): SDK面向运算、存储能力较强的嵌入式终端设备,开发者通过调用SDK接口,便可实现设备与物联网平台的上下行通讯。SDK当前支持的功能有: - [使用说明](https://support.huaweicloud.com/sdkreference-iothub/iot_02_00910.md): 设备侧 IoT Device C# SDK提供设备接入华为云IoT物联网平台的C#版本的SDK,提供设备和平台之间通讯能力,以及设备服务、OTA等高级服务,并且针对各种场景提供了丰富的demo代码。相关集成指导请参考设备侧 IoT Device C# SDK使用指南。已安装 DotNet SDK 8.0。点此查看 .NET 安装指导点此下 - [快速接入](https://support.huaweicloud.com/sdkreference-iothub/iot_02_00911.md): 本章将使用SmokeDetector Demo 指导您快速体验产品模型的创建、Demo的配置与启动、以及SDK基本功能的使用。Demo源码可见:SmokeDetector.cs。为了方便体验,提供了一个烟感的产品模型,烟感会上报烟雾值、温度、湿度、烟雾报警、还支持响铃报警命令。以烟感例,体验消息上报、属性上报等功能。为了方便体验,提供了一 - [功能支持](https://support.huaweicloud.com/sdkreference-iothub/iot_02_00912.md): SDK面向运算、存储能力较强的嵌入式终端设备,开发者通过调用SDK接口,便可实现设备与IoTDA服务(后续简出现的“服务”、“平台“均指IoTDA服务)双向通讯。 SDK当前支持的功能有: - [使用说明](https://support.huaweicloud.com/sdkreference-iothub/iot_02_00928.md): 设备侧 IoT Device Android SDK提供设备接入华为云IoT物联网平台的Android版本的SDK,提供设备和平台之间通讯能力,以及设备服务、OTA等高级服务,并且针对各种场景提供了丰富的demo代码。相关集成指导请参考设备侧 IoT Device Android SDK使用指南。已安装Android StudioSDK目 - [编译及代码工程设置](https://support.huaweicloud.com/sdkreference-iothub/iot_02_00921.md): 在build.gradle中修改部分代码,具体修改如下。Android SDK删除配置数据在build.gradle中添加以下编译脚本。task cleanJar(type: Delete){ //删除存在的 delete 'build/libs/com.huaweicloud.sdk.iot.device-1.0.0.j - [快速接入](https://support.huaweicloud.com/sdkreference-iothub/iot_02_00922.md): 本章将使用SmokeDetector Demo指导您快速体验产品模型的创建、Demo的配置与启动、以及SDK基本功能的使用。Demo源码下载SmokeDetector.cs。为了方便体验,提供了一个烟感的产品模型,烟感会上报烟雾值、温度、湿度、烟雾报警以及支持响铃报警命令。以烟感为例,体验消息上报、属性上报等功能。为了方便体验,提供了一个 - [功能支持](https://support.huaweicloud.com/sdkreference-iothub/iot_02_00923.md): SDK面向运算、存储能力较强的嵌入式终端设备,开发者通过调用SDK接口,便可实现设备与IoTDA服务(后续简出现的“服务”、“平台“均指IoTDA服务)双向通讯。 SDK当前支持的功能有: - [快速引用](https://support.huaweicloud.com/sdkreference-iothub/iot_02_00927.md): 开发环境要求:Go 1.18+。访问SDK下载页面,下载工程,工程包含以下子工程:GO语言SDK目录结构目录结构目录说明iotcallback客户端回调函数client设备客户端config客户端配置constants常量包device直连设备客户端file文件上传下载gateway网关设备客户端model结构体包rule端侧规则包sam - [使用说明](https://support.huaweicloud.com/sdkreference-iothub/iot_02_00924.md): huaweicloud-iot-device-sdk-go提供设备接入华为云IoT物联网平台的Go版本的SDK,提供设备和平台之间通讯能力,以及设备服务、网关服务、OTA等高级服务,并且针对各种场景提供了丰富的样例代码。IoT设备开发者使用SDK可以大大简化开发复杂度,快速的接入平台。该SDK用于帮助设备通过MQTT协议快速连接到华为物联 - [快速接入](https://support.huaweicloud.com/sdkreference-iothub/iot_02_00925.md): 本章将使用SmokeDetector样例指导您快速体验产品模型的创建、样例的配置与启动、以及SDK基本功能的使用。为了方便体验,提供了一个烟感的产品模型,烟感会上报烟雾值、温度、湿度、烟雾报警,还支持响铃报警命令。 以烟感为例,体验消息上报、属性上报、命令响应等功能。为了方便体验,提供了一个烟感的产品模型,烟感会上报烟雾值、温度、湿度、烟 - [功能支持](https://support.huaweicloud.com/sdkreference-iothub/iot_02_00926.md): SDK面向运算、存储能力较强的嵌入式终端设备,开发者通过调用SDK接口,便可实现设备与IoTDA服务(后续简出现的“服务”、“平台“均指IoTDA服务)双向通讯。 SDK当前支持的功能有: - [使用说明](https://support.huaweicloud.com/sdkreference-iothub/iot_02_99801.md): IoT Device SDK Tiny是部署在具备广域网能力、对功耗、存储、计算资源有苛刻限制的终端设备上的轻量级的互联互通中间件,您只需调用API接口,便可实现设备快速接入到物联网平台以及数据上报和命令接收等功能。IoT Device SDK Tiny提供端云协同能力,集成了MQTT、LWM2M、CoAP、mbedtls、LwIP全套I - [通信协议选择与适配](https://support.huaweicloud.com/sdkreference-iothub/iot_02_99802.md): Tiny中支持MQTT、LWM2M、CoAP、mbedtls、LwIP全套IoT互联互通协议栈,以下主要介绍MQTT、LWM2M、CoAP这三种协议。端云互通组件是IoT Device SDK Tiny中的重要组件,提供端云协同能力和基于MQTT、LwM2M、CoAP协议对接华为云的开放API。支持MQTT/ LwM2M/CoAP协议、M - [OS系统选择与适配](https://support.huaweicloud.com/sdkreference-iothub/iot_02_99803.md): Tiny中提供了LiteOS、NovaOS、linux、ucos_ii、macOS、FreeRTOS等多操作系统的适配,您也可以根据需要去适配自己的操作系统。IoT Device SDK Tiny本身是不局限于某一款具体的物联网操作系统的,但是其运行是依赖于操作系统的,因此需要进行OS的相关适配。用户可以根据模组、MCU厂商的需求使用其内 - [开发板移植清单](https://support.huaweicloud.com/sdkreference-iothub/iot_02_99804.md): huaweicloud_iot_link SDK目前已经适配了多款模组多款开发板,多个不同的OS,具体如下所示:WIFI&蓝牙模组WIFI&蓝牙模组适配分类硬件上华为云协议描述博流 BL602单模组MQTT华为云openCPU智联模组_wifi_BL602(RISC-V)_MQTT单模组LwM2M华为云openCPU智联模组_wifi_B - [设备侧 IoT Device C for OpenHarmony SDK使用指南](https://support.huaweicloud.com/sdkreference-iothub/iot_02_0093.md): 设备侧 IoT Device C for OpenHarmony SDK提供设备接入华为云IoT物联网平台的OpenHarmony版本的SDK,提供设备和平台之间通讯能力,以及设备服务、OTA等高级服务,并且针对各种场景提供了丰富的demo代码。相关集成指导请参考设备侧 IoT Device C for OpenHarmony SDK使用 - [使用说明](https://support.huaweicloud.com/sdkreference-iothub/iot_02_00941.md): iot-device-sdk-python(以下简称SDK)提供设备接入华为云IoT物联网平台的Python版本的SDK,提供设备和平台之间通讯能力, 以及设备服务、网关服务、OTA等高级服务,并且针对各种场景提供了丰富的demo代码。 IoT设备开发者使用SDK可以大大简化开发复杂度,快速的接入平台。本文通过示例讲述SDK帮助设备用MQ - [快速接入](https://support.huaweicloud.com/sdkreference-iothub/iot_02_00942.md): 本章将使用SmokeDetector样例指导您快速体验产品模型的创建、样例代码的配置与启动、以及SDK基本功能的使用。为了方便体验,提供了一个烟感的产品模型,烟感会上报烟雾值、温度、湿度、烟雾报警、还支持响铃报警命令。 以烟感为例,体验消息上报、属性上报、命令响应等功能。为了方便体验,提供了一个烟感的产品模型,烟感会上报烟雾值、温度、湿度 - [功能支持](https://support.huaweicloud.com/sdkreference-iothub/iot_02_00943.md): SDK面向运算、存储能力较强的嵌入式终端设备,开发者通过调用SDK接口,便可实现设备与IoTDA服务(后续出现的“服务”、“平台“均指IoTDA服务)双向通讯。 SDK当前支持的功能有: - [使用说明](https://support.huaweicloud.com/sdkreference-iothub/iot_02_00951.md): 设备侧 IoT Device Arkts(OpenHarmony) SDK提供设备接入华为云IoT物联网平台的ArkTS版本的SDK,提供设备和平台之间通讯能力,并且针对各种场景提供了丰富的demo代码。相关集成指导请参考设备侧 IoT Device Arkts(OpenHarmony) SDK使用指南。已安装 DevEco Studio - [快速接入](https://support.huaweicloud.com/sdkreference-iothub/iot_02_00952.md): 本章将使用SmokeDetector Demo 指导您快速体验产品模型的创建、Demo的配置与启动、以及SDK基本功能的使用。为了方便体验,提供了一个烟感的产品模型,烟感会上报烟雾值、温度、湿度、烟雾报警、还支持响铃报警命令。 以烟感例,体验消息上报、属性上报、命令响应等功能。为了方便体验,提供了一个烟感的产品模型,烟感会上报烟雾值、温度 - [功能支持](https://support.huaweicloud.com/sdkreference-iothub/iot_02_00953.md): SDK面向运算、存储能力较强的嵌入式终端设备,开发者通过调用SDK接口,便可实现设备与IoTDA服务(后续简出现的“服务”、“平台“均指IoTDA服务)双向通讯。 SDK当前支持的功能有: ## 常见问题 - [热门问题](https://support.huaweicloud.com/iothub_faq/iot_faq_00000.md): 设备管理服务和设备接入服务合一后的差异点是什么?如何获取对接物联网平台的地址?如何获取新域名和老域名接入的地址/证书?新旧域名接入的鉴权方式有什么区别?命令/属性下发总是超时?应用侧如何获取appid和secret?Java SDK中有多个demo,该参考哪一个demo?C版 SDK中有多个demo,该参考哪一个demo?如果是TCP协议 - [连接IoT平台的业务场景有哪些?](https://support.huaweicloud.com/iothub_faq/iot_faq_00250.md): 连接IoT平台的业务有四个场景:设备 + IoT平台 + 应用该场景为最通用的场景,设备将数据上报到IoT平台,IoT平台对设备进行管理,同时针对不同的事件类型,会将数据推送到用户应用,同时应用可以将命令下发到IoT平台,平台可以缓存/实时下发命令给设备。设备 + IoT平台 + 应用该场景为最通用的场景,设备将数据上报到IoT平台,Io - [设备管理服务和设备接入服务合一后的差异点是什么?](https://support.huaweicloud.com/iothub_faq/iot_faq_00002.md): 设备管理服务和设备接入服务合一后,主要有以下变更点:功能:全新升级后的设备接入服务(IoTDA),整合了原设备接入服务和设备管理服务的功能,新用户只需开通设备接入服务,即可同时使用设备接入和设备管理的全部功能。计费:已开通过设备接入服务的用户,可叠加使用设备管理服务的功能,按消息数计费的方式不变;原设备接入服务和设备管理服务都已开通使用的 - [IAM子用户或子项目是否可以开通物联网平台服务?](https://support.huaweicloud.com/iothub_faq/iot_faq_00003.md): 1、子用户可以开通设备接入实例,所开通的设备接入实例属于IAM主账号,即付费主体为IAM主账号。2、通过IAM创建的子项目无法开通设备接入服务。 - [物联网平台支持在华为云的哪些区域开通?](https://support.huaweicloud.com/iothub_faq/iot_faq_00006.md): 设备接入服务(IoTDA)当前支持在“华北-北京四”、“华东-上海一”、“华南-广州”和“华南-广州-友好用户环境”、“中国-香港”、“亚太-新加坡”、亚太-雅加达、“亚太-曼谷”、拉美-圣地亚哥、拉美-墨西哥城二、中东-利雅得、“非洲-约翰内斯堡”区域开通服务。企业版当前仅支持在“华北-北京四”、“华东-上海一”、“华南-广州”区域开通 - [华为是否提供模组/硬件终端/应用软件等?](https://support.huaweicloud.com/iothub_faq/iot_faq_00009.md): 华为提供了芯片供模组厂商集成,同时提供了物联网平台及终端接入物联网平台方案供设备厂商集成。当前有多家合作伙伴已经和华为物联网平台完成集成认证,建议您访问华为云商店寻找合适的提供商。 - [IAM用户访问API提示没有权限?](https://support.huaweicloud.com/iothub_faq/iothub_faq_0002.md): 2020/04/23设备接入服务上线了细粒度策略权限控制,如果未对IAM用户授予IoTDA的权限,使用IAM用户访问设备接入资源提示没有权限,返回"Operation not allowed. The user does not have the permission"报错。您可以参考如下步骤为IAM用户所在的用户组授予IoTDA Ful - [创建规则或者设置资源文件存储时候提示赋予Security Administrator权限](https://support.huaweicloud.com/iothub_faq/iothub_faq_0003.md): 使用IAM用户访问设备接入服务,创建规则或者设置资源文件存储时提示“请联系管理员给您所在的用户组赋予Security Administrator的权限”,表明IAM用户没有授予委托管理权限,请参考以下操作配置权限。方法1:创建一个自定义策略(包括查询、创建委托、查询角色等功能),并添加到IAM用户所在的用户组中(推荐该方法)使用管理员账号 - [物联网平台设置默认资源空间的规则是什么?](https://support.huaweicloud.com/iothub_faq/iothub_faq_00104.md): 如果您是2020年04月27日00:00前开通的设备接入服务,且您的账户下有多个资源空间,物联网平台设置默认资源空间的规则如下:设置包含Default字样的资源空间为默认资源空间。如果资源空间名不包含Default字样,则设置拥有最多设备数的资源空间为默认资源空间。 - [应用服务器如何通过IoTDA获取设备数据?](https://support.huaweicloud.com/iothub_faq/iot_faq_00011.md): 应用服务器通过IoTDA设备接入服务获取设备数据,需要通过IoTDA平台上的规则引擎配置数据转发规则,将数据转发至AMQP消息队列或MQTT消息队列,再从应用服务器侧进行数据拉取;或直接转发至第三方应用服务(HTTP推送)。 - [物联网平台的资源空间和设备可以无限创建吗?](https://support.huaweicloud.com/iothub_faq/iot_faq_00094.md): 不可以。具体技术规格限制可以参见使用限制。 - [物联网平台支持批量注册设备吗?](https://support.huaweicloud.com/iothub_faq/iot_faq_00091.md): 物联网平台支持通过应用服务器调用创建批量任务接口,或者在控制台上批量注册设备。下面介绍如何在控制台上批量注册设备。 - [物联网平台对应用侧和设备侧在开发或使用时有限制吗?](https://support.huaweicloud.com/iothub_faq/iot_faq_00092.md): 有。具体技术规格可以参见使用限制。 - [物联网平台支持的DTLS加密算法有哪些?](https://support.huaweicloud.com/iothub_faq/iot_faq_00033.md): 平台支持预置密钥的安全模式,支持的加密套包括:TLS_PSK_WITH_AES_128_CCM_8, as defined in [RFC6655]。TLS_PSK_WITH_AES_128_CBC_SHA256, as defined in [RFC5487]。 - [物联网平台支持二进制大小端模式切换吗?](https://support.huaweicloud.com/iothub_faq/iot_faq_00043.md): 不支持,物联网平台为大端模式。 - [什么是NB-IoT?](https://support.huaweicloud.com/iothub_faq/iot_faq_00200.md): 基于蜂窝的窄带物联网(Narrow Band Internet of Things, NB-IoT)是万物互联网络的一个重要分支。NB-IoT构建于蜂窝网络,只消耗大约180KHz的带宽,可直接部署于GSM网络、UMTS网络或LTE网络,以降低部署成本、实现平滑升级。NB-IoT是IoT领域一个新兴的技术,支持低功耗设备在广域网的蜂窝数据 - [物联网平台支持的硬件架构和使用的相关组件有哪些?](https://support.huaweicloud.com/iothub_faq/iot_faq_00220.md): 物联网平台目前使用华为自研的操作系统欧拉OS、自研的Java编译及运行环境、自研数据库GaussDB、开源MongoDB数据库等,支持多种硬件架构,包括X86和ARM架构,可满足不同场景需求。 - [如何获取平台接入地址?](https://support.huaweicloud.com/iothub_faq/iot_faq_00123.md): 请进入IoTDA的控制台界面,在左侧菜单栏单击“IoTDA实例”,选择您的实例并单击实例卡片进入。实例管理-切换实例在左侧导航栏单击总览,单击“接入信息”,找到您的平台接入地址。总览-获取接入信息 - [如何选择合适的操作系统](https://support.huaweicloud.com/iothub_faq/iot_faq_00124.md): 选择物联网操作系统要综合考量硬件资源限制、功耗要求、网络连接需求、开发与维护成本、安全性、生态系统扩展性等因素,以下是两种华为开发的操作系统的简单介绍。LiteOS是一种轻量级物联网操作系统,广泛适用于各种资源受限的场景,尤其适合智能家居、可穿戴设备、车联网、工业控制等需要低功耗、实时性能以及小巧体积的物联网终端。它也可以作为嵌入式系统的 - [连接IoT平台的业务场景有哪些?](https://support.huaweicloud.com/iothub_faq/iot_faq_00250.md): 连接IoT平台的业务有四个场景:设备 + IoT平台 + 应用该场景为最通用的场景,设备将数据上报到IoT平台,IoT平台对设备进行管理,同时针对不同的事件类型,会将数据推送到用户应用,同时应用可以将命令下发到IoT平台,平台可以缓存/实时下发命令给设备。设备 + IoT平台 + 应用该场景为最通用的场景,设备将数据上报到IoT平台,Io - [设备管理服务和设备接入服务合一后的差异点是什么?](https://support.huaweicloud.com/iothub_faq/iot_faq_00002.md): 设备管理服务和设备接入服务合一后,主要有以下变更点:功能:全新升级后的设备接入服务(IoTDA),整合了原设备接入服务和设备管理服务的功能,新用户只需开通设备接入服务,即可同时使用设备接入和设备管理的全部功能。计费:已开通过设备接入服务的用户,可叠加使用设备管理服务的功能,按消息数计费的方式不变;原设备接入服务和设备管理服务都已开通使用的 - [IAM子用户或子项目是否可以开通物联网平台服务?](https://support.huaweicloud.com/iothub_faq/iot_faq_00003.md): 1、子用户可以开通设备接入实例,所开通的设备接入实例属于IAM主账号,即付费主体为IAM主账号。2、通过IAM创建的子项目无法开通设备接入服务。 - [物联网平台支持在华为云的哪些区域开通?](https://support.huaweicloud.com/iothub_faq/iot_faq_00006.md): 设备接入服务(IoTDA)当前支持在“华北-北京四”、“华东-上海一”、“华南-广州”和“华南-广州-友好用户环境”、“中国-香港”、“亚太-新加坡”、亚太-雅加达、“亚太-曼谷”、拉美-圣地亚哥、拉美-墨西哥城二、中东-利雅得、“非洲-约翰内斯堡”区域开通服务。企业版当前仅支持在“华北-北京四”、“华东-上海一”、“华南-广州”区域开通 - [华为是否提供模组/硬件终端/应用软件等?](https://support.huaweicloud.com/iothub_faq/iot_faq_00009.md): 华为提供了芯片供模组厂商集成,同时提供了物联网平台及终端接入物联网平台方案供设备厂商集成。当前有多家合作伙伴已经和华为物联网平台完成集成认证,建议您访问华为云商店寻找合适的提供商。 - [IAM用户访问API提示没有权限?](https://support.huaweicloud.com/iothub_faq/iothub_faq_0002.md): 2020/04/23设备接入服务上线了细粒度策略权限控制,如果未对IAM用户授予IoTDA的权限,使用IAM用户访问设备接入资源提示没有权限,返回"Operation not allowed. The user does not have the permission"报错。您可以参考如下步骤为IAM用户所在的用户组授予IoTDA Ful - [创建规则或者设置资源文件存储时候提示赋予Security Administrator权限](https://support.huaweicloud.com/iothub_faq/iothub_faq_0003.md): 使用IAM用户访问设备接入服务,创建规则或者设置资源文件存储时提示“请联系管理员给您所在的用户组赋予Security Administrator的权限”,表明IAM用户没有授予委托管理权限,请参考以下操作配置权限。方法1:创建一个自定义策略(包括查询、创建委托、查询角色等功能),并添加到IAM用户所在的用户组中(推荐该方法)使用管理员账号 - [物联网平台设置默认资源空间的规则是什么?](https://support.huaweicloud.com/iothub_faq/iothub_faq_00104.md): 如果您是2020年04月27日00:00前开通的设备接入服务,且您的账户下有多个资源空间,物联网平台设置默认资源空间的规则如下:设置包含Default字样的资源空间为默认资源空间。如果资源空间名不包含Default字样,则设置拥有最多设备数的资源空间为默认资源空间。 - [应用服务器如何通过IoTDA获取设备数据?](https://support.huaweicloud.com/iothub_faq/iot_faq_00011.md): 应用服务器通过IoTDA设备接入服务获取设备数据,需要通过IoTDA平台上的规则引擎配置数据转发规则,将数据转发至AMQP消息队列或MQTT消息队列,再从应用服务器侧进行数据拉取;或直接转发至第三方应用服务(HTTP推送)。 - [物联网平台的资源空间和设备可以无限创建吗?](https://support.huaweicloud.com/iothub_faq/iot_faq_00094.md): 不可以。具体技术规格限制可以参见使用限制。 - [物联网平台支持批量注册设备吗?](https://support.huaweicloud.com/iothub_faq/iot_faq_00091.md): 物联网平台支持通过应用服务器调用创建批量任务接口,或者在控制台上批量注册设备。下面介绍如何在控制台上批量注册设备。 - [物联网平台对应用侧和设备侧在开发或使用时有限制吗?](https://support.huaweicloud.com/iothub_faq/iot_faq_00092.md): 有。具体技术规格可以参见使用限制。 - [物联网平台支持的DTLS加密算法有哪些?](https://support.huaweicloud.com/iothub_faq/iot_faq_00033.md): 平台支持预置密钥的安全模式,支持的加密套包括:TLS_PSK_WITH_AES_128_CCM_8, as defined in [RFC6655]。TLS_PSK_WITH_AES_128_CBC_SHA256, as defined in [RFC5487]。 - [物联网平台支持二进制大小端模式切换吗?](https://support.huaweicloud.com/iothub_faq/iot_faq_00043.md): 不支持,物联网平台为大端模式。 - [什么是NB-IoT?](https://support.huaweicloud.com/iothub_faq/iot_faq_00200.md): 基于蜂窝的窄带物联网(Narrow Band Internet of Things, NB-IoT)是万物互联网络的一个重要分支。NB-IoT构建于蜂窝网络,只消耗大约180KHz的带宽,可直接部署于GSM网络、UMTS网络或LTE网络,以降低部署成本、实现平滑升级。NB-IoT是IoT领域一个新兴的技术,支持低功耗设备在广域网的蜂窝数据 - [物联网平台支持的硬件架构和使用的相关组件有哪些?](https://support.huaweicloud.com/iothub_faq/iot_faq_00220.md): 物联网平台目前使用华为自研的操作系统欧拉OS、自研的Java编译及运行环境、自研数据库GaussDB、开源MongoDB数据库等,支持多种硬件架构,包括X86和ARM架构,可满足不同场景需求。 - [如何获取平台接入地址?](https://support.huaweicloud.com/iothub_faq/iot_faq_00123.md): 请进入IoTDA的控制台界面,在左侧菜单栏单击“IoTDA实例”,选择您的实例并单击实例卡片进入。实例管理-切换实例在左侧导航栏单击总览,单击“接入信息”,找到您的平台接入地址。总览-获取接入信息 - [如何选择合适的操作系统](https://support.huaweicloud.com/iothub_faq/iot_faq_00124.md): 选择物联网操作系统要综合考量硬件资源限制、功耗要求、网络连接需求、开发与维护成本、安全性、生态系统扩展性等因素,以下是两种华为开发的操作系统的简单介绍。LiteOS是一种轻量级物联网操作系统,广泛适用于各种资源受限的场景,尤其适合智能家居、可穿戴设备、车联网、工业控制等需要低功耗、实时性能以及小巧体积的物联网终端。它也可以作为嵌入式系统的 - [设备集成相关问题](https://support.huaweicloud.com/iothub_faq/iot_faq_01003.md): 登录设备接入服务控制台,在左侧菜单栏单击“IoTDA实例”,选择您的实例并单击实例卡片进入。实例管理-切换实例在左侧导航栏单击总览,单击“接入信息”,找到您的设备对接地址。总览-获取接入信息建议使用权威机构认证的证书,平台也支持自定义证书,详细步骤可参考上传设备CA证书。出现堆栈信息:Caused by: javax.net.ssl.SS - [设备侧SDK相关问题](https://support.huaweicloud.com/iothub_faq/iot_faq_01002.md): C版SDK启动失败一般是openssl、paho库文件编译失败、或者没有使用export LD_LIBRARY_PATH=./lib/加载库文件。可参考IoT Device SDK(C)使用指南中的准备工作。IoT Device SDK Java启动失败一般是未安装JDK(需1.8及以上),或者未安装Maven。直连设备建议参考“devi - [设备发放相关问题](https://support.huaweicloud.com/iothub_faq/iot_faq_01008.md): 不需要,通过设备发放服务成功发放的设备,会将设备信息同步到设备接入服务。设备发放提供证书认证方式,证书认证为双向认证过程,涉及到设备发放(平台)和设备两端,过程如下图所示。双向证书认证过程使用到了如下几类证书:样例中各类证书常用文件名:双向认证,即双向证书认证,与单向认证中不同的是,不仅包含单向认证中的设备对平台的证书验证步骤,还包含了平 - [LWM2M/CoAP接入相关问题](https://support.huaweicloud.com/iothub_faq/iot_faq_01005.md): 平台侧开发:包括创建产品、开发产品模型、开发编解码插件、注册设备。详细操作指导请参考创建产品、开发产品模型、开发编解码插件、注册单个设备。设备侧开发:使用模组、设备侧Tiny SDK接入。详细操作指导请参考通过华为认证模组接入、IoT Device SDK Tiny使用指南(C)(可选)应用侧开发。发送指令AT+CSQ命令查询NB信号强度 - [MQTT接入相关问题](https://support.huaweicloud.com/iothub_faq/iot_faq_01006.md): 登录设备接入服务控制台,在左侧菜单栏单击“IoTDA实例”,选择您的实例并单击实例卡片进入。实例管理-切换实例在左侧导航栏单击总览,单击“接入信息”,找到您的平台接入地址。总览-获取接入信息使用TLS进行MQTT接入,需要加载服务端CA证书。参考设备侧demo MQTTS接入中证书的使用方式,或访问资源获取下载平台的CA证书。检查是否网络 - [泛协议接入相关问题](https://support.huaweicloud.com/iothub_faq/iot_faq_01007.md): 平台侧开发:包括创建产品、(可选)开发产品模型、(可选)开发编解码插件。设备侧开发:使用泛协议网关方式接入,可参考泛协议开发。(可选)应用侧开发。一般使用泛协议接入,详细请参考通过协议转换网关实现泛协议设备接入。 - [物模型相关问题](https://support.huaweicloud.com/iothub_faq/iot_faq_01000.md): 本文介绍物模型相关的问题和解决方法。物联网平台提供线上和线下两种产品模型开发方式:线上开发指导详见线上开发参考;线下开发指导详见线下开发参考。数据类型的配置可以参考如下原则:int:当上报的数据为整数或布尔值时,可以匹配为此类型。插件开发中可匹配int型或array类型。decimal:当上报的数据为小数时,可以匹配为此类型。插件开发中可 - [消息通信相关问题](https://support.huaweicloud.com/iothub_faq/iot_faq_00225.md): 若设备是使用接口注册的,请确认设备是否因为没在指定的timeout时间内上线而被物联网平台自动删除了。如果设备已被删除,请重新注册设备再尝试上报数据。请检查使用接口注册设备时,填写的产品信息是否和产品模型一致。请检查上报的数据名称是否和产品模型定义的服务属性一致。确定以上都不存在问题时,请检查设备和物联网平台之间的网络链路是否畅通,设备是 - [订阅推送相关问题](https://support.huaweicloud.com/iothub_faq/iot_faq_00101.md): 以业务应用订阅设备数据变化通知为例,订阅和推送的流程如下:应用服务器通过调用物联网平台的订阅接口订阅设备数据变化通知(携带回调地址和通知类型),物联网平台将业务应用的回调地址和订阅的通知类型存储到订阅列表中以便向业务应用推送设备数据变化消息。设备上报数据给物联网平台。物联网平台根据订阅时设置的回调地址,将设备数据主动推送给业务应用。什么是 - [编解码插件相关问题](https://support.huaweicloud.com/iothub_faq/iot_faq_00018.md): 物联网平台提供线上编解码插件开发方式:线上开发指导详见在线开发参考。在线开发编解码插件时,如果某字段的数据类型为字符串或可变长度字符串,则按照ACSII码进行编解码。对应的插件在线开发可参考字符串及可变长字符串的编解码插件在线开发。在线开发编解码插件时,如果某字段的数据类型为数组或可变长度数组,则按照base64进行编解码。对应的插件在线 - [OTA升级相关问题](https://support.huaweicloud.com/iothub_faq/iot_faq_01001.md): 软件升级指升级设备的系统软件和应用软件,固件升级指升级设备硬件的底层“驱动程序”。升级方式均为将软/固件包上传到物联网平台上,或者关联用户OBS上的对象,设备从物联网平台或用户OBS获取软/固件包实现远程升级。不支持。目前只支持将软/固件包直接上传至物联网平台或者关联用户OBS上的对象,上传的位置为控制台的设备 > 软固件升级 > 软件列 - [应用集成相关问题](https://support.huaweicloud.com/iothub_faq/iot_faq_01004.md): 客户应用服务器调用平台接口可以通过调用IAM接口获取X-Auth-Token或者集成SDK使用AKSK方式认证鉴权。华为云账号可能需要定期更新密码,生产系统建议集成IoTDA的应用侧SDK,使用AKSK鉴权。问题描述应用集成了IoTDA的应用侧SDK,使用AKSK进行认证鉴权,但是接口返回400状态码,错误描述是Missing reque - [实例管理相关问题](https://support.huaweicloud.com/iothub_faq/iot_faq_01010.md): 企业版实例创建异常通常有以下原因:实例依赖的底层资源不足,如资源售罄,可用区不足等。通常无法通过重试恢复,建议提交工单联系技术支持。委托权限不足,可以参考委托授权进行排查,确认委托给IoTDA云服务的权限是否满足创建企业版实例的要求,如委托权限不足可自行补齐后,在创建异常的企业版实例信息中单击“重试”。实例管理-重启企业版创建