com.databricks.sdk.service.catalog

Interface ModelVersionsService

@Generated
public interface ModelVersionsService

Databricks provides a hosted version of MLflow Model Registry in Unity Catalog. Models in Unity Catalog provide centralized access control, auditing, lineage, and discovery of ML models across Databricks workspaces.

This API reference documents the REST endpoints for managing model versions in Unity Catalog. For more details, see the [registered models API docs](/api/workspace/registeredmodels).

This is the high-level interface, that contains generated methods.

Evolving: this interface is under development. Method signatures may change.

Method Summary

Modifier and Type	Method and Description
void	delete(DeleteModelVersionRequest deleteModelVersionRequest) Delete a Model Version.
RegisteredModelInfo	get(GetModelVersionRequest getModelVersionRequest) Get a Model Version.
ModelVersionInfo	getByAlias(GetByAliasRequest getByAliasRequest) Get Model Version By Alias.
ListModelVersionsResponse	list(ListModelVersionsRequest listModelVersionsRequest) List Model Versions.
ModelVersionInfo	update(UpdateModelVersionRequest updateModelVersionRequest) Update a Model Version.

Method Detail

delete

void delete(DeleteModelVersionRequest deleteModelVersionRequest)

Delete a Model Version.

Deletes a model version from the specified registered model. Any aliases assigned to the model version will also be deleted.

The caller must be a metastore admin or an owner of the parent registered model. For the latter case, the caller must also be the owner or have the **USE_CATALOG** privilege on the parent catalog and the **USE_SCHEMA** privilege on the parent schema.

get

RegisteredModelInfo get(GetModelVersionRequest getModelVersionRequest)

Get a Model Version.

Get a model version.

The caller must be a metastore admin or an owner of (or have the **EXECUTE** privilege on) the parent registered model. For the latter case, the caller must also be the owner or have the **USE_CATALOG** privilege on the parent catalog and the **USE_SCHEMA** privilege on the parent schema.

getByAlias

ModelVersionInfo getByAlias(GetByAliasRequest getByAliasRequest)

Get Model Version By Alias.

Get a model version by alias.

The caller must be a metastore admin or an owner of (or have the **EXECUTE** privilege on) the registered model. For the latter case, the caller must also be the owner or have the **USE_CATALOG** privilege on the parent catalog and the **USE_SCHEMA** privilege on the parent schema.

list

ListModelVersionsResponse list(ListModelVersionsRequest listModelVersionsRequest)

List Model Versions.

List model versions. You can list model versions under a particular schema, or list all model versions in the current metastore.

The returned models are filtered based on the privileges of the calling user. For example, the metastore admin is able to list all the model versions. A regular user needs to be the owner or have the **EXECUTE** privilege on the parent registered model to recieve the model versions in the response. For the latter case, the caller must also be the owner or have the **USE_CATALOG** privilege on the parent catalog and the **USE_SCHEMA** privilege on the parent schema.

There is no guarantee of a specific ordering of the elements in the response.

update

ModelVersionInfo update(UpdateModelVersionRequest updateModelVersionRequest)

Update a Model Version.

Updates the specified model version.

The caller must be a metastore admin or an owner of the parent registered model. For the latter case, the caller must also be the owner or have the **USE_CATALOG** privilege on the parent catalog and the **USE_SCHEMA** privilege on the parent schema.

Currently only the comment of the model version can be updated.