检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
设备消息上报 功能描述 是指设备无法按照产品模型中定义的属性格式进行数据上报时，可调用此接口将设备的自定义数据格式上报给平台，平台对该消息不进行解析，该消息可以转发给应用服务器或华为云其他云服务上进行存储和处理。 消息上报和属性上报的区别，请查看消息通信说明。 低配置且资源受限或者对网络流量有要求的设备
平台消息下发 功能介绍 设备无法按照产品模型中定义的格式进行指令下发时，可使用此接口下发自定义格式的数据给设备。在此之上也可以使用平台封装的标准格式，即在应用侧API的下发设备消息中payload_format填写为“standard”，或者在设备详情页的云端下发-消息下发中下发时选择
安全隧道协议消息交互说明 当应用端与设备端建立安全隧道的WebSocket连接后，应用端与设备端将基于安全隧道协议进行消息通信，数据格式如下： 名称 类型 说明 operation_type String 参数说明: 数据类型。 取值范围： connect_tunnel：平台通知应用端设备已连接
什么是产品模型 产品模型用于描述设备具备的能力和特性。开发者通过定义产品模型，在物联网平台构建一款设备的抽象模型，使平台理解该款设备支持的服务、属性、命令等信息，如开关等。当定义完一款产品模型后，在进行注册设备时，就可以使用在控制台上定义的产品模型。 产品模型定义了服务能力： 服务能力
网桥接入信息，环境变量配置参考： 图1 环境变量配置参考 NET_BRIDGE_ID与NET_BRIDGE_SECRET在标准版和企业版支持在界面配置和获取，获取方式如下： 进入泛协议接入页面：登录管理控制台，单击左侧导航栏“IoTDA实例”，选择对应实例，点击右侧“详情”进入实例
通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 Instance-Id 否 String 参数说明：实例ID。
Instance-Id 否 String 参数说明：实例ID。物理多租下各实例的唯一标识，建议携带该参数，在使用专业版时必须携带该参数。您可以在IoTDA管理控制台界面，选择左侧导航栏“总览”页签查看当前实例的ID，具体获取方式请参考查看实例详情 。
平台命令下发 功能介绍 用于平台向设备下发设备控制命令。平台下发命令后，需要设备及时将命令的执行结果返回给平台，如果设备没回响应，平台会认为命令执行超时。命令下发和消息下发的区别，请查看消息通信说明。 低配置且资源受限或者对网络流量有要求的设备，不适合直接构造JSON数据与物联网平台通信时
设备消息上报 接口说明 用于设备将自定义数据上报给平台，平台将设备上报的消息转发给应用服务器或华为云其他云服务上进行存储和处理。 URI 请求方法 POST URI /v5/devices/{device_id}/sys/messages/up 传输协议 HTTPS 请求参数 名称
IoT Device SDK 使用指南（OpenHarmony） IoT Device SDK（OpenHarmony）提供设备接入华为云IoT物联网平台的OpenHarmony版本的SDK，提供设备和平台之间通讯能力，以及设备服务、OTA等高级服务，并且针对各种场景提供了丰富的demo
设备时间同步请求 功能描述 设备向平台发起时间同步请求。 Topic 上行: $oc/devices/{device_id}/sys/events/up 参数说明 字段名 必选/可选 类型 参数描述 object_device_id 可选 String 参数解释： 网关设备上报时，
产品删除通知 功能介绍 应用服务器在调用物联网平台的创建规则触发条件（Resource:product，Event:delete）、创建规则动作、修改规则触发条件接口配置并激活规则后，当物联网平台中的产品删除时，物联网平台会向应用服务器推送通知消息。 URI POST /由应用服务器创建产品删除通知规则的转发目标决定
版本更新说明 表1 安卓版本更新说明 版本号 变更类型 功能描述说明 1.0.0 第一次发布 提供基础的设备接入能力 父主题： 设备侧SDK
设备删除通知 功能介绍 应用服务器在调用物联网平台的创建规则触发条件（Resource:device，Event:delete）、创建规则动作、修改规则触发条件接口配置并激活规则后，当物联网平台中的设备删除时，物联网平台会向应用服务器推送通知消息。 URI POST /由应用服务器创建设备删除通知规则的转发目标决定
设备上报日志内容 Topic 上行: $oc/devices/{device_id}/sys/events/up 接口功能 日志收集开关开启时设备使用该接口向平台上报日志内容，最大不超过1MB。 参数说明 字段名 必选/可选 类型 参数描述 services 可选 List<ServiceEvent
Instance-Id 否 String 参数说明：实例ID。物理多租下各实例的唯一标识，建议携带该参数，在使用专业版时必须携带该参数。您可以在IoTDA管理控制台界面，选择左侧导航栏“总览”页签查看当前实例的ID，具体获取方式请参考查看实例详情 。
请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 参数说明：用户Token。通过调用IAM服务获取。 Instance-Id 否 String 参数说明：实例ID。
设备属性上报 接口说明 用于设备按产品模型中定义的格式将属性数据上报给平台。 URI 请求方法 POST URI /v5/devices/{device_id}/sys/properties/report 传输协议 HTTPS 请求参数 名称 必选 类型 位置 说明 access_token
设备属性上报 功能介绍 用于设备按产品模型中定义的格式将属性数据上报给平台。属性上报和消息上报的区别，请查看消息通信说明。 低配置且资源受限或者对网络流量有要求的设备，不适合直接构造JSON数据与物联网平台通信时，可将原始二进制数据透传到物联网平台。通过开发编解码插件实现二进制数据到平台定义
设备时间同步响应 功能描述 平台向设备发送时间同步响应，携带设备发送时间device_send_time。当平台收到时间server_recv_time 后，向设备发送时间server_send_time 。 例如，设备收到的设备侧时间为device_recv_time ，则设备计算自己的准确时间为
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
