检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
设备时间同步请求 功能描述 设备向平台发起时间同步请求。 Topic 上行: $oc/devices/{device_id}/sys/events/up 参数说明 字段名 必选/可选 类型 参数描述 object_device_id 可选 String 参数解释： 网关设备上报时
设备的产品模型中定义了物联网平台可向设备下发的命令，应用服务器可调用此接口向指定设备下发命令，以实现对设备的同步控制。平台负责将命令以同步方式发送给设备，并将设备执行命令结果同步返回, 如果设备没有响应，平台会返回给应用服务器超时，平台超时时间是20秒。如果命令下发需要超过20秒，建议采用消息下发。
如何获取平台接入地址？ 请进入IoTDA的控制台界面，在左侧菜单栏单击“IoTDA实例”，选择您的实例并单击实例卡片进入。 图1 实例管理-切换实例 在左侧导航栏单击总览，单击“接入信息”，找到您的平台接入地址。 图2 总览-获取接入信息 父主题： 方案咨询
设备时间同步响应 功能描述 平台向设备发送时间同步响应，携带设备发送时间device_send_time。当平台收到时间server_recv_time 后，向设备发送时间server_send_time 。 例如，设备收到的设备侧时间为device_recv_time ，则设备计算自己的准确时间为：
设备时间同步 设备时间同步请求 设备时间同步响应 父主题： 设备侧MQTT/MQTTS接口参考
使用设备发放服务跨实例同步设备时，如果是指定资源空间和设备同步，同步数据仅包括设备连接新实例认证需要的身份信息，包括产品、证书和设备；不包括原实例中的设备分组、服务端订阅、规则引擎配置和平台日志等；支持同步设备的状态。 目前除了支持资源空间和设备的同步，还能指定插件的同步。 设备同步成功后，可以通
设备同步命令 下发设备命令 父主题： 设备命令
N文件，用于存储设备的在线状态、设备最近一次上报的设备属性值、应用服务器期望下发的配置。每个设备有且只有一个设备影子，设备可以获取和设置设备影子以此来同步设备属性值，这个同步可以是影子同步给设备，也可以是设备同步给影子。 设备影子上有desired区和reported区。 des
应用服务器可调用同步命令下发接口向指定设备下发命令，以实现对设备的同步控制。平台负责将命令以同步方式发送给设备，并将设备执行命令结果在HTTP请求中同步返回, 如果设备没有响应，平台会返回给应用服务器超时。 同步命令下发适合对命令实时性有要求的场景，比如路灯开关灯，燃气表开关阀。使用
用户可以通过该接口创建隧道（WebSocket协议），应用服务器和设备可以通过该隧道进行数据传输。 该API接口在基础版不支持。 该API调用后平台会向对应的MQTT/MQTTS设备下发隧道地址及密钥，同时给应用服务器也返回隧道地址及密钥，设备可以通过该地址及密钥创建WebSocket协议连接。 一个设备无法创建多个隧道。
通过华为认证模组接入 概述 认证模组是指通过预集成IoT Device SDK Tiny，并且通过华为测试认证，遵循华为指定AT命令规范的模组。使用华为认证的模组可以带来以下好处： 设备厂商在MCU上无需关心如何连接到华为云IoT（例如，MQTT建链时密钥的加密算法，client
设备发放业务流程 设备启动后，通过Bootstrap流程（设备出厂时预置设备发放平台地址作为引导服务器地址），引导物联网设备在初次上电时获得正确的目标物联网平台地址，继而完成设备与平台的建链过程。保证设备安全可靠的按业务目标上线，最大程度上减少人为干预的错误可能。 流程如下： 首
查询设备属性 功能介绍 设备的产品模型中定义了物联网平台可向设备下发的属性，应用服务器可调用此接口向设备发送指令用以查询设备的实时属性, 并由设备将属性查询的结果同步返回给应用服务器。 注意：此接口适用于MQTT设备，暂不支持NB-IoT设备。 调用方法 请参见如何调用API。 URI
修改设备属性 功能介绍 设备的产品模型中定义了物联网平台可向设备下发的属性，应用服务器可调用此接口向指定设备下发属性。平台负责将属性以同步方式发送给设备，并将设备执行属性结果同步返回。 注意：此接口适用于MQTT设备，暂不支持NB-IoT设备。 调用方法 请参见如何调用API。 URI
设备影子是一个JSON文件，用于存储设备的在线状态、设备最近一次上报的设备属性、应用服务器期望下发的配置（期望值）。每个设备有且只有一个设备影子，设备可以获取和设置设备影子以此来同步状态，这个同步可以是影子同步给设备，也可以是设备同步给影子。 数据流转 名词 描述 规则引擎 物联网平台根据用户设置的
网关同步子设备列表 功能介绍 网关设备从平台同步子设备列表。网关设备不在线时，平台无法将子设备新增和删除的信息及时通知到网关设备。网关设备离线再上线时，可以通过此接口从平台同步这段时间内新增或者删除的子设备信息。新增的子设备信息会通过平台通知网关子设备新增接口通知网关设备，删除的
好DNS解析，确保DNS解析后的IP地址可达。这种情况下，推荐使用IP地址作为回调地址。 应用服务器只有内网地址，能否订阅成功？ 企业版支持使用内网地址进行订阅。应用服务器需与购买IoTDA企业版时选择的VPC一致。 非企业版不支持使用内网地址进行订阅。在使用公司或校园的内网网络
图1 总览-获取接入信息 针对不支持用域名接入的设备，通过在cmd命令框中执行“ping 域名”获取IP地址，用IP地址接入平台。由于IP地址不固定，您需要将IP地址做成可配置项。 创建产品 创建MQTT协议产品。如果已有MQTT协议产品，可跳过此步骤。 登录管理控制台，单击
status，Event:update）、创建规则动作并激活规则后，当命令状态变更时，物联网平台会根据规则将结果发送到规则指定的服务器，如用户自定义的HTTP服务器，AMQP服务器，以及华为云的其他存储服务器等, 详情参考设备命令状态变更通知。 注意： 此接口适用于NB设备异步命令下发，暂不支持其他协议类型设备命令下发。
选定资源空间，根据步骤4、5配置电信AEP平台对接信息，接入地址信息可参考中国电信AEP平台的帮助文档，MQ对接地址为msgpush.ctwing.cn:16651，HTTP接入地址为ag-api.ctwing.cn。配置完成后即可在华为物联网平台上管理您的资源，也会同步更新到电信AEP平台。 图4 实例管理-第三方AEP平台对接引导
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
