文档中心

免费开始使用

云手机

镜像管理

构建 AOSP 镜像 BuildAOSPImage

导入基于平台镜像基线改制的镜像文件，构建成自定义镜像。

注意事项

单个火山引擎账号下，同时只能有一个正在构建的镜像。如需构建下一个镜像，需等待上一个镜像构建完成后再进行。
云手机镜像构建最大并发为 30，即所有云手机用户同时构建的镜像数量不能超过 30。如发现构建请求报错，建议稍后重试。
本接口的单用户 QPS 限制为 1 次/秒。超过限制，API 调用会被限流。

请求说明

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

请求参数

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

Query

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

Body

参数	类型	是否必选	示例值	描述
ImageName	String	否	example-image-name	镜像名称。
ImageAnnotation	String	否	example-image-annotation	镜像备注信息。
ImageFileFormat	String	否	volc_tos	镜像文件格式，默认为 volc_tos。 volc_tos：从火山引擎的 TOS 对象存储中拉取文件。选择该选项后，必须设置 ImageTosInfo 参数值。 url：从第三方对象存储服务拉取文件，当前已支持阿里云 OSS。选择该选项后，必须设置 ImageUrlInfo 参数值。
ImageTosInfo	Object of AOSPImgTosInfo	否	-	存储在火山引擎对象存储系统中的原始镜像信息，具体参数说明参见 AOSPImgTosInfo。说明 ImageFileFormat 取值 volc_tos 时，该参数必填。
ImageUrlInfo	Object of AOSPImgUrlInfo	否	-	存储在第三方对象储存服务中的镜像文件信息，具体参数说明参见 AOSPImgUrlInfo。说明 ImageFileFormat 取值 url 时，该参数必填。

AOSPImgTosInfo

参数	类型	是否必选	示例值	描述
Bucket	String	是	`bucket`	镜像文件所在 TOS 的 bucket。
Region	String	是	`cn-beijing`	对象存储所在区域，例如：`cn-beijing`。
Endpoint	String	是	`tos-cn-beijing.volces.com`	镜像文件所在 TOS 的 endpoint，例如：`tos-cn-beijing.volces.com`。
SystemImg	Object of AOSPImgFile	是	-	AOSP 镜像 system 分区原始镜像信息，具体参数说明参见 AOSPImgFile。
VendorImg	Object of AOSPImgFile	是	-	AOSP 镜像 vendor 分区原始镜像信息，具体参数说明参见 AOSPImgFile。

AOSPImgUrlInfo

参数	类型	是否必选	示例值	描述
SystemImg	Object of AOSPImgFileUrl	是	-	AOSP 镜像 system 分区原始镜像信息，具体参数说明参见 AOSPImgFileUrl。
VendorImg	Object of AOSPImgFileUrl	是	-	AOSP 镜像 vendor 分区原始镜像信息，具体参数说明参见 AOSPImgFileUrl。

AOSPImgFile

参数	类型	是否必选	示例值	描述
MD5	String	否	`example-md5`	镜像文件的 MD5，不填则不校验。
FilePath	String	是	tos-cn-beijing.volces.com/****	镜像文件在 TOS 中的路径。

AOSPImgFileUrl

参数	类型	是否必选	示例值	描述
MD5	String	否	`example-md5`	镜像文件的 MD5，不填则不校验。
Url	String	是	https://****.volces.com	镜像文件所在第三方对象存储中的路径或地址。仅支持传入火山引擎域名（volces.com 后缀）、阿里云域名（aliyuncs.com 后缀）。

返回参数

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

参数	类型	示例值	描述
ImageId	String	img-158****	镜像 ID。

请求示例

POST https://open.volcengineapi.com?Action=BuildAOSPImage&Version=2025-05-01
{
    "ImageName": "example-image-name",
    "ImageAnnotation": "example-image-annotation",
    "ImageFileFormat": "volc_tos",
    "ImageTosInfo": {
        "Bucket": "bucket",
        "Region": "cn-beijing",
        "Endpoint": "tos-cn-beijing.volces.com",
        "SystemImg": {
            "MD5": "example-md5",
            "FilePath": "tos-cn-beijing.volces.com/****"
        },
        "VendorImg": {
            "MD5": "example-md5",
            "FilePath": "tos-cn-beijing.volces.com/****"
        }
    },
    "ImageUrlInfo": {
        "SystemImg": {
            "MD5": "example-md5",
            "Url": "https://****.volces.com"
        },
        "VendorImg": {
            "MD5": "example-md5",
            "Url": "https://****.volces.com"
        }
    }
}

返回示例

{
    "ResponseMetadata": {
        "Action": "BuildAOSPImage",
        "Region": "cn-north-1",
        "Service": "ACEP",
        "Version": "2025-05-01",
        "RequestId": "20230604110420****100232280022D31"
    },
    "Result": {
        "ImageId": "img-158****"
    }
}

错误码

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

最近更新时间：2026.01.28 16:03:56

这个页面对您有帮助吗？

有用

无用

云手机

注意事项 #

请求说明 #

请求参数 #

Query #

Body #

AOSPImgTosInfo #

AOSPImgUrlInfo #

AOSPImgFile #

AOSPImgFileUrl #

返回参数 #

请求示例 #

返回示例 #

错误码 #

注意事项

请求说明

请求参数

Query

Body

AOSPImgTosInfo

AOSPImgUrlInfo

AOSPImgFile

AOSPImgFileUrl

返回参数

请求示例

返回示例

错误码