调用FindAppVersions分页获取应用版本列表。

支持多种查询条件，如机型、系统版本号等。

调试

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

请求参数

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

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

ProjectId String 是 P0VFCREU

项目ID
PageIndex Integer 是 1

分页索引，从1开始。
PageSize Integer 是 20

每页大小，支持20，50。
RegionId String 否 cn-shanghai

地域ID
VersionId String 否 12345

版本ID
AppId String 否 123

应用ID
DeviceModelId String 否 1230

设备型号ID
Status String 否 PUBLISHED

版本状态，如TESTING，TEST_PASSED，PREPUBLISH，PUBLISHED。

Remark String 否 sample remark

备注

返回数据

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

请求ID
AppVersionList

版本列表信息，包括当前页的版本列表以及总共符合条件的版本个数。
Items

符合条件的当前页的版本列表。
AppId String 20

应用ID
AppName String iovcc-ota

应用名
AppPackageName String com.aliyun.iovcc.ota

应用包名
AppVersion String 2.0.2

应用版本号
GmtCreate String 2018-04-24 12:23:45

版本创建时间
GmtCreateTimestamp Long 12432500000

版本创建时间戳
GmtModify String 2018-04-24 12:23:45

版本更新时间
GmtModifyTimestamp Long 12432500000

版本更新时间戳
Id Long 12345

版本ID
InstallType String auto

版本升级包客户端安装类型。取值：

  • auto：表示自动安装
  • customize：表示自定义安装
IsAllowNewInstall String Y

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

是否强制升级，Y或N
IsNeedRestart String N

是否需要重启，Y或N
IsSilentUpgrade String N

是否静默升级，Y或N
RestartAppParam String N

应用重启参数，Y或N
RestartAppType String service

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

  • service：表示Service重启
  • activity：表示Activity重启
RestartType String app

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

  • system：表示系统重启
  • app：表示应用重启
Status String PUBLISHED

版本状态，状态定义和系统版本升级一致。
StatusName String 已发布

状态名
VersionCode String 201

应用版本versioncode，是用于应用升级版本比较大小的字段。
TotalCount Integer 1000

符合条件的总记录数，方便调用方计算总页数。

示例

请求示例


http(s)://iovcc.cn-shanghai.aliyuncs.com/?Action=FindAppVersions
&ProjectId=P0VFCREU
&PageIndex=1
&PageSize=20
&<公共请求参数>

正常返回示例

XML 格式 

<FindAppVersionsResponse>
	  <AppVersionList>
		    <Items>
			      <AppId>1</AppId>
			      <AppName>iovcc-ota</AppName>
			      <AppPackageName>com.aliyun.iovcc.ota</AppPackageName>
			      <AppVersion>2.0.2</AppVersion>
			      <AsAllowNewInstall>N</AsAllowNewInstall>
			      <GmtCreate></GmtCreate>
			      <GmtModify></GmtModify>
			      <Id>124</Id>
			      <InstallType>auto</InstallType>
			      <IsForceUpgrade>N</IsForceUpgrade>
			      <IsNeedRestart>N</IsNeedRestart>
			      <IsSilentUpgrade>N</IsSilentUpgrade>
			      <RestartAppParam>N</RestartAppParam>
			      <RestartAppType>N</RestartAppType>
			      <RestartType>system</RestartType>
			      <Status>PUBLISHED</Status>
			      <StatusName>已发布</StatusName>
			      <VersionCode>202</VersionCode>
		    </Items>
		    <TotalCount>1000</TotalCount>
	  </AppVersionList>
	  <RequestId>6F25F67C-F411-499F-BCE2-67CA563CB064</RequestId>
</FindAppVersionsResponse>

JSON 格式 

{
	"RequestId":"6F25F67C-F411-499F-BCE2-67CA563CB064",
	"AppVersionList":{
		"Items":[
			{
				"RestartType":"system",
				"AsAllowNewInstall":"N",
				"AppVersion":"2.0.2",
				"IsForceUpgrade":"N",
				"AppId":"1",
				"InstallType":"auto",
				"IsSilentUpgrade":"N",
				"GmtCreate":"",
				"Status":"PUBLISHED",
				"RestartAppType":"N",
				"IsNeedRestart":"N",
				"VersionCode":202,
				"RestartAppParam":"N",
				"StatusName":"已发布",
				"AppName":"iovcc-ota",
				"Id":124,
				"AppPackageName":"com.aliyun.iovcc.ota",
				"GmtModify":""
			}
		],
		"TotalCount":1000
	}
}

错误码

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