Model Alias

View as Markdown

UpdatePUT /api/2.1/unity-catalog/models/{full_name_arg}/aliases/{alias_arg}DeleteDELETE /api/2.1/unity-catalog/models/{full_name_arg}/aliases/{alias_arg}

ModelVersionInfo object

model_namestring

The name of the parent registered model of the model version, relative to parent schema

catalog_namestring

The name of the catalog containing the model version

schema_namestring

The name of the schema containing the model version, relative to parent catalog

sourcestring

URI indicating the location of the source artifacts (files) for the model version

commentstring

The comment attached to the model version

Constraints: [ 1 .. 65536 ] characters

run_idstring

MLflow run ID used when creating the model version, if source was generated by an experiment run stored in an MLflow tracking server

run_workspace_idint64

ID of the <Databricks> workspace containing the MLflow run that generated this model version, if applicable

model_version_dependenciesobject

Model version dependencies, for feature-store packaged models

Show child attributesHide child attributes

dependenciesarray of object

Array of dependencies.

Show child attributesHide child attributes

tableobject

Show child attributesHide child attributes

table_full_namestring

Full name of the dependent table, in the form of catalog_name.schema_name.table_name.

functionobject

Show child attributesHide child attributes

function_full_namestring

Full name of the dependent function, in the form of catalog_name.schema_name.function_name.

connectionobject

Show child attributesHide child attributes

connection_namestring

Full name of the dependent connection, in the form of connection_name.

credentialobject

Show child attributesHide child attributes

credential_namestring

Full name of the dependent credential, in the form of credential_name.

statusstring

Current status of the model version. Newly created model versions start in PENDING_REGISTRATION status, then move to READY status once the model version files are uploaded and the model version is finalized. Only model versions in READY status can be loaded for inference or served.

Values: MODEL_VERSION_STATUS_UNKNOWN, PENDING_REGISTRATION, FAILED_REGISTRATION, READY

versionint64

Integer model version number, used to reference the model version in API requests.

storage_locationstring

The storage location on the cloud under which model version data files are stored

metastore_idstring

The unique identifier of the metastore containing the model version

created_atint64

created_bystring

The identifier of the user who created the model version

updated_atint64

updated_bystring

The identifier of the user who updated the model version last time

idstring

The unique identifier of the model version

aliasesarray of object

List of aliases associated with the model version

Show child attributesHide child attributes

alias_namestring

Name of the alias, e.g. 'champion' or 'latest_stable'

version_numint64

Integer version number of the model version to which this alias points.

idstring

The unique identifier of the alias

model_namestring

The name of the parent registered model of the model version, relative to parent schema

catalog_namestring

The name of the catalog containing the model version

schema_namestring

The name of the schema containing the model version, relative to parent catalog

View as Markdown

The ModelVersionInfo object

{
  "model_name": "string",
  "catalog_name": "string",
  "schema_name": "string",
  "source": "string",
  "comment": "string",
  "run_id": "string",
  "run_workspace_id": 0,
  "model_version_dependencies": {
    "dependencies": [
      {}
    ]
  },
  "status": "string",
  "version": 0,
  "storage_location": "string",
  "metastore_id": "string",
  "created_at": 0,
  "created_by": "string",
  "updated_at": 0,
  "updated_by": "string",
  "id": "string",
  "aliases": [
    {
      "alias_name": "string",
      "version_num": 0,
      "id": "string",
      "model_name": "string",
      "catalog_name": "string",
      "schema_name": "string"
    }
  ]
}

Update GA

PUT /api/2.1/unity-catalog/models/{full_name_arg}/aliases/{alias_arg}

Set an alias on the specified registered model.

The caller must be a metastore admin or an owner of 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.

API scopes: unity-catalog

Parameters

full_name_argstringRequiredpath

The three-level (fully qualified) name of the registered model

alias_argstringRequiredpath

The name of the alias

Request body

version_numint64Required

The version number of the model version to which the alias points

Response

alias_namestring

Name of the alias, e.g. 'champion' or 'latest_stable'

version_numint64

Integer version number of the model version to which this alias points.

idstring

The unique identifier of the alias

model_namestring

The name of the parent registered model of the model version, relative to parent schema

catalog_namestring

The name of the catalog containing the model version

schema_namestring

The name of the schema containing the model version, relative to parent catalog

View as Markdown

Request

{
  "version_num": 0
}

Response

{
  "alias_name": "string",
  "version_num": 0,
  "id": "string",
  "model_name": "string",
  "catalog_name": "string",
  "schema_name": "string"
}

Delete GA

DELETE /api/2.1/unity-catalog/models/{full_name_arg}/aliases/{alias_arg}

Deletes a registered model alias.

The caller must be a metastore admin or an owner of 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.

API scopes: unity-catalog

Parameters

full_name_argstringRequiredpath

The three-level (fully qualified) name of the registered model

alias_argstringRequiredpath

The name of the alias

View as Markdown

Response

{}