查询应用镜像列表详情。 ## 请求说明 * 请求方式：POST * 请求地址：https://open.volcengineapi.com?Action=ListAppImage&Version=2025\-05\-01 ## 请求参数下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见 [公共参数](https://www.volcengine.com/docs/6369/67268)。 ### Query |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Action |String |是 |ListAppImage |接口名称。当前 API 的名称为 `ListAppImage`。 | |Version |String |是 |2025\-05\-01 |接口版本。当前 API 的版本为 `2025-05-01`。 | ### Body |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |ProductId |String |是 |1749281594201\*\*\* |业务 ID，管理云手机资源、开展云手机业务的标识。您可以登录 [云手机控制台](https://console.volcengine.com/ACEP/Business/5)，在已创建的业务卡片中获取。 | |AppId |String |否 |7332828319227\*\*\* |应用 ID，您可以通过 [ListApp](https://docs.volcengine.com/docs/6394/1747879) 获取。传入后按此条件筛选，返回该应用下的镜像列表；不传或为空时，返回全部应用的镜像列表。 | |AppVersionImageId |String |否 |com.xxx.yyy_8d436f20\*\*\* |应用版本镜像 ID。您可以使用 [CreateAppImage](https://docs.volcengine.com/docs/6394/2610035) 接口获取 `TaskId`，再使用 [GetTaskInfo](https://docs.volcengine.com/docs/6394/2189053) 查询创建任务进度，然后在其返回结果中获取 `AppVersionImageId`。传入后按此条件筛选，返回对应应用版本镜像的信息；不传或为空时，返回全部应用版本镜像列表。 | |Expire |Integer |否 |24 |下载链接的有效期，单位为小时。默认值为 `24`，最长支持 `168`小时（即 7 天）。 | |Offset |Integer |否 |0 |查询结果的起始位置，用于指定从哪一条记录开始返回数据。例如，若 `Offset` 为 10，则表示从第 11 条记录开始。默认值为 0。

说明

可与 Count 配合使用。假设当前数据集的记录总数为 200 条，如需查询第 101～150 条数据，需设置 Offset 为 100，Count 为 50。

说明

可与 Offset 配合使用。假设当前数据集的记录总数为 200 条，如需查询第 101～150 条数据，需设置 Offset 为 100，Count 为 50。

| |AOSPVersion |Integer |否 |10 |制作镜像的实例 AOSP 版本，[了解更多](https://docs.volcengine.com/docs/6394/1472187)。取值：

* `10`：AOSP 10。

* `11`：AOSP 11。

* `12`：AOSP 12。

* `13`：AOSP 13。

* `15`：AOSP 15。 | |VersionId |String |否 |73328283\*\*\* |应用版本 ID，用于筛选特定版本的应用镜像，您可以调用 [ListApp](https://docs.volcengine.com/docs/6394/1747879) 接口获取。填写后，仅返回对应版本 ID 的镜像列表；不填写则不按版本 ID 筛选，返回符合其他筛选条件的所有镜像列表。 | ## 返回参数下表仅列出本接口特有的返回参数。更多信息请参见 [返回结构](https://www.volcengine.com/docs/6394/75748#%E8%BF%94%E5%9B%9E%E7%BB%93%E6%9E%9C)。 |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |Row |Array of [AppVersionImage](https://docs.volcengine.com/docs/6394/2612145#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。 | ## 请求示例 ```JSON POST https://open.volcengineapi.com?Action=ListAppImage&Version=2025-05-01 { "ProductId": "1749281594201***", "AppId": "7332828319227***", "VersionId": "73328283***", "AppVersionImageId": "com.xxx.yyy_8d436f20***", "Expire": 24, "Offset": 0, "Count": 10, "AOSPVersion": 10 } ``` ## 返回示例 ```JSON { "ResponseMetadata": { "Action": "ListAppImage", "Region": "cn-north-1", "Service": "ACEP", "Version": "2025-05-01", "RequestId": "20230604110420****100232280022D31" }, "Result": { "Row": [ { "AppId": "724281594201***", "AppName": "抖音", "CreateAt": 1717248000, "ExpireAt": 1719878400, "ImageMD5": "f4015d1859605e***", "ProductId": "1749281594201***", "VersionId": "73328283***", "BuildJobId": "job-7414035235***", "BuildPodId": "741395072823***", "AOSPVersion": "10", "BuildTaskId": "741403523585***", "DownloadUrl": "https://app-image.tos-cn-beijing.volces.com/74*****f9.tar.gz", "PackageName": "com.android.test1", "VersionCode": 80000, "CompressFormat": 0, "AppVersionImageId": "com.tencent.letsgo_8d4*****" } ], "Total": 10 } } ``` ## 错误码您可访问 [公共错误码](https://www.volcengine.com/docs/6394/1134303)，获取更多错误码信息。