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
NameTypeDefaultDescription
kindstr'full'Checkpoint kind. The public API currently accepts "full".
namestr | NoneNoneOptional display name for the checkpoint.
waitboolTrueWait for the checkpoint to become ready before returning.
timeoutfloat240.0Maximum number of seconds to wait for readiness.
poll_intervalfloat0.5Seconds 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
NameTypeDefaultDescription
idstrResource UUID or display name.