Lifecycle

Lifecycle calls on a Sandbox handle. They act on the container or VM, locally or in the cloud.

Python programs usually use the high-level API instead: Sandbox lifecycle.

Lifecycle methods#

Methods of Sandbox.

Sandbox.wait_ready#

Waits until every probe passes.

async def wait_ready(self, probes: List[ReadinessProbe], timeout_ms: int) -> None

Async · Raises CuaError

Sandbox.refresh#

Fresh info (status from the provider).

async def refresh(self) -> SandboxInfo

Returns SandboxInfo · Async · Raises CuaError

Sandbox.keep_alive#

Extends a Fleet lease by seconds.

async def keep_alive(self, seconds: int) -> None

Async · Raises CuaError

Sandbox.suspend#

Suspends.

async def suspend(self) -> None

Async · Raises CuaError

Sandbox.resume#

Resumes.

async def resume(self) -> None

Async · Raises CuaError

Sandbox.restart#

Restarts.

async def restart(self) -> None

Async · Raises CuaError

Sandbox.detach#

Managed Fleet claims: stop renewing the claim and forget the handle; the claim runs until its current shutdown time. Embedded runtime only (a daemon holds its claims by design).

def detach(self) -> None

Raises CuaError

Sandbox.delete#

Deletes (Fleet: releases the claim and an ephemeral pool).

async def delete(self) -> None

Async · Raises CuaError