REST Resource: runtimes

Resource: Runtime

A Colab managed runtime.

JSON representation 
{
  "name": string,
  "runtimeSpec": {
    object (RuntimeSpec.Key)
  },
  "connectionInfo": {
    object (ConnectionInfo)
  },
  "version": string
}
Fields
name

string

Identifier. The name of the runtime in the format runtimes/{runtimeId}, where runtimeId is either the value supplied via CreateRuntimeRequest.runtime_id or, if none was supplied, a random ID generated by the backend.
runtimeSpec

object (RuntimeSpec.Key)

Required. The specification of the runtime.
connectionInfo

object (ConnectionInfo)

Output only. The connection info used to authenticate to the runtime.
version

string

Optional. The version of the runtime image.

See Colab Runtime Version FAQ for supported runtime versions. If omitted (empty), the latest runtime image is used.

RuntimeSpec.Key

Key fields that uniquely identify a runtime spec.

JSON representation 
{
  "variant": enum (Variant),
  "accelerator": string,
  "shape": enum (Shape)
}
Fields
variant

enum (Variant)

Required. Runtime variant.
accelerator

string

Required. Runtime accelerator model name (e.g., "T4", "L4", "A100"). For CPU runtime specs, this field will be "NONE".
shape

enum (Shape)

Required. Runtime shape.

Variant

Runtime variant.

Enums
VARIANT_UNSPECIFIED Default value. This value is unused.
VARIANT_CPU CPU variant.
VARIANT_GPU GPU variant.
VARIANT_TPU TPU variant.

Shape

Runtime shape.

Enums
SHAPE_UNSPECIFIED Default value. This value is unused.
SHAPE_STANDARD Standard shape.
SHAPE_HIGHMEM High memory shape.

ConnectionInfo

Connection info used to authenticate to the runtime.

JSON representation 
{
  "token": string,
  "expireTime": string,
  "url": string
}
Fields
token

string

Required. Output only. The runtime proxy token. This is a short-lived credential used to authenticate to the runtime.
expireTime

string (Timestamp format)

Required. Output only. The expiration time of the runtime proxy token.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
url

string

Required. Output only. The authenticated URL that can be used to connect to the runtime.

Methods

create

 Creates a Colab runtime assignment.

delete

 Deletes a Colab runtime assignment.

get

 Gets a Colab runtime assigned to the requesting user.

list

 Lists Colab runtimes assigned to the requesting user.