发起升级批次任务

参数

描述

升级范围

• 全部设备：升级该产品下满足升级条件的全部设备。

• 定向升级：仅升级被选中的设备。

选择为定向升级后，从设备范围下拉列表选择要升级的设备。

• 灰度升级：即局部升级，灰度升级的设备至少为1个。

选择为灰度升级后，下方出现灰度范围输入框，需针对已选择的设备，设置灰度百分比，灰度范围为 1-100。平台根据设置的灰度百分进行计算，计算结果向下取整。

• 分组升级：

  • 分组列表展示当前实例下的所有分组，即所有父分组及其子分组。

升级时间

指定设备OTA升级的时间。

• 立即升级：立即进行OTA升级。

是否确认升级

如需自主控制设备OTA升级时，可以配置此参数，通过手机App来控制，设备是否可进行OTA升级。手机App需您自行开发。

• 是：设备无法获取OTA升级任务，需App侧确认设备可进行OTA升级（即通过ConfirmOTATask接口，批量确认待确认状态的设备升级作业）后，才能按照云端主动推送升级包设置，获取OTA升级任务信息。

• 否（默认）：直接按照云端主动推送升级包设置，获取OTA升级任务信息。

App确认升级的流程：

1. 用户自行开发App，平台无法主动推送消息给设备，需要App主动查询。

2. App侧调用ListOTAUnfinishedTaskByDevice，查询未完成状态的设备升级作业。

3. App侧调用ConfirmOTATask，确认升级任务。

云端是否主动推送升级

选择物联网平台是否主动向设备推送升级任务。

• 是：批次任务创建完成后，物联网平台主动将OTA升级任务，直接推送给升级范围内的在线设备。

此模式下，设备仍可主动向物联网平台发起请求，来获取OTA升级任务信息。

• 否（默认）：设备必须通过向物联网平台发起请求，来获取OTA升级任务信息。

升级失败重试间隔

如果升级失败，选择重试升级的时间。可选：

• 不重试

• 立即重试

• 10分钟后重试

• 30分钟后重试

• 1小时后重试

• 24小时后重试

设备升级超时时间

设置单个设备的升级超时时间，即多长时间之后，升级未完成则为超时。可选值范围：1分钟~1,440分钟。

升级包下载协议

仅支持 HTTPS

API

描述

CreateOTAStaticUpgradeJob

创建静态升级批次。

CancelOTATaskByDevice

取消指定升级包下状态为待升级的设备升级作业。

CancelOTATaskByJob

取消指定批次下的设备升级作业。