文档中心

函数服务

沙箱镜像

PrecacheSandboxImages

PrecacheSandboxImages

批量预热用户自定义镜像。

请求说明

请求方式：POST

请求地址：http://open.volcengineapi.com/?Action=PrecacheSandboxImages&Version=2024-06-06

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

请求参数

参数	类型	是否必选	示例值	描述
Action	String	是	PrecacheSandboxImages	接口名称。当前 API 的名称为 PrecacheSandboxImages。
Version	String	是	2024-06-06	接口版本。当前 API 的版本为 2024-06-06。
ImageUrls	Array of String	是	["vefaas-****.cr.volces.com/vefaas-cr/****:latest"]	需要预热的 Sandbox 自定义镜像地址列表。火山引擎镜像仓库：在镜像仓库（CR）中上传镜像后，在镜像仓库控制台的 OCI 制品仓库页面具体镜像详情中获取镜像地址。第三方镜像仓库：待预热镜像的完整地址，通过目标镜像仓库的域名、命名空间、镜像名称和版本拼接而成，格式为{仓库域名}/{命名空间}/{镜像名}:{版本}。
RegistryId	String	否	regcfg-2fvj****	自定义镜像仓库的 ID。仅预热第三方自定义镜像仓库中的镜像时需要填写。支持通过 ListCustomImageRegistries 获取自定义镜像仓库的 ID。不填写时，仅 ImageUrls 为火山引擎镜像仓库地址时支持预热。

请求示例

返回参数

参数	类型	示例值	描述
TicketId	String	948410ee80954******	预热工单 ID。您可以在本地保存预热工单 ID，后续可以通过预热工单 ID 查询预热工单详情。

返回示例

错误码

当前接口暂无独立错误码，若接口调用返回异常，可参考公共错误码进行故障排查。

最近更新时间：2026.07.31 11:24:46

这个页面对您有帮助吗？

有用

有用

无用

无用