Skip to main content
API docs by Redocly

ai/h2o/notebook/v1/base_types.proto (version not set)

Download OpenAPI specification:Download

KernelImageService

Updates a KernelImage.

path Parameters
kernelImage.name
required
stringworkspaces/[^/]+/kernelImages/[^/]+

Output only. Resource name. Format is workspaces/*/kernelImages/*.

query Parameters
updateMask
required
string

Required. The list of paths referencing which fields to update. Update mask must be non-empty.

Allowed field paths are: {"display_name", "type", "image", "disabled", "image_pull_policy", "image_pull_secrets"}. Paths are case sensitive (must match exactly).

To update all allowed fields, specify exactly one path with value "*".

Request Body schema: application/json

Required. KernelImage resource.

displayName
string

Optional. Human-readable name.

type
string (v1KernelImageType)
Default: "TYPE_UNSPECIFIED"
Enum: "TYPE_UNSPECIFIED" "TYPE_PYTHON" "TYPE_R" "TYPE_SPARK_PYTHON" "TYPE_SPARK_R"

KernelImage type.

  • TYPE_UNSPECIFIED: KernelImage type is unspecified or unknown.
  • TYPE_PYTHON: Python KernelImage.
  • TYPE_R: R KernelImage.
  • TYPE_SPARK_PYTHON: Python with Spark KernelImage.
  • TYPE_SPARK_R: R with Spark KernelImage.
image
required
string (Required. Docker image name. For example: "gcr.io/vorvan/h2oai/h2o-kernel-py:0.3.2")
disabled
boolean

Optional. Whether the KernelImage is disabled. Disabled KernelImage cannot be used for creating new Kernel.

imagePullPolicy
string (v1ImagePullPolicy)
Default: "IMAGE_PULL_POLICY_UNSPECIFIED"
Enum: "IMAGE_PULL_POLICY_UNSPECIFIED" "IMAGE_PULL_POLICY_ALWAYS" "IMAGE_PULL_POLICY_NEVER" "IMAGE_PULL_POLICY_IF_NOT_PRESENT"

Policy for downloading an image in K8s.

  • IMAGE_PULL_POLICY_UNSPECIFIED: Unspecified image pull policy.
  • IMAGE_PULL_POLICY_ALWAYS: Every time the container is launched, the container image registry is queried to resolve the name to an image digest.
  • IMAGE_PULL_POLICY_NEVER: Do not try to fetch the image. If the image is already present locally, the container will start. If the image is not present, container startup will fail.
  • IMAGE_PULL_POLICY_IF_NOT_PRESENT: The image is pulled only if it is not already present locally.
imagePullSecrets
Array of strings

Optional. A list of Kubernetes secret references used for authenticating to private container registries or repositories. These secrets provide the necessary credentials to pull Docker images from private repositories. Each entry in this list should be the name of a Kubernetes secret configured in the cluster.

Responses

Request samples

Content type
application/json
{
  • "displayName": "string",
  • "type": "TYPE_UNSPECIFIED",
  • "image": "string",
  • "disabled": true,
  • "imagePullPolicy": "IMAGE_PULL_POLICY_UNSPECIFIED",
  • "imagePullSecrets": [
    ]
}

Response samples

Content type
application/json
{
  • "kernelImage": {
    }
}

Returns a specific KernelImage.

path Parameters
name
required
stringworkspaces/[^/]+/kernelImages/[^/]+

Required. The name of the KernelImage to retrieve. Format is workspaces/*/kernelImages/*

Responses

Response samples

Content type
application/json
{
  • "kernelImage": {
    }
}

Deletes a KernelImage.

path Parameters
name
required
stringworkspaces/[^/]+/kernelImages/[^/]+

Required. KernelImage resource name. Format is workspaces/*/kernelImages/*.

Responses

Response samples

Content type
application/json
{ }

Returns a collection of KernelImages.

path Parameters
parent
required
stringworkspaces/[^/]+

Required. The resource name of the workspace to associate with the KernelImage. Format is workspaces/*.

query Parameters
pageSize
integer <int32>

Optional. Maximum number of KernelImages to return in a response. If unspecified (or set to 0), at most 50 KernelImages will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

pageToken
string

Optional. Leave unset to receive the initial page. To list any subsequent pages use the value of 'next_page_token' returned from the ListKernelImagesResponse.

Responses

Response samples

Content type
application/json
{
  • "kernelImages": [
    ],
  • "nextPageToken": "string"
}

Creates a new KernelImage.

path Parameters
parent
required
stringworkspaces/[^/]+

Required. The resource name of the workspace to associate with the KernelImage. Format is workspaces/*.

query Parameters
kernelImageId
string

Optional. Specify the KernelImage ID, which will become a part of the KernelImage resource name. If not specified, the server will generate one.

It must:

  • contain 1-63 characters
  • contain only lowercase alphanumeric characters or hyphen ('-')
  • start with an alphabetic character
  • end with an alphanumeric character

This matches a regular expression: ^a-z?$

Request Body schema: application/json

Required. The KernelImage resource to create.

displayName
string

Optional. Human-readable name.

type
string (v1KernelImageType)
Default: "TYPE_UNSPECIFIED"
Enum: "TYPE_UNSPECIFIED" "TYPE_PYTHON" "TYPE_R" "TYPE_SPARK_PYTHON" "TYPE_SPARK_R"

KernelImage type.

  • TYPE_UNSPECIFIED: KernelImage type is unspecified or unknown.
  • TYPE_PYTHON: Python KernelImage.
  • TYPE_R: R KernelImage.
  • TYPE_SPARK_PYTHON: Python with Spark KernelImage.
  • TYPE_SPARK_R: R with Spark KernelImage.
image
required
string (Required. Docker image name. For example: "gcr.io/vorvan/h2oai/h2o-kernel-py:0.3.2")
disabled
boolean

Optional. Whether the KernelImage is disabled. Disabled KernelImage cannot be used for creating new Kernel.

imagePullPolicy
string (v1ImagePullPolicy)
Default: "IMAGE_PULL_POLICY_UNSPECIFIED"
Enum: "IMAGE_PULL_POLICY_UNSPECIFIED" "IMAGE_PULL_POLICY_ALWAYS" "IMAGE_PULL_POLICY_NEVER" "IMAGE_PULL_POLICY_IF_NOT_PRESENT"

Policy for downloading an image in K8s.

  • IMAGE_PULL_POLICY_UNSPECIFIED: Unspecified image pull policy.
  • IMAGE_PULL_POLICY_ALWAYS: Every time the container is launched, the container image registry is queried to resolve the name to an image digest.
  • IMAGE_PULL_POLICY_NEVER: Do not try to fetch the image. If the image is already present locally, the container will start. If the image is not present, container startup will fail.
  • IMAGE_PULL_POLICY_IF_NOT_PRESENT: The image is pulled only if it is not already present locally.
imagePullSecrets
Array of strings

Optional. A list of Kubernetes secret references used for authenticating to private container registries or repositories. These secrets provide the necessary credentials to pull Docker images from private repositories. Each entry in this list should be the name of a Kubernetes secret configured in the cluster.

Responses

Request samples

Content type
application/json
{
  • "displayName": "string",
  • "type": "TYPE_UNSPECIFIED",
  • "image": "string",
  • "disabled": true,
  • "imagePullPolicy": "IMAGE_PULL_POLICY_UNSPECIFIED",
  • "imagePullSecrets": [
    ]
}

Response samples

Content type
application/json
{
  • "kernelImage": {
    }
}

KernelService

Returns a specific Kernel.

path Parameters
name_1
required
stringworkspaces/[^/]+/kernels/[^/]+

Required. The name of the Kernel to retrieve. Format is workspaces/*/kernels/*.

Responses

Response samples

Content type
application/json
{
  • "kernel": {
    }
}

Deletes a Kernel.

path Parameters
name_1
required
stringworkspaces/[^/]+/kernels/[^/]+

Required. Kernel resource name. Format is workspaces/*/kernels/*.

Responses

Response samples

Content type
application/json
{
  • "kernel": {
    }
}

Terminates a Kernel.

path Parameters
name
required
stringworkspaces/[^/]+/kernels/[^/]+

Required. Kernel resource name. Format is workspaces/*/kernels/*.

Request Body schema: application/json
object

Request message for terminating an existing Kernel.

Responses

Request samples

Content type
application/json
{ }

Response samples

Content type
application/json
{
  • "kernel": {
    }
}

Returns a collection of Kernels.

path Parameters
parent
required
stringworkspaces/[^/]+

Required. The resource name of the workspace to associate with the Kernel. Format is workspaces/*.

query Parameters
pageSize
integer <int32>

Optional. Maximum number of Kernels to return in a response. If unspecified (or set to 0), at most 50 Kernels will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

pageToken
string

Optional. Leave unset to receive the initial page. To list any subsequent pages use the value of 'next_page_token' returned from the ListKernelsResponse.

Responses

Response samples

Content type
application/json
{
  • "kernels": [
    ],
  • "nextPageToken": "string"
}

Creates a new Kernel.

path Parameters
parent
required
stringworkspaces/[^/]+

Required. The resource name of the workspace to associate with the Kernel. Format is workspaces/*.

query Parameters
kernelId
string

Optional. Specify the Kernel ID, which will become a part of the Kernel resource name. If not specified, the server will generate one.

It must:

  • contain 1-63 characters
  • contain only lowercase alphanumeric characters or hyphen ('-')
  • start with an alphabetic character
  • end with an alphanumeric character

This matches a regular expression: ^a-z?$

Request Body schema: application/json

Required. The Kernel resource to create.

displayName
string

Optional. Human-readable name.

kernelImage
required
string

Required. Immutable. The resource name of the KernelImage that is used to create the Kernel. Format is workspaces/*/kernelImages/*.

object (v1KernelImageInfo)

KernelImageInfo contains data from the KernelImage that is used to create a Kernel. The original KernelImage might be deleted or modified during the lifetime of the Kernel.

kernelTemplate
required
string

Required. Immutable. The resource name of the KernelTemplate that is used to create the Kernel. Format is workspaces/*/kernelTemplates/*.

object (v1KernelTemplateInfo)

KernelTemplateInfo contains data from the KernelTemplate that is used to create a Kernel. The original KernelTemplate might be deleted during the lifetime of the Kernel.

object

Optional. Immutable. Map of additional environmental variables that will be set in the Kernel. This set of environmental variables take precedence over the ones defined in the KernelTemplate.

state
string (v1KernelState)
Default: "STATE_UNSPECIFIED"
Enum: "STATE_UNSPECIFIED" "STATE_STARTING" "STATE_RUNNING_IDLE" "STATE_RUNNING_BUSY" "STATE_FAILED" "STATE_TERMINATING" "STATE_TERMINATED"

Kernel states.

  • STATE_UNSPECIFIED: Kernel state is unspecified or unknown.
  • STATE_STARTING: Kernel is starting.
  • STATE_RUNNING_IDLE: Kernel is running and is not executing any KernelTask.
  • STATE_RUNNING_BUSY: Kernel is running and is busy executing a KernelTask.
  • STATE_FAILED: Kernel has failed.
  • STATE_TERMINATING: Kernel is being terminated.
  • STATE_TERMINATED: Kernel is terminated.
type
string (v1KernelType)
Default: "TYPE_UNSPECIFIED"
Enum: "TYPE_UNSPECIFIED" "TYPE_NOTEBOOK" "TYPE_HEADLESS"

Kernel types.

  • TYPE_UNSPECIFIED: Kernel type is unspecified or unknown.
  • TYPE_NOTEBOOK: Kernel was created by H2O Notebook Lab. No methods are allowed on this type of Kernel.
  • TYPE_HEADLESS: Kernel was created using this API.

Responses

Request samples

Content type
application/json
{
  • "displayName": "string",
  • "kernelImage": "string",
  • "kernelImageInfo": {
    },
  • "kernelTemplate": "string",
  • "kernelTemplateInfo": { },
  • "environmentalVariables": {
    },
  • "state": "STATE_UNSPECIFIED",
  • "type": "TYPE_UNSPECIFIED"
}

Response samples

Content type
application/json
{
  • "kernel": {
    }
}

KernelTaskMessageService

Returns a collection of KernelTaskMessages produced by a KernelTask.

path Parameters
parent
required
stringworkspaces/[^/]+/kernels/[^/]+/tasks/[^/]+

Required. The resource name of the KernelTask to list KernelTaskMessages from. Format is workspaces/*/kernels/*/tasks/*.

query Parameters
pageSize
integer <int32>

Optional. Maximum number of KernelTaskMessages to return in a response. If unspecified (or set to 0), at most 50 KernelTaskMessages will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

pageToken
string

Optional. Leave unset to receive the initial page. To list any subsequent pages use the value of 'next_page_token' returned from the ListKernelTaskMessagesResponse.

Responses

Response samples

Content type
application/json
{
  • "kernelTaskMessages": [
    ],
  • "nextPageToken": "string"
}

KernelTaskOutputService

Returns a KernelTaskOutput produced by a KernelTask.

path Parameters
name_2
required
stringworkspaces/[^/]+/kernels/[^/]+/tasks/[^/]+/ou...

KernelTaskOutput resource name. Format is workspaces/*/kernels/*/tasks/*/output.

