文档中心

云手机

应用镜像管理

查询应用镜像列表 ListAppImage

查询应用镜像列表 ListAppImage

查询应用镜像列表详情。

请求说明

请求方式：POST

请求地址：https://open.volcengineapi.com?Action=ListAppImage&Version=2025-05-01

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query

参数	类型	是否必选	示例值	描述
Action	String	是	ListAppImage	接口名称。当前 API 的名称为 ListAppImage。
Version	String	是	2025-05-01	接口版本。当前 API 的版本为 2025-05-01。

Body

参数	类型	是否必选	示例值	描述
ProductId	String	是	1749281594201***	业务 ID，管理云手机资源、开展云手机业务的标识。您可以登录云手机控制台，在已创建的业务卡片中获取。
AppId	String	否	7332828319227***	应用 ID，您可以通过 ListApp 获取。传入后按此条件筛选，返回该应用下的镜像列表；不传或为空时，返回全部应用的镜像列表。
AppVersionImageId	String	否	com.xxx.yyy_8d436f20***	应用版本镜像 ID。您可以使用 CreateAppImage 接口获取 TaskId，再使用 GetTaskInfo 查询创建任务进度，然后在其返回结果中获取 AppVersionImageId。传入后按此条件筛选，返回对应应用版本镜像的信息；不传或为空时，返回全部应用版本镜像列表。
Expire	Integer	否	24	下载链接的有效期，单位为小时。默认值为 24，最长支持 168小时（即 7 天）。
Offset	Integer	否	0	查询结果的起始位置，用于指定从哪一条记录开始返回数据。例如，若 Offset 为 10，则表示从第 11 条记录开始。默认值为 0。说明可与 Count 配合使用。假设当前数据集的记录总数为 200 条，如需查询第 101～150 条数据，需设置 Offset 为 100，Count 为 50。
Count	Integer	否	10	单次查询返回的最大记录数，用于控制每次查询返回的数据量。例如，若 Count 为 100，则表示在查询数据时，系统将每次返回 100 条记录。说明可与 Offset 配合使用。假设当前数据集的记录总数为 200 条，如需查询第 101～150 条数据，需设置 Offset 为 100，Count 为 50。
AOSPVersion	Integer	否	10	制作镜像的实例 AOSP 版本，了解更多。取值： 10：AOSP 10。 11：AOSP 11。 12：AOSP 12。 13：AOSP 13。 15：AOSP 15。
VersionId	String	否	73328283***	应用版本 ID，用于筛选特定版本的应用镜像，您可以调用 ListApp 接口获取。填写后，仅返回对应版本 ID 的镜像列表；不填写则不按版本 ID 筛选，返回符合其他筛选条件的所有镜像列表。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数	类型	示例值	描述
Row	Array of AppVersionImage	-	应用镜像信息列表。
Total	Long	10	符合查询条件的应用镜像总数量。

AppVersionImage

参数	类型	示例值	描述
AppId	String	724281594201***	应用 ID。
AppName	String	抖音	应用名称。
CreateAt	Long	1717248000	应用镜像的创建时间，以 Unix 时间戳形式表示。
ExpireAt	Long	1719878400	应用镜像下载地址（DownloadUrl）的到期时间，以 Unix 时间戳形式表示。
ImageMD5	String	f4015d1859605e***	应用版本镜像的 MD5 校验值，用于验证镜像文件在传输或存储过程中的完整性。
ProductId	String	1749281594201***	业务 ID。
VersionId	String	73328283***	应用版本 ID。
BuildJobId	String	job-7414035235***	构建任务的 Job ID。
BuildPodId	String	741395072823***	执行该镜像构建任务的实例 ID，用于定位具体的构建执行记录。
AOSPVersion	String	10	镜像的实例 AOSP 版本。
BuildTaskId	String	741403523585***	构建任务 ID，用于关联该应用镜像的构建任务记录。
DownloadUrl	String	https://app-image.tos-cn-beijing.volces.com/74*****f9.tar.gz	应用版本镜像文件的下载地址。
PackageName	String	com.android.test1	已打包的应用镜像包名。
VersionCode	Integer	80000	应用镜像版本号。
CompressFormat	Integer	0	应用镜像的打包格式，取值： 0：.tar.gz 格式，打包后进行 gzip 压缩，文件体积更小。 1：.tar格式，仅打包不压缩。
AppVersionImageId	String	com.tencent.letsgo_8d4*****	应用版本镜像 ID。

请求示例

返回示例

错误码

您可访问公共错误码，获取更多错误码信息。

最近更新时间：2026.09.03 09:47:02

这个页面对您有帮助吗？

有用

有用

无用

无用