Interface Provider

ReadonlyisReal

Readonlylabel

get

• get(nameOrId: string): Promise<ManagedInstance | null>

  Fetch a single instance by name or instance-id. Returns null if not found.

  Parameters

  • nameOrId: string

  Returns Promise<ManagedInstance | null>

hibernate

• hibernate(instanceId: string): Promise<void>

  Hibernate (RAM saved to disk).

  Parameters

  • instanceId: string

  Returns Promise<void>

launch

• launch(spec: LaunchSpec, launchTimeMs: number): Promise<ManagedInstance>

  Launch one instance from a spec at the given launch time (ms epoch).

  Parameters

  • spec: LaunchSpec
  • launchTimeMs: number

  Returns Promise<ManagedInstance>

list

• list(includeTerminated?: boolean): Promise<ManagedInstance[]>

  List all spawn-managed instances (spawn:managed=true), excluding terminated by default.

  Parameters

  • OptionalincludeTerminated: boolean

  Returns Promise<ManagedInstance[]>

setTags

• setTags(instanceId: string, tags: Record<string, string>): Promise<void>

  Overwrite/merge tags on an instance. Used by extend to push out spawn:ttl-deadline, and by the sim to update spawn:compute-seconds.

  Parameters

  • instanceId: string
  • tags: Record<string, string>

  Returns Promise<void>

start

• start(instanceId: string): Promise<void>

  Start a stopped/hibernated instance.

  Parameters

  • instanceId: string

  Returns Promise<void>

stop

• stop(instanceId: string, reason: string): Promise<void>

  Stop (billing pauses, EBS persists).

  Parameters

  • instanceId: string
  • reason: string

  Returns Promise<void>

terminate

• terminate(instanceId: string, reason: string): Promise<void>

  Terminate (permanent).

  Parameters

  • instanceId: string
  • reason: string

  Returns Promise<void>