检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
网关批量设备属性上报 功能介绍 用于批量设备上报属性数据给平台。网关设备可以用此接口同时上报多个子设备的属性数据。网关与子设备关系，请查看网关与子设备。 属性上报和消息上报的区别，请查看消息通信说明。 网关批量设备属性上报，单批次最多可上报100个子设备的属性数据。如果子设备数量超过100个，建议分不同批次进行上报。
转发两种类型。 订阅推送 订阅：是指应用服务器通过调用物联网平台的API接口，向平台获取发生变更的设备业务信息（如设备注册、设备数据上报、设备状态等）和管理信息（软固件升级状态和升级结果）。 推送：是指订阅成功后，物联网平台根据应用服务器订阅的数据类型，将对应的变更信息推送给指定的URL地址或AMQP消息队列。
参数说明：实例ID。物理多租下各实例的唯一标识，建议携带该参数，在使用专业版时必须携带该参数。您可以在IoTDA管理控制台界面，选择左侧导航栏“总览”页签查看当前实例的ID，具体获取方式请参考查看实例详情 。 响应参数 无 请求示例 删除设备隧道。 DELELE https://{endpoint}/v5/iot/
品。删除产品后，该产品下的产品模型、编解码插件等资源将被清空，请谨慎操作。 后续步骤 在产品列表中，单击对应的产品，进入产品详情页。您可以查看产品ID、产品名称、设备类型、数据格式、所属资源空间、协议类型等产品基本信息。 图1 产品-产品详情 您可以在产品详情页，开发产品模型、开
模组连接或者断开的状态主动传递给外部MCU。 AT+HMSUB 订阅自定义主题 AT+HMUNS 取消订阅自定义主题 AT+HMPKS 用于设置服务器或者客户端证书 父主题： 模组AT指令参考
说明 ak 您的华为云账号访问密钥ID（Access Key ID）。请在华为云控制台“我的凭证 > 访问密钥”页面上创建和查看您的 AK/SK。更多信息请查看访问密钥。 sk 您的华为云账号秘密访问密钥（Secret Access Key）。 projectId 项目ID。获取方法请参见
enableAutoReport(10000); 执行上述代码，查看日志上报属性。 在平台侧查看设备影子中属性alarm为1，修改alarm为0后，查看设备日志收到属性设置 图13 设备影子-查看alarm属性 图14 查看设备日志属性设置成功 在平台下发ringAlarm命令，查看设备日志看到ringAlarm命令被调用，并且成功上报响应。
平台基于客户业务安全考虑，只有将设备的基本信息（例如设备ID、鉴权信息）注册到平台后，设备才能使用成功注册后的设备ID和鉴权信息接入物联网平台。当用户注册的设备不断增多时，如何安全且高效地注册设备变得尤为关键。 一种方案是，使用批量注册模板或者循环调用平台应用侧注册设备的API，实现高效地批量注册设备。此方案能够
设备鉴权成功后，发起广播Topic订阅，广播Topic必须为“$oc/broadcast/”前缀，样例如下： $oc/broadcast/test 应用服务器下发广播消息，指定Topic名称和消息内容。 POST https://{Endpoint}/v5/iot/{project_id}/broadcast-messages
fx调测）。 等待一分钟左右后，前往Kafka控制台，选择“消息查询”，topic名称填写AOM中配置的topic，查询内容填写设备所在的资源空间ID，查看收到转发的设备总数指标中是否包含在线设备数的指标信息。 图4 查看kafka消息-AOM 父主题： 数据转发
enableAutoReport(10000); 执行上述代码，查看日志上报属性。 在平台侧查看设备影子中属性alarm为1，修改alarm为0后，查看设备日志收到属性设置 图13 设备影子-查看alarm属性 图14 查看设备日志属性设置成功 在平台下发ringAlarm命令，查看设备日志看到ringAlarm命令被调用，并且成功上报响应。
支持对设备进行分组或打标签，详细请参见群组与标签。 设备物模型定义 对设备进行物模型定义（Product Model），详细请参见产品模型。 设备影子 支持影子数据查询和影子设置，详细请参见设备影子。 OTA升级 支持对设备软固件进行升级，详细请参考OTA升级。 设备文件上传 支持设备上传文件到OBS，设
设备接入实例的标签信息。如果实例有标签，则会有该字段，否则该字段为空。 order_id String 参数说明：订单号，仅包年包月实例返回该参数。查看订单详情请参考查询订单详情。 operate_window OperateWindow object 实例维护时间窗，用户在变更实例规格时，可以指定在该时间窗内进行变更。
连接成功。 连接成功。 0x01 请求拒绝，协议版本错误。 服务器不支持客户端请求MQTT协议版本。 0x02 请求拒绝，无效的客户端标识符。 clientId不符合格式要求或者心跳时间间隔不满足平台要求。 0x03 请求拒绝，服务器不可用。 平台服务不可用。 0x04 请求拒绝，用户名或密码错误。
前保留30s，30s之后失效。 设备消息上报 API 说明 设备消息上报 用于设备将自定义数据上报给平台，平台将设备上报的消息转发给应用服务器或华为云其他云服务上进行存储和处理。 设备属性上报 API 说明 设备属性上报 用于设备按产品模型中定义的格式将属性数据上报给平台。 网关上报子设备属性
参数说明：实例ID。物理多租下各实例的唯一标识，建议携带该参数，在使用专业版时必须携带该参数。您可以在IoTDA管理控制台界面，选择左侧导航栏“总览”页签查看当前实例的ID，具体获取方式请参考查看实例详情 。 响应参数 无 请求示例 删除资源空间。 DELETE https://{endpoint}/v5/iot/
参数说明：实例ID。物理多租下各实例的唯一标识，建议携带该参数，在使用专业版时必须携带该参数。您可以在IoTDA管理控制台界面，选择左侧导航栏“总览”页签查看当前实例的ID，具体获取方式请参考查看实例详情 。 表3 请求Body参数 参数 是否必选 参数类型 描述 type 否 String 参数说明：接入凭证类型，默认为AMQP的接入凭证类型。
参数说明：实例ID。物理多租下各实例的唯一标识，建议携带该参数，在使用专业版时必须携带该参数。您可以在IoTDA管理控制台界面，选择左侧导航栏“总览”页签查看当前实例的ID，具体获取方式请参考查看实例详情 。 X-Auth-Token 否 String 参数说明：用户Token。通过调用IAM服务 获取IAM用户T
Topic通信场景迁移实践 本文以自建MQTT Broker的空调控制设备迁移到华为云IoT为例，介绍如何进行Topic通信场景的设备迁移。 业务场景说明 自建MQTT Broker基于MQTT协议的上行数据和下行指令的业务定义如下： 表1 业务场景 业务场景 通信Topic 报文Payload
} ] } 图22 请求示例 单击“Publish”，可以在物联网平台上查看设备是否成功上报数据。 图23 查看上报属性-batteryLevel 图24 查看上报属性-batteryLevel 父主题： 设备接入
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
