UNunitycatalog
ModelVersions

Create a model version.

Changed on

Creates a new model version instance.

post/models/versions

Request

  • Base URL
    http://localhost:8080/api/2.1/unity-catalog
  • Auth
    none declared

Request body

model_namestring required

Name of registered model, relative to parent schema.

catalog_namestring required

Name of parent catalog.

schema_namestring required

Name of parent schema relative to its parent catalog.

sourcestring required

URI indicating the location of the source model artifacts.

run_idstring

The run id used by the ML package that generated the model.

commentstring

User-provided free-form text description.

Response

The new model version was successfully created.

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

versioninteger

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

sourcestring

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

run_idstring

The run id used by the ML package that generated the model.

status'MODEL_VERSION_STATUS_UNKNOWN' | 'PENDING_REGISTRATION' | 'FAILED_REGISTRATION' | 'READY'

All possible model version statuses.

storage_locationstring

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

commentstring

The comment attached to the model version

created_atinteger

Time at which this model version was created, in epoch milliseconds.

created_bystring

The identifier of the user who created the model version

updated_atinteger

Time at which this model version was last modified, in epoch milliseconds.

updated_bystring

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

idstring

Unique identifier for the model version.

Changes

  • 636264d287b0Revision changes
    • breaking

      the request property became required

  • 2dd9fd4253e0Revision changes
    • warning

      removed the optional property from the response with the status

    • info

      added the optional property to the response with the status