Model Class

Model for training and scoring.

Inheritance

azure.ai.ml.entities._assets._artifacts.artifact.Artifact

Model

Constructor

Model(*, name: str | None = None, version: str | None = None, type: str | None = None, path: str | PathLike | None = None, utc_time_created: str | None = None, flavors: Dict[str, Dict[str, Any]] | None = None, description: str | None = None, tags: Dict | None = None, properties: Dict | None = None, stage: str | None = None, **kwargs: Any)

Parameters

Name	Description
name Required	Optional[str] The name of the model. Defaults to a random GUID.
version Required	Optional[str] The version of the model. Defaults to "1" if either no name or an unregistered name is provided. Otherwise, defaults to autoincrement from the last registered version of the model with that name.
type Required	Optional[str] The storage format for this entity, used for NCD (Novel Class Discovery). Accepted values are "custom_model", "mlflow_model", or "triton_model". Defaults to "custom_model".
utc_time_created Required	Optional[str] The date and time when the model was created, in UTC ISO 8601 format. (e.g. '2020-10-19 17:44:02.096572').
flavors Required	Optional[dict[str, Any]] The flavors in which the model can be interpreted. Defaults to None.
path Required	Optional[str] A remote uri or a local path pointing to a model. Defaults to None.
description Required	Optional[str] The description of the resource. Defaults to None
tags Required	Optional[dict[str, str]] Tag dictionary. Tags can be added, removed, and updated. Defaults to None.
properties Required	Optional[dict[str, str]] The asset property dictionary. Defaults to None.
stage Required	Optional[str] The stage of the resource. Defaults to None.
kwargs Required	Optional[dict] A dictionary of additional configuration parameters.

Keyword-Only Parameters

Name	Description
name Required
version Required
type Required
path Required
utc_time_created Required
flavors Required
description Required
tags Required
properties Required
stage Required

Examples

Creating a Model object.

   from azure.ai.ml.entities import Model

   model = Model(
       name="model1",
       version="5",
       description="my first model in prod",
       path="models/very_important_model.pkl",
       properties={"prop1": "value1", "prop2": "value2"},
       type="mlflow_model",
       flavors={
           "sklearn": {"sklearn_version": "0.23.2"},
           "python_function": {"loader_module": "office.plrmodel", "python_version": 3.6},
       },
       stage="Production",
   )
   ml_client.models.create_or_update(model)

Methods

dump	Dump the asset content into a file in YAML format.

dump

Dump the asset content into a file in YAML format.

dump(dest: str | PathLike | IO, **kwargs: Any) -> None

Parameters

Name	Description
dest Required	Union[<xref:PathLike>, str, IO[AnyStr]] The local path or file stream to write the YAML content to. If dest is a file path, a new file will be created. If dest is an open file, the file will be written to directly.

Keyword-Only Parameters

Name	Description
kwargs	dict Additional arguments to pass to the YAML serializer.

Exceptions

Type	Description
FileExistsError	Raised if dest is a file path and the file already exists.
IOError	Raised if dest is an open file and the file is not writable.

Attributes

base_path

The base path of the resource.

Returns

Type	Description
str	The base path of the resource.

creation_context

The creation context of the resource.

Returns

Type	Description
Optional[SystemData]	The creation metadata for the resource.

id

The resource ID.

Returns

Type	Description
Optional[str]	The global ID of the resource, an Azure Resource Manager (ARM) ID.

path

version

The asset version.

Returns

Type	Description
str	The asset version.