Condividi tramite

EnvironmentOperations Classe

  • Riferimento

EnvironmentOperations.

Non è consigliabile creare direttamente un'istanza di questa classe. È invece necessario creare un'istanza di MLClient per crearne un'istanza per l'utente e allegarla come attributo.

Ereditarietà
azure.ai.ml._scope_dependent_operations._ScopeDependentOperations
EnvironmentOperations

Costruttore

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

Parametri

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

Variabili di ambito per le classi di operazioni di un oggetto MLClient.

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

Configurazione comune per le classi di operazioni di un oggetto 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>]
Necessario

Client del servizio per consentire agli utenti finali di operare sulle risorse dell'area di lavoro di Azure Machine Learning (ServiceClient042023Preview o ServiceClient102021Dataplane).

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

Tutte le classi di operazioni di un oggetto MLClient.

Metodi

archive

Archiviare un ambiente o una versione dell'ambiente.
create_or_update

Restituisce un asset di ambiente creato o aggiornato.
get

Restituisce l'asset di ambiente specificato.
list

Elencare tutti gli asset di ambiente nell'area di lavoro.
restore

Ripristinare una versione dell'ambiente archiviata.
share

Nota

Si tratta di un metodo sperimentale e può cambiare in qualsiasi momento. Per altre informazioni, vedere https://aka.ms/azuremlexperimental.

Condividere un asset di ambiente dall'area di lavoro al Registro di sistema.

archive

Archiviare un ambiente o una versione dell'ambiente.

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

Parametri

name
str
Necessario

Nome dell'ambiente.

version
str
Necessario

Versione dell'ambiente.

label
str
Necessario

Etichetta dell'ambiente. (che si escludono a vicenda con la versione)

Esempio

Esempio di archivio.


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

create_or_update

Restituisce un asset di ambiente creato o aggiornato.

create_or_update(environment: Environment) -> Environment

Parametri

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

Oggetto Environment

Restituisce

Oggetto Environment creato o aggiornato

Tipo restituito

Environment

Eccezioni

ValidationException

Generato se l'ambiente non può essere convalidato correttamente. I dettagli verranno forniti nel messaggio di errore.

EmptyDirectoryError

Generato se il percorso locale specificato punta a una directory vuota.

Esempio

Creare l'ambiente.


   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

Restituisce l'asset di ambiente specificato.

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

Parametri

name
str
Necessario

Nome dell'ambiente.

version
str
Necessario

Versione dell'ambiente.

label
str
Necessario

Etichetta dell'ambiente. (che si escludono a vicenda con la versione)

Restituisce

Oggetto Environment

Tipo restituito

Environment

Eccezioni

ValidationException

Generato se l'ambiente non può essere convalidato correttamente. I dettagli verranno forniti nel messaggio di errore.

Esempio

Ottenere un esempio.


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

list

Elencare tutti gli asset di ambiente nell'area di lavoro.

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

Parametri

name
Optional[str]
Necessario

Nome dell'ambiente.

list_view_type

Tipo di visualizzazione per ambienti archiviati inclusi/esclusi (ad esempio). Impostazione predefinita: ACTIVE_ONLY.

Restituisce

Iteratore come l'istanza degli oggetti Environment.

Tipo restituito

ItemPaged[Environment]

Esempio

Esempio di elenco.


   ml_client.environments.list()

restore

Ripristinare una versione dell'ambiente archiviata.

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

Parametri

name
str
Necessario

Nome dell'ambiente.

version
str
Necessario

Versione dell'ambiente.

label
str
Necessario

Etichetta dell'ambiente. (che si escludono a vicenda con la versione)

Esempio

Esempio di ripristino.


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

share

Nota

Si tratta di un metodo sperimentale e può cambiare in qualsiasi momento. Per altre informazioni, vedere https://aka.ms/azuremlexperimental.

Condividere un asset di ambiente dall'area di lavoro al Registro di sistema.

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

Parametri

name
str
Necessario

Nome dell'asset di ambiente.

version
str
Necessario

Versione dell'asset di ambiente.

share_with_name
str

Nome dell'asset di ambiente con cui condividere.

share_with_version
str

Versione dell'asset di ambiente con cui condividere.

registry_name
str

Nome del Registro di sistema di destinazione.

Restituisce

Oggetto asset di ambiente.

Tipo restituito

Environment