调用CreateOsVersion创建系统升级版本。

说明 当用户需要进行FOTA升级(即系统升级)时,需要首先调用此接口创建一个系统版本,然后进行后续的版本测试、灰度、发布。

调试

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

请求参数

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

系统规定参数。取值:CreateOsVersion

RegionId String cn-shanghai

地域ID

DeviceModelId String 12

设备型号ID

IsForceNightUpgrade String N

是否强制夜间升级,取值:Y | N

与强制升级不能同时选择是(Y)。

IsForceUpgrade String N

是否强制升级,取值:Y | N

IsMilestone String N

是否里程碑,取值:Y | N

NightUpgradeDownloadType String 1

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

NightUpgradeIsAllowedCancel String N

夜间升级是否允许取消,取值:Y | N

NightUpgradeIsShowTip String N

夜间升级时是否给出提示框,取值:Y | N

ProjectId String P0VFCREU

项目ID

RomList String 0|http://www.oss-server.com/file1.zip,2.0.1|http://www.oss-server.com/file2.zip

升级包列表,包括全量包和增量包,格式为baseVersion|romUrl,baseVersion|romUrl

其中,baseVersion为基准版本,

  • 如果是全量包,则基准版本为0。
  • 如果是增量包,则基准版本为基准的系统版本号。
SystemVersion String 2.0.1-R-20180501.1208

系统版本号

EnableMobileDownload String Y

是否允许移动网络下载升级包,取值:Y | N

MaxClientVersion String 1200

允许的OTA SDK的最大版本versioncode

MinClientVersion String 1100

允许的OTA SDK的最小版本versioncode

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

版本发布说明

Remark String 版本备注信息,终端设备不可见

备注

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

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

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

VersionId String 12345

返回创建的版本的ID

示例

请求示例


http(s)://iovcc.cn-shanghai.aliyuncs.com/?Action=CreateOsVersion
&RegionId=cn-shanghai
&DeviceModelId=12
&IsForceNightUpgrade=N
&IsForceUpgrade=N
&IsMilestone=N
&NightUpgradeDownloadType=1
&NightUpgradeIsAllowedCancel=N
&NightUpgradeIsShowTip=N
&ProjectId=P0VFCREU
&RomList=0|http://www.oss-server.com/file1.zip,2.0.1|http://www.oss-server.com/file2.zip
&SystemVersion=2.0.1-R-20180501.1208
&EnableMobileDownload=Y
&<公共请求参数>

正常返回示例

XML 格式

<CreateOsVersionResponse>
	  <RequestId>6F25F67C-F411-499F-BCE2-67CA563CB064</RequestId>
	  <VersionId>1003</VersionId>
</CreateOsVersionResponse>

JSON 格式

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

错误码

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