Responses

Response samples

Content type
application/json
{
  • "kernelTaskOutput": {
    }
}

KernelTaskService

Returns a specific KernelTask.

path Parameters
name_3
required
stringworkspaces/[^/]+/kernels/[^/]+/tasks/[^/]+

Required. The name of the KernelTask to retrieve. Format is workspaces/*/kernels/*/tasks/*.

Responses

Response samples

Content type
application/json
{
  • "kernelTask": {
    }
}

Cancels a KernelTask. Enqueued task will be skipped. Running task will be cancelled.

path Parameters
name
required
stringworkspaces/[^/]+/kernels/[^/]+/tasks/[^/]+

Required. The name of the KernelTask to cancel. Format is workspaces/*/kernels/*/tasks/*.

Request Body schema: application/json
object

Request message for CancelKernelTask.

Responses

Request samples

Content type
application/json
{ }

Response samples

Content type
application/json
{ }

Returns a collection of KernelTasks assigned to a Kernel.

path Parameters
parent
required
stringworkspaces/[^/]+/kernels/[^/]+

Required. The resource name of the Kernel to list KernelTasks from. Format is workspaces/*/kernels/*.

query Parameters
pageSize
integer <int32>

Optional. Maximum number of KernelTasks to return in a response. If unspecified (or set to 0), at most 50 KernelTasks will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

pageToken
string

Optional. Leave unset to receive the initial page. To list any subsequent pages use the value of 'next_page_token' returned from the ListKernelTasksResponse.

Responses

Response samples

Content type
application/json
{
  • "kernelTasks": [
    ],
  • "nextPageToken": "string"
}

Creates a new KernelTask and assign it to a Kernel.

path Parameters
parent
required
stringworkspaces/[^/]+/kernels/[^/]+

Required. The resource name of the Kernel to create the KernelTask in. Format is workspaces/*/kernels/*.

query Parameters
kernelTaskId
string

Optional. Specify the KernelTask ID, which will become a part of the KernelTask resource name. If not specified, the server will generate one.

It must:

  • contain 1-63 characters
  • contain only lowercase alphanumeric characters or hyphen ('-')
  • start with an alphabetic character
  • end with an alphanumeric character

This matches a regular expression: ^a-z?$

Request Body schema: application/json

Required. The KernelTask resource to create.

code
required
string

Required. Immutable. The code to be executed by the Kernel.

state
string (v1KernelTaskState)
Default: "STATE_UNSPECIFIED"
Enum: "STATE_UNSPECIFIED" "STATE_QUEUED" "STATE_EXECUTING" "STATE_COMPLETE_ERROR" "STATE_COMPLETE_SUCCESS" "STATE_CANCELLED"

KernelTask states.

  • STATE_UNSPECIFIED: KernelTask state is unspecified or unknown.
  • STATE_QUEUED: KernelTask is waiting on execution.
  • STATE_EXECUTING: KernelTask is being executed by the Kernel.
  • STATE_COMPLETE_ERROR: KernelTask has completed with an error.
  • STATE_COMPLETE_SUCCESS: KernelTask has completed successfully.
  • STATE_CANCELLED: KernelTask has been cancelled.

Responses

Request samples

Content type
application/json
{
  • "code": "string",
  • "state": "STATE_UNSPECIFIED"
}

Response samples

Content type
application/json
{
  • "kernelTask": {
    }
}

KernelTemplateService

Deletes a KernelTemplate.

path Parameters
name_2
required
stringworkspaces/[^/]+/kernelTemplates/[^/]+

Required. KernelTemplate resource name. Format is workspaces/*/kernelTemplates/*.

Responses

Response samples

Content type
application/json
{ }

Returns a specific KernelTemplate.

path Parameters
name_4
required
stringworkspaces/[^/]+/kernelTemplates/[^/]+

Required. The name of the KernelTemplate to retrieve. Format is workspaces/*/kernelTemplates/*.

Responses

Response samples

Content type
application/json
{
  • "kernelTemplate": {
    }
}

Returns a collection of KernelTemplates.

path Parameters
parent
required
stringworkspaces/[^/]+

Required. The resource name of the workspace to associate with the KernelTemplate. Format is workspaces/*.

query Parameters
pageSize
integer <int32>

Optional. Maximum number of KernelTemplates to return in a response. If unspecified (or set to 0), at most 50 KernelTemplates will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

pageToken
string

Optional. Leave unset to receive the initial page. To list any subsequent pages use the value of 'next_page_token' returned from the ListKernelTemplatesResponse.

Responses

Response samples

Content type
application/json
{
  • "kernelTemplates": [
    ],
  • "nextPageToken": "string"
}

Creates a new KernelTemplate.

path Parameters
parent
required
stringworkspaces/[^/]+

Required. The resource name of the workspace to associate with the KernelTemplate. Format is workspaces/*.

query Parameters
kernelTemplateId
string

Optional. Specify the KernelTemplate ID, which will become a part of the KernelTemplate resource name. If not specified, the server will generate one.

It must:

  • contain 1-63 characters
  • contain only lowercase alphanumeric characters or hyphen ('-')
  • start with an alphabetic character
  • end with an alphanumeric character

This matches a regular expression: ^a-z?$

Request Body schema: application/json

Required. The KernelTemplate resource to create.

milliCpuRequest
integer <int32>

Optional. MilliCPU units that will be reserved for the Kernel. Kernel may use more CPU resources up to the millicpu_limit. It is recommended to set CPU requests to avoid resource contention. 1000 milliCPU = 1 CPU core.

When unset, milli_cpu_request will be set to milli_cpu_limit.

milliCpuLimit
integer <int32>

Optional. Maximum MilliCPU units a kernel is allowed to use. The Kernel will be throttled to not exceed this limit. It is discouraged to set CPU limits when possible. 1000 milliCPU = 1 CPU core.

gpuResource
string

Optional. Kubernetes GPU resource name. For example: nvidia.com/gpu or amd.com/gpu. When unset, server will choose a default value.

gpu
required
integer <int32>

Required. The amount of GPU units requested by this DAIEngine.

memoryBytesRequest
string <int64>

Optional. Memory in bytes that will be reserved for the Kernel.

When unset, memory_bytes_request will be set to memory_bytes_limit.

memoryBytesLimit
required
string <int64>

Required. Max memory in bytes a kernel is allowed to use. Kernel may fail or be terminated if it exceeds this limit.

storageBytes
string <int64>

Optional. External ephemeral storage in bytes that will be mounted to the /home/jovyan/workspace directory of the Kernel. When unset, the node disk will be used.

storageClassName
string

Optional. Kubernetes storage class name for the ephemeral storage. Defaults to the default storage class of the Kubernetes cluster.

object

Optional. Map of environmental variables that will be set in the Kernel.

yamlPodTemplateSpec
string (Optional. YAML representation of custom PodTemplateSpec serialized into bytes. Definition of PodTemplateSpec: https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.27/#podtemplatespec-v1-core)

When specified, then it is applied for Kernel pod. PodTemplateSpec describes what will be applied on top of a regular Kernel pod before it is created. This template is merged using StrategicMergePatch method (it overrides the default Kernel pod). More info about StrategicMergePatch: https://kubernetes.io/docs/tasks/manage-kubernetes-objects/update-api-object-kubectl-patch/

Example YAML value (custom annotation applied on Kernel pod): metadata: annotations: custom-key: custom-value

The YAML can be templated using Go template syntax. Currently supported values are:

  • {{.Creator}} - Name of an entity that created the Kernel. Usually in the format of users/{user_id}.
  • {{.CreatorID}} - ID of an entity that created the Kernel.
  • {{.CreatorDisplayName}} - Human-readable name of creator.
disabled
boolean

Optional. Whether the KernelTemplate is disabled. Disabled KernelTemplates cannot not be used for creating new Kernels.

maxIdleDuration
required
string

Required. Maximum time a Kernel can be idle before it is automatically shutdown.

Responses

Request samples

Content type
application/json
{
  • "milliCpuRequest": 0,
  • "milliCpuLimit": 0,
  • "gpuResource": "string",
  • "gpu": 0,
  • "memoryBytesRequest": "string",
  • "memoryBytesLimit": "string",
  • "storageBytes": "string",
  • "storageClassName": "string",
  • "environmentalVariables": {
    },
  • "yamlPodTemplateSpec": "string",
  • "disabled": true,
  • "maxIdleDuration": "string"
}

Response samples

Content type
application/json
{
  • "kernelTemplate": {
    }
}

NotebookKernelSpecService

Deletes a NotebookKernelSpec.

path Parameters
name_3
required
stringworkspaces/[^/]+/notebookKernelSpecs/[^/]+

Required. NotebookKernelSpec resource name. Format is workspaces/*/notebookKernelSpecs/*.

Responses

Response samples

Content type
application/json
{ }

Returns a specific NotebookKernelSpec.

path Parameters
name_5
required
stringworkspaces/[^/]+/notebookKernelSpecs/[^/]+

Required. The name of the NotebookKernelSpec to retrieve. Format is workspaces/*/notebookKernelSpecs/*.

Responses

Response samples

Content type
application/json
{
  • "notebookKernelSpec": {
    }
}

Updates a NotebookKernelSpec.

path Parameters
notebookKernelSpec.name
required
stringworkspaces/[^/]+/notebookKernelSpecs/[^/]+

Output only. Resource name. Format is workspaces/*/notebookKernelSpecs/*.

query Parameters
updateMask
required
string

Required. The list of paths referencing which fields to update. Update mask must be non-empty.

Allowed field paths are:

  • display_name
  • kernel_image
  • kernel_template
  • disabled Paths are case sensitive (must match exactly).

To update all allowed fields, specify exactly one path with value "*".

Request Body schema: application/json

Required. NotebookKernelSpec resource.

displayName
string

Optional. Human-readable name.

kernelImage
required
string

Required. The resource name of the KernelImage which will be used to create Notebook Lab Kernels. Format is workspaces/*/kernelImages/*.

kernelTemplate
required
string

Required. The resource name of the KernelTemplate which will be used to create Notebook Lab Kernels. Format is workspaces/*/kernelTemplates/*.

disabled
boolean

Optional. Whether the NotebookKernelSpec is disabled. Disabled NotebookKernelSpecs are not available in H2O Notebook Lab.

Responses

Request samples

Content type
application/json
{
  • "displayName": "string",
  • "kernelImage": "string",
  • "kernelTemplate": "string",
  • "disabled": true
}

Response samples

Content type
application/json
{
  • "notebookKernelSpec": {
    }
}

Returns a collection of NotebookKernelSpecs.

path Parameters
parent
required
stringworkspaces/[^/]+

Required. The resource name of the workspace to associate with the NotebookKernelSpec. Format is workspaces/*.

query Parameters
pageSize
integer <int32>

Optional. Maximum number of NotebookKernelSpecs to return in a response. If unspecified (or set to 0), at most 50 NotebookKernelSpecs will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.

pageToken
string

Optional. Leave unset to receive the initial page. To list any subsequent pages use the value of 'next_page_token' returned from the ListNotebookKernelSpecsResponse.

Responses

Response samples

Content type
application/json
{
  • "notebookKernelSpecs": [
    ],
  • "nextPageToken": "string"
}

Creates a new NotebookKernelSpec.

path Parameters
parent
required
stringworkspaces/[^/]+

Required. The resource name of the workspace to associate with the NotebookKernelSpec. Format is workspaces/*.

query Parameters
notebookKernelSpecId
string

Optional. Specify the NotebookKernelSpec ID, which will become a part of the NotebookKernelSpec resource name. If not specified, the server will generate one.

It must:

  • contain 1-63 characters
  • contain only lowercase alphanumeric characters or hyphen ('-')
  • start with an alphabetic character
  • end with an alphanumeric character

This matches a regular expression: ^a-z?$

Request Body schema: application/json

Required. The NotebookKernelSpec resource to create.

displayName
string

Optional. Human-readable name.

kernelImage
required
string

Required. The resource name of the KernelImage which will be used to create Notebook Lab Kernels. Format is workspaces/*/kernelImages/*.

kernelTemplate
required
string

Required. The resource name of the KernelTemplate which will be used to create Notebook Lab Kernels. Format is workspaces/*/kernelTemplates/*.

disabled
boolean

Optional. Whether the NotebookKernelSpec is disabled. Disabled NotebookKernelSpecs are not available in H2O Notebook Lab.

Responses

Request samples

Content type
application/json
{
  • "displayName": "string",
  • "kernelImage": "string",
  • "kernelTemplate": "string",
  • "disabled": true
}

Response samples

Content type
application/json
{
  • "notebookKernelSpec": {
    }
}