调用CreateAppVersion创建应用升级版本。

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

调试

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

请求参数

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

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

ProjectId String 是 P0VFCREU

项目ID
RegionId String 是 cn-shanghai

地域ID
ApkMd5 String 否 34653456wertwe234653retwewer3456

APK的MD5值
AppId String 否 123

应用ID，表示要针对哪个应用进行升级。
AppVersion String 否 1.0

应用版本号
BlackVersionList String 否 10,20,30

版本黑名单，versioncode英文逗号拼接。
DeviceAdapterList String 否 10|2.0.1-R-20180412.1024|3.0.1-R-20180412.1024,11|2.1.1-R-20180412.1024|3.1.1-R-20180412.1024

应用版本的适配机型列表。

格式：deviceModelId1|minOsVersion1|maxOsVersion1,deviceModelId2|minOsVersion2|maxOsVersion2，即设备型号ID|最低的系统版本号|最高的系统版本号。

InstallType String 否 auto

安装类型，取值：auto表示自动，customize表示自定义。

IsAllowNewInstall String 否 N

表示当客户端不存在此应用时，是否允许新安装此应用，相当于后装。
IsForceUpgrade String 否 N

是否强制升级，取值：Y | N。

IsNeedRestart String 否 N

是否需要重启，取值：Y | N。

IsSilentUpgrade String 否 N

是否静默升级，取值：Y | N。

PackageUrl String 否 http://www.oss-server.com/file.zip

升级包地址
ReleaseNote String 否 sample release note

版本发布说明
Remark String 否 sample remark

版本备注
RestartAppParam String 否 {"restartDelay":1}

应用重启时可以由服务端指定的重启参数
RestartAppType String 否 service

如果restartType为应用重启，则这个字段表示应用重启的类型。取值：

  • service：Service重启
  • activity：Activity重启
RestartType String 否 app

应用安装完成后的重启类型。取值：

  • system：系统重启
  • app：应用重启
VersionCode String 否 100

应用版本versioncode
WhiteVersionList String 否 10,20,30

版本白名单，versioncode英文逗号拼接。

返回数据

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

请求ID
VersionId String 12345

版本ID

示例

请求示例


http(s)://iovcc.cn-shanghai.aliyuncs.com/?Action=CreateAppVersion
&ProjectId=P0VFCREU
&RegionId=cn-shanghai
&<公共请求参数>

正常返回示例

XML 格式 

<CreateAppVersionResponse>
	  <RequestId>6F25F67C-F411-499F-BCE2-67CA563CB064</RequestId>
	  <VersionId>12345</VersionId>
</CreateAppVersionResponse>

JSON 格式 

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

错误码

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