REST Resource: projects.locations.notebookRuntimeTemplates

Resource: NotebookRuntimeTemplate

A template that specifies runtime configurations such as machine type, runtime version, network configurations, etc. Multiple runtimes can be created from a runtime template.

Fields
name string

The resource name of the NotebookRuntimeTemplate.

displayName string

Required. The display name of the NotebookRuntimeTemplate. The name can be up to 128 characters long and can consist of any UTF-8 characters.

description string

The description of the NotebookRuntimeTemplate.

isDefault
(deprecated)
boolean

Output only. Deprecated: This field has no behavior. Use notebookRuntimeType = 'ONE_CLICK' instead.

The default template to use if not specified.

machineSpec object (MachineSpec)

Optional. Immutable. The specification of a single machine for the template.

dataPersistentDiskSpec object (PersistentDiskSpec)

Optional. The specification of [persistent disk][https://cloud.google.com/compute/docs/disks/persistent-disks] attached to the runtime as data disk storage.

networkSpec object (NetworkSpec)

Optional. Network spec.

serviceAccount
(deprecated)
string

Deprecated: This field is ignored and the "Vertex AI Notebook service Account" (service-PROJECT_NUMBER@gcp-sa-aiplatform-vm.iam.gserviceaccount.com) is used for the runtime workload identity. See https://cloud.google.com/iam/docs/service-agents#vertex-ai-notebook-service-account for more details. For NotebookExecutionJob, use NotebookExecutionJob.service_account instead.

The service account that the runtime workload runs as. You can use any service account within the same project, but you must have the service account user permission to use the instance.

If not specified, the Compute Engine default service account is used.

etag string

Used to perform consistent read-modify-write updates. If not set, a blind "overwrite" update happens.

labels map (key: string, value: string)

The labels with user-defined metadata to organize the NotebookRuntimeTemplates.

label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed.

See https://goo.gl/xmQnxf for more information and examples of labels.

idleShutdownConfig object (NotebookIdleShutdownConfig)

The idle shutdown configuration of NotebookRuntimeTemplate. This config will only be set when idle shutdown is enabled.

eucConfig object (NotebookEucConfig)

EUC configuration of the NotebookRuntimeTemplate.

createTime string (Timestamp format)

Output only. timestamp when this NotebookRuntimeTemplate was created.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

updateTime string (Timestamp format)

Output only. timestamp when this NotebookRuntimeTemplate was most recently updated.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

notebookRuntimeType enum (NotebookRuntimeType)

Optional. Immutable. The type of the notebook runtime template.

shieldedVmConfig object (ShieldedVmConfig)

Optional. Immutable. Runtime Shielded VM spec.

networkTags[] string

Optional. The Compute Engine tags to add to runtime (see Tagging instances).

encryptionSpec object (EncryptionSpec)

Customer-managed encryption key spec for the notebook runtime.

JSON representation
{
  "name": string,
  "displayName": string,
  "description": string,
  "isDefault": boolean,
  "machineSpec": {
    object (MachineSpec)
  },
  "dataPersistentDiskSpec": {
    object (PersistentDiskSpec)
  },
  "networkSpec": {
    object (NetworkSpec)
  },
  "serviceAccount": string,
  "etag": string,
  "labels": {
    string: string,
    ...
  },
  "idleShutdownConfig": {
    object (NotebookIdleShutdownConfig)
  },
  "eucConfig": {
    object (NotebookEucConfig)
  },
  "createTime": string,
  "updateTime": string,
  "notebookRuntimeType": enum (NotebookRuntimeType),
  "shieldedVmConfig": {
    object (ShieldedVmConfig)
  },
  "networkTags": [
    string
  ],
  "encryptionSpec": {
    object (EncryptionSpec)
  }
}

Methods

create

Creates a NotebookRuntimeTemplate.

delete

Deletes a NotebookRuntimeTemplate.

get

Gets a NotebookRuntimeTemplate.

getIamPolicy

Gets the access control policy for a resource.

list

Lists NotebookRuntimeTemplates in a Location.

patch

Updates a NotebookRuntimeTemplate.

setIamPolicy

Sets the access control policy on the specified resource.

testIamPermissions

Returns permissions that a caller has on the specified resource.