ComponentOperations Osztály

ComponentOperations.

Ezt az osztályt nem szabad közvetlenül példányosítani. Ehelyett létre kell hoznia egy MLClient-példányt, amely példányosítja, és attribútumként csatolja.

Öröklődés

azure.ai.ml._scope_dependent_operations._ScopeDependentOperations

ComponentOperations

Konstruktor

ComponentOperations(operation_scope: OperationScope, operation_config: OperationConfig, service_client: AzureMachineLearningWorkspaces | AzureMachineLearningWorkspaces, all_operations: OperationsContainer, preflight_operation: DeploymentsOperations | None = None, **kwargs: Dict)

Paraméterek

operation_scope

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

Kötelező

A művelet hatóköre.

operation_config

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

Kötelező

A művelet konfigurációja.

service_client

Union[ <xref:azure.ai.ml._restclient.v2022_10_01.AzureMachineLearningWorkspaces>, <xref:azure.ai.ml._restclient.v2021_10_01_dataplanepreview.AzureMachineLearningWorkspaces>]

Kötelező

Az API-műveletek szolgáltatásügyfele.

all_operations

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

Kötelező

Az összes elérhető művelet tárolója.

preflight_operation

Optional[<xref:azure.ai.ml._vendor.azure_resources.operations.DeploymentsOperations>]

alapértelmezett érték: None

Az üzembe helyezések elővizsgálati művelete.

kwargs

Dict

Kötelező

További kulcsszóargumentumok.

Metódusok

archive	Összetevő archiválása.
create_or_update	Adott összetevő létrehozása vagy frissítése. Ha vannak beágyazott definiált entitások, például környezet, kód, akkor azok az összetevővel együtt jönnek létre.
download	Megjegyzés Ez egy kísérleti módszer, és bármikor változhat. További információ: https://aka.ms/azuremlexperimental. Töltse le a megadott összetevőt és annak függőségeit a helyire. A helyi összetevő használatával létrehozhatja az összetevőt egy másik munkaterületen vagy offline fejlesztés céljából.
get	A megadott összetevőre vonatkozó információkat adja vissza.
list	Listázhatja a munkaterület adott összetevőjét vagy összetevőit.
restore	Archivált összetevő visszaállítása.
validate	Megjegyzés Ez egy kísérleti módszer, és bármikor változhat. További információ: https://aka.ms/azuremlexperimental. ellenőrizze a megadott összetevőt. Ha vannak beágyazott entitások, például környezet, kód, akkor ezek nem jönnek létre.

archive

Összetevő archiválása.

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

Paraméterek

name

str

Kötelező

Az összetevő neve.

version

str

Kötelező

Az összetevő verziója.

label

str

Kötelező

Az összetevő címkéje. (kölcsönösen kizárva a verzióval).

Példák

Példa archív összetevőre.

   ml_client.components.archive(name=component_example.name)

create_or_update

Adott összetevő létrehozása vagy frissítése. Ha vannak beágyazott definiált entitások, például környezet, kód, akkor azok az összetevővel együtt jönnek létre.

create_or_update(component: Component | function, version=None, *, skip_validation: bool = False, **kwargs) -> Component

Paraméterek

component

Union[Component, FunctionType]

Kötelező

Az összetevőobjektum vagy egy mldesigner összetevő-függvény, amely összetevő-objektumot hoz létre

version

str

Kötelező

A felülbírálandó összetevő verziója.

skip_validation

bool

kihagyja-e az érvényesítést az összetevő létrehozása/frissítése előtt, alapértelmezés szerint False (Hamis) értékre

Válaszok

A megadott összetevő-objektum.

Visszatérési típus

Component

Kivételek

ValidationException

Elő van állítva, ha az összetevő nem érvényesíthető sikeresen. A részletek a hibaüzenetben lesznek megadva.

AssetException

Akkor jelenik meg, ha az összetevő-objektumok (például Adatok, Kód, Modell, Környezet) ellenőrzése nem sikerült. A részletek a hibaüzenetben lesznek megadva.

ComponentException

Akkor aktiválódik, ha az összetevő típusa nem támogatott. A részletek a hibaüzenetben lesznek megadva.

