检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 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 参数解释： 网关设备上报时，
MQTT 华为云X.509证书认证设备使用证书策略发放示例 获取设备发放终端节点 表1 设备发放节点列表 区域名称 区域 终端节点（Endpoint） 端口 协议 华北-北京四 cn-north-4 iot-bs.cn-north-4.myhuaweicloud.com 8883
创建OTA升级包 功能介绍 用户可调用此接口创建升级包关联OBS对象 使用前提：使用该API需要您授权设备接入服务(IoTDA)的实例访问对象存储服务(OBS)以及 密钥管理服务(KMS Administrator)的权限。在“统一身份认证服务（IAM） - 委托”中将委托名称为
批量任务 批量任务场景下，用户通过调用此目录接口实现任务文件管理功能。 - 当前支持批量创建设备任务、批量删除设备任务、批量冻结设备任务、批量解冻设备任务的文件管理。 - 当前单用户管理的文件数量最大为10，超过则无法上传新的文件。 - 当前文件最大存储时间为1小时，超过1小时文件会被平台自动老化。
删除OTA升级包 功能介绍 用户可调用此接口删除关联OBS对象的升级包信息，不会删除OBS上对象 使用前提：使用该API需要您授权设备接入服务(IoTDA)的实例访问对象存储服务(OBS)以及 密钥管理服务(KMS Administrator)的权限。在“统一身份认证服务（IAM）
设备上报获取文件上传URL请求 功能介绍 设备上报获取文件上传URL信息请求。 Topic 上行: $oc/devices/{device_id}/sys/events/up 参数说明 字段名 必选/可选 类型 参数描述 object_device_id 可选 String 参数解释：
第三方云设备迁移至华为云最佳实践 整体方案说明 Topic通信场景迁移实践 物模型通信场景迁移实践 父主题： 设备管理
自定义设备侧域名 概述 自定义域名允许设备指定要连接到 IoTDA 的自定义完全限定域名 (FQDN)。使用自定义域名，用户可以管理自己的服务器证书，例如用于签署证书的根证书颁发机构 (CA)、签名算法、以及证书的生命周期。 使用场景 自己管理服务器证书的根证书颁发机构 (CA)、签名算法、以及证书的生命周期等。
异常数据转发目标 概述 在数据被转发至华为云其他服务或第三方应用时，若由于云服务权限不足、 华为云其他服务或第三方应用不可用等原因导致目标服务器不可达，物联网平台会停止消息的推送，并每三分钟进行一次通道恢复探测，若探测成功，通道将恢复正常使用。如果用户消息实时性要求高，为降低通道
MQTT使用指导 概述 MQTT（Message Queuing Telemetry Transport）是一个基于客户端-服务器的消息发布/订阅传输协议，主要应用于计算能力有限，且工作在低带宽、不可靠的网络的远程传感器和控制设备，适合长连接的场景，如智能路灯等。更多关于MQTT协议语法及接口信息，请访问这里获取。
获取OTA升级包详情 功能介绍 用户可调用此接口查询关联OBS对象的升级包详情 使用前提：使用该API需要您授权设备接入服务(IoTDA)的实例访问对象存储服务(OBS)以及 密钥管理服务(KMS Administrator)的权限。在“统一身份认证服务（IAM） - 委托”中将
上传批量任务文件 功能介绍 应用服务器可调用此接口上传批量任务文件，用于创建批量任务。当前支持批量创建设备任务、批量删除设备任务、批量冻结设备任务、批量解冻设备任务的文件上传。 批量注册设备模板 批量删除设备模板 批量冻结设备模板 批量解冻设备模板 调用方法 请参见如何调用API。
删除批量任务文件 功能介绍 应用服务器可调用此接口删除批量任务文件。 调用方法 请参见如何调用API。 URI DELETE /v5/iot/{project_id}/batchtask-files/{file_id} 表1 路径参数 参数 是否必选 参数类型 描述 file_id
网关更新子设备状态 功能介绍 网关更新子设备状态，更新结果通过网关更新子设备状态响应接口通知网关设备。网关与子设备关系，请查看网关与子设备。 接口tps限制为直连设备并发建链的1.5倍。即为单个实例每秒最大建立请求连接数量为100*购买单元数量 *1.5。 该接口1次调用的tps为1*上报子设备的数量。
MQTT(S)协议接入 概述 MQTT消息由固定报头（Fixed header）、可变报头（Variable header）和有效载荷（Payload）三部分组成。 其中固定报头（Fixed header）和可变报头（Variable header）格式的填写请参考MQTT标准规
查询设备组设备列表 功能介绍 应用服务器可调用此接口查询指定设备组下的设备列表。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/device-group/{group_id}/devices 表1 路径参数 参数 是否必选 参数类型 描述
查询OTA升级包列表 功能介绍 用户可调用此接口查询关联OBS对象的升级包列表 使用前提：使用该API需要您授权设备接入服务(IoTDA)的实例访问对象存储服务(OBS)以及 密钥管理服务(KMS Administrator)的权限。在“统一身份认证服务（IAM） - 委托”中将
使用Postman调测 概述 Postman是网页调试与辅助接口调用的工具，具有界面简洁清晰、操作方便快捷的特性，可以处理用户发送的HTTP请求，例如：GET，PUT、POST，DELETE等，支持用户修改HTTP请求中的参数并返回响应数据。 为充分了解接口，建议提前获取应用侧A
查询批量任务文件列表 功能介绍 应用服务器可调用此接口查询批量任务文件列表。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/batchtask-files 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String
SDK介绍 业务流程 基于SDK实现泛协议设备接入的业务流程： 图1 业务流程图 SDK接口说明： 表1 表1 泛协议SDK提供监听平台下行数据的接口说明 接口 说明 BridgeCommandListener 平台命令下发监听接口。泛协议插件可以通过该接口将平台的下行命令转发给第三方协议设备。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
