检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
接口功能 设备第一次接入物联网平台时需要进行绑定操作，上层应用通过调用该接口传入设备序列号或者MAC地址以及设备信息来绑定到物联网平台。 在绑定前需要调用绑定配置接口设置物联网平台的IP与端口。 设备绑定是指设备第一次接入物联网平台的过程，需要开发者先在物联网平台注册直连设备，之后在设备
概述 订阅：是指应用服务器通过调用物联网平台的“订阅平台业务数据”和“订阅平台管理数据”接口，向平台获取发生变更的设备业务信息（如设备注册、设备数据上报、设备状态等）和管理信息（软固件升级状态和升级结果）。 推送：是指订阅成功后，物联网平台根据应用服务器订阅的数据类型，将对应的变
应用服务器如何获取物联网平台推送消息时使用的地址？ 应用服务器设置防火墙策略时，可向物联网平台支撑人员获取平台推送消息的地址。 父主题： 订阅推送（联通用户专用）
典型场景 第三方应用首次访问物联网平台的开放API时，需调用此接口完成接入认证；第三方应用在物联网平台的认证过期后，需调用此接口重新进行认证，才能继续访问物联网平台的开放API。 接口功能 支持第三方应用在首次访问物联网平台的开放API之前，完成在物联网平台的接入认证。 注意事项 鉴权
为能有效地对设备进行管理，设备的产品模型中定义了物联网平台可向设备下发的命令，应用服务器可以调用物联网平台开放的API接口向单个设备或批量设备下发命令，或者用户通过物联网平台直接向单个设备下发命令，以实现对设备的远程控制。 物联网平台有两种命令下发机制，如下表所示。 命令下发机制 定义
从设备的软件升级流程（本流程只描述物联网平台与设备基于PCP协议交互的流程，完整的软件升级流程请参考LWM2M协议软件升级流程）可以看到，首先物联网平台向设备下发查询版本号信息，设备进行应答。 物联网平台发送消息 根据PCP消息结构的定义可以得出，物联网平台向设备下发查询版本号时，各消息字段的填写如下：
CONNECT连接鉴权 接口说明 物联网平台设备侧支持MQTT协议的connect消息接口，接口规范参考MQTT标准规范，鉴权通过后建立设备与平台间的MQTT连接。 物联网平台目前只支持MQTTS接入，设备通过connect消息接口跟平台建立MQTT连接时，需要携带TLS证书。T
PCP协议介绍（联通用户专用） 平台升级协议（PCP协议）规定了设备和平台之间升级的通信内容与格式。 本协议规定设备和IoT平台（以下简称“平台”）之间的应用层升级协议（简称“PCP协议”），用于实现设备的升级。 通讯方式 PCP协议运行在应用层，底层可以是LWM2M/CoAP/MQTT或者其他非流式协议。
第三方应用通过“注册设备”接口在物联网平台注册设备后，在设备首次接入平台之前，设备的激活状态为false；当设备首次接入平台后，设备的激活状态为true（无论设备接入后是处于在线、离线或异常状态）。第三方应用可调用此接口查询设备在物联网平台的激活状态，确定设备是否已接入平台。 接口功能 支持第三
第三方应用在物联网平台订阅了设备命令响应通知后（订阅的通知类型为commandRsp），当平台向设备下发命令，并收到设备返回的命令响应消息（如命令执行成功或者执行失败，设备要向平台返回指定内容响应）时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备命令响应通知的第三方应用推送通知消息。
设备在接入物联网平台时携带该标识信息完成接入鉴权。 原生MQTT设备：通过注册成功后生成的“设备ID”（与设备标识码一一对应）和“密钥”接入平台。 NB-IoT设备、集成Agent Lite SDK的设备：设备通过注册时填写的“设备标识码”和“预置密钥”接入平台。 无真实设备时可随意填写英文字母和数字的组合字符串。
设备Profile文件中定义了物联网平台可向设备下发的命令，第三方应用可调用此接口向设备下发命令，配置或修改设备的服务属性，以实现对设备的控制。 物联网平台有两种命令下发机制： 立即下发：平台收到命令后立即下发给设备，保证实时性，不保证串行性。 缓存下发：平台收到命令后缓存起来，在设备可
第三方应用在物联网平台订阅了设备模型增加通知后（订阅的通知类型为deviceModelAdded），在物联网平台上新增设备Profile文件时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备模型增加通知的第三方应用推送通知消息。 注意事项 应用在订阅平台业务数据时
设备服务能力增加通知 接口说明 应用服务器在物联网平台订阅了设备服务能力增加通知后（订阅的通知类型为deviceCapabilitiesAdded），在物联网平台上新增设备Profile文件时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI
规则事件通知 接口说明 应用服务器在物联网平台订阅了规则事件通知后（订阅的通知类型为ruleEvent），当平台中配置的规则触发时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
目标版本可以比当前版本低吗？ 可以。物联网平台会判断目标版本和当前版本是否一致：如果一致，任务详情显示“The current version is the same as the target version”，物联网平台不会发起升级任务；如果不一致，物联网平台则会启动升级任务。 父主题： 软/固件升级（联通用户专用）
第三方应用在物联网平台订阅了设备影子状态变更通知后（订阅的通知类型为deviceDesiredPropertiesModifyStatusChanged），当平台中的设备影子向设备同步数据成功或失败时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备影子状态变更通知的第三方应用推送通知消息。
FG_IOCM_PORT。 设备绑定是指设备第一次接入物联网平台的过程，需要开发者先在物联网平台注册直连设备，之后在设备上发起绑定操作，将设备绑定到物联网平台上。如果未在物联网平台注册该设备，则绑定操作会失败，Agent Lite将会等待一段时间继续尝试。 接口描述 1 HW_INT
软件升级状态变更通知 典型场景 第三方应用在物联网平台订阅了软件升级状态变更通知后（订阅的通知类型为swUpgradeStateChangeNotify），当设备进行软件升级，升级任务的状态发生变化时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了软件升级状态变更通知的第三方应用推送通知消息。
软件升级状态变更通知 典型场景 第三方应用在物联网平台订阅了软件升级状态变更通知后（订阅的通知类型为swUpgradeStateChangeNotify），当设备进行软件升级，升级任务的状态发生变化时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了软件升级状态变更通知的第三方应用推送通知消息。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
