检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
创建产品 功能介绍 应用服务器可调用此接口创建产品。此接口仅创建了产品，没有创建和安装插件，如果需要对数据进行编解码，还需要在平台开发和安装插件。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/products 表1 路径参数 参数
serverIp string 服务器地址 FTP服务器地址 port int 服务器端口 FTP服务器端口 username string 用户名 FTP服务器用户名 password string 密码 FTP服务器密码 path string 文件上传路径 FTP服务器文件上传路径 channelNo
(FQDN)。使用自定义域名，用户可以管理自己的服务器证书，例如用于签署证书的根证书颁发机构 (CA)、签名算法、以及证书的生命周期。 使用场景 自己管理服务器证书的根证书颁发机构 (CA)、签名算法、以及证书的生命周期等。 出于品牌推广目的向客户公开公司自己的域名。 迁移场景继承自己原有的域名和服务器证书。 使用限制
查询设备属性 功能介绍 设备的产品模型中定义了物联网平台可向设备下发的属性，应用服务器可调用此接口向设备发送指令用以查询设备的实时属性, 并由设备将属性查询的结果同步返回给应用服务器。 注意：此接口适用于MQTT设备，暂不支持NB-IoT设备。 调用方法 请参见如何调用API。 URI
创建批量任务 功能介绍 应用服务器可调用此接口为创建批量处理任务，对多个设备进行批量操作。当前支持批量软固件升级、批量创建设备、批量修改设备、批量删除设备、批量冻结设备、批量解冻设备、批量创建命令、批量创建消息任务。 调用方法 请参见如何调用API。 URI POST /v5/i
物联网平台支持设备数据上报和设备命令下发，但若要将两者联动起来，一般需要由应用服务器实现对应逻辑。 设备接入服务提供规则引擎功能，平台上简单几步操作即可实现数据上报特定数据时平台自动下发指定命令，减少应用服务器开发工作量。 示例场景 本示例为设备自带的温度传感器上报的温度大于80度时，平台自动下发命令关闭设备。
功能介绍 用户可以通过该接口创建隧道（WebSocket协议），应用服务器和设备可以通过该隧道进行数据传输。 该API接口在基础版不支持。 该API调用后平台会向对应的MQTT/MQTTS设备下发隧道地址及密钥，同时给应用服务器也返回隧道地址及密钥，设备可以通过该地址及密钥创建WebSocket协议连接。
数据转发至OBS长期存储 场景说明 对于设备上报的数据，可以选择让平台将设备上报数据推送给应用服务器，由应用服务器进行保存；还可以选择让平台将设备上报数据转发给对象存储服务（OBS），由OBS进行存储。 本示例为将所有设备上报的数据转发至OBS存储。 创建OBS桶 登录华为云官方网站，访问对象存储服务。
创建AMQP队列 功能介绍 应用服务器可调用此接口在物联网平台创建一个AMQP队列。每个租户只能创建100个队列，若超过规格，则创建失败，若队列名称与已有的队列名称相同，则创建失败。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/amqp-queues
物联网平台支持批量注册设备吗？ 物联网平台支持通过应用服务器调用创建批量任务接口，或者在控制台上批量注册设备。下面介绍如何在控制台上批量注册设备。 访问设备接入服务，单击“立即使用”进入设备接入控制台。 选择并进入您的实例，在左侧导航栏，单击“ 设备 > 所有设备”。 单击“批量
设备消息上报 接口说明 用于设备将自定义数据上报给平台，平台将设备上报的消息转发给应用服务器或华为云其他云服务上进行存储和处理。 URI 请求方法 POST URI /v5/devices/{device_id}/sys/messages/up 传输协议 HTTPS 请求参数 名称
数据转发至Kafka存储 场景说明 对于设备上报的数据，可以选择让平台将设备上报数据推送给应用服务器，由应用服务器进行保存；还可以选择让平台将设备上报数据转发给分布式消息服务（Kafka），由Kafka进行存储。 本示例为将所有设备上报的数据转发至Kafka存储。 购买Kafka实例
全新升级后的设备接入服务获取设备数据，需要通过规则引擎，将数据转发至其他服务获取。例如转发至OBS存储，转发至DIS或DMS后再发送至应用服务器。 父主题： 方案咨询
当规则引擎将消息转发至第三方应用服务器时，若该服务器故障导致消息无法及时处理，IoT物联网平台将会积压数据。考虑到用户对数据实时性的要求，我们支持清理积压在转发通道中的数据，以确保数据的及时处理和传输。 例如：当定时上报用户使用量的水表将数据发送至目标服务器时，由于服务器出现故障导致数据积压
设备的产品模型中定义了物联网平台可向设备下发的命令，应用服务器可调用此接口向指定设备下发命令，以实现对设备的同步控制。平台负责将命令以同步方式发送给设备，并将设备执行命令结果同步返回, 如果设备没有响应，平台会返回给应用服务器超时，平台超时时间是20秒。如果命令下发需要超过20秒，建议采用消息下发。
将设备上报的二进制码流解码成JSON格式的数据，发送给应用服务器。 将应用服务器响应的JSON格式数据编码成二进制码流，下发给设备。 命令下发流程 图2 命令下发编解码插件流程 在命令下发流程中，有两处需要用到编解码插件： 将应用服务器下发的JSON格式数据编码成二进制码流，下发给设备。
上报的消息转发给应用服务器或华为云其他云服务上进行存储和处理。 设备属性上报：用于设备按产品模型中定义的格式将属性数据上报给平台。 网关批量属性上报：用于网关设备将多个设备的属性数据一次性上报给平台。 应用服务器下发指令给设备 设备接入物联网平台后，应用服务器可通过以下方式发送指令到设备。
数据转发流控策略配置 概述 客户可以根据自身的业务场景以及转发目标（如第三方应用服务器等）的性能等情况，在IoT物联网平台上创建不同维度的流控策略，控制IoT物联网平台数据转发到转发目标（如第三方应用服务器等）的流量限制。 流控策略维度 表1 流控策略类型 流控策略类型 描述 实例级别流控
务后，再定义每个服务具备的属性、命令以及命令的参数。 以水表为例，水表具有多种能力，如上报水流、告警、电量、连接等各种数据，并且能够接受服务器下发的各种命令。产品模型文件在描述水表的能力时，可以将水表的能力划分五个服务，每个服务都需要定义各自的上报属性或命令。说明如下： 服务类型
批量注册设备 物联网平台支持通过应用服务器调用创建批量任务接口，或者在控制台上批量注册设备。本文介绍如何在控制台上批量注册设备。 操作步骤 访问设备接入服务，单击“管理控制台”进入设备接入控制台。 在左侧导航栏选择“设备 > 所有设备”，进入“批量注册”页签，单击“批量注册”。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
