Dela via

ModelOperations Class

ModelOperations.

You should not instantiate this class directly. Instead, you should create an MLClient instance that instantiates it for you and attaches it as an attribute.

Constructor

ModelOperations(operation_scope: OperationScope, operation_config: OperationConfig, service_client: AzureMachineLearningWorkspaces | AzureMachineLearningWorkspaces, datastore_operations: DatastoreOperations, service_client_model_dataplane: AzureMachineLearningWorkspaces = None, all_operations: OperationsContainer | None = None, **kwargs)

Parameters

Name Description
operation_scope
Required
<xref:azure.ai.ml._scope_dependent_operations.OperationScope>

Scope variables for the operations classes of an MLClient object.
operation_config
Required
<xref:azure.ai.ml._scope_dependent_operations.OperationConfig>

Common configuration for operations classes of an MLClient object.
service_client
Required
Union[ <xref:azure.ai.ml._restclient.v2023_04_01_preview._azure_machine_learning_workspaces.AzureMachineLearningWorkspaces>, <xref:azure.ai.ml._restclient.v2021_10_01_dataplanepreview._azure_machine_learning_workspaces. AzureMachineLearningWorkspaces>]

Service client to allow end users to operate on Azure Machine Learning Workspace resources (ServiceClient082023Preview or ServiceClient102021Dataplane).
datastore_operations
Required
DatastoreOperations

Represents a client for performing operations on Datastores.
all_operations
<xref:azure.ai.ml._scope_dependent_operations.OperationsContainer>

All operations classes of an MLClient object.

Default value: None
service_client_model_dataplane
Default value: None

Methods

archive

Archive a model asset.
create_or_update

Returns created or updated model asset.
download

Download files related to a model.
get

Returns information about the specified model asset.
list

List all model assets in workspace.
package

Note

This is an experimental method, and may change at any time. Please see https://aka.ms/azuremlexperimental for more information.

Package a model asset
restore

Restore an archived model asset.
share

Note

This is an experimental method, and may change at any time. Please see https://aka.ms/azuremlexperimental for more information.

Share a model asset from workspace to registry.

archive

Archive a model asset.

archive(name: str, version: str | None = None, label: str | None = None, **kwargs: Any) -> None

Parameters

Name Description
name
Required
str

Name of model asset.
version
str

Version of model asset.

Default value: None
label
str

Label of the model asset. (mutually exclusive with version)

Default value: None

Examples

Archive a model.


   ml_client.models.archive(name="model1", version="5")

create_or_update

Returns created or updated model asset.

create_or_update(model: Model | WorkspaceAssetReference) -> Model

Parameters

Name Description
model
Required
Model

Model asset object.

Returns

Type Description
Model

Model asset object.

Exceptions

Type Description
AssetPathException

Raised when the Model artifact path is already linked to another asset
ValidationException

Raised if Model cannot be successfully validated. Details will be provided in the error message.
EmptyDirectoryError

Raised if local path provided points to an empty directory.

download

Download files related to a model.

download(name: str, version: str, download_path: PathLike | str = '.') -> None

Parameters

Name Description
name
Required
str

Name of the model.
version
Required
str

Version of the model.
download_path
Union[<xref:PathLike>, str]

Local path as download destination, defaults to current working directory of the current user. Contents will be overwritten.

Default value: .

Exceptions

Type Description
ResourceNotFoundError

if can't find a model matching provided name.

get

Returns information about the specified model asset.

get(name: str, version: str | None = None, label: str | None = None) -> Model

Parameters

Name Description
name
Required
str

Name of the model.
version
str

Version of the model.

Default value: None
label
str

Label of the model. (mutually exclusive with version)

Default value: None

Returns

Type Description
Model

Model asset object.

Exceptions

Type Description
ValidationException

Raised if Model cannot be successfully validated. Details will be provided in the error message.

list

List all model assets in workspace.

list(name: str | None = None, stage: str | None = None, *, list_view_type: ListViewType = ListViewType.ACTIVE_ONLY) -> Iterable[Model]

Parameters

Name Description
name
Optional[str]

Name of the model.

Default value: None
stage
Optional[str]

The Model stage

Default value: None

Keyword-Only Parameters

Name Description
list_view_type
ListViewType

View type for including/excluding (for example) archived models. Defaults to <xref:ListViewType.ACTIVE_ONLY>.

Default value: ListViewType.ACTIVE_ONLY

Returns

Type Description
ItemPaged[Model]

An iterator like instance of Model objects

package

Note

This is an experimental method, and may change at any time. Please see https://aka.ms/azuremlexperimental for more information.

Package a model asset

package(name: str, version: str, package_request: ModelPackage, **kwargs: Any) -> Environment

Parameters

Name Description
name
Required
str

Name of model asset.
version
Required
str

Version of model asset.
package_request
Required
ModelPackage

Model package request.

Returns

Type Description
Environment

Environment object

restore

Restore an archived model asset.

restore(name: str, version: str | None = None, label: str | None = None, **kwargs: Any) -> None

Parameters

Name Description
name
Required
str

Name of model asset.
version
str

Version of model asset.

Default value: None
label
str

Label of the model asset. (mutually exclusive with version)

Default value: None

Examples

Restore an archived model.


   ml_client.models.restore(name="model1", version="5")

share

Note

This is an experimental method, and may change at any time. Please see https://aka.ms/azuremlexperimental for more information.

Share a model asset from workspace to registry.

share(name: str, version: str, *, share_with_name: str, share_with_version: str, registry_name: str) -> Model

Parameters

Name Description
name
Required
str

Name of model asset.
version
Required
str

Version of model asset.

Keyword-Only Parameters

Name Description
share_with_name
str

Name of model asset to share with.
share_with_version
str

Version of model asset to share with.
registry_name
str

Name of the destination registry.

Returns

Type Description
Model

Model asset object.