EnvironmentOperations Třída

  • Reference

EnvironmentOperations.

Neměli byste vytvořit instanci této třídy přímo. Místo toho byste měli vytvořit instanci MLClient, která vytvoří instanci za vás a připojí ji jako atribut.

Dědičnost
azure.ai.ml._scope_dependent_operations._ScopeDependentOperations
EnvironmentOperations

Konstruktor

EnvironmentOperations(operation_scope: OperationScope, operation_config: OperationConfig, service_client: AzureMachineLearningWorkspaces | AzureMachineLearningWorkspaces, all_operations: OperationsContainer, **kwargs: Any)

Parametry

operation_scope
<xref:azure.ai.ml._scope_dependent_operations.OperationScope>
Vyžadováno

Proměnné oboru pro třídy operací objektu MLClient.

operation_config
<xref:azure.ai.ml._scope_dependent_operations.OperationConfig>
Vyžadováno

Běžná konfigurace pro třídy operací objektu 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>]
Vyžadováno

Klient služby umožňuje koncovým uživatelům pracovat s prostředky pracovního prostoru Azure Machine Learning (ServiceClient042023Preview nebo ServiceClient102021Dataplane).

all_operations
<xref:azure.ai.ml._scope_dependent_operations.OperationsContainer>
Vyžadováno

Všechny třídy operací objektu MLClient.

Metody

archive

Archivujte prostředí nebo verzi prostředí.
create_or_update

Vrátí vytvořený nebo aktualizovaný prostředek prostředí.
get

Vrátí zadaný prostředek prostředí.
list

Vypíše všechny prostředky prostředí v pracovním prostoru.
restore

Obnovte archivovanou verzi prostředí.
share

Poznámka

Jedná se o experimentální metodu, která se může kdykoli změnit. Další informace najdete tady: https://aka.ms/azuremlexperimental.

Sdílení prostředku prostředí z pracovního prostoru do registru

archive

Archivujte prostředí nebo verzi prostředí.

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

Parametry

name
str
Vyžadováno

Název prostředí

version
str
Vyžadováno

Verze prostředí.

label
str
Vyžadováno

Popisek prostředí. (vzájemně se vylučují s verzí)

Příklady

Příklad archivace.


   ml_client.environments.archive("create-environment", "2.0")

create_or_update

Vrátí vytvořený nebo aktualizovaný prostředek prostředí.

create_or_update(environment: Environment) -> Environment

Parametry

environment
<xref:azure.ai.ml.entities._assets.Environment>
Vyžadováno

Objekt prostředí

Návraty

Vytvořený nebo aktualizovaný objekt prostředí

Návratový typ

Environment

Výjimky

ValidationException

Vyvolána, pokud prostředí nelze úspěšně ověřit. Podrobnosti budou uvedeny v chybové zprávě.

EmptyDirectoryError

Vyvoláno, pokud zadaná místní cesta odkazuje na prázdný adresář.

Příklady

Vytvořit prostředí.


   from azure.ai.ml.entities import BuildContext, Environment

   env_docker_context = Environment(
       build=BuildContext(
           path="./sdk/ml/azure-ai-ml/tests/test_configs/environment/environment_files",
           dockerfile_path="DockerfileNonDefault",
       ),
       name="create-environment",
       version="2.0",
       description="Environment created from a Docker context.",
   )
   ml_client.environments.create_or_update(env_docker_context)

get

Vrátí zadaný prostředek prostředí.

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

Parametry

name
str
Vyžadováno

Název prostředí

version
str
Vyžadováno

Verze prostředí.

label
str
Vyžadováno

Popisek prostředí. (vzájemně se vylučují s verzí)

Návraty

Objekt prostředí

Návratový typ

Environment

Výjimky

ValidationException

Vyvolána, pokud prostředí nelze úspěšně ověřit. Podrobnosti budou uvedeny v chybové zprávě.

Příklady

Získejte příklad.


   ml_client.environments.get("create-environment", "2.0")

list

Vypíše všechny prostředky prostředí v pracovním prostoru.

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

Parametry

name
Optional[str]
Vyžadováno

Název prostředí

list_view_type

Typ zobrazení pro zahrnutí nebo vyloučení (například) archivovaných prostředí Výchozí: ACTIVE_ONLY.

Návraty

Iterátor, jako je instance objektů prostředí.

Návratový typ

ItemPaged[Environment]

Příklady

Příklad seznamu


   ml_client.environments.list()

restore

Obnovte archivovanou verzi prostředí.

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

Parametry

name
str
Vyžadováno

Název prostředí

version
str
Vyžadováno

Verze prostředí.

label
str
Vyžadováno

Popisek prostředí. (vzájemně se vylučují s verzí)

Příklady

Příklad obnovení


   ml_client.environments.restore("create-environment", "2.0")

share

Poznámka

Jedná se o experimentální metodu, která se může kdykoli změnit. Další informace najdete tady: https://aka.ms/azuremlexperimental.

Sdílení prostředku prostředí z pracovního prostoru do registru

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

Parametry

name
str
Vyžadováno

Název prostředku prostředí

version
str
Vyžadováno

Verze prostředku prostředí.

share_with_name
str

Název prostředku prostředí, se kterým se má sdílet.

share_with_version
str

Verze prostředku prostředí, se kterým chcete sdílet.

registry_name
str

Název cílového registru.

Návraty

Objekt prostředku prostředí.

Návratový typ

Environment