Skip to content

RuntimeCheckpointManager

Creates, lists, and deletes checkpoints for a runtime.

Sync · Async counterpart: AsyncRuntimeCheckpointManager

class RuntimeCheckpointManager(_SdkOwnedHandle):

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

manager = runtime.checkpoints

Create a checkpoint from this runtime and optionally wait until ready.

def create(kind: str = 'full', name: str | None = None, *, wait: bool = True, timeout: float = 240.0, poll_interval: float = 0.5) -> CheckpointInfo
Name Type Default Description
kind str 'full' Checkpoint kind. The public API currently accepts "full".
name str | None None Optional display name for the checkpoint.
wait bool True Wait for the checkpoint to become ready before returning.
timeout float 240.0 Maximum number of seconds to wait for readiness.
poll_interval float 0.5 Seconds between readiness checks.
  • CheckpointInfo — Metadata for the created checkpoint.
>>> checkpoint = runtime.checkpoints.create(name="worker-ready")
>>> restored = client.runtimes.create(checkpoint_id=checkpoint.id)

List checkpoints created from this runtime.

def list() -> list[CheckpointInfo]
  • list[CheckpointInfo]

Delete one of this runtime’s checkpoints.

def delete(id: str) -> None
Name Type Default Description
id str Resource UUID or display name.