检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
写属性处理：实现了alarm属性的写操作，其他属性不支持写操作。 读属性处理：将本地属性值按照接口格式进行拼装。
可创建批量处理任务，对多个设备进行批量操作 对多个设备进行批量下发设备控制命令。 批量MQTT设备同步命令下发 单个MQTT设备同步命令下发 属性设置和属性查询分别参考查询设备属性和修改设备属性接口。
概述 概述 当设备和物联网平台完成对接后，设备可通过以下方式发送数据到物联网平台： 表1 数据上报 类型 子类型 描述 适用场景 协议 物模型 大小 消息上报 设备消息上报 是设备直接将数据传到云端的一种方式，实现设备侧到应用侧的数据直接透传，平台对设备上报的消息不进行解析和存储。
取值范围：长度不超过36，十六进制字符串和连接符（-）的组合 表2 Query参数 参数 是否必选 参数类型 描述 action_id 是 String 参数说明：操作类型，支持添加设备和删除设备。 取值范围： addDevice: 添加设备。添加已注册的设备到指定的设备组中。
图2 运行日志-前往新版 首次使用，需要单击“启动并配置”按钮，此时您可以选择两种方式进行运行日志的配置 一键配置： 采用一键配置后，平台将会自动创建日志组及日志流，并配置结构化，同时创建对应的转发规则及动作，无需用户手动操作。
由于设备可能长时间处于离线状态，修改设备属性值的操作不能及时下发给设备。在这种情况下，物联网平台可以将修改设备的属性信息存储在设备影子中，待设备上线后，将修改的设备属性值同步给设备，从而完成设备属性值的修改。
operator 是 String 参数说明：数据比较的操作符。 取值范围：当前支持的操作符有：>，<，>=，<=，=，in:表示在指定值中匹配和between:表示数值区间。 value 否 String 参数说明：数据比较表达式的右值。
新增 删除批量任务 创建设备隧道 查询设备所有隧道 查询设备隧道 关闭设备隧道 删除设备隧道 2023-06-17 第二十九次正式发布 新增 重试批量任务 停止批量任务 修改 设备同步命令、修改设备属性接口，增加响应参数error_code、error_msg，用以支持返回同步操作时设备的异常行为
、dollar符号($)、空char(十六进制的ASCII码为00),key为以上特殊字符无法正常刷新设备影子 event_time String 事件操作时间，格式：yyyyMMdd'T'HHmmss'Z'，如20151212T121212Z。
= topic) { msgType = topicParse(topic); } //将payload通过0xFF进行与操作，获取其对应的补码 var uint8Array = new Uint8Array(payload.length);
表2 Query参数 参数 是否必选 参数类型 描述 action_id 是 String 参数说明：对设备执行的操作。 取值范围： resetSecret: 重置密钥。注意：NB设备密钥由于协议特殊性，只支持十六进制密钥接入。
where 否 String 参数说明：用户自定义sql where语句，最大长度2500，更新操作时，select跟where必须同时传参，如果需要清除该参数的值，输入空字符串，该参数仅供标准版和企业版用户使用。
使用限制 设备发放服务具有以下使用限制。 表1 设备发放服务使用限制列表 对象 类别/描述 限制 设备 集成Agent Lite的设备（MQTT） 不支持 原生MQTT协议设备 支持，设备需要开发设备引导接口，具备设备发放能力。 集成LiteOS的设备（LwM2M） 支持 证书 数字证书保证系统内各服务及系统与外部通信的安全性
设备消息上报 功能描述 是指设备无法按照产品模型中定义的属性格式进行数据上报时，可调用此接口将设备的自定义数据格式上报给平台，平台对该消息不进行解析，该消息可以转发给应用服务器或华为云其他云服务上进行存储和处理。 消息上报和属性上报的区别，请查看消息通信说明。 低配置且资源受限或者对网络流量有要求的设备
Topic定义 设备使用MQTT协议接入平台时，平台和设备通过Topic进行通信。平台预置的topic列表如下： Topic分类 Topic Publisher(发布者) Subscriber(订阅者) 用途 设备消息相关Topic $oc/devices/{device_id}/
平台下发日志收集通知 Topic 下行: $oc/devices/{device_id}/sys/events/down 接口功能 用于平台下发日志收集通知给设备。 参数说明 字段名 必选/可选 类型 参数描述 services 可选 List<EventService> 参数解释
设备上报日志内容 Topic 上行: $oc/devices/{device_id}/sys/events/up 接口功能 日志收集开关开启时设备使用该接口向平台上报日志内容，最大不超过1MB。 参数说明 字段名 必选/可选 类型 参数描述 services 可选 List<ServiceEvent
最小长度：1 最大长度：36 表2 Query参数 参数 是否必选 参数类型 描述 action_id 是 String 对证书执行的操作，当前仅支持verify:校验证书 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String
设备上报软固件版本 功能介绍 设备上报软固件版本信息。 Topic 上行: $oc/devices/{device_id}/sys/events/up 参数说明 字段名 必选/可选 类型 参数描述 object_device_id 可选 String 参数解释： 网关设备上报时，子设备进行上报需填写该参数
设备上报获取文件上传URL请求 功能介绍 设备上报获取文件上传URL信息请求。 Topic 上行: $oc/devices/{device_id}/sys/events/up 参数说明 字段名 必选/可选 类型 参数描述 object_device_id 可选 String 参数解释
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
