EnvironmentOperations Klas

EnvironmentOperations.

U moet deze klasse niet rechtstreeks instantiëren. In plaats daarvan moet u een MLClient-exemplaar maken dat het voor u instanteert en als een kenmerk koppelt.

Overname

azure.ai.ml._scope_dependent_operations._ScopeDependentOperations

EnvironmentOperations

Constructor

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

Parameters

operation_scope

<xref:azure.ai.ml._scope_dependent_operations.OperationScope>

Vereist

Bereikvariabelen voor de bewerkingsklassen van een MLClient-object.

operation_config

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

Vereist

Algemene configuratie voor bewerkingsklassen van een MLClient-object.

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

Vereist

Serviceclient zodat eindgebruikers kunnen werken met Azure Machine Learning-werkruimteresources (ServiceClient042023Preview of ServiceClient102021Dataplane).

all_operations

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

Vereist

Alle bewerkingsklassen van een MLClient-object.

Methoden

archive	Een omgeving of een omgevingsversie archiveren.
create_or_update	Retourneert gemaakte of bijgewerkte omgevingsasset.
get	Retourneert de opgegeven omgevingsasset.
list	Alle omgevingsassets in de werkruimte weergeven.
restore	Een gearchiveerde omgevingsversie herstellen.
share	Notitie Dit is een experimentele methode en kan op elk gewenst moment worden gewijzigd. Zie https://aka.ms/azuremlexperimental voor meer informatie. Deel een omgevingsasset van werkruimte naar register.

archive

Een omgeving of een omgevingsversie archiveren.

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

Parameters

name

str

Vereist

Naam van de omgeving.

version

str

Vereist

Versie van de omgeving.

label

str

Vereist

Label van de omgeving. (sluiten elkaar uit met versie)

Voorbeelden

Archiefvoorbeeld.

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

create_or_update

Retourneert gemaakte of bijgewerkte omgevingsasset.

create_or_update(environment: Environment) -> Environment

Parameters

environment

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

Vereist

Omgevingsobject

Retouren

Omgevingsobject gemaakt of bijgewerkt

Retourtype

Environment

Uitzonderingen

ValidationException

Wordt weergegeven als de omgeving niet kan worden gevalideerd. Details worden opgegeven in het foutbericht.

EmptyDirectoryError

Wordt gegenereerd als het opgegeven lokale pad verwijst naar een lege map.

Voorbeelden

Omgeving maken.

   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

Retourneert de opgegeven omgevingsasset.

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

Parameters

name

str

Vereist

Naam van de omgeving.

version

str

Vereist

Versie van de omgeving.

label

str

Vereist

Label van de omgeving. (sluiten elkaar uit met versie)

Retouren

Omgevingsobject

Retourtype

Environment

Uitzonderingen

ValidationException

Wordt weergegeven als de omgeving niet kan worden gevalideerd. Details worden opgegeven in het foutbericht.

Voorbeelden

Haal een voorbeeld op.

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

list

Alle omgevingsassets in de werkruimte weergeven.

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

Parameters

name

Optional[str]

Vereist

Naam van de omgeving.

list_view_type

Weergavetype voor het opnemen/uitsluiten van (bijvoorbeeld) gearchiveerde omgevingen. Standaardinstelling: ACTIVE_ONLY.

Retouren

Een iterator zoals een exemplaar van omgevingsobjecten.

Retourtype

ItemPaged[Environment]

Voorbeelden

Lijstvoorbeeld.

   ml_client.environments.list()

restore

Een gearchiveerde omgevingsversie herstellen.

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

Parameters

name

str

Vereist

Naam van de omgeving.

version

str

Vereist

Versie van de omgeving.

label

str

Vereist

Label van de omgeving. (sluiten elkaar uit met versie)

Voorbeelden

Voorbeeld van herstellen.

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

share

Notitie

Dit is een experimentele methode en kan op elk gewenst moment worden gewijzigd. Zie https://aka.ms/azuremlexperimental voor meer informatie.

Deel een omgevingsasset van werkruimte naar register.

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

Parameters

name

str

Vereist

Naam van omgevingsasset.

version

str

Vereist

Versie van omgevingsasset.

share_with_name

str

Naam van omgevingsasset waarmee u wilt delen.

share_with_version

str

Versie van omgevingsasset waarmee u wilt delen.

registry_name

str

Naam van het doelregister.

Retouren

Omgevingsassetobject.

Retourtype

Environment