CreateOTADynamicUpgradeJob

系统规定参数。取值：CreateOTADynamicUpgradeJob。

升级包ID，升级包的唯一标识符。

升级包ID是调用CreateOTAFirmware创建升级包时，返回的参数之一。

可以调用ListOTAFirmware，从返回参数中查看。

升级包所属产品的ProductKey。

待升级版本号列表。

批次标签key。仅支持英文字母、数字、半角句号（.）。长度限制为1~30个字符。批次标签将在向设备推送升级通知时下发给设备。

批次标签value。长度限制为1~1024个字符。

实例ID。

• 企业版实例：必须传入此参数。您可在物联网平台控制台的实例概览页面，查看您的企业版实例ID。
• 公共实例：无需传入此参数。

设备升级失败后，自动重试的时间间隔，单位为分钟。可选值：

• 0：立即重试。
• 10：10分钟后重试。
• 30：30分钟后重试。
• 60：60分钟（即1小时）后重试。
• 1440：1,440分钟（即24小时）后重试。

不传入此参数，则表示不重试。

自动重试次数。

如果传入RetryInterval参数，则需传入该参数。

可选值：

• 1：1次。
• 2：2次。
• 5：5次。

设备升级超时时间，超过指定时间后，设备未完成升级，则升级失败。单位为分钟，取值范围为1~1,440。

不传入该参数，则表示设备升级没有超时限制。

每分钟最多向多少个设备推升级包下载URL。取值范围：10~1,000。

不传入该参数，则取默认值1,000。

是否覆盖之前的升级任务。取值：

• 1（默认）：不覆盖。若设备已有升级任务，则只执行已有任务。
• 2：覆盖。设备只执行新的升级任务。

动态升级模式。取值范围：

• 1（默认）：除了升级当前满足升级条件的设备，还将持续检查设备是否满足升级条件，对满足升级条件的设备进行升级。
• 2：仅对后续上报新版本号的设备生效。

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

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

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

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

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

• false（默认）：否。直接按照NeedPush设置，获取OTA升级任务信息。
• true：是。设备无法获取OTA升级任务，需App侧确认OTA升级后，才能按照NeedPush设置，获取OTA升级任务信息。

调用失败时，返回的错误码。更多信息，请参见错误码。

调用失败时，返回的出错信息。

阿里云为该请求生成的唯一标识符。

表示是否调用成功。

• true：调用成功。
• false：调用失败。