调用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"
}

错误码

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