检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
使用前必读 非联通用户请查看设备接入服务。 概述 物联网平台把自身丰富的管理能力通过API的形式对外开放，包括设备管理、数据采集、命令下发、设备升级等，帮助用户快速构筑基于物联网平台的行业应用。您可以根据本文档提供的API来使用物联网平台的服务，平台支持的全部API请参见API列表。 调用说明
计费详情（联通用户专用） 非联通用户请查看设备接入服务。 计费变更 设备管理服务和设备接入服务已经整合为全新升级的设备接入服务（IoT Device Access），设备管理服务不另外收费。 原设备管理服务已开通使用的用户（必须同时使用设备接入服务），业务使用不受影响， 自202
鉴权 典型场景 第三方应用首次访问物联网平台的开放API时，需调用此接口完成接入认证；第三方应用在物联网平台的认证过期后，需调用此接口重新进行认证，才能继续访问物联网平台的开放API。 接口功能 支持第三方应用在首次访问物联网平台的开放API之前，完成在物联网平台的接入认证。 注意事项
性。 远程诊断 支持用户对接入的设备进行远程维护操作，快速定位问题及恢复业务，减少近端维护引入的高成本。当前支持的远程维护操作包括设备的运行日志收集、重启模组。 固件升级 用户可以通过OTA的方式对支持LWM2M协议的设备进行固件升级，升级协议为LWM2M协议。 软件升级 用户可
什么是Profile（联通用户专用） 非联通用户请查看设备接入服务。 Profile（即产品模型）是用来描述一款产品中的设备“是什么”、“能做什么”以及“如何控制该设备”的文件。在物联网平台集成对接中需要先创建Profile，因为Profile里面定义了设备上报的数据和应用服务器
第三方应用可调用此接口在物联网平台上创建设备组，并把设备归类到不同的设备组内，进行分组管理。一个设备可以归属到多个设备组内。 在对设备进行某些操作时（如升级设备软固件、批量下发命令等），可通过设备组来指定要进行操作的设备。 接口功能 支持第三方应用在物联网平台创建设备组，用于对设备进行分组管理。
第三方应用可调用此接口在物联网平台上创建设备组，并把设备归类到不同的设备组内，进行分组管理。一个设备可以归属到多个设备组内。 在对设备进行某些操作时（如升级设备软固件、批量下发命令等），可通过设备组来指定要进行操作的设备。 接口功能 支持第三方应用在物联网平台创建设备组，用于对设备进行分组管理。
swUpgradeStateChangeNotify（软件升级状态变更通知） swUpgradeResultNotify（软件升级结果通知） fwUpgradeStateChangeNotify（固件升级状态变更通知） fwUpgradeResultNotify（固件升级结果通知） pageNo 可选 Integer
设备进行软件版本升级。 创建固件升级任务 为设备创建固件升级任务，当前仅支持对NB-IoT设备进行固件版本升级。 查询指定升级任务结果 查询某个升级任务的详细信息。 查询指定升级任务子任务详情 查询某个升级任务的各个子任务详细信息。 查询升级任务列表 根据指定条件查询物联网平台中的升级任务列表信息。
下一步”，系统自动创建固件升级任务。 请确保上传的升级包用于该设备的固件升级，且文件为zip格式压缩包。 操作真实设备上报一条属性数据，触发升级任务，待升级任务执行完成后，查看升级结果。 升级成功，单击“下一步”验证设备升级后是否正常工作。 升级失败，排查并处理问题后，单击“重新测试”重测固件升级。
upgradeCapability 可选 设备软件升级能力。 supportUpgrade 可选 true：设备支持软件升级。 false：设备不支持软件升级。 upgradeProtocolType 可选 升级使用的协议类型，此处不同于设备的protocolType，例如CoAP设备软件升级协议使用PCP。 fwUpgradeCapability
删除设备通知 设备消息确认通知 设备命令响应通知 命令状态变化通知 规则事件通知 设备影子状态变更通知 软件升级状态变更通知 软件升级结果通知 固件升级状态变更通知 固件升级结果通知 父主题： 订阅管理-V3
批量任务ID。调用创建批量任务接口时返回的任务ID。 task_type 必选 String 任务类型。 firmwareUpgrade：固件升级 softwareUpgrade：软件升级 status 必选 String 任务状态 Waitting 任务正在被等待执行 Processing 任务正在执行
设备消息确认通知 设备命令响应通知 设备事件通知 增加设备模型通知 删除设备模型通知 设备影子状态变更通知 软件升级状态变更通知 软件升级结果变更通知 固件升级状态变更通知 固件升级结果变更通知 NB设备命令状态变化通知 父主题： 应用侧Python SDK API参考（联通用户专用）
设备绑定 接口功能 设备第一次接入物联网平台时需要进行绑定操作，上层应用通过调用该接口传入设备序列号或者MAC地址以及设备信息来绑定到物联网平台。 在绑定前需要调用绑定配置接口设置物联网平台的IP与端口。 设备绑定是指设备第一次接入物联网平台的过程，需要开发者先在物联网平台注册直
添加设备 接口功能 当有新设备接入网关后，通过调用设备添加接口将非直连设备接入物联网平台，并且获得平台分配的唯一设备逻辑ID。 接口描述 1 HW_INT IOTA_HubDeviceAdd(HW_UINT uiCookie, const ST_IOTA_DEVICE_INFO *pstDeviceInfo);
使用Modbus协议接入（联通用户专用） 使用Agent SDK接入 使用模组接入 软固件升级调测 应用管理 订阅推送 授权访问 设备管理 设备注册鉴权 数据上报 命令下发 设备配置更新 设备影子 规则引擎 群组与标签 设备监控 远程诊断 固件升级 软件升级 网关与子设备
应用服务器只有内网地址，能否订阅成功？ 不能。物联网平台向应用服务器推动订阅信息时，必须是可访问的公网地址。 在使用公司或校园的内网网络时，需要进行NAT穿透。您可使用NAT穿透软件将内网地址转换为公网地址。 父主题： 订阅推送（联通用户专用）
添加设备 接口功能 当有新设备接入网关后，通过调用设备添加接口将非直连设备接入物联网平台，并且获得平台分配的唯一设备逻辑ID。 接口描述 1 public static boolean addDevice(int cookie, IotaDeviceInfo deviceInfo);
使用Modbus协议接入（联通用户专用） 非联通用户请查看设备接入服务。 概述 Modbus协议目前已经成为工业领域通信协议的业界标准，是工业电子设备之间最常用的连接方式。使用Modbus协议的方式包括直连和非直连两种方式，组网方案如下图所示。 接入方式 方案说明 适用场景 直连接入 Mod
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
