Skip to main content

Runtime

Datalayer Core


Datalayer Core / Runtime

Class: Runtime

Defined in: src/models/RuntimeDTO.ts:131

Runtime domain model that wraps API responses with convenient methods. Provides state management and lifecycle operations for computational runtimes.

Example

const runtime = await sdk.createRuntime({ environment_name: 'python-cpu' });
await runtime.waitUntilReady();

Constructors

Constructor

new Runtime(data, sdk): RuntimeDTO

Defined in: src/models/RuntimeDTO.ts:143

Create a Runtime instance.

Parameters

data

RuntimeData

Runtime data from API

sdk

DatalayerClient

SDK instance

Returns

RuntimeDTO

Properties

_data

_data: RuntimeData

Defined in: src/models/RuntimeDTO.ts:133

Internal

Accessors

burningRate

Get Signature

get burningRate(): number

Defined in: src/models/RuntimeDTO.ts:199

Credits consumed per second.

Returns

number


environmentName

Get Signature

get environmentName(): string

Defined in: src/models/RuntimeDTO.ts:181

Name of the environment this runtime is based on.

Returns

string


environmentTitle

Get Signature

get environmentTitle(): string

Defined in: src/models/RuntimeDTO.ts:229

Environment title for display.

Returns

string


expiredAt

Get Signature

get expiredAt(): Date

Defined in: src/models/RuntimeDTO.ts:223

When the runtime will expire.

Returns

Date


givenName

Get Signature

get givenName(): string

Defined in: src/models/RuntimeDTO.ts:205

User-friendly name for the runtime.

Returns

string


ingress

Get Signature

get ingress(): string

Defined in: src/models/RuntimeDTO.ts:187

Ingress URL for accessing the runtime.

Returns

string


podName

Get Signature

get podName(): string

Defined in: src/models/RuntimeDTO.ts:169

Kubernetes pod name for the runtime instance.

Returns

string


startedAt

Get Signature

get startedAt(): Date

Defined in: src/models/RuntimeDTO.ts:217

When the runtime started.

Returns

Date


token

Get Signature

get token(): string

Defined in: src/models/RuntimeDTO.ts:193

Authentication token for accessing the runtime.

Returns

string


type

Get Signature

get type(): string

Defined in: src/models/RuntimeDTO.ts:211

Type of runtime (notebook, terminal, or job).

Returns

string


uid

Get Signature

get uid(): string

Defined in: src/models/RuntimeDTO.ts:175

Unique identifier for the runtime.

Returns

string

Methods

createSnapshot()

createSnapshot(name, description?, stop?): Promise<Snapshot>

Defined in: src/models/RuntimeDTO.ts:272

Create a snapshot of this runtime.

Parameters

name

string

Name for the snapshot

description?

string

Optional description

stop?

boolean

Whether to stop runtime after snapshotting

Returns

Promise<Snapshot>

Created Snapshot instance


delete()

delete(): Promise<void>

Defined in: src/models/RuntimeDTO.ts:242

Delete this runtime permanently. After deletion, subsequent calls to dynamic methods will throw errors.

Returns

Promise<void>


rawData()

rawData(): RuntimeData

Defined in: src/models/RuntimeDTO.ts:348

Get the raw runtime data exactly as received from the API. This preserves the original snake_case naming from the API response. Returns the current cached state - call getState() first if you need fresh data.

Returns

RuntimeData

Raw runtime data from API


toJSON()

toJSON(): RuntimeJSON

Defined in: src/models/RuntimeDTO.ts:298

Get runtime data in camelCase format. Returns only the core fields that consumers need. This provides a stable interface regardless of API changes. Returns the current cached state - call getState() first if you need fresh data.

Returns

RuntimeJSON

Core runtime data with camelCase properties


toString()

toString(): string

Defined in: src/models/RuntimeDTO.ts:354

String representation of the runtime.

Returns

string


update()

update(from): Promise<RuntimeDTO>

Defined in: src/models/RuntimeDTO.ts:253

Update runtime from a snapshot.

Parameters

from

string

Snapshot identifier to restore from

Returns

Promise<RuntimeDTO>

Updated Runtime instance