查询指定应用镜像的详细信息。 ## 请求说明 * 请求方式：POST * 请求地址：https://open.volcengineapi.com?Action=DetailAppImage&Version=2025\-05\-01 ## 请求参数下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见 [公共参数](https://www.volcengine.com/docs/6369/67268)。 ### Query |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Action |String |是 |DetailAppImage |接口名称。当前 API 的名称为 `DetailAppImage`。 | |Version |String |是 |2025\-05\-01 |接口版本。当前 API 的版本为 `2025-05-01`。 | ### Body |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |ProductId |String |是 |1749281594201\*\*\* |业务 ID，管理云手机资源、开展云手机业务的标识。您可以登录 [云手机控制台](https://console.volcengine.com/ACEP/Business/5)，在已创建的业务卡片中获取。 | |AppId |String |否 |7295222843434xxxxxx |应用 ID，您可以通过 [ListApp](https://www.volcengine.com/docs/6394/1747879) 接口获取。传入后查询此应用下的所有镜像信息；不传或为空时，返回当前业务下全部应用镜像信息。 | |AppVersionImageId |String |是 |com.xxx.yyy_8d43\*\*\* |应用版本镜像 ID，传入后查询对应的应用版本镜像详情。

说明

您可以使用 CreateAppImage 接口获取 TaskId，再使用 GetTaskInfo 查询创建任务进度，然后在其返回结果中获取 AppVersionImageId。

| |Expire |Integer |否 |24 |下载链接的有效期，单位为小时。默认值为 `24`，最长支持 `168`小时（即7天）。 | ## 返回参数下表仅列出本接口特有的返回参数。更多信息请参见 [返回结构](https://www.volcengine.com/docs/6394/75748#%E8%BF%94%E5%9B%9E%E7%BB%93%E6%9E%9C)。 |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |ProductId |String |1749281594201\*\*\* |业务 ID。 | |AppId |String |724281594201\*\*\* |应用 ID。 | |AppVersionImageId |String |com.tencent\*\*\*\*\* |应用版本镜像 ID。 | |ImageMD5 |String |f4015d1859605e\*\*\* |应用版本镜像的 MD5 校验值，用于验证镜像文件在传输或存储过程中的完整性。 | |PackageName |String |com.tencent.letsgo |应用包名。 | |VersionCode |Integer |80000 |应用镜像版本号。 | |CompressFormat |Integer |0 |应用镜像的打包格式，取值：

* `0`：`.tar.gz` 格式，打包后进行 gzip 压缩，文件体积更小。

* `1`：`.tar`格式，仅打包不压缩。 | |DownloadUrl |String |https://app\-image.tos\-cn\-beijing.volces.com/74\*\*\*\*\*9.tar.gz |应用版本镜像文件的下载地址。 | |ExpireAt |Long |1719878400 |应用镜像下载地址（`DownloadUrl`）的到期时间，以 Unix 时间戳形式表示。 | |BuildTaskId |String |7414035235\*\*\* |构建任务 ID。 | |BuildJobId |String |job\-7414035235\*\*\* |构建任务的 Job ID。 | |BuildPodId |String |7413950728232\*\*\* |执行该镜像构建任务的目标实例 ID。 | |CreateAt |Long |1707258000 |应用版本镜像的创建时间，以 Unix 时间戳形式表示。 | |AppName |String |抖音 |应用名称。 | |AOSPVersion |String |10 |制作镜像的实例 AOSP 版本，[了解更多](https://docs.volcengine.com/docs/6394/1472187)。取值：

* `10`：AOSP 10。

* `11`：AOSP 11。

* `12`：AOSP 12。

* `13`：AOSP 13。

* `15`：AOSP 15。 | ## 请求示例 ```JSON POST https://open.volcengineapi.com?Action=DetailAppImage&Version=2025-05-01 { "ProductId": "1749281594201***", "AppId": "7295222843434xxxxxx", "AppVersionImageId": "com.xxx.yyy_8d43***", "Expire": 24 } ``` ## 返回示例 ```JSON { "ResponseMetadata": { "Action": "DetailAppImage", "Region": "cn-north-1", "Service": "ACEP", "Version": "2025-05-01", "RequestId": "20230604110420****100232280022D31" }, "Result": { "ProductId": "1749281594201***", "AppId": "724281594201***", "AppVersionImageId": "com.tencent*****", "ImageMD5": "f4015d1859605e***", "PackageName": "com.tencent.letsgo", "VersionCode": 80000, "CompressFormat": 0, "DownloadUrl": "https://app-image.tos-cn-beijing.volces.com/74*****9.tar.gz", "ExpireAt": 1719878400, "BuildTaskId": "7414035235***", "BuildJobId": "job-7414035235***", "BuildPodId": "7413950728232***", "CreateAt": 1707258000, "AppName": "抖音", "AOSPVersion": "10" } } ``` ## 错误码您可访问 [公共错误码](https://www.volcengine.com/docs/6394/1134303)，获取更多错误码信息。