批量设备OTA升级

上传软固件包

创建批量设备软件、固件升级任务前需要上传软件升级包，平台支持两种方式上传软件、固件包：

1. 应用服务器通过调用“创建OTA升级包”API接口，创建OTA升级包，详情请参考创建OTA升级包。
2. 通过控制台，在软固件升级页面上传软件、固件升级包，详情请参考软固件包上传。
   

   • 通过API接口创建的OTA升级包，只支持MQTT协议设备升级。
   • 升级包为OBS对象时，无论OBS桶是否配置了CDN域名加速功能，下发的升级包链接都为OBS链接地址。

批量设备软件升级

用户对批量设备进行软件升级有两种方式：

1. 应用服务器通过调用的“创建软件升级任务”API接口，创建批量设备的升级任务，详情请参考创建批量任务。
2. 通过控制台，创建批量设备的软件升级任务。

下面将重点介绍通过控制台创建批量设备的软件升级任务。

1. 访问设备接入服务，单击“管理控制台”进入设备接入控制台。选择您的实例，单击实例卡片进入。
2. 在左侧导航栏选择"设备 > 软固件升级"，单击“升级任务”。
3. 选择“软件升级”页签，单击“新建任务”按钮，进入新建软件升级任务页面。
   图1 软固件升级-新建软件升级任务
   

4. 设置“任务信息”，填写任务名称、执行时间、启用重试。

   启用重试后，可以设置重启次数和重启间隔。重启次数建议设置为2次，重启间隔设置为5分钟，即设备升级失败后，隔5分钟后会进行升级重试。

   图2 新建软件升级任务-基本信息
   

5. 选择需要升级的软件包。
   图3 新建软件升级任务-选择升级包
   

6. 选择需要升级的设备或者设备群组，然后单击“立即创建任务”。

   设备群组可以参考群组与标签创建需要升级的设备群组，并绑定对应的设备。

   图4 新建软件升级任务-选择设备群组
   

7. 创建完批量升级任务后，可以在软件升级任务列表中查看批量任务的执行结果。单击对应任务“详情”按钮，可以在“执行详情”界面查看每个设备的升级结果。
   

   如果升级任务正在执行中，是不允许删除任务的，如需删除，请先在任务列表中，手动停止任务后，再删除升级任务。

批量设备固件升级

用户对批量设备进行固件升级有两种方式：

1. 应用服务器通过调用的“创建固件升级任务”API接口，创建批量设备的升级任务，详情请参考创建批量任务。
2. 通过控制台，创建批量设备的固件升级任务。

下面将重点介绍通过控制台创建批量设备的固件升级任务。

1. 访问设备接入服务，单击“管理控制台”进入设备接入控制台。选择您的实例，单击实例卡片进入。
2. 在左侧导航栏选择"设备 > 软固件升级"，单击“升级任务”。
3. 在“固件升级”页签，单击“新建任务”按钮，进入新建固件任务页面。
   图5 软固件升级-新建固件升级任务
   

4. 设置“任务信息”，填写任务名称、执行时间、启用重试。

   启用重试后，可以设置重启次数和重启间隔。重启次数建议设置为2次，重启间隔设置为5分钟（最大重启次数为5次，最大重启间隔为1440分钟），即设备升级失败后，隔5分钟后会进行升级重试。

   图6 新建固件升级任务-基本信息
   

5. 选择需要升级的固件包。
   图7 新建固件升级任务-选择升级包
   

6. 选择需要升级的设备群组，然后单击“提交”。

   设备群组可以参考群组与标签创建需要升级的设备群组，并绑定对应的设备。

   图8 新建固件升级任务-选择设备群组
   

7. 创建完批量升级任务后，可以在固件升级任务列表中查看批量任务的执行结果。单击对应任务“详情”按钮，可以在“执行详情”界面查看每个设备的升级结果。
   

   如果升级任务正在执行中，是不允许删除任务的，如需删除，请先在任务列表中，手动停止任务后，再删除升级任务。

软固件升级失败原因

物联网平台上报的失败原因：

设备上报的失败原因：

常见问题

相关API接口

• 创建批量任务
• 查询批量任务列表
• 查询批量任务