检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
app_key 必选 String Header 已鉴权应用的appId Authorization 必选 String Header 请求的认证信息，值为“Bearer ******”，其中******为Auth鉴权接口返回的accessToken deviceId 必选 String
第三方应用可向物联网平台订阅设备相关的管理数据，当物联网平台中设备进行版本升级等相关操作时，平台会向第三方应用发送通知消息，知会其具体的操作状态或操作结果信息。第三方应用可以调用此接口向物联网平台订阅不同类型的设备升级操作通知。 接口功能 支持第三方应用向物联网平台订阅设备的升级操作信
网关时，网关需要调用设备服务数据上报接口将数据上报到物联网平台。 上报设备数据接口的deviceId，requstId和serviceId由SDK组装为消息的header；serviceProperties由SDK组装为消息的body。消息组装格式为JSON。 接口描述 1 public
推送通知 应用服务器向物联网平台订阅设备信息，当设备信息发生变更时，物联网平台向应用服务器推送此消息，应用服务器根据通知类型对消息分派处理。需要配合订阅管理接口使用。 注册设备通知 绑定设备通知 设备信息变化通知 设备数据变化通知 设备数据批量变化通知 设备服务能力变化通知 设备服务能力增加通知
对应关系？ 在物联网平台中，设备注册时，需要填写设备标识码（即nodeId）。设备标识码唯一标识物理设备，通常使用IMEI和MAC地址。 NB-IoT设备：在设备接入物联网平台时携带设备标识码（nodeId），完成设备的接入鉴权。 集成Agent Lite SDK的设备：当设备上
上一次分页查询结果中最后一条记录的ID，在上一次分页查询时由物联网平台返回获得。分页查询时物联网平台是按marker也就是记录ID降序查询的，越新的数据记录ID也会越大。若填写marker，则本次只查询记录ID小于marker的数据记录。若不填写，则从记录ID最大也就是最新的一条数据开始查询。
header 访问物联网平台的应用ID，在物联网平台创建应用时由平台分配获得。 Authorization 必选 String header 访问物联网平台的认证信息，值为“Bearer {accessToken}”，其中{accessToken}为调用鉴权接口返回的accessToken。
以业务应用订阅设备数据变化通知为例，订阅和推送的流程如下： 应用服务器通过调用物联网平台的订阅接口订阅设备数据变化通知（携带回调地址和通知类型），物联网平台将业务应用的回调地址和订阅的通知类型存储到订阅列表中以便向业务应用推送设备数据变化消息。 设备上报数据给物联网平台。 物联网平台根据订阅时设置的回调地址，将设备数据主动推送给业务应用。
设备Profile文件中定义了物联网平台可向设备下发的命令，第三方应用可调用此接口向设备下发命令，配置或修改设备的服务属性，以实现对设备的控制。 物联网平台不对设备命令进行缓存而是直接下发命令，设备不在线时命令下发失败。下发命令的具体格式需要第三方应用与设备自定义，物联网平台在接口中直接进行封装，透传。
产品ID，用于唯一标识一个产品，在物联网平台创建产品后由平台分配获得。 topic String mqtt设备消息上报时的订阅主题topic data String 消息上报的具体内容，平台会将设备消息上报的结构体当成字符串放在data的value域。 消息上报转发结构体示例： {
订阅ID，用于唯一标识一个订阅，在创建订阅时由物联网平台分配获得。 subject Subject Object 订阅的主题信息，即订阅的资源变化事件。 callbackurl String 订阅的回调地址，用于接收对应资源事件的通知消息。 channel String 物联网平台推送通知消息时使用的协议通道。使
典型场景 第三方应用首次访问物联网平台的开放API时，需调用此接口完成接入认证；第三方应用在物联网平台的认证过期后，需调用此接口重新进行认证，才能继续访问物联网平台的开放API。 接口功能 支持第三方应用在首次访问物联网平台的开放API之前，完成在物联网平台的接入认证。 注意事项 鉴
若子设备不再需要接入物联网平台，应用服务器可调用此接口解绑网关下的子设备。 此功能通过设备命令下发接口向网关下发命令实现，具体删除子设备命令需网关提前实现（即网关收到什么命令会触发删除子设备的流程），并已在设备的Profile文件中定义。当网关收到平台下发的删除子设备命令时，则启动内部业务流程，删除子设备。
目标版本可以比当前版本低吗？ 可以。物联网平台会判断目标版本和当前版本是否一致：如果一致，任务详情显示“The current version is the same as the target version”，物联网平台不会发起升级任务；如果不一致，物联网平台则会启动升级任务。 父主题：
appId 必选 String(256) body 访问物联网平台的应用ID，在物联网平台创建应用时由平台分配获得。 secret 必选 String(256) body 访问物联网平台的应用密钥，与appId对应，在物联网平台创建应用时由平台分配获得。 refreshToken
设备绑定 接口功能 设备第一次接入物联网平台时需要进行绑定操作，上层应用通过调用该接口传入设备序列号或者MAC地址以及设备信息来绑定到物联网平台。 在绑定前需要调用绑定配置接口设置物联网平台的IP与端口，对应参数配置为EN_IOTA_CFG_IOCM_ADDR和EN_IOTA_CFG_IOCM_PORT。
华为是否提供模组/硬件终端/应用软件等？ 华为不提供模组，终端及应用软件，华为提供了芯片供模组厂商集成，同时提供了物联网平台及终端接入物联网平台方案供设备厂商集成。 当前有多家合作伙伴已经和华为物联网平台完成集成认证。 父主题： 方案咨询（联通用户专用）
header 访问物联网平台的应用ID，在物联网平台创建应用时由平台分配获得。 Authorization 必选 String header 访问物联网平台的认证信息，值为“Bearer {accessToken}”，其中{accessToken}为调用鉴权接口返回的accessToken。
回调地址可以修改吗？ 可以。如果回调地址的IP和端口号需要更换，需要调用“批量删除订阅”接口，删除之前的回调地址后，并上传新的CA证书，再重新订阅。 父主题： 订阅推送（联通用户专用）
查询指定版本包 典型场景 在进行设备版本升级前，第三方应用可调用此接口在物联网平台查询某个版本升级包的信息，确保设备要升级的版本包已上传到平台。 接口功能 支持第三方应用在物联网平台根据版本包ID查询指定版本包信息，在调用该接口前需要通过“查询版本包列表”接口查询获得版本包ID。 接口描述
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
