MLClient Třída

Reference

Klientská třída pro interakci se službami Azure ML.

Pomocí tohoto klienta můžete spravovat prostředky Azure ML, jako jsou pracovní prostory, úlohy, modely atd.

Dědičnost: builtins.object

MLClient

Konstruktor

MLClient(credential: TokenCredential, subscription_id: str | None = None, resource_group_name: str | None = None, workspace_name: str | None = None, registry_name: str | None = None, **kwargs: Any)

Parametry

credential: TokenCredential

Vyžadováno

Přihlašovací údaje, které se mají použít pro ověřování.

subscription_id: Optional[str]

výchozí hodnota: None

ID předplatného Azure. Volitelné pouze pro prostředky registru. Výchozí hodnota je Žádná.

resource_group_name: Optional[str]

výchozí hodnota: None

Skupina prostředků Azure. Volitelné pouze pro prostředky registru. Výchozí hodnota je Žádná.

workspace_name: Optional[str]

výchozí hodnota: None

Pracovní prostor, který se má použít v klientovi. Volitelné pouze pro operace, které nejsou závislé na pracovním prostoru. Výchozí hodnota je Žádná.

registry_name: Optional[str]

výchozí hodnota: None

Registr, který se má použít v klientovi. Volitelné pouze pro operace, které nejsou závislé na pracovním prostoru. Výchozí hodnota je Žádná.

show_progress: Optional[bool]

Určuje, jestli se mají zobrazit indikátory průběhu pro dlouhotrvající operace (například zákazníci můžou zvážit nastavení na Hodnotu False, pokud tuto sadu SDK nepoužívají v interaktivním nastavení). Výchozí hodnota je Pravda.

enable_telemetry: Optional[bool]

Určuje, jestli se má povolit telemetrie. Pokud ne v Jupyter Notebook, přepíše se na False. Výchozí hodnota je True, pokud je v Jupyter Notebook.

cloud: Optional[str]

Název cloudu, který se má použít. Výchozí hodnota je AzureCloud.

Příklady

Při použití suverénních domén (tj. jakéhokoli jiného cloudu než AZURE_PUBLIC_CLOUD) musíte předat název cloudu v kwargs a musíte použít autoritu s DefaultAzureCredential.


   from azure.ai.ml import MLClient
   from azure.identity import AzureAuthorityHosts, DefaultAzureCredential

   kwargs = {"cloud": "AzureChinaCloud"}
   ml_client = MLClient(
       subscription_id=subscription_id,
       resource_group_name=resource_group,
       credential=DefaultAzureCredential(authority=AzureAuthorityHosts.AZURE_CHINA),
       **kwargs,
   )

Metody

begin_create_or_update

Vytvoří nebo aktualizuje prostředek Azure ML asynchronně.

create_or_update

Vytvoří nebo aktualizuje prostředek Azure ML.

from_config

Vrátí klienta z existujícího pracovního prostoru služby Azure Machine Learning pomocí konfigurace souboru.

Tato metoda poskytuje jednoduchý způsob opakovaného použití stejného pracovního prostoru v několika poznámkových blocích nebo projektech Pythonu. Vlastnosti Azure Resource Manager (ARM) pracovního prostoru můžete uložit do konfiguračního souboru JSON pomocí tohoto formátu:


   {
       "subscription_id": "<subscription-id>",
       "resource_group": "<resource-group>",
       "workspace_name": "<workspace-name>"
   }

Tuto metodu pak můžete použít k načtení stejného pracovního prostoru v různých poznámkových blocích Nebo projektech Pythonu bez přepsání vlastností ARM pracovního prostoru.

begin_create_or_update

Vytvoří nebo aktualizuje prostředek Azure ML asynchronně.

begin_create_or_update(entity: R, **kwargs) -> LROPoller[R]

Parametry

entity: Union[Workspace , Registry, Compute, OnlineDeployment , OnlineEndpoint, BatchDeployment , BatchEndpoint, Schedule]

Vyžadováno

Prostředek, který chcete vytvořit nebo aktualizovat.

Návraty

Prostředek po operaci vytvoření/aktualizace.

Návratový typ

LROPoller[Union[Workspace , Registry, Compute, OnlineDeployment , OnlineEndpoint, BatchDeployment , BatchEndpoint, Schedule]]

create_or_update

Vytvoří nebo aktualizuje prostředek Azure ML.

create_or_update(entity: T, **kwargs) -> T

Parametry

entity: Union[Job , Model, Environment, Component , Datastore]

Vyžadováno

Prostředek, který chcete vytvořit nebo aktualizovat.

Návraty

Vytvořený nebo aktualizovaný prostředek.

Návratový typ

Union[Job, Model , Environment, Component, Datastore]

from_config

Vrátí klienta z existujícího pracovního prostoru služby Azure Machine Learning pomocí konfigurace souboru.


   {
       "subscription_id": "<subscription-id>",
       "resource_group": "<resource-group>",
       "workspace_name": "<workspace-name>"
   }

Tuto metodu pak můžete použít k načtení stejného pracovního prostoru v různých poznámkových blocích Nebo projektech Pythonu bez přepsání vlastností ARM pracovního prostoru.

from_config(credential: TokenCredential, *, path: PathLike | str | None = None, file_name=None, **kwargs) -> MLClient

Parametry

credential: TokenCredential

Vyžadováno

Objekt přihlašovacích údajů pro pracovní prostor.

path: Optional[Union[PathLike, str]]

Cesta ke konfiguračnímu souboru nebo počátečnímu adresáři, ve které chcete konfigurační soubor vyhledat. Výchozí hodnota je Žádná, což znamená, že se použije aktuální adresář.

file_name: Optional[str]

Název konfiguračního souboru, který se má vyhledat, když je cesta k adresáři. Výchozí hodnota je config.json.

cloud: Optional[str]

Název cloudu, který se má použít. Výchozí hodnota je AzureCloud.

Návraty

Klient existujícího pracovního prostoru Azure ML.

Návratový typ

MLClient

Výjimky

ValidationException

Vyvolána, pokud soubor config.json nebo file_name, pokud je přepsán, nelze v adresáři najít. Podrobnosti budou uvedeny v chybové zprávě.

Příklady

Vytvoření MLClient ze souboru s názvem "config.json" v adresáři "src".


   from azure.ai.ml import MLClient

   client = MLClient.from_config(credential=DefaultAzureCredential(), path="./sdk/ml/azure-ai-ml/samples/src")

Vytvoření MLClient ze souboru s názvem "team_workspace_configuration.json" v aktuálním adresáři


   from azure.ai.ml import MLClient

   client = MLClient.from_config(
       credential=DefaultAzureCredential(),
       file_name="./sdk/ml/azure-ai-ml/samples/team_workspace_configuration.json",
   )

další informace aka.ms/azuremlexperimental.

Kolekce operací souvisejících se sadou funkcí.

Návraty

Operace FeatureSet

Návratový typ

FeatureSetOperations

feature_store_entities

další informace aka.ms/azuremlexperimental.

Kolekce operací souvisejících s entitou úložiště funkcí

Návraty

Operace FeatureStoreEntity

Návratový typ

FeatureStoreEntityOperations

feature_stores

registries

workspace_hubs

R

R = ~R

T

T = ~T