检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
查询版本包列表 典型场景 在进行设备版本升级前，第三方应用可调用此接口查询已经上传到物联网平台的版本升级包列表信息，确保设备要升级的版本包已上传到平台。 接口功能 支持第三方应用在物联网平台查询已上传的版本包列表信息，可根据条件查询满足要求的版本包。 接口描述 1 def que
创建设备命令撤销任务 典型场景 第三方应用向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行（DEFAULT状态），此时第三方应用可调用此接口撤销指定设备的所有未下发的命令，对于已下发成功的命令不可撤销。 接口功能 支持第三方应用创建设备命令
查询设备历史数据 典型场景 在日常运行中，物联网平台会收到并保存设备上报业务数据（历史数据默认保留7天），第三方应用若需要查看某个设备上报到平台的历史数据，可调用此接口查询获取。 接口功能 支持第三方应用根据设备ID，查询指定设备上报到物联网平台的历史数据。 接口描述 1 Que
查询指定设备组成员 典型场景 第三方应用若需要查看某个设备组中的设备成员分布情况，可调用此接口查询指定设备组的设备成员列表信息。 接口功能 支持第三方应用在物联网平台根据设备组ID查询指定设备组内设备列表信息。 接口描述 1 def queryDeviceGroupMembers(self
查询设备影子历史数据 典型场景 第三方应用通过“修改设备影子”接口修改设备影子的配置时，物联网平台会保存修改记录。当第三方应用需要查看设备影子的历史配置记录时，可调用此接口查询获取。 接口功能 支持第三方应用根据设备ID，在物联网平台查询指定设备影子的历史配置数据。 接口描述 1
查询指定设备组成员 典型场景 第三方应用若需要查看某个设备组中的设备成员分布情况，可调用此接口查询指定设备组的设备成员列表信息。 接口功能 支持第三方应用在物联网平台根据设备组ID查询指定设备组内设备列表信息。 接口描述 1 QueryDeviceGroupMembersOutDTO
删除设备组成员 典型场景 若设备组中的一个或多个设备不再归属于该设备组，第三方应用可调用此接口从设备组删除设备成员。 接口功能 支持第三方应用在物联网平台从指定设备组删除设备。 接口描述 1 def deleteDevicesFromGroup(self, dgwdlDTO, accessAppId
删除设备组成员 典型场景 若设备组中的一个或多个设备不再归属于该设备组，第三方应用可调用此接口从设备组删除设备成员。 接口功能 支持第三方应用在物联网平台从指定设备组删除设备。 接口描述 1 void deleteDevicesFromGroup(DeviceGroupWithDeviceListDTO
查询升级任务列表 典型场景 第三方应用可调用此接口查询已创建的升级任务列表信息，以了解当前已有的升级任务信息及各个任务的执行情况。 接口功能 支持第三方应用在物联网平台查询升级任务的列表信息，可根据条件查询满足要求的升级任务信息。 接口描述 1 def queryUpgradeTaskList(self
查询设备组详情 典型场景 第三方应用可调用此接口查询当前已创建的所有设备组列表信息，以了解当前设备组的分组和使用情况。 接口功能 支持第三方应用在物联网平台查询已创建的所有设备组信息。 接口描述 1 QueryDeviceGroupsOutDTO queryDeviceGroup
修改设备命令 典型场景 第三方应用向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行，此时第三方应用可调用此接口修改该命令的状态信息。当前仅支持把命令状态修改为CANCELED状态，即撤销命令的执行。 接口功能 支持第三方应用修改指定命令的状
创建设备命令撤销任务 接口说明 应用服务器向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行（PENDING状态），此时应用服务器可调用此接口撤销指定设备的所有未下发的命令，对于已下发成功的命令不可撤销。 URI 请求方法 POST URI /iocm/app/cmd/v1
查询指定批量任务信息 典型场景 第三方应用通过“创建批量任务”接口创建了设备的批量操作任务后，可调用此接口查询该批量任务的信息，包括任务的当前状态、子任务完成情况等。 接口功能 支持第三方应用通过任务ID查询单个批量任务的信息。 接口描述 1 QueryOneTaskOutDTO
查询指定批量任务信息 典型场景 第三方应用通过“创建批量任务”接口创建了设备的批量操作任务后，可调用此接口查询该批量任务的信息，包括任务的当前状态、子任务完成情况等。 接口功能 支持第三方应用通过任务ID查询单个批量任务的信息。 接口描述 1 def queryOneTask(self
创建批量任务 典型场景 第三方应用若需要对多个设备进行批量操作时，可调用此接口创建设备的批量操作任务，当前仅支持给批量设备下发缓存命令。 接口功能 支持第三方应用在物联网平台创建设备的批量操作任务。 接口描述 1 BatchTaskCreateOutDTO createBatch
查询指定升级任务结果 典型场景 在创建了设备软件升级任务或固件升级任务后，第三方应用可调用此接口查询某个升级任务详细信息，以查看升级任务的配置信息和执行情况等。 接口功能 支持第三方应用在物联网平台查询单个固件或软件升级任务的详细信息，包括升级任务的配置信息和执行情况等。 接口描述
查询指定升级任务结果 典型场景 在创建了设备软件升级任务或固件升级任务后，第三方应用可调用此接口查询某个升级任务详细信息，以查看升级任务的配置信息和执行情况等。 接口功能 支持第三方应用在物联网平台查询单个固件或软件升级任务的详细信息，包括升级任务的配置信息和执行情况等。 接口描述
创建批量任务 接口说明 应用服务器若需要对多个设备进行批量操作时，可调用此接口创建设备的批量操作任务，当前仅支持给批量设备下发缓存命令。 URI 请求方法 POST URI /iocm/app/batchtask/v1.1.0/tasks 传输协议 HTTPS 请求参数 参数 必选/可选
软件升级（联通用户专用） 非联通用户请查看设备接入服务。 软件（Software）一般分为系统软件和应用软件，系统软件实现设备最基本的功能，比如编译工具、系统文件管理等；应用软件可以根据设备的特点，提供不同的功能，比如采集数据、数据分析处理等。软件升级又称为SOTA（SoftWare
创建设备命令撤销任务 典型场景 第三方应用向设备下发命令后，如果由于命令排队、设备不在线等原因，物联网平台还未把命令下发给设备执行（DEFAULT状态），此时第三方应用可调用此接口撤销指定设备的所有未下发的命令，对于已下发成功的命令不可撤销。 接口功能 支持第三方应用创建设备命令
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
