检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
可调用此接口将设备的自定义数据格式上报给平台，平台对该消息不进行解析，该消息可以转发给应用服务器或华为云其他云服务上进行存储和处理。 消息上报和属性上报的区别，请查看消息通信说明。 低配置且资源受限或者对网络流量有要求的设备，不适合直接构造JSON数据与物联网平台通信时，可将原始
配置设备影子预期数据 功能介绍 应用服务器可调用此接口配置设备影子的预期属性（desired区），当设备上线或者设备上报属性时把属性下发给设备。 设备影子介绍： 设备影子是一个用于存储和检索设备当前状态信息的JSON文档。 每个设备有且只有一个设备影子，由设备ID唯一标识 设备影
需要由应用服务器实现对应逻辑。 设备接入服务提供规则引擎功能，平台上简单几步操作即可实现数据上报特定数据时平台自动下发指定命令，减少应用服务器开发工作量。 示例场景 本示例为设备自带的温度传感器上报的温度大于80度时，平台自动下发命令关闭设备。 操作步骤如下： 1.配置设备接入服
查询设备属性 功能介绍 设备的产品模型中定义了物联网平台可向设备下发的属性，应用服务器可调用此接口向设备发送指令用以查询设备的实时属性, 并由设备将属性查询的结果同步返回给应用服务器。 注意：此接口适用于MQTT设备，暂不支持NB-IoT设备。 调用方法 请参见如何调用API。 URI
的服务，请根据界面提示，配置云服务访问授权。 存储桶 选择要存储数据的桶。若没有，请前往OBS服务创建桶。 图3 新建转发目标-转发至OBS-JSON格式 单击“启动规则”，激活配置好的数据转发规则。 图4 启动规则-转发至OBS 验证操作 您可以使用配置设备接入服务时注册的真实设备接入平台，上报任意数据。
用于设备向平台获取设备影子数据。用户可以通过应用服务器或物联网控制台配置设备影子预期数据，设备上线时订阅该topic，可以获取到平台设备影子数据，以此来同步设备属性期望值，从而完成设备属性值的修改。 简单交互逻辑介绍如下： ① 应用调用“配置设备影子预期数据”接口或在控制台配置设备影子数据； ② 设备侧
设备上报配置响应 功能介绍 设备上报配置结果响应。创建远程配置任务时，可以配置超时时间（1-30天，不配置默认30天）。在超时时间内，平台每24小时向设备下发一次配置，直到设备上报配置响应。如果设备在超时时间内一直没有上报配置响应，则平台显示该设备配置任务超时失败。 Topic 上行:
远程配置 平台下发配置通知 设备上报配置响应 父主题： 设备侧MQTT/MQTTS接口参考
status，Event:update）、创建规则动作并激活规则后，当命令状态变更时，物联网平台会根据规则将结果发送到规则指定的服务器，如用户自定义的HTTP服务器，AMQP服务器，以及华为云的其他存储服务器等, 详情参考设备命令状态变更通知。 注意： 此接口适用于NB设备异步命令下发，暂不支持其他协议类型设备命令下发。
(FQDN)。使用自定义域名，用户可以管理自己的服务器证书，例如用于签署证书的根证书颁发机构 (CA)、签名算法、以及证书的生命周期。 使用场景 自己管理服务器证书的根证书颁发机构 (CA)、签名算法、以及证书的生命周期等。 出于品牌推广目的向客户公开公司自己的域名。 迁移场景继承自己原有的域名和服务器证书。 使用限制
创建设备代理 功能介绍 应用服务器可调用此接口在物联网平台创建一个动态设备代理规则，用于子设备自主选择网关设备上线和上报消息，即代理组下的任意网关下的子设备均可以通过代理组里其他设备上线(网关更新子设备状态 )然后进行数据上报(网关批量设备属性上报 )。 单实例最多可以配置10个设备代理 单账号调用该接口的
平台下发配置通知 功能介绍 物联网平台向设备侧下发配置通知。物联网平台为用户提供远程配置功能，用户可以在不中断设备运行的情况下，远程更新设备的系统参数、运行参数等配置信息。例如：Windows的收银台机器，需要通过远程配置修改一些系统参数；车联网中的T-BOX，需要通过远程配置修改设备侧的一些数据上报频率等。
AT+HMPKS 该指令用于设置服务器或者客户端证书。 指令 参数 参数缺省处理 AT响应结果 使用示例 AT+HMPKS =type, para1,[para2] type=0，表示平台证书，证书在para1中。 type=1，表示设备公钥证书，证书在para1中。 type=
channel_detail ChannelDetail object 通道配置信息。 表20 ChannelDetail 参数 参数类型 描述 http_forwarding HttpForwarding object 参数说明：http服务器转发消息内容。当channel为HTTP_FORWARDING时，必填。
将设备上报的二进制码流解码成JSON格式的数据，发送给应用服务器。 将应用服务器响应的JSON格式数据编码成二进制码流，下发给设备。 命令下发流程 图2 命令下发编解码插件流程 在命令下发流程中，有两处需要用到编解码插件： 将应用服务器下发的JSON格式数据编码成二进制码流，下发给设备。
上传批量任务文件 功能介绍 应用服务器可调用此接口上传批量任务文件，用于创建批量任务。当前支持批量创建设备任务、批量删除设备任务、批量冻结设备任务、批量解冻设备任务的文件上传。 批量注册设备模板 批量删除设备模板 批量冻结设备模板 批量解冻设备模板 调用方法 请参见如何调用API。
查询产品 功能介绍 应用服务器可调用此接口查询已在物联网平台的创建的指定产品模型详细信息，包括产品模型的服务、属性、命令等。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/products/{product_id} 表1 路径参数 参数
数据转发至Kafka存储 场景说明 对于设备上报的数据，可以选择让平台将设备上报数据推送给应用服务器，由应用服务器进行保存；还可以选择让平台将设备上报数据转发给分布式消息服务（Kafka），由Kafka进行存储。 本示例为将所有设备上报的数据转发至Kafka存储。 购买Kafka实例
查询规则动作 功能介绍 应用服务器可调用此接口查询物联网平台中指定规则动作的配置信息。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/routing-rule/actions/{action_id} 表1 路径参数 参数 是否必选 参数类型
查询规则条件 功能介绍 应用服务器可调用此接口查询物联网平台中指定规则条件的配置信息。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/routing-rule/rules/{rule_id} 表1 路径参数 参数 是否必选 参数类型 描述
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
