检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
删除OTA升级包 功能介绍 用户可调用此接口删除关联OBS对象的升级包信息，不会删除OBS上对象 使用前提：使用该API需要您授权设备接入服务(IoTDA)的实例访问对象存储服务(OBS)以及 密钥管理服务(KMS Administrator)的权限。在“统一身份认证服务（IAM）
应用服务器在调用物联网平台的创建规则触发条件（Resource:device.message，Event:report）、创建规则动作、修改规则触发条件接口配置并激活规则后，当设备上报消息数据时，物联网平台会向应用服务器推送通知消息。 URI POST /由应用服务器创建设备消息上报通知规则的转发目标决定
获取OTA升级包详情 功能介绍 用户可调用此接口查询关联OBS对象的升级包详情 使用前提：使用该API需要您授权设备接入服务(IoTDA)的实例访问对象存储服务(OBS)以及 密钥管理服务(KMS Administrator)的权限。在“统一身份认证服务（IAM） - 委托”中将
创建规则触发条件 功能介绍 应用服务器可调用此接口在物联网平台创建一条规则触发条件。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/routing-rule/rules 表1 路径参数 参数 是否必选 参数类型 描述 project_id
应用服务器在调用物联网平台的创建规则触发条件（Resource:device.property，Event:report）、创建规则动作、修改规则触发条件接口配置并激活规则后，当设备上报属性数据时，物联网平台会向应用服务器推送通知消息。 URI POST /由应用服务器创建设备属性上报通知规则的转发目标决定
功能介绍 应用服务器可调用此接口上传批量任务文件，用于创建批量任务。当前支持批量创建设备任务、批量删除设备任务、批量冻结设备任务、批量解冻设备任务的文件上传。 批量注册设备模板 批量删除设备模板 批量冻结设备模板 批量解冻设备模板 调用方法 请参见如何调用API。 URI POST /
管理设备组中的设备 功能介绍 应用服务器可调用此接口管理设备组中的设备。单个设备组内最多添加20,000个设备，一个设备最多可以被添加到10个设备组中。 调用方法 请参见如何调用API。 URI POST /v5/iot/{project_id}/device-group/{group_id}/action
查询设备策略列表 功能介绍 应用服务器可调用此接口在物联网平台查询策略列表。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/device-policies 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String
功能介绍 资源空间对应的是物联网平台原有的应用，在物联网平台的含义与应用一致，只是变更了名称。应用服务器可以调用此接口查询资源空间列表。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/apps 表1 路径参数 参数 是否必选 参数类型 描述
创建OTA升级包 功能介绍 用户可调用此接口创建升级包关联OBS对象 使用前提：使用该API需要您授权设备接入服务(IoTDA)的实例访问对象存储服务(OBS)以及 密钥管理服务(KMS Administrator)的权限。在“统一身份认证服务（IAM） - 委托”中将委托名称为
附录 状态码 获取项目ID 错误码 父主题： 应用侧API参考
应用服务器在调用物联网平台创建规则触发条件（Resource:batchtask，Event:update）、创建规则动作、修改规则触发条件接口配置并激活规则后，当批量任务状态变更时，物联网平台会向应用服务器推送通知消息。 URI POST /由应用服务器创建批量任务状态变更通知规则的转发目标决定
查询数据流转积压策略 功能介绍 应用服务器可调用此接口在物联网平台查询指定数据流转积压策略。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/routing-rule/backlog-policy/{policy_id} 表1 路径参数
查询设备组列表 功能介绍 应用服务器可调用此接口查询物联网平台中的设备组信息列表。 调用方法 请参见如何调用API。 URI GET /v5/iot/{project_id}/device-group 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String
应用服务器在调用物联网平台的创建规则触发条件（Resource:device.message.status，Event:update）、创建规则动作、修改规则触发条件接口配置并激活规则后，当设备消息状态变更时，物联网平台会向应用服务器推送通知消息。 URI POST /由应用服务器创建设备消息状态变更通知规则的转发目标决定
用服务器可调用此接口向指定设备下发命令，以实现对设备的同步控制。平台负责将命令以同步方式发送给设备，并将设备执行命令结果同步返回, 如果设备没有响应，平台会返回给应用服务器超时，平台超时时间是20秒。如果命令下发需要超过20秒，建议采用消息下发。 注意： 此接口适用于MQTT设备
应用服务器可调用此接口在物联网平台创建一个预调配模板。用户的设备未在平台注册时，可以通过预调配模板在设备首次接入物联网平台时将设备信息自动注册到物联网平台。 该预调配模板至少需要绑定到一个设备CA证书下才能生效。 一个实例最多可有10个预调配模板。 仅标准版实例、企业版实例支持该接口调用，基础版不支持。
第二十一次正式发布 新增 重置设备指纹接口。 2021-06-18 第二十次正式发布 修改 修改应用侧API接口参数的类型： 去除长度描述。 对象参数增加“Object”。 2021-05-28 第十九次正式发布 修改 修改应用侧API接口请求参数描述，增加参数说明和取值范围。 2021-02-08
应用示例 示例一：使用模板文件批量创建设备 示例二：给指定设备下发消息 示例三：在指定资源空间下创建设备 父主题： 应用侧API参考
是否必选 参数类型 描述 X-Auth-Token 否 String 参数说明：用户Token。通过调用IAM服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 Instance-Id
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
