published on Thursday, Apr 23, 2026 by Volcengine
published on Thursday, Apr 23, 2026 by Volcengine
A sandbox instance is a secure and isolated container runtime environment that actually runs the sandbox image in the cloud sandbox
Example Usage
Example coming soon!
Example coming soon!
Example coming soon!
Example coming soon!
Example coming soon!
resources:
vefaasSandboxDemo:
type: volcenginecc:vefaas:Sandbox
name: VefaasSandboxDemo
properties:
functionId: n5hcs3y5****
timeout: 50
memoryMb: 2048
cpuMilli: 1000
requestTimeout: 30
maxConcurrency: 100
metadatas:
- key: env
value: test
instanceImageInfo:
image: enterprise-public-cn-beijing.cr.volces.com/xxxxxx/all-in-one-sandbox:xxxxxx
command: /opt/gem/run.sh
port: 8080
image_id: 3ewzg8x5h1***
instanceTosMountConfig:
enable: true
tos_mount_points:
- bucketPath: /mnt/tos
localMountPath: /mnt/tos
envs:
- key: env
value: test
Create Sandbox Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Sandbox(name: string, args: SandboxArgs, opts?: CustomResourceOptions);@overload
def Sandbox(resource_name: str,
args: SandboxArgs,
opts: Optional[ResourceOptions] = None)
@overload
def Sandbox(resource_name: str,
opts: Optional[ResourceOptions] = None,
function_id: Optional[str] = None,
cpu_milli: Optional[int] = None,
envs: Optional[Sequence[SandboxEnvArgs]] = None,
instance_image_info: Optional[SandboxInstanceImageInfoArgs] = None,
instance_tos_mount_config: Optional[SandboxInstanceTosMountConfigArgs] = None,
max_concurrency: Optional[int] = None,
memory_mb: Optional[int] = None,
metadatas: Optional[Sequence[SandboxMetadataArgs]] = None,
request_timeout: Optional[int] = None,
timeout: Optional[int] = None)func NewSandbox(ctx *Context, name string, args SandboxArgs, opts ...ResourceOption) (*Sandbox, error)public Sandbox(string name, SandboxArgs args, CustomResourceOptions? opts = null)
public Sandbox(String name, SandboxArgs args)
public Sandbox(String name, SandboxArgs args, CustomResourceOptions options)
type: volcenginecc:vefaas:Sandbox
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args SandboxArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args SandboxArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args SandboxArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args SandboxArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args SandboxArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Sandbox Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The Sandbox resource accepts the following input properties:
- Function
Id string - Sandbox application ID to which the sandbox instance belongs
- Cpu
Milli int - Sandbox instance CPU specification: Unit: milli CPU, range: 250~16000, default: 1000
- Envs
List<Volcengine.
Sandbox Env> - Instance
Image Volcengine.Info Sandbox Instance Image Info - Sandbox instance image information, including image address, startup command, and listening port.
- Instance
Tos Volcengine.Mount Config Sandbox Instance Tos Mount Config - Instance-level object storage (TOS) mount configuration for the sandbox instance
- Max
Concurrency int - Maximum concurrent requests per instance: range: 10~1000, default: 100
- Memory
Mb int - Sandbox instance memory specification: Unit: MiB, range: 512~131072, default: 2048
- Metadatas
List<Volcengine.
Sandbox Metadata> - Request
Timeout int - Request timeout: Unit: seconds, range: 1~900, positive integer. Default: 30
- Timeout int
- Sandbox instance lifespan: Unit: minutes, range: 3~1440, default: 60
- Function
Id string - Sandbox application ID to which the sandbox instance belongs
- Cpu
Milli int - Sandbox instance CPU specification: Unit: milli CPU, range: 250~16000, default: 1000
- Envs
[]Sandbox
Env Args - Instance
Image SandboxInfo Instance Image Info Args - Sandbox instance image information, including image address, startup command, and listening port.
- Instance
Tos SandboxMount Config Instance Tos Mount Config Args - Instance-level object storage (TOS) mount configuration for the sandbox instance
- Max
Concurrency int - Maximum concurrent requests per instance: range: 10~1000, default: 100
- Memory
Mb int - Sandbox instance memory specification: Unit: MiB, range: 512~131072, default: 2048
- Metadatas
[]Sandbox
Metadata Args - Request
Timeout int - Request timeout: Unit: seconds, range: 1~900, positive integer. Default: 30
- Timeout int
- Sandbox instance lifespan: Unit: minutes, range: 3~1440, default: 60
- function
Id String - Sandbox application ID to which the sandbox instance belongs
- cpu
Milli Integer - Sandbox instance CPU specification: Unit: milli CPU, range: 250~16000, default: 1000
- envs
List<Sandbox
Env> - instance
Image SandboxInfo Instance Image Info - Sandbox instance image information, including image address, startup command, and listening port.
- instance
Tos SandboxMount Config Instance Tos Mount Config - Instance-level object storage (TOS) mount configuration for the sandbox instance
- max
Concurrency Integer - Maximum concurrent requests per instance: range: 10~1000, default: 100
- memory
Mb Integer - Sandbox instance memory specification: Unit: MiB, range: 512~131072, default: 2048
- metadatas
List<Sandbox
Metadata> - request
Timeout Integer - Request timeout: Unit: seconds, range: 1~900, positive integer. Default: 30
- timeout Integer
- Sandbox instance lifespan: Unit: minutes, range: 3~1440, default: 60
- function
Id string - Sandbox application ID to which the sandbox instance belongs
- cpu
Milli number - Sandbox instance CPU specification: Unit: milli CPU, range: 250~16000, default: 1000
- envs
Sandbox
Env[] - instance
Image SandboxInfo Instance Image Info - Sandbox instance image information, including image address, startup command, and listening port.
- instance
Tos SandboxMount Config Instance Tos Mount Config - Instance-level object storage (TOS) mount configuration for the sandbox instance
- max
Concurrency number - Maximum concurrent requests per instance: range: 10~1000, default: 100
- memory
Mb number - Sandbox instance memory specification: Unit: MiB, range: 512~131072, default: 2048
- metadatas
Sandbox
Metadata[] - request
Timeout number - Request timeout: Unit: seconds, range: 1~900, positive integer. Default: 30
- timeout number
- Sandbox instance lifespan: Unit: minutes, range: 3~1440, default: 60
- function_
id str - Sandbox application ID to which the sandbox instance belongs
- cpu_
milli int - Sandbox instance CPU specification: Unit: milli CPU, range: 250~16000, default: 1000
- envs
Sequence[Sandbox
Env Args] - instance_
image_ Sandboxinfo Instance Image Info Args - Sandbox instance image information, including image address, startup command, and listening port.
- instance_
tos_ Sandboxmount_ config Instance Tos Mount Config Args - Instance-level object storage (TOS) mount configuration for the sandbox instance
- max_
concurrency int - Maximum concurrent requests per instance: range: 10~1000, default: 100
- memory_
mb int - Sandbox instance memory specification: Unit: MiB, range: 512~131072, default: 2048
- metadatas
Sequence[Sandbox
Metadata Args] - request_
timeout int - Request timeout: Unit: seconds, range: 1~900, positive integer. Default: 30
- timeout int
- Sandbox instance lifespan: Unit: minutes, range: 3~1440, default: 60
- function
Id String - Sandbox application ID to which the sandbox instance belongs
- cpu
Milli Number - Sandbox instance CPU specification: Unit: milli CPU, range: 250~16000, default: 1000
- envs List<Property Map>
- instance
Image Property MapInfo - Sandbox instance image information, including image address, startup command, and listening port.
- instance
Tos Property MapMount Config - Instance-level object storage (TOS) mount configuration for the sandbox instance
- max
Concurrency Number - Maximum concurrent requests per instance: range: 10~1000, default: 100
- memory
Mb Number - Sandbox instance memory specification: Unit: MiB, range: 512~131072, default: 2048
- metadatas List<Property Map>
- request
Timeout Number - Request timeout: Unit: seconds, range: 1~900, positive integer. Default: 30
- timeout Number
- Sandbox instance lifespan: Unit: minutes, range: 3~1440, default: 60
Outputs
All input properties are implicitly available as output properties. Additionally, the Sandbox resource produces the following output properties:
- Availability
Zone string - Availability zone ID of the sandbox instance
- Created
Time string - Sandbox instance creation time.
- Error
Code string - Sandbox instance startup failure error code. Parameter description: internalloadrequesterror: internal system error, functioninitializefailed: business process initialization error, functionhealthcheckfailed: health check error, route_terminating: route deletion in progress. This field is empty when the sandbox instance starts normally
- Error
Message string - Details of the error code when the sandbox instance fails to start. This field is empty when the sandbox instance starts normally.
- Expire
At string - Sandbox instance uptime.
- Id string
- The provider-assigned unique ID for this managed resource.
- Instance
Type string - Sandbox instance type. Parameter description: elastic: elastic instance, frozen: frozen instance, activated: activated instance, reserved: reserved instance
- Pending bool
- Whether the sandbox instance is in Pending status. Parameter description: true: yes, false: no
- Revision
Number int - Function instance version number
- Sandbox
Id string - Sandbox instance ID
- Status string
- Sandbox instance status. Parameter description: Starting: starting, Ready: startup completed, Failed: startup failed, Terminating: terminating
- Availability
Zone string - Availability zone ID of the sandbox instance
- Created
Time string - Sandbox instance creation time.
- Error
Code string - Sandbox instance startup failure error code. Parameter description: internalloadrequesterror: internal system error, functioninitializefailed: business process initialization error, functionhealthcheckfailed: health check error, route_terminating: route deletion in progress. This field is empty when the sandbox instance starts normally
- Error
Message string - Details of the error code when the sandbox instance fails to start. This field is empty when the sandbox instance starts normally.
- Expire
At string - Sandbox instance uptime.
- Id string
- The provider-assigned unique ID for this managed resource.
- Instance
Type string - Sandbox instance type. Parameter description: elastic: elastic instance, frozen: frozen instance, activated: activated instance, reserved: reserved instance
- Pending bool
- Whether the sandbox instance is in Pending status. Parameter description: true: yes, false: no
- Revision
Number int - Function instance version number
- Sandbox
Id string - Sandbox instance ID
- Status string
- Sandbox instance status. Parameter description: Starting: starting, Ready: startup completed, Failed: startup failed, Terminating: terminating
- availability
Zone String - Availability zone ID of the sandbox instance
- created
Time String - Sandbox instance creation time.
- error
Code String - Sandbox instance startup failure error code. Parameter description: internalloadrequesterror: internal system error, functioninitializefailed: business process initialization error, functionhealthcheckfailed: health check error, route_terminating: route deletion in progress. This field is empty when the sandbox instance starts normally
- error
Message String - Details of the error code when the sandbox instance fails to start. This field is empty when the sandbox instance starts normally.
- expire
At String - Sandbox instance uptime.
- id String
- The provider-assigned unique ID for this managed resource.
- instance
Type String - Sandbox instance type. Parameter description: elastic: elastic instance, frozen: frozen instance, activated: activated instance, reserved: reserved instance
- pending Boolean
- Whether the sandbox instance is in Pending status. Parameter description: true: yes, false: no
- revision
Number Integer - Function instance version number
- sandbox
Id String - Sandbox instance ID
- status String
- Sandbox instance status. Parameter description: Starting: starting, Ready: startup completed, Failed: startup failed, Terminating: terminating
- availability
Zone string - Availability zone ID of the sandbox instance
- created
Time string - Sandbox instance creation time.
- error
Code string - Sandbox instance startup failure error code. Parameter description: internalloadrequesterror: internal system error, functioninitializefailed: business process initialization error, functionhealthcheckfailed: health check error, route_terminating: route deletion in progress. This field is empty when the sandbox instance starts normally
- error
Message string - Details of the error code when the sandbox instance fails to start. This field is empty when the sandbox instance starts normally.
- expire
At string - Sandbox instance uptime.
- id string
- The provider-assigned unique ID for this managed resource.
- instance
Type string - Sandbox instance type. Parameter description: elastic: elastic instance, frozen: frozen instance, activated: activated instance, reserved: reserved instance
- pending boolean
- Whether the sandbox instance is in Pending status. Parameter description: true: yes, false: no
- revision
Number number - Function instance version number
- sandbox
Id string - Sandbox instance ID
- status string
- Sandbox instance status. Parameter description: Starting: starting, Ready: startup completed, Failed: startup failed, Terminating: terminating
- availability_
zone str - Availability zone ID of the sandbox instance
- created_
time str - Sandbox instance creation time.
- error_
code str - Sandbox instance startup failure error code. Parameter description: internalloadrequesterror: internal system error, functioninitializefailed: business process initialization error, functionhealthcheckfailed: health check error, route_terminating: route deletion in progress. This field is empty when the sandbox instance starts normally
- error_
message str - Details of the error code when the sandbox instance fails to start. This field is empty when the sandbox instance starts normally.
- expire_
at str - Sandbox instance uptime.
- id str
- The provider-assigned unique ID for this managed resource.
- instance_
type str - Sandbox instance type. Parameter description: elastic: elastic instance, frozen: frozen instance, activated: activated instance, reserved: reserved instance
- pending bool
- Whether the sandbox instance is in Pending status. Parameter description: true: yes, false: no
- revision_
number int - Function instance version number
- sandbox_
id str - Sandbox instance ID
- status str
- Sandbox instance status. Parameter description: Starting: starting, Ready: startup completed, Failed: startup failed, Terminating: terminating
- availability
Zone String - Availability zone ID of the sandbox instance
- created
Time String - Sandbox instance creation time.
- error
Code String - Sandbox instance startup failure error code. Parameter description: internalloadrequesterror: internal system error, functioninitializefailed: business process initialization error, functionhealthcheckfailed: health check error, route_terminating: route deletion in progress. This field is empty when the sandbox instance starts normally
- error
Message String - Details of the error code when the sandbox instance fails to start. This field is empty when the sandbox instance starts normally.
- expire
At String - Sandbox instance uptime.
- id String
- The provider-assigned unique ID for this managed resource.
- instance
Type String - Sandbox instance type. Parameter description: elastic: elastic instance, frozen: frozen instance, activated: activated instance, reserved: reserved instance
- pending Boolean
- Whether the sandbox instance is in Pending status. Parameter description: true: yes, false: no
- revision
Number Number - Function instance version number
- sandbox
Id String - Sandbox instance ID
- status String
- Sandbox instance status. Parameter description: Starting: starting, Ready: startup completed, Failed: startup failed, Terminating: terminating
Look up Existing Sandbox Resource
Get an existing Sandbox resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: SandboxState, opts?: CustomResourceOptions): Sandbox@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
availability_zone: Optional[str] = None,
cpu_milli: Optional[int] = None,
created_time: Optional[str] = None,
envs: Optional[Sequence[SandboxEnvArgs]] = None,
error_code: Optional[str] = None,
error_message: Optional[str] = None,
expire_at: Optional[str] = None,
function_id: Optional[str] = None,
instance_image_info: Optional[SandboxInstanceImageInfoArgs] = None,
instance_tos_mount_config: Optional[SandboxInstanceTosMountConfigArgs] = None,
instance_type: Optional[str] = None,
max_concurrency: Optional[int] = None,
memory_mb: Optional[int] = None,
metadatas: Optional[Sequence[SandboxMetadataArgs]] = None,
pending: Optional[bool] = None,
request_timeout: Optional[int] = None,
revision_number: Optional[int] = None,
sandbox_id: Optional[str] = None,
status: Optional[str] = None,
timeout: Optional[int] = None) -> Sandboxfunc GetSandbox(ctx *Context, name string, id IDInput, state *SandboxState, opts ...ResourceOption) (*Sandbox, error)public static Sandbox Get(string name, Input<string> id, SandboxState? state, CustomResourceOptions? opts = null)public static Sandbox get(String name, Output<String> id, SandboxState state, CustomResourceOptions options)resources: _: type: volcenginecc:vefaas:Sandbox get: id: ${id}- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Availability
Zone string - Availability zone ID of the sandbox instance
- Cpu
Milli int - Sandbox instance CPU specification: Unit: milli CPU, range: 250~16000, default: 1000
- Created
Time string - Sandbox instance creation time.
- Envs
List<Volcengine.
Sandbox Env> - Error
Code string - Sandbox instance startup failure error code. Parameter description: internalloadrequesterror: internal system error, functioninitializefailed: business process initialization error, functionhealthcheckfailed: health check error, route_terminating: route deletion in progress. This field is empty when the sandbox instance starts normally
- Error
Message string - Details of the error code when the sandbox instance fails to start. This field is empty when the sandbox instance starts normally.
- Expire
At string - Sandbox instance uptime.
- Function
Id string - Sandbox application ID to which the sandbox instance belongs
- Instance
Image Volcengine.Info Sandbox Instance Image Info - Sandbox instance image information, including image address, startup command, and listening port.
- Instance
Tos Volcengine.Mount Config Sandbox Instance Tos Mount Config - Instance-level object storage (TOS) mount configuration for the sandbox instance
- Instance
Type string - Sandbox instance type. Parameter description: elastic: elastic instance, frozen: frozen instance, activated: activated instance, reserved: reserved instance
- Max
Concurrency int - Maximum concurrent requests per instance: range: 10~1000, default: 100
- Memory
Mb int - Sandbox instance memory specification: Unit: MiB, range: 512~131072, default: 2048
- Metadatas
List<Volcengine.
Sandbox Metadata> - Pending bool
- Whether the sandbox instance is in Pending status. Parameter description: true: yes, false: no
- Request
Timeout int - Request timeout: Unit: seconds, range: 1~900, positive integer. Default: 30
- Revision
Number int - Function instance version number
- Sandbox
Id string - Sandbox instance ID
- Status string
- Sandbox instance status. Parameter description: Starting: starting, Ready: startup completed, Failed: startup failed, Terminating: terminating
- Timeout int
- Sandbox instance lifespan: Unit: minutes, range: 3~1440, default: 60
- Availability
Zone string - Availability zone ID of the sandbox instance
- Cpu
Milli int - Sandbox instance CPU specification: Unit: milli CPU, range: 250~16000, default: 1000
- Created
Time string - Sandbox instance creation time.
- Envs
[]Sandbox
Env Args - Error
Code string - Sandbox instance startup failure error code. Parameter description: internalloadrequesterror: internal system error, functioninitializefailed: business process initialization error, functionhealthcheckfailed: health check error, route_terminating: route deletion in progress. This field is empty when the sandbox instance starts normally
- Error
Message string - Details of the error code when the sandbox instance fails to start. This field is empty when the sandbox instance starts normally.
- Expire
At string - Sandbox instance uptime.
- Function
Id string - Sandbox application ID to which the sandbox instance belongs
- Instance
Image SandboxInfo Instance Image Info Args - Sandbox instance image information, including image address, startup command, and listening port.
- Instance
Tos SandboxMount Config Instance Tos Mount Config Args - Instance-level object storage (TOS) mount configuration for the sandbox instance
- Instance
Type string - Sandbox instance type. Parameter description: elastic: elastic instance, frozen: frozen instance, activated: activated instance, reserved: reserved instance
- Max
Concurrency int - Maximum concurrent requests per instance: range: 10~1000, default: 100
- Memory
Mb int - Sandbox instance memory specification: Unit: MiB, range: 512~131072, default: 2048
- Metadatas
[]Sandbox
Metadata Args - Pending bool
- Whether the sandbox instance is in Pending status. Parameter description: true: yes, false: no
- Request
Timeout int - Request timeout: Unit: seconds, range: 1~900, positive integer. Default: 30
- Revision
Number int - Function instance version number
- Sandbox
Id string - Sandbox instance ID
- Status string
- Sandbox instance status. Parameter description: Starting: starting, Ready: startup completed, Failed: startup failed, Terminating: terminating
- Timeout int
- Sandbox instance lifespan: Unit: minutes, range: 3~1440, default: 60
- availability
Zone String - Availability zone ID of the sandbox instance
- cpu
Milli Integer - Sandbox instance CPU specification: Unit: milli CPU, range: 250~16000, default: 1000
- created
Time String - Sandbox instance creation time.
- envs
List<Sandbox
Env> - error
Code String - Sandbox instance startup failure error code. Parameter description: internalloadrequesterror: internal system error, functioninitializefailed: business process initialization error, functionhealthcheckfailed: health check error, route_terminating: route deletion in progress. This field is empty when the sandbox instance starts normally
- error
Message String - Details of the error code when the sandbox instance fails to start. This field is empty when the sandbox instance starts normally.
- expire
At String - Sandbox instance uptime.
- function
Id String - Sandbox application ID to which the sandbox instance belongs
- instance
Image SandboxInfo Instance Image Info - Sandbox instance image information, including image address, startup command, and listening port.
- instance
Tos SandboxMount Config Instance Tos Mount Config - Instance-level object storage (TOS) mount configuration for the sandbox instance
- instance
Type String - Sandbox instance type. Parameter description: elastic: elastic instance, frozen: frozen instance, activated: activated instance, reserved: reserved instance
- max
Concurrency Integer - Maximum concurrent requests per instance: range: 10~1000, default: 100
- memory
Mb Integer - Sandbox instance memory specification: Unit: MiB, range: 512~131072, default: 2048
- metadatas
List<Sandbox
Metadata> - pending Boolean
- Whether the sandbox instance is in Pending status. Parameter description: true: yes, false: no
- request
Timeout Integer - Request timeout: Unit: seconds, range: 1~900, positive integer. Default: 30
- revision
Number Integer - Function instance version number
- sandbox
Id String - Sandbox instance ID
- status String
- Sandbox instance status. Parameter description: Starting: starting, Ready: startup completed, Failed: startup failed, Terminating: terminating
- timeout Integer
- Sandbox instance lifespan: Unit: minutes, range: 3~1440, default: 60
- availability
Zone string - Availability zone ID of the sandbox instance
- cpu
Milli number - Sandbox instance CPU specification: Unit: milli CPU, range: 250~16000, default: 1000
- created
Time string - Sandbox instance creation time.
- envs
Sandbox
Env[] - error
Code string - Sandbox instance startup failure error code. Parameter description: internalloadrequesterror: internal system error, functioninitializefailed: business process initialization error, functionhealthcheckfailed: health check error, route_terminating: route deletion in progress. This field is empty when the sandbox instance starts normally
- error
Message string - Details of the error code when the sandbox instance fails to start. This field is empty when the sandbox instance starts normally.
- expire
At string - Sandbox instance uptime.
- function
Id string - Sandbox application ID to which the sandbox instance belongs
- instance
Image SandboxInfo Instance Image Info - Sandbox instance image information, including image address, startup command, and listening port.
- instance
Tos SandboxMount Config Instance Tos Mount Config - Instance-level object storage (TOS) mount configuration for the sandbox instance
- instance
Type string - Sandbox instance type. Parameter description: elastic: elastic instance, frozen: frozen instance, activated: activated instance, reserved: reserved instance
- max
Concurrency number - Maximum concurrent requests per instance: range: 10~1000, default: 100
- memory
Mb number - Sandbox instance memory specification: Unit: MiB, range: 512~131072, default: 2048
- metadatas
Sandbox
Metadata[] - pending boolean
- Whether the sandbox instance is in Pending status. Parameter description: true: yes, false: no
- request
Timeout number - Request timeout: Unit: seconds, range: 1~900, positive integer. Default: 30
- revision
Number number - Function instance version number
- sandbox
Id string - Sandbox instance ID
- status string
- Sandbox instance status. Parameter description: Starting: starting, Ready: startup completed, Failed: startup failed, Terminating: terminating
- timeout number
- Sandbox instance lifespan: Unit: minutes, range: 3~1440, default: 60
- availability_
zone str - Availability zone ID of the sandbox instance
- cpu_
milli int - Sandbox instance CPU specification: Unit: milli CPU, range: 250~16000, default: 1000
- created_
time str - Sandbox instance creation time.
- envs
Sequence[Sandbox
Env Args] - error_
code str - Sandbox instance startup failure error code. Parameter description: internalloadrequesterror: internal system error, functioninitializefailed: business process initialization error, functionhealthcheckfailed: health check error, route_terminating: route deletion in progress. This field is empty when the sandbox instance starts normally
- error_
message str - Details of the error code when the sandbox instance fails to start. This field is empty when the sandbox instance starts normally.
- expire_
at str - Sandbox instance uptime.
- function_
id str - Sandbox application ID to which the sandbox instance belongs
- instance_
image_ Sandboxinfo Instance Image Info Args - Sandbox instance image information, including image address, startup command, and listening port.
- instance_
tos_ Sandboxmount_ config Instance Tos Mount Config Args - Instance-level object storage (TOS) mount configuration for the sandbox instance
- instance_
type str - Sandbox instance type. Parameter description: elastic: elastic instance, frozen: frozen instance, activated: activated instance, reserved: reserved instance
- max_
concurrency int - Maximum concurrent requests per instance: range: 10~1000, default: 100
- memory_
mb int - Sandbox instance memory specification: Unit: MiB, range: 512~131072, default: 2048
- metadatas
Sequence[Sandbox
Metadata Args] - pending bool
- Whether the sandbox instance is in Pending status. Parameter description: true: yes, false: no
- request_
timeout int - Request timeout: Unit: seconds, range: 1~900, positive integer. Default: 30
- revision_
number int - Function instance version number
- sandbox_
id str - Sandbox instance ID
- status str
- Sandbox instance status. Parameter description: Starting: starting, Ready: startup completed, Failed: startup failed, Terminating: terminating
- timeout int
- Sandbox instance lifespan: Unit: minutes, range: 3~1440, default: 60
- availability
Zone String - Availability zone ID of the sandbox instance
- cpu
Milli Number - Sandbox instance CPU specification: Unit: milli CPU, range: 250~16000, default: 1000
- created
Time String - Sandbox instance creation time.
- envs List<Property Map>
- error
Code String - Sandbox instance startup failure error code. Parameter description: internalloadrequesterror: internal system error, functioninitializefailed: business process initialization error, functionhealthcheckfailed: health check error, route_terminating: route deletion in progress. This field is empty when the sandbox instance starts normally
- error
Message String - Details of the error code when the sandbox instance fails to start. This field is empty when the sandbox instance starts normally.
- expire
At String - Sandbox instance uptime.
- function
Id String - Sandbox application ID to which the sandbox instance belongs
- instance
Image Property MapInfo - Sandbox instance image information, including image address, startup command, and listening port.
- instance
Tos Property MapMount Config - Instance-level object storage (TOS) mount configuration for the sandbox instance
- instance
Type String - Sandbox instance type. Parameter description: elastic: elastic instance, frozen: frozen instance, activated: activated instance, reserved: reserved instance
- max
Concurrency Number - Maximum concurrent requests per instance: range: 10~1000, default: 100
- memory
Mb Number - Sandbox instance memory specification: Unit: MiB, range: 512~131072, default: 2048
- metadatas List<Property Map>
- pending Boolean
- Whether the sandbox instance is in Pending status. Parameter description: true: yes, false: no
- request
Timeout Number - Request timeout: Unit: seconds, range: 1~900, positive integer. Default: 30
- revision
Number Number - Function instance version number
- sandbox
Id String - Sandbox instance ID
- status String
- Sandbox instance status. Parameter description: Starting: starting, Ready: startup completed, Failed: startup failed, Terminating: terminating
- timeout Number
- Sandbox instance lifespan: Unit: minutes, range: 3~1440, default: 60
Supporting Types
SandboxEnv, SandboxEnvArgs
SandboxInstanceImageInfo, SandboxInstanceImageInfoArgs
- Command string
- Startup command for the sandbox instance program. To specify a script file, use an absolute path and ensure the script has executable permissions
- Image string
- Preheated image address used by the sandbox instance
- Image
Id string - Pre-warmed image ID used by the sandbox instance.
- Port int
- Listening port of the sandbox instance image.
- Command string
- Startup command for the sandbox instance program. To specify a script file, use an absolute path and ensure the script has executable permissions
- Image string
- Preheated image address used by the sandbox instance
- Image
Id string - Pre-warmed image ID used by the sandbox instance.
- Port int
- Listening port of the sandbox instance image.
- command String
- Startup command for the sandbox instance program. To specify a script file, use an absolute path and ensure the script has executable permissions
- image String
- Preheated image address used by the sandbox instance
- image
Id String - Pre-warmed image ID used by the sandbox instance.
- port Integer
- Listening port of the sandbox instance image.
- command string
- Startup command for the sandbox instance program. To specify a script file, use an absolute path and ensure the script has executable permissions
- image string
- Preheated image address used by the sandbox instance
- image
Id string - Pre-warmed image ID used by the sandbox instance.
- port number
- Listening port of the sandbox instance image.
- command str
- Startup command for the sandbox instance program. To specify a script file, use an absolute path and ensure the script has executable permissions
- image str
- Preheated image address used by the sandbox instance
- image_
id str - Pre-warmed image ID used by the sandbox instance.
- port int
- Listening port of the sandbox instance image.
- command String
- Startup command for the sandbox instance program. To specify a script file, use an absolute path and ensure the script has executable permissions
- image String
- Preheated image address used by the sandbox instance
- image
Id String - Pre-warmed image ID used by the sandbox instance.
- port Number
- Listening port of the sandbox instance image.
SandboxInstanceTosMountConfig, SandboxInstanceTosMountConfigArgs
- Enable bool
- Whether instance-level TOS mount is enabled for the sandbox instance. Parameter description: true: yes, false: no
- Tos
Mount List<Volcengine.Points Sandbox Instance Tos Mount Config Tos Mount Point>
- Enable bool
- Whether instance-level TOS mount is enabled for the sandbox instance. Parameter description: true: yes, false: no
- Tos
Mount []SandboxPoints Instance Tos Mount Config Tos Mount Point
- enable Boolean
- Whether instance-level TOS mount is enabled for the sandbox instance. Parameter description: true: yes, false: no
- tos
Mount List<SandboxPoints Instance Tos Mount Config Tos Mount Point>
- enable boolean
- Whether instance-level TOS mount is enabled for the sandbox instance. Parameter description: true: yes, false: no
- tos
Mount SandboxPoints Instance Tos Mount Config Tos Mount Point[]
- enable bool
- Whether instance-level TOS mount is enabled for the sandbox instance. Parameter description: true: yes, false: no
- tos_
mount_ Sequence[Sandboxpoints Instance Tos Mount Config Tos Mount Point]
- enable Boolean
- Whether instance-level TOS mount is enabled for the sandbox instance. Parameter description: true: yes, false: no
- tos
Mount List<Property Map>Points
SandboxInstanceTosMountConfigTosMountPoint, SandboxInstanceTosMountConfigTosMountPointArgs
- Bucket
Path string - TOS remote directory mounted by the sandbox instance
- Local
Mount stringPath - Local directory of the TOS bucket mounted by the sandbox instance. If this directory is the local directory configured for TOS storage mount in the sandbox application, the system modifies the corresponding TOS BucketPath based on the specified local directory
- Bucket
Path string - TOS remote directory mounted by the sandbox instance
- Local
Mount stringPath - Local directory of the TOS bucket mounted by the sandbox instance. If this directory is the local directory configured for TOS storage mount in the sandbox application, the system modifies the corresponding TOS BucketPath based on the specified local directory
- bucket
Path String - TOS remote directory mounted by the sandbox instance
- local
Mount StringPath - Local directory of the TOS bucket mounted by the sandbox instance. If this directory is the local directory configured for TOS storage mount in the sandbox application, the system modifies the corresponding TOS BucketPath based on the specified local directory
- bucket
Path string - TOS remote directory mounted by the sandbox instance
- local
Mount stringPath - Local directory of the TOS bucket mounted by the sandbox instance. If this directory is the local directory configured for TOS storage mount in the sandbox application, the system modifies the corresponding TOS BucketPath based on the specified local directory
- bucket_
path str - TOS remote directory mounted by the sandbox instance
- local_
mount_ strpath - Local directory of the TOS bucket mounted by the sandbox instance. If this directory is the local directory configured for TOS storage mount in the sandbox application, the system modifies the corresponding TOS BucketPath based on the specified local directory
- bucket
Path String - TOS remote directory mounted by the sandbox instance
- local
Mount StringPath - Local directory of the TOS bucket mounted by the sandbox instance. If this directory is the local directory configured for TOS storage mount in the sandbox application, the system modifies the corresponding TOS BucketPath based on the specified local directory
SandboxMetadata, SandboxMetadataArgs
Import
$ pulumi import volcenginecc:vefaas/sandbox:Sandbox example "function_id|sandbox_id"
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- volcenginecc volcengine/pulumi-volcenginecc
- License
- MPL-2.0
- Notes
- This Pulumi package is based on the
volcengineccTerraform Provider.
published on Thursday, Apr 23, 2026 by Volcengine
