检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
查询指定升级任务子任务详情 典型场景 在创建了设备软件升级任务或固件升级任务后，任务中涉及的每个设备的升级是一个子任务（即升级任务中涉及多少个设备，就有多少个子任务）。第三方应用可调用此接口查询某个升级任务中各个子任务的详细信息，以查看子任务的具体执行情况。 接口功能 支持第三方
使用MQTTS协议接入（联通用户专用） 非联通用户请查看设备接入服务。 MQTTS是安全的基于TLS的加密协议，采用MQTTS协议接入平台的设备，设备与物联网平台之间的通信过程，数据都是加密的，具有一定的安全性。 MQTT主要应用于计算能力有限，且工作在低带宽、不可靠的网络的远程
应用快速接入（联通用户专用） 非联通用户请查看设备接入服务。 为了降低应用侧的开发难度、提升应用侧开发效率，物联网平台向应用侧开放了丰富的Restful API。本文档以Postman为例，模拟应用服务器以HTTPS协议为例接入物联网平台。 前提条件 已经注册华为云官方帐号，可点击注册页面完成注册。
查询指定升级任务子任务详情 典型场景 在创建了设备软件升级任务或固件升级任务后，任务中涉及的每个设备的升级是一个子任务（即升级任务中涉及多少个设备，就有多少个子任务）。第三方应用可调用此接口查询某个升级任务中各个子任务的详细信息，以查看子任务的具体执行情况。 接口功能 支持第三方
命令下发（联通用户专用） 非联通用户请查看设备接入服务。 概述 为能有效地对设备进行管理，设备的产品模型中定义了物联网平台可向设备下发的命令，应用服务器可以调用物联网平台开放的API接口向单个设备或批量设备下发命令，或者用户通过物联网平台直接向单个设备下发命令，以实现对设备的远程控制。
刷新设备密钥 接口说明 已在物联网平台注册的设备，若设备的唯一标识码发生变更（如更换设备等场景），应用服务器需要调用此接口在物联网平台更新设备的唯一标识，并重新绑定设备。 注意事项 仅当设备处于离线状态时，才能进行刷新设备密钥操作。 URI 请求方法 PUT URI /iocm/app/reg/v1
创建数据转发规则 接口说明 应用服务器可调用此接口在物联网平台创建一条规则，当指定设备上报的数据满足条件时，触发规则。 调试 您可以在API Explorer中直接运行调试该接口。 URI 请求方法 POST URI /v5/iot/{project_id}/rules 传输协议
创建应用（联通用户专用） 非联通用户请查看设备接入服务。 应用可以理解为在物联网平台中为用户的业务划分一个项目空间，当用户在开发中心、线下环境里完成应用服务器侧的开发、物联网平台侧的开发以及设备侧的开发后，就需要在控制台上创建应用，将开发完的应用服务器与真实设备接入到这个项目空间中，实现设备的数据采集和设备管理。
命令下发（联通用户专用） 非联通用户请查看设备接入服务。 命令下发失败或设备收不到命令如何处理？ 设备变为异常或者离线后，命令下发会成功吗? 物联网平台下发命令有重发机制吗？ 物联网平台的命令状态总共有几种？ 设备收到命令需要多长时间? 平台能批量下发命令吗？
修改规则 接口说明 应用服务器可调用此接口修改物联网平台中指定规则的配置。 调试 您可以在API Explorer中直接运行调试该接口。 URI 请求方法 PUT URI /v5/iot/{project_id}/rules/{rule_id} 传输协议 HTTPS 请求参数 名称
设备数据变化通知 典型场景 第三方应用在物联网平台订阅了设备数据变化通知后（订阅的通知类型为deviceDataChanged），当设备上报单个服务属性数据时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备数据变化通知的第三方应用推送通知消息。 注意事项 1
刷新设备密钥 典型场景 已在物联网平台注册的设备，若设备的唯一标识码发生变更（如更换设备等场景），第三方应用需要调用此接口在物联网平台更新设备的唯一标识，并重新绑定设备。 仅当设备处于离线状态时，才能进行刷新设备密钥操作。 接口功能 支持第三方应用在物联网平台更新已注册设备的no
消息结构体说明 转发设备上报的属性 根据定义的产品模型，上报设备属性至平台。结构体描述如下： 表1 属性上报规则转发结构体 参数名称 类型 描述 device_id String 设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 services services[]
刷新设备密钥 典型场景 已在物联网平台注册的设备，若设备的唯一标识码发生变更（如更换设备等场景），第三方应用需要调用此接口在物联网平台更新设备的唯一标识，并重新绑定设备。 仅当设备处于离线状态时，才能进行刷新设备密钥操作。 接口功能 支持第三方应用在物联网平台更新已注册设备的no
查询规则 接口说明 应用服务器可调用此接口查询物联网平台中指定规则的配置信息。 调试 您可以在API Explorer中直接运行调试该接口。 URI 请求方法 GET URI /v5/iot/{project_id}/rules/{rule_id} 传输协议 HTTPS 请求参数
批量设备数据变化通知 典型场景 第三方应用在物联网平台订阅了设备数据批量变化通知后（订阅的通知类型为deviceDatasChanged），当设备同时上报多个服务属性数据时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备数据批量变化通知的第三方应用推送通知消息。
查询单个设备信息 典型场景 已在物联网平台注册的设备，第三方应用若需要查看某个设备的详细信息（如厂商、型号、版本、状态和服务属性等信息），可调用此接口在物联网平台查询获取。 接口功能 支持第三方应用在物联网平台根据设备ID查询指定设备的详细信息，包括配置信息、状态信息、服务属性信息等。
设备命令下发 接口说明 设备Profile文件中定义了物联网平台可向设备下发的命令，应用服务器可调用此接口向设备下发命令，配置或修改设备的服务属性，以实现对设备的控制。 物联网平台不对设备命令进行缓存而是直接下发命令，设备不在线时命令下发失败。下发命令的具体格式需要应用服务器与设
鉴权 典型场景 第三方应用首次访问物联网平台的开放API时，需调用此接口完成接入认证；第三方应用在物联网平台的认证过期后，需调用此接口重新进行认证，才能继续访问物联网平台的开放API。 接口功能 支持第三方应用在首次访问物联网平台的开放API之前，完成在物联网平台的接入认证。 注意事项
注册设备（验证码方式） 典型场景 在设备接入物联网平台前，第三方应用需要调用此接口在物联网平台注册设备，并把设备的唯一标识码（如IMEI）设置为设备接入平台的验证码。在设备接入物联网平台时携带设备唯一标识，完成设备的接入认证。 接口功能 支持第三方应用在物联网平台注册设备，完成注册后设备方可接入物联网平台。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
