检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
用户可以通过该接口创建隧道（WebSocket协议），应用服务器和设备可以通过该隧道进行数据传输。 该API接口在基础版不支持。 该API调用后平台会向对应的MQTT/MQTTS设备下发隧道地址及密钥，同时给应用服务器也返回隧道地址及密钥，设备可以通过该地址及密钥创建WebSocket协议连接。 一个设备无法创建多个隧道。
如何获取平台接入地址？ 请进入IoTDA的控制台界面，在左侧菜单栏单击“IoTDA实例”，选择您的实例并单击实例卡片进入。 图1 实例管理-切换实例 在左侧导航栏单击总览，单击“接入信息”，找到您的平台接入地址。 图2 总览-获取接入信息 父主题： 方案咨询
设备影子 概述 物联网平台支持创建设备的“影子”。设备影子是一个JSON文件，用于存储设备的在线状态、设备最近一次上报的设备属性值、应用服务器期望下发的配置。每个设备有且只有一个设备影子，设备可以获取和设置设备影子以此来同步设备属性值，这个同步可以是影子同步给设备，也可以是设备同步给影子。
后将会根据service_id和desired设置的属性值与产品中对应属性的默认值比对，如果不同，则将以shadow字段中设置的属性值为准写入到设备影子中。service_id的值和desired内的属性必须是profile中定义的。 表4 AuthInfo 参数 是否必选 参数类型
查询设备属性 功能介绍 设备的产品模型中定义了物联网平台可向设备下发的属性，应用服务器可调用此接口向设备发送指令用以查询设备的实时属性, 并由设备将属性查询的结果同步返回给应用服务器。 注意：此接口适用于MQTT设备，暂不支持NB-IoT设备。 调用方法 请参见如何调用API。 URI
打开MQTT.fx软件，单击设置图标。 参考下表配置鉴权参数，然后单击“Apply”。 参数名称 说明 Broker Address 填写从设备接入服务控制台获取的设备对接地址，此地址为域名信息。不能通过域名接入的设备，此处填写从2中获取的IP地址。 Broker Port 默认为1883。
该接口仅支持配置单个设备的设备影子的预期数据，如需多个设备的设备影子配置，请参见 创建批量任务。 限制： 设备影子JSON文档中的key不允许特殊字符：点(.)、dollar符号($)、空char(十六进制的ASCII码为00)。如果包含了以上特殊字符则无法正常刷新影子文档。 调用方法 请参见如何调用API。
查询设备影子数据 功能介绍 应用服务器可调用此接口查询指定设备的设备影子信息，包括对设备的期望属性信息（desired区）和设备最新上报的属性信息（reported区）。 设备影子介绍： 设备影子是一个用于存储和检索设备当前状态信息的JSON文档。 每个设备有且只有一个设备影子，由设备ID唯一标识
下发设备命令 功能介绍 设备的产品模型中定义了物联网平台可向设备下发的命令，应用服务器可调用此接口向指定设备下发命令，以实现对设备的同步控制。平台负责将命令以同步方式发送给设备，并将设备执行命令结果同步返回, 如果设备没有响应，平台会返回给应用服务器超时，平台超时时间是20秒。如
删除、设备更新设置为数据来源。当数据来源选择“设备”时，不支持快速配置。 设备属性：将归属在某个资源空间下的设备上报给平台的属性值设置为数据来源。单击右侧的“快速配置”勾选需要转发的产品、属性、服务等数据。 设备消息：将归属在某个资源空间下的设备上报给平台的消息设置为转发目标。单
长度不超过128，只允许字母、数字、下划线（_）、连接符（-）的组合。 该接口支持设备将自定义数据通过请求中的body体上报给平台，平台收到该请求后会将body内容转发给应用服务器或华为云其他云服务上进行存储和处理。平台对body中的内容无具体格式限制，小于1MB的数据可以通过该接口携带。 请求示例 POST
下发异步设备命令 功能介绍 设备的产品模型中定义了物联网平台可向设备下发的命令，应用服务器可调用此接口向指定设备下发异步命令，以实现对设备的控制。平台负责将命令发送给设备，并将设备执行命令结果异步通知应用服务器。 命令执行结果支持灵活的数据流转，应用服务器通过调用物联网平台的创建规则触发条件（Resource:device
物联网平台根据订阅时设置的回调地址，将设备数据主动推送给业务应用。 什么是回调地址？ 回调地址（callbackUrl）是指业务应用自定义的，供外部访问的restful接口地址。当物联网平台向业务应用推送消息时，实际是调用业务应用的restful接口把数据发给业务应用。 回调地址的请求方式必须为POST。
是否必选 参数类型 描述 tag_key 是 String 参数说明：标签键，在同一资源下标签键唯一。绑定资源时，如果设置的键已存在，则将覆盖之前的标签值。如果设置的键值不存在，则新增标签。 tag_value 否 String 参数说明：标签值。 表5 DevicePropertyReport
源时，如果设置的键已存在，则将覆盖之前的标签值。如果设置的键值不存在，则新增标签。 tag_value 否 String 参数说明：标签值。 表5 DeviceStatusUpdate 参数 是否必选 参数类型 描述 status 是 String 参数说明：设备当前的状态。 ONLINE：设备在线
AT+HMPKS 该指令用于设置服务器或者客户端证书。 指令 参数 参数缺省处理 AT响应结果 使用示例 AT+HMPKS =type, para1,[para2] type=0，表示平台证书，证书在para1中。 type=1，表示设备公钥证书，证书在para1中。 type=
参数说明：转发roma消息对应的地址列表 topic 是 String 参数说明：转发roma消息关联的topic信息。 username 是 String 参数说明：转发roma关联的用户名信息。 password 是 String 参数说明：转发roma关联的密码信息。 表12 MysqlForwarding
功能介绍 应用服务器在调用物联网平台的创建规则触发条件（Resource:device，Event:update）、创建规则动作、修改规则触发条件接口配置并激活规则后，当物联网平台中的设备更新时，物联网平台会向应用服务器推送通知消息。 URI POST /由应用服务器创建设备更新通知规则的转发目标决定
功能介绍 应用服务器在调用物联网平台的创建规则触发条件（Resource:device，Event:delete）、创建规则动作、修改规则触发条件接口配置并激活规则后，当物联网平台中的设备删除时，物联网平台会向应用服务器推送通知消息。 URI POST /由应用服务器创建设备删除通知规则的转发目标决定
是否必选 参数类型 描述 tag_key 是 String 参数说明：标签键，在同一资源下标签键唯一。绑定资源时，如果设置的键已存在，则将覆盖之前的标签值。如果设置的键值不存在，则新增标签。 tag_value 否 String 参数说明：标签值。 表5 DeviceCommandStatusUpdate
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