ModelException

Elő van állítva, ha az összetevőmodell nem érvényesíthető sikeresen. A részletek a hibaüzenetben lesznek megadva.

EmptyDirectoryError

Fel van emelve, ha a helyi elérési út egy üres könyvtárra mutat.

Példák

Példa összetevő létrehozására.

   from azure.ai.ml import load_component
   from azure.ai.ml.entities._component.component import Component

   component_example = load_component(
       source="./sdk/ml/azure-ai-ml/tests/test_configs/components/helloworld_component.yml",
       params_override=[{"version": "1.0.2"}],
   )
   component = ml_client.components.create_or_update(component_example)

download

Megjegyzés

Ez egy kísérleti módszer, és bármikor változhat. További információ: https://aka.ms/azuremlexperimental.

Töltse le a megadott összetevőt és annak függőségeit a helyire. A helyi összetevő használatával létrehozhatja az összetevőt egy másik munkaterületen vagy offline fejlesztés céljából.

download(name: str, download_path: PathLike | str = '.', *, version: str = None) -> None

Paraméterek

name

str

Kötelező

A kódösszetevő neve.

download_path

str

Kötelező

Helyi elérési út letöltési célként, alapértelmezés szerint az aktuális felhasználó aktuális munkakönyvtárába. Ha nem létezik, létrejön.

version

Optional[str]

Az összetevő verziója.

Válaszok

A megadott összetevő-objektum.

Visszatérési típus

Component

Kivételek

OSError

Akkor jön létre, ha download_path egy meglévő könyvtárra mutat, amely nem üres. azonosítja és lekéri. A részletek a hibaüzenetben lesznek megadva.

get

A megadott összetevőre vonatkozó információkat adja vissza.

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

Paraméterek

name

str

Kötelező

A kódösszetevő neve.

version

Optional[str]

Kötelező

Az összetevő verziója.

label

Optional[str]

Kötelező

Az összetevő címkéje, kölcsönösen kizárva a verzióval.

Válaszok

A megadott összetevő-objektum.

Visszatérési típus

Component

Kivételek

ValidationException

Elő van állítva, ha az összetevőt nem lehet sikeresen azonosítani és lekérni. A részletek a hibaüzenetben lesznek megadva.

Példák

Példa az összetevőre.

   ml_client.components.get(name=component_example.name, version="1.0.2")

list

Listázhatja a munkaterület adott összetevőjét vagy összetevőit.

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

Paraméterek

name

Optional[str]

Kötelező

Az összetevő neve, ha nincs beállítva, listázze a munkaterület összes összetevőjét

list_view_type

Az archivált összetevők belefoglalásának/kizárásának (például) nézettípusa. Alapértelmezett: ACTIVE_ONLY.

Válaszok

Iterátor, például összetevő-objektumok példánya

Visszatérési típus

ItemPaged[Component]

Példák

Példa listaösszetevőre.

   print(ml_client.components.list())

restore

Archivált összetevő visszaállítása.

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

Paraméterek

name

str

Kötelező

Az összetevő neve.

version

str

Kötelező

Az összetevő verziója.

label

str

Kötelező

Az összetevő címkéje. (kölcsönösen kizárva a verzióval).

Példák

Példa a visszaállítási összetevőre.

   ml_client.components.restore(name=component_example.name)

validate

Megjegyzés

Ez egy kísérleti módszer, és bármikor változhat. További információ: https://aka.ms/azuremlexperimental.

ellenőrizze a megadott összetevőt. Ha vannak beágyazott entitások, például környezet, kód, akkor ezek nem jönnek létre.

validate(component: Component | function, raise_on_failure: bool = False, **kwargs) -> ValidationResult

Paraméterek

component

Union[Component, FunctionType]

Kötelező

Az összetevőobjektum vagy egy mldesigner összetevő-függvény, amely összetevő-objektumot hoz létre

raise_on_failure

bool

Kötelező

Kivételt kíván-e emelni az érvényesítési hiba miatt. Alapértelmezés szerint False (Hamis)

Válaszok

Minden érvényesítési hiba

Visszatérési típus

ValidationResult