You need to enable JavaScript to run this app.
云手机

云手机

请输入
  • 文档首页
    • 云手机服务端 OpenAPI 文档镜像管理构建 AOSP 镜像 BuildAOSPImage
复制全文
我的收藏
镜像管理
构建 AOSP 镜像 BuildAOSPImage
复制全文
我的收藏
构建 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
这个页面对您有帮助吗？
有用
有用
无用
无用