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