RuntimeManager

Creates, lists, and resolves runtimes for a synchronous client.

Sync · Async counterpart: AsyncRuntimeManager

RuntimeManager declaration

class RuntimeManager(_SdkOwnedHandle):

RuntimeManager access

This type is created by the SDK; do not construct it directly.

manager = client.runtimes

RuntimeManager methods

`list()`

List runtimes, optionally filtered by lifecycle state.

def list(status: str | Sequence[str] | None = None) -> list[Runtime]

Parameters

Name	Type	Default	Description
`status`	`str \| Sequence[str] \| None`	`None`	Optional lifecycle status filter.

Returns

list[Runtime]

`create()`

Create a runtime and optionally wait until it is ready.

def create(name: str | None = None, *, checkpoint_id: str | None = None, vcpus: int = 1, memory_mib: int = 1024, memory_max_mib: int | None = None, resources: CreateRuntimeResources | Mapping[str, object] | None = None, ingress_specs: Sequence[IngressSpec | Mapping[str, object]] | None = None, egress_policy: EgressPolicy | None = None, idle_suspend_after_secs: int | None = None, runtime_agent: str | None = None, wait: bool = True, timeout: float = 240.0, poll_interval: float = 0.5) -> Runtime

Parameters

Name	Type	Default	Description
`name`	`str \| None`	`None`	Optional display name for the runtime.
`checkpoint_id`	`str \| None`	`None`	Checkpoint UUID to restore into the new runtime.
`vcpus`	`int`	`1`	Requested virtual CPU count when `resources` is not supplied.
`memory_mib`	`int`	`1024`	Requested memory in MiB when `resources` is not supplied.
`memory_max_mib`	`int \| None`	`None`	Optional maximum memory allocation in MiB.
`resources`	`CreateRuntimeResources \| Mapping[str, object] \| None`	`None`	Structured resource requests and limits.
`ingress_specs`	`Sequence[IngressSpec \| Mapping[str, object]] \| None`	`None`	Ports and protocols to expose from the runtime.
`egress_policy`	`EgressPolicy \| None`	`None`	Initial outbound network policy.
`idle_suspend_after_secs`	`int \| None`	`None`	Idle time before automatic suspension.
`runtime_agent`	`str \| None`	`None`	Optional runtime-agent version or channel.
`wait`	`bool`	`True`	Wait until the runtime is ready before returning.
`timeout`	`float`	`240.0`	Maximum number of seconds to wait for readiness.
`poll_interval`	`float`	`0.5`	Seconds between readiness checks.

Returns

Runtime — The newly created runtime handle.

Raises

ApiError — If the control plane rejects the create request.
TimeoutError — If wait is true and the runtime is not ready in time.

Examples

>>> runtime = client.runtimes.create(name="worker", memory_mib=2048)
>>> runtime.status()
<RuntimeStatus.RUNNING: 'running'>

`get()`

Resolve a runtime by UUID or display name.

def get(id: str) -> Runtime

Parameters

Name	Type	Default	Description
`id`	`str`	`—`	Resource UUID or display name.

Returns

Runtime