检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
设备鉴权 设备鉴权 父主题： 设备侧HTTPS接口参考
更新CA证书 功能介绍 应用服务器可调用此接口在物联网平台上更新CA证书。仅标准版实例、企业版实例支持该接口调用，基础版不支持。 调用方法 请参见如何调用API。 URI PUT /v5/iot/{project_id}/certificates/{certificate_id}
查询网桥列表 功能介绍 应用服务器可调用此接口在物联网平台查询网桥列表。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/bridges 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数说明：项目ID。获取方法请参见
修改设备代理 功能介绍 应用服务器可调用此接口修改物联网平台中指定设备代理的基本信息。 调用方法 请参见如何调用API。 URI PUT /v5/iot/{project_id}/device-proxies/{proxy_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id
软固件升级 平台下发获取版本信息通知 设备上报软固件版本 平台下发升级通知 设备上报升级状态 父主题： 设备侧MQTT/MQTTS接口参考
设备时间同步 设备时间同步请求 设备时间同步响应 父主题： 设备侧MQTT/MQTTS接口参考
设备消息上报 设备消息上报 父主题： 设备侧HTTPS接口参考
设备属性上报 设备属性上报 网关上报子设备属性 父主题： 设备侧HTTPS接口参考
取值范围：长度不超过36，十六进制字符串和连接符（-）的组合。 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 参数说明：用户Token。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Sub
批量任务 批量任务场景下，用户通过调用此目录接口实现任务文件管理功能。 - 当前支持批量创建设备任务、批量删除设备任务、批量冻结设备任务、批量解冻设备任务的文件管理。 - 当前单用户管理的文件数量最大为10，超过则无法上传新的文件。 - 当前文件最大存储时间为1小时，超过1小时文件会被平台自动老化。
参数说明：数据比较的操作符。 取值范围：当前支持的操作符有：>，<，>=，<=，=，in:表示在指定值中匹配和between:表示数值区间。 value 否 String 参数说明：数据比较表达式的右值。与数据比较操作符between联用时，右值表示最小值和最大值，用逗号隔开，如“20,30”表示大于等于20小于30。
Topic定义 设备使用MQTT协议接入平台时，平台和设备通过Topic进行通信。平台预置的topic列表如下： Topic分类 Topic Publisher(发布者) Subscriber(订阅者) 用途 设备消息相关Topic $oc/devices/{device_id}/sys/messages/up
更新资源空间 功能介绍 应用服务器可以调用此接口更新资源空间的名称 调用方法 请参见如何调用API。 URI PUT /v5/iot/{project_id}/apps/{app_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数说明：项目ID
Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。 调用获取IAM用户Token（使用密码）接口获取Token，调用样例如下： POST https://iam.cn-north-4
删除预调配模板 功能介绍 应用服务器可调用此接口在物联网平台上删除指定预调配模板。 调用方法 请参见如何调用API。 URI DELETE /v5/iot/{project_id}/provisioning-templates/{template_id} 表1 路径参数 参数 是否必选
获取OTA升级包详情 功能介绍 用户可调用此接口查询关联OBS对象的升级包详情 使用前提：使用该API需要您授权设备接入服务(IoTDA)的实例访问对象存储服务(OBS)以及 密钥管理服务(KMS Administrator)的权限。在“统一身份认证服务（IAM） - 委托”中将
ion中接口的请求结构体已经完成可以直接使用。 本文档以Postman为例，模拟应用服务器以HTTPS协议接入物联网平台，调测以下API接口： “获取IAM用户Token”接口 “查询IAM用户可以访问的项目列表”接口 “创建产品”接口 “查询产品”接口 “创建设备”接口 “查询设备”接口
参数说明：异常信息错误码，包含IOTDA.014016和IOTDA.014112。IOTDA.014016表示设备不在线；IOTDA.014112表示设备没有订阅topic。 error_msg 否 String 参数说明：异常信息说明，包含设备不在线和设备没有订阅topic说明。 响应参数 无
创建批量任务 功能介绍 应用服务器可调用此接口为创建批量处理任务，对多个设备进行批量操作。当前支持批量软固件升级、批量创建设备、批量修改设备、批量删除设备、批量冻结设备、批量解冻设备、批量创建命令、批量创建消息任务。 调用方法 请参见如何调用API。 URI POST /v5/iot/
取值范围：长度不超过36，十六进制字符串和连接符（-）的组合。 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 参数说明：用户Token。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Sub
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
