检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
设备命令响应通知 典型场景 第三方应用在物联网平台订阅了设备命令响应通知后（订阅的通知类型为commandRsp），当平台向设备下发命令，并收到设备返回的命令响应消息（如命令执行成功或者执行失败，设备要向平台返回指定内容响应）时，平台会向第三方应用推送通知消息。 接口功能 支持物
查询单个设备信息 典型场景 已在物联网平台注册的设备，第三方应用若需要查看某个设备的详细信息（如厂商、型号、版本、状态和服务属性等信息），可调用此接口在物联网平台查询获取。 接口功能 支持第三方应用在物联网平台根据设备ID查询指定设备的详细信息，包括配置信息、状态信息、服务属性信息等。
刷新token 典型场景 第三方应用通过鉴权接口获取到的accessToken是有有效时间的，在accessToken快过期时，第三方应用通过调用此接口，获取新的accessToken。 接口功能 支持第三方应用在accessToken到期前，从物联网平台获取新的accessToken。
订阅平台业务数据 典型场景 第三方应用可在物联网平台订阅设备相关的业务数据，当物联网平台中设备的业务信息发生变化时（如设备注册、设备数据上报、设备状态变更等），平台会向第三方应用发送通知消息，通知其具体的变化信息。第三方应用可以调用此接口向物联网平台订阅不同类型的设备业务变更通知。
订阅平台管理数据 典型场景 第三方应用可向物联网平台订阅设备相关的管理数据，当物联网平台中设备进行版本升级等相关操作时，平台会向第三方应用发送通知消息，知会其具体的操作状态或操作结果信息。第三方应用可以调用此接口向物联网平台订阅不同类型的设备升级操作通知。 接口功能 支持第三方应
设备数据变化通知 典型场景 第三方应用在物联网平台订阅了设备数据变化通知后（订阅的通知类型为deviceDataChanged），当设备上报单个服务属性数据时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备数据变化通知的第三方应用推送通知消息。 注意事项 1
设备事件通知 典型场景 第三方应用在物联网平台订阅了设备事件通知后（订阅的通知类型为deviceEvent），当平台收到设备上报的事件消息时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备事件通知的第三方应用推送通知消息。 注意事项 1. 应用在订阅平台业
创建设备命令 典型场景 设备Profile文件中定义了物联网平台可向设备下发的命令，第三方应用可调用此接口向设备下发命令，配置或修改设备的服务属性，以实现对设备的控制。 物联网平台有两种命令下发机制： 立即下发：平台收到命令后立即下发给设备，保证实时性，不保证串行性。 缓存下发：
查询指定版本包 典型场景 在进行设备版本升级前，第三方应用可调用此接口在物联网平台查询某个版本升级包的信息，确保设备要升级的版本包已上传到平台。 接口功能 支持第三方应用在物联网平台根据版本包ID查询指定版本包信息，在调用该接口前需要通过“查询版本包列表”接口查询获得版本包ID。
鉴权 典型场景 第三方应用首次访问物联网平台的开放API时，需调用此接口完成接入认证；第三方应用在物联网平台的认证过期后，需调用此接口重新进行认证，才能继续访问物联网平台的开放API。 接口功能 支持第三方应用在首次访问物联网平台的开放API之前，完成在物联网平台的接入认证。 注意事项
批量查询订阅 典型场景 第三方应用可在物联网平台上创建多个订阅，以订阅不同类型的设备变更通知。第三方应用若需要查看本应用下所有订阅配置，或者查看某种订阅类型下的所有订阅配置，可调用此接口进行查询。 接口功能 支持第三方应用在物联网平台查询本应用下的所有订阅信息，或者某种订阅类型下的所有订阅信息。
定时刷新token 典型场景 第三方应用通过调用此接口，定期刷新accessToken，刷新周期为鉴权方法返回值中的expiresIn，以保证accessToken不过期。accessToken由SDK管理，调用其他业务接口，accessToken可以直接传入null。 接口功能
查询指定批量任务信息 典型场景 第三方应用通过“创建批量任务”接口创建了设备的批量操作任务后，可调用此接口查询该批量任务的信息，包括任务的当前状态、子任务完成情况等。 接口功能 支持第三方应用通过任务ID查询单个批量任务的信息。 接口描述 1 QueryOneTaskOutDTO
批量设备数据变化通知 典型场景 第三方应用在物联网平台订阅了设备数据批量变化通知后（订阅的通知类型为deviceDatasChanged），当设备同时上报多个服务属性数据时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备数据批量变化通知的第三方应用推送通知消息。
固件升级状态变更通知 典型场景 第三方应用在物联网平台订阅了固件升级状态变更通知后（订阅的通知类型为fwUpgradeStateChangeNotify），当设备进行固件升级，升级任务的状态发生变化时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了固件升级状态变更通知的第三方应用推送通知消息。
创建软件升级任务 典型场景 若需要对设备进行软件版本升级，第三方应用可调用此接口为多个设备创建软件升级任务，升级前请确保目标版本包已上传到物联网平台。当前仅支持对NB-IoT设备进行软件版本升级。 接口功能 支持第三方应用在物联网平台为多个设备进行软件版本升级，当前仅支持对NB-IoT设备进行软件版本升级。
刷新设备密钥 典型场景 已在物联网平台注册的设备，若设备的唯一标识码发生变更（如更换设备等场景），第三方应用需要调用此接口在物联网平台更新设备的唯一标识，并重新绑定设备。 仅当设备处于离线状态时，才能进行刷新设备密钥操作。 接口功能 支持第三方应用在物联网平台更新已注册设备的no
查询设备影子 典型场景 若设备处于离线或异常状态时，第三方应用无法通过命令下发的方式向设备下发配置。此时可把要下发的配置设置到设备影子，当设备重新上线时，设备影子会把配置下发给设备。第三方应用可调用此接口查看设备影子上的设备配置信息及最新的设备上报数据信息。 接口功能 支持第三方
软件升级结果变更通知 典型场景 第三方应用在物联网平台订阅了软件升级结果通知后（订阅的通知类型为swUpgradeResultNotify），当设备的软件升级任务执行完成时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了软件升级结果通知的第三方应用推送通知消息。
查询设备历史数据 典型场景 在日常运行中，物联网平台会收到并保存设备上报业务数据（历史数据默认保留7天），第三方应用若需要查看某个设备上报到平台的历史数据，可调用此接口查询获取。 接口功能 支持第三方应用根据设备ID，查询指定设备上报到物联网平台的历史数据。 接口描述 1 Que
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
