Udostępnij za pośrednictwem

EnvironmentOperations Klasa

  • Odwołanie

EnvironmentOperations.

Nie należy bezpośrednio utworzyć wystąpienia tej klasy. Zamiast tego należy utworzyć wystąpienie klasy MLClient, które tworzy wystąpienie dla Ciebie i dołącza je jako atrybut.

Dziedziczenie
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>
Wymagane

Zmienne zakresu dla klas operacji obiektu MLClient.

operation_config
<xref:azure.ai.ml._scope_dependent_operations.OperationConfig>
Wymagane

Typowa konfiguracja klas operacji obiektu 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>]
Wymagane

Klient usługi umożliwia użytkownikom końcowym obsługę zasobów obszaru roboczego usługi Azure Machine Learning (ServiceClient042023Preview lub ServiceClient102021Dataplane).

all_operations
<xref:azure.ai.ml._scope_dependent_operations.OperationsContainer>
Wymagane

Wszystkie klasy operacji obiektu MLClient.

Metody

archive

Archiwizowanie środowiska lub wersji środowiska.
create_or_update

Zwraca utworzony lub zaktualizowany zasób środowiska.
get

Zwraca określony zasób środowiska.
list

Wyświetl listę wszystkich zasobów środowiskowych w obszarze roboczym.
restore

Przywracanie zarchiwizowanej wersji środowiska.
share

Uwaga

Jest to metoda eksperymentalna i może ulec zmianie w dowolnym momencie. Aby uzyskać więcej informacji, zobacz https://aka.ms/azuremlexperimental.

Udostępnianie zasobu środowiska z obszaru roboczego do rejestru.

archive

Archiwizowanie środowiska lub wersji środowiska.

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

Parametry

name
str
Wymagane

Nazwa środowiska.

version
str
Wymagane

Wersja środowiska.

label
str
Wymagane

Etykieta środowiska. (wzajemnie wykluczające się wersje)

Przykłady

Przykład archiwum.


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

create_or_update

Zwraca utworzony lub zaktualizowany zasób środowiska.

create_or_update(environment: Environment) -> Environment

Parametry

environment
<xref:azure.ai.ml.entities._assets.Environment>
Wymagane

Obiekt środowiska

Zwraca

Utworzony lub zaktualizowany obiekt środowiska

Typ zwracany

Environment

Wyjątki

ValidationException

Podniesione, jeśli nie można pomyślnie zweryfikować środowiska. Szczegóły zostaną podane w komunikacie o błędzie.

EmptyDirectoryError

Podniesiono, jeśli ścieżka lokalna wskazuje pusty katalog.

Przykłady

Tworzenie środowiska.


   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

Zwraca określony zasób środowiska.

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

Parametry

name
str
Wymagane

Nazwa środowiska.

version
str
Wymagane

Wersja środowiska.

label
str
Wymagane

Etykieta środowiska. (wzajemnie wykluczające się wersje)

Zwraca

Obiekt środowiska

Typ zwracany

Environment

Wyjątki

ValidationException

Podniesione, jeśli nie można pomyślnie zweryfikować środowiska. Szczegóły zostaną podane w komunikacie o błędzie.

Przykłady

Pobierz przykład.


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

list

Wyświetl listę wszystkich zasobów środowiskowych w obszarze roboczym.

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

Parametry

name
Optional[str]
Wymagane

Nazwa środowiska.

list_view_type

Wyświetl typ zarchiwizowanych środowisk, w tym/wykluczania (na przykład). Ustawienie domyślne: ACTIVE_ONLY.

Zwraca

Iterator, taki jak wystąpienie obiektów środowiska.

Typ zwracany

ItemPaged[Environment]

Przykłady

Przykład listy.


   ml_client.environments.list()

restore

Przywracanie zarchiwizowanej wersji środowiska.

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

Parametry

name
str
Wymagane

Nazwa środowiska.

version
str
Wymagane

Wersja środowiska.

label
str
Wymagane

Etykieta środowiska. (wzajemnie wykluczające się wersje)

Przykłady

Przykład przywracania.


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

share

Uwaga

Jest to metoda eksperymentalna i może ulec zmianie w dowolnym momencie. Aby uzyskać więcej informacji, zobacz https://aka.ms/azuremlexperimental.

Udostępnianie zasobu środowiska z obszaru roboczego do rejestru.

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

Parametry

name
str
Wymagane

Nazwa zasobu środowiska.

version
str
Wymagane

Wersja zasobu środowiska.

share_with_name
str

Nazwa zasobu środowiska do udostępnienia.

share_with_version
str

Wersja zasobu środowiska do udostępnienia.

registry_name
str

Nazwa rejestru docelowego.

Zwraca

Obiekt zasobu środowiska.

Typ zwracany

Environment