Skip to main content

Module clients.notebook_engine.client

Classes

NotebookEngineClient

class NotebookEngineClient(connection_config: h2o_engine_manager.clients.connection_config.ConnectionConfig, verify_ssl: bool = True, ssl_ca_cert: Optional[str] = None)

NotebookEngineClient manages NotebookEngines.

Args
connection_config
AIEM connection configuration object.
verify_ssl
Set to False to disable SSL certificate verification.
ssl_ca_cert
Path to a CA cert bundle with certificates of trusted CAs.

Methods

access_notebook_engine

def access_notebook_engine(self, name: str) ‑> str

Returns the notebook engine access URI.

Args
name
NotebookEngine resource name. Format: "workspaces//notebookEngines/"

Returns: The notebook engine access URI

create_notebook_engine

def create_notebook_engine(self, parent: str, notebook_engine: h2o_engine_manager.clients.notebook_engine.engine.NotebookEngine, notebook_engine_id: str) ‑> h2o_engine_manager.clients.notebook_engine.engine.NotebookEngine

Create notebook engine.

Args
parent : str
Name of the engine's parent workspace. Format: "workspaces/*".
notebook_engine : NotebookEngine
NotebookEngine to create.
notebook_engine_id : str
The ID to use for the NotebookEngine, which will form the engine's resource name. This value must: - contain 1-63 characters - contain only lowercase alphanumeric characters or hyphen ('-') - start with an alphabetic character - end with an alphanumeric character
Returns
NotebookEngine
created NotebookEngine.

delete_notebook_engine

def delete_notebook_engine(self, name: str) ‑> None

Start notebook engine deletion. Method returns instantly, but it may take some time until the engine is deleted.

Args
name
NotebookEngine resource name. Format: "workspaces//notebookEngines/"

get_notebook_engine

def get_notebook_engine(self, name: str) ‑> h2o_engine_manager.clients.notebook_engine.engine.NotebookEngine

Get notebook engine.

Args
name
NotebookEngine resource name. Format: "workspaces//notebookEngines/"
Returns
NotebookEngine
notebook engine

list_all_notebook_engines

def list_all_notebook_engines(self, parent: str) ‑> List[h2o_engine_manager.clients.notebook_engine.engine.NotebookEngine]

Help method for listing all NotebookEngines.

Args
parent : str
Name of the workspace from which to list notebookEngines. Format: workspaces/*.

list_notebook_engines

def list_notebook_engines(self, parent: str, page_size: int = 0, page_token: str = '') ‑> h2o_engine_manager.clients.notebook_engine.page.NotebookEnginesPage

Standard list method.

Args
parent : str
Name of the workspace from which to list notebookEngines. Format: workspaces/*.
page_size : int
Maximum number of NotebookEngines to return in a response. If unspecified (or set to 0), at most 50 NotebookEngines will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
page_token : str
Page token. Leave unset to receive the initial page. To list any subsequent pages use the value of 'next_page_token' returned from the NotebookEnginesPage.
Returns
NotebookEnginesPage
NotebookEnginesPage object.

pause_notebook_engine

def pause_notebook_engine(self, name: str) ‑> h2o_engine_manager.clients.notebook_engine.engine.NotebookEngine

Pause notebook engine. Method returns instantly, but it may take some time until the engine is paused.

Args
name
NotebookEngine resource name. Format: "workspaces//notebookEngines/"

Returns: paused notebookEngine

resume_notebook_engine

def resume_notebook_engine(self, name: str) ‑> h2o_engine_manager.clients.notebook_engine.engine.NotebookEngine

Resume notebook engine. Method returns instantly, but it may take some time until the engine is running.

Args
name
NotebookEngine resource name. Format: "workspaces//notebookEngines/"

Returns: resumed notebookEngine

update_notebook_engine

def update_notebook_engine(self, notebook_engine: h2o_engine_manager.clients.notebook_engine.engine.NotebookEngine, update_mask: str = '*') ‑> h2o_engine_manager.clients.notebook_engine.engine.NotebookEngine

Standard Update method.

Args
notebook_engine : NotebookEngine
notebookEngine to update.
update_mask : str
The field mask to use for the update. Allowed field paths are: - profile - notebook_image - cpu - gpu - memory_bytes - display_name - max_idle_duration - max_running_duration Default value "*" will update all updatable fields.
Returns
NotebookEngine
Updated NotebookEngine.

wait

def wait(self, name: str, timeout_seconds: Optional[float] = None) ‑> Optional[h2o_engine_manager.clients.notebook_engine.engine.NotebookEngine]

Blocks execution until the notebookEngine with the given name is in the process of reconciling or until it is no longer found.

Args
name
NotebookEngine resource name for which to wait. Format: "workspaces//notebookEngines/"
timeout_seconds
Time limit in seconds for how long to wait.

Returns: engine that has finished waiting or nothing, if engine is no longer found.


Feedback