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>]

必要

服務用戶端，可讓使用者在 Azure Machine Learning 工作區資源上運作， (ServiceClient042023Preview 或 ServiceClient102021Dataplane) 。

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

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