你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

ModelOperations 类

  • 参考

ModelOperations。

不应直接实例化此类。 相反，应创建一个 MLClient 实例来实例化它，并将其作为属性附加。

继承
azure.ai.ml._scope_dependent_operations._ScopeDependentOperations
ModelOperations

构造函数

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

参数

operation_scope
<xref:azure.ai.ml._scope_dependent_operations.OperationScope>
必需

MLClient 对象的操作类的范围变量。

operation_config
<xref:azure.ai.ml._scope_dependent_operations.OperationConfig>
必需

MLClient 对象的操作类的常见配置。

service_client
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>]
必需

服务客户端允许最终用户 (ServiceClient042023Preview 或 ServiceClient102021Dataplane) 对 Azure 机器学习工作区资源进行操作。

datastore_operations
DatastoreOperations
必需

表示用于对数据存储执行操作的客户端。

all_operations
<xref:azure.ai.ml._scope_dependent_operations.OperationsContainer>
默认值: None

MLClient 对象的所有操作类。

方法

archive

存档模型资产。
create_or_update

返回创建或更新的模型资产。
download

下载与模型相关的文件。
get

返回有关指定模型资产的信息。
list

列出工作区中的所有模型资产。
package

注意

这是一个实验性的方法，可能会在任何时候更改。 有关详细信息，请参阅 https://aka.ms/azuremlexperimental。

打包模型资产
restore

还原存档的模型资产。
share

注意

这是一个实验性的方法，可能会在任何时候更改。 有关详细信息，请参阅 https://aka.ms/azuremlexperimental。

将模型资产从工作区共享到注册表。

archive

存档模型资产。

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

参数

name
str
必需

模型资产的名称。

version
str
必需

模型资产的版本。

label
str
必需

模型资产的标签。 (版本) 互斥

create_or_update

返回创建或更新的模型资产。

create_or_update(model: Model | WorkspaceAssetReference) -> Model

参数

model
Model
必需

模型资产对象。

返回

模型资产对象。

返回类型

Model

例外

AssetPathException

当模型项目路径已链接到另一个资产时引发

ValidationException

如果无法成功验证 Model，则引发。 错误消息中将提供详细信息。

EmptyDirectoryError

如果提供的本地路径指向空目录，则引发。

download

下载与模型相关的文件。

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

参数

name
str
必需

模型的名称。

version
str
必需

模型的版本。

download_path
Union[<xref:PathLike>, str]
必需

本地路径作为下载目标，默认为当前用户的工作目录。 内容将被覆盖。

例外

ResourceNotFoundError

如果找不到与所提供的名称匹配的模型，则为 。

get

返回有关指定模型资产的信息。

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

参数

name
str
必需

模型的名称。

version
str
必需

模型的版本。

label
str
必需

模型的标签。 (版本) 互斥

返回

模型资产对象。

返回类型

Model

例外

ValidationException

如果无法成功验证 Model，则引发。 错误消息中将提供详细信息。

list

列出工作区中的所有模型资产。

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

参数

name
Optional[str]
必需

模型的名称。

stage
Optional[str]
必需

模型阶段

list_view_type

包括/排除 (的视图类型，例如) 存档的模型。 默认为 <xref:ListViewType.ACTIVE_ONLY>。

返回

一个迭代器，例如 Model 对象的实例

返回类型

ItemPaged[Model]

package

注意

这是一个实验性的方法，可能会在任何时候更改。 有关详细信息，请参阅 https://aka.ms/azuremlexperimental。

打包模型资产

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

参数

name
str
必需

模型资产的名称。

version
str
必需

模型资产的版本。

package_request
ModelPackage
必需

模型包请求。

返回

Environment 对象

返回类型

Environment

restore

还原存档的模型资产。

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

参数

name
str
必需

模型资产的名称。

version
str
必需

模型资产的版本。

label
str
必需

模型资产的标签。 (版本) 互斥

share

注意

这是一个实验性的方法，可能会在任何时候更改。 有关详细信息，请参阅 https://aka.ms/azuremlexperimental。

将模型资产从工作区共享到注册表。

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

参数

name
str
必需

模型资产的名称。

version
str
必需

模型资产的版本。

share_with_name
str

要与之共享的模型资产的名称。

share_with_version
str

要与之共享的模型资产的版本。

registry_name
str

目标注册表的名称。

返回

模型资产对象。

返回类型

Model