调用UpdateOsVersion更新系统版本的基本信息。

用户创建完系统版本后,可能需要修改系统版本,可以调用此接口进行修改。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String UpdateOsVersion

系统规定参数。取值:UpdateOsVersion

RegionId String cn-shanghai

地域ID

DeviceModelId String 12

设备型号ID

Id String 123456

版本ID

IsForceNightUpgrade String N

是否强制夜间升级,Y或N;与强制升级不能同时选择是。

IsForceUpgrade String N

是否强制升级,Y或N。

IsMilestone String Y

是否里程碑,Y或N。

NightUpgradeDownloadType String 1

夜间升级下载类型,1表示WIFI下下载,2表示任全网下载。

NightUpgradeIsAllowedCancel String N

夜间升级时是否给出提示框,Y或N。

NightUpgradeIsShowTip String N

夜间升级时是否给出提示框,Y或N。

ProjectId String P0VFCREU

项目ID

ReleaseNote String 改用UI用户体验,提升系统稳定性

版本发布说明,客户端展示升级说明。

RomList String 10|0|http://www.oss-server.com/file0.zip,11|123|http://www.oss-server.com/file1.zip,0|124|http://www.oss-server.com/file2.zip

升级包列表,包括全量包和增量包。

格式为:id|baseVersion|romUrl,id|baseVersion|romUrl

  • 第一位指升级包的ID,如果是新的升级包,则为0。
  • 第二位为基准系统版本号,全量包的基准系统版本号位0。
  • 最后一位为升级包下载地址。
SystemVersion String 2.0.1-R-20180501.1208

系统版本号

EnableMobileDownload String Y

是否允许移动网络下载升级包

BlackVersionList String 2.0.1-R-20180501.1208,2.0.1-R-20180501.1209

系统版本黑名单列表,英文逗号隔开。

MaxClientVersion String 100

允许的OTA SDK的最大版本versioncode

MinClientVersion String 90

允许的OTA SDK的最小版本versioncode

Remark String 版本备注信息

版本备注,仅用于服务端管理维护。

WhiteVersionList String 2.0.1-R-20180501.1208,2.0.1-R-20180501.1209

系统版本白名单列表,英文逗号隔开。

MobileDownloadMaxSize String 10

允许移动网络下载的包的最大限制,单位为M,在允许移动网络下载包的情况下,大于该限制的包也不会自动下载。

返回数据

名称 类型 示例值 描述
RequestId String 6F25F67C-F411-499F-BCE2-67CA563CB064

请求ID

示例

请求示例


http(s)://iovcc.cn-shanghai.aliyuncs.com/?Action=UpdateOsVersion
&RegionId=cn-shanghai
&DeviceModelId=12
&Id=123456
&IsForceNightUpgrade=N
&IsForceUpgrade=N
&IsMilestone=Y
&NightUpgradeDownloadType=1
&NightUpgradeIsAllowedCancel=N
&NightUpgradeIsShowTip=N
&ProjectId=P0VFCREU
&ReleaseNote=改用UI用户体验,提升系统稳定性
&RomList=10|0|http://www.oss-server.com/file0.zip,11|123|http://www.oss-server.com/file1.zip,0|124|http://www.oss-server.com/file2.zip
&SystemVersion=2.0.1-R-20180501.1208
&EnableMobileDownload=Y
&<公共请求参数>

正常返回示例

XML 格式

<UpdateOsVersionResponse>
	  <RequestId>6F25F67C-F411-499F-BCE2-67CA563CB064</RequestId>
</UpdateOsVersionResponse>

JSON 格式

{
	"RequestId":"6F25F67C-F411-499F-BCE2-67CA563CB064"
}

错误码

访问错误中心查看更多错误码。