Docs

Volcano Engine Function as a Service

Sandbox images

PrecacheSandboxImages

Preheat custom images in batch.

Request description

Request method: POST

Request URL: http://open.volcengineapi.com/?Action=PrecacheSandboxImages&Version=2024-06-06

Debugging

API Explorer

You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.

Go to debug

Request parameters

Parameter	Type	Require	Sample value	Description
Action	String	Yes	PrecacheSandboxImages	Interface name. The name of the current API is PrecacheSandboxImages.
Version	String	Yes	2024-06-06	Interface version. The current version of the API is 2024-06-06 .
ImageUrls	Array of String	Yes	["vefaas-****.cr.volces.com/vefaas-cr/****:latest"]	A list of Sandbox custom image addresses to be preheated. Volcano Engine Container Registry (CR): After uploading an image to the CR, obtain the image address from the image details on the OCI artifact repository page of CR console. Third-party registry: The complete address of the image to be warmed up. It is composed of the domain name, namespace, image name, and version of the target image registry. The format is {registry domain}/{namespace}/{image name}:{version}.
RegistryId	String	No	regcfg-2fvj****	ID of the custom CR. Fill this in only when warming up images from a third-party custom registry. You can obtain the ID of the custom registry via ListCustomImageRegistries. If left empty, warm-up is supported only when ImageUrls are Volcano Engine CR addresses.

Sample requests

Response parameters

Parameter	Type	Sample value	Description
TicketId	String	948410ee80954******	Preheating ticket ID. You can keep the preheating ticket ID locally and use it later to query the details of that ticket.

Sample responses

Error codes

The current interface temporarily has no independent error code. If the interface calls back abnormally, you can refer to the Public error code to troubleshoot.

Last updated: 2026.10.16 11:27:55