AmlCompute Osztály

Referencia

Azure Machine Learning-számításokat kezel az Azure Machine Learningben.

Az Azure Machine Learning Compute (AmlCompute) egy felügyelt számítási infrastruktúra, amely lehetővé teszi egy vagy többcsomópontos számítás egyszerű létrehozását. A számítás a munkaterület régiójában jön létre erőforrásként, amely megosztható más felhasználókkal. További információ: Mik azok a számítási célok az Azure Machine Learningben?

ComputeTarget-konstruktor osztály.

A megadott munkaterülethez társított számítási objektum felhőbeli ábrázolásának lekérése. Egy gyermekosztály egy példányát adja vissza, amely a lekért számítási objektum adott típusának felel meg.

Öröklődés: ComputeTarget

AmlCompute

Konstruktor

AmlCompute(workspace, name)

Paraméterek

Name	Description
workspace Kötelező	Workspace A lekérni kívánt AmlCompute objektumot tartalmazó munkaterület-objektum.
name Kötelező	str A lekérni kívánt AmlCompute objektum neve.
workspace Kötelező	Workspace A lekérni kívánt Compute objektumot tartalmazó munkaterület-objektum.
name Kötelező	str A lekérni kívánt Compute objektum neve.

Megjegyzések

Az alábbi példában létrehozunk egy állandó számítási célt, amelyet kiépítettünk AmlCompute . A provisioning_configuration példában szereplő paraméter típusa AmlComputeProvisioningConfiguration, amely a gyermekosztálya ComputeTargetProvisioningConfiguration.


   from azureml.core.compute import ComputeTarget, AmlCompute
   from azureml.core.compute_target import ComputeTargetException

   # Choose a name for your CPU cluster
   cpu_cluster_name = "cpu-cluster"

   # Verify that cluster does not exist already
   try:
       cpu_cluster = ComputeTarget(workspace=ws, name=cpu_cluster_name)
       print('Found existing cluster, use it.')
   except ComputeTargetException:
       compute_config = AmlCompute.provisioning_configuration(vm_size='STANDARD_D2_V2',
                                                              max_nodes=4)
       cpu_cluster = ComputeTarget.create(ws, cpu_cluster_name, compute_config)

   cpu_cluster.wait_for_completion(show_output=True)

A teljes minta a következő forrásból érhető el: https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-amlcompute/train-on-amlcompute.ipynb

Metódusok

add_identity	Adjon hozzá identitástípust és/vagy identitásazonosítókat ehhez az AmlCompute-célhoz.
delete	Távolítsa el az AmlCompute objektumot a társított munkaterületről.
deserialize	JSON-objektum átalakítása AmlCompute objektummá.
detach	Az AmlCompute objektum leválasztása nem támogatott. A delete használható helyette.
get	Számítási objektumot ad vissza.
get_active_runs	A számítási futtatások generátorát adja vissza.
get_status	Kérje le az AmlCompute fürt aktuális részletes állapotát.
list_nodes	Kérje le a számítási cél összes számítási csomópontjának adatait (például IP-címét, portját stb.).
list_quotas	Kérje le a jelenleg hozzárendelt munkaterületkvótákat az adott munkaterülethez és előfizetéshez tartozó VMFamily alapján.
list_usages	Lekérheti az aktuális használati adatokat, valamint az adott munkaterületre és előfizetésre vonatkozó AML-erőforrások korlátait.
provisioning_configuration	Hozzon létre egy konfigurációs objektumot egy AmlCompute-cél kiépítéséhez.
refresh_state	Végezze el az objektum tulajdonságainak helyben történő frissítését. Ez a módszer a megfelelő felhőobjektum aktuális állapota alapján frissíti a tulajdonságokat. Ezt elsősorban a számítási állapot manuális lekérdezésére használják.
remove_identity	Távolítsa el az identitást a számításban.
serialize	Konvertálja ezt az AmlCompute objektumot JSON szerializált szótárlá.
supported_vmsizes	A támogatott virtuálisgép-méretek listázása egy régióban.
update	Frissítse az ScaleSettings AmlCompute-célhoz tartozó értéket.
update_quotas	Virtuálisgép-család kvótájának frissítése a munkaterületen.
wait_for_completion	Várja meg, amíg az AmlCompute fürt befejezi a kiépítést. Ez úgy konfigurálható, hogy megvárja a csomópontok minimális számát, és egy megadott idő elteltével időtúllépést állítson be.

add_identity

Adjon hozzá identitástípust és/vagy identitásazonosítókat ehhez az AmlCompute-célhoz.

add_identity(identity_type, identity_id=None)

Paraméterek

Name	Description
identity_type Kötelező	string Lehetséges értékek: SystemAssigned – Rendszer által hozzárendelt identitás UserAssigned – Felhasználó által hozzárendelt identitás. Be kell állítani az identitásazonosítót.
identity_id	list[str] A felhasználó által hozzárendelt identitás erőforrás-azonosítóinak listája. például: ['./subscriptions//resourceGroups//providers/Microsoft.ManagedIdentity /userAssignedIdentities/] Alapértelmezett érték: None

Megjegyzések

identity_id csak akkor kell megadni, ha identity_type == UserAssigned

delete

Távolítsa el az AmlCompute objektumot a társított munkaterületről.

delete()

Kivételek

Típus	Description
ComputeTargetException

Megjegyzések

Ha ezt az objektumot az Azure Machine Learningen keresztül hozták létre, a megfelelő felhőalapú objektumok is törlődnek. Ha ez az objektum külsőleg lett létrehozva, és csak a munkaterülethez lett csatolva, ez a metódus egy ComputeTargetException értéket ad vissza, és semmi sem változik.

deserialize

JSON-objektum átalakítása AmlCompute objektummá.

static deserialize(workspace, object_dict)

Paraméterek

Name	Description
workspace Kötelező	Workspace Az AmlCompute objektumhoz társított munkaterület-objektum.
object_dict Kötelező	dict Egy JSON-objektum, amely AmlCompute objektummá konvertálható.

Válaszok

Típus	Description
AmlCompute	A megadott JSON-objektum AmlCompute-ábrázolása.

Kivételek

Típus	Description
ComputeTargetException

Megjegyzések

A értéket ad ComputeTargetException elő, ha a megadott munkaterület nem az a munkaterület, amelyhez a Számítás társítva van.

detach

Az AmlCompute objektum leválasztása nem támogatott. A delete használható helyette.

detach()

Kivételek

Típus	Description
ComputeTargetException

get

Számítási objektumot ad vissza.

get()

get_active_runs

A számítási futtatások generátorát adja vissza.

get_active_runs(type=None, tags=None, properties=None, status=None)

Paraméterek

Name	Description
type	str Szűrje a futtatások visszaadott generátorát a megadott típus szerint. Tekintse meg add_type_provider a futtatási típusok létrehozását. Alapértelmezett érték: None
tags	str vagy dict A szűrő a következő szerint fut: "tag" vagy {"tag": "value"} Alapértelmezett érték: None
properties	str vagy dict A szűrő a következő szerint fut: "property" vagy {"property": "value"} Alapértelmezett érték: None
status	str Futtatás állapota – "Fut" vagy "Várólistán" Alapértelmezett érték: None

Válaszok

Típus	Description
<xref:builtin.generator>	a ~_restclient.models.RunDto generátora

get_status

Kérje le az AmlCompute fürt aktuális részletes állapotát.

get_status()

Válaszok

Típus	Description
AmlComputeStatus	A fürt részletes állapotobjektuma

list_nodes

Kérje le a számítási cél összes számítási csomópontjának adatait (például IP-címét, portját stb.).

list_nodes()

Válaszok

Típus	Description
list	A számítási cél összes számítási csomópontjának részletei.

list_quotas

Kérje le a jelenleg hozzárendelt munkaterületkvótákat az adott munkaterülethez és előfizetéshez tartozó VMFamily alapján.

static list_quotas(workspace, location=None)

Paraméterek

Name	Description
workspace Kötelező	Workspace
location	str A kvóták helye. Ha nincs megadva, akkor alapértelmezés szerint a munkaterület helye lesz. Alapértelmezett érték: None

Válaszok

Típus	Description
list	A jelenleg hozzárendelt munkaterületkvóták listája a VMFamily alapján

list_usages

Lekérheti az aktuális használati adatokat, valamint az adott munkaterületre és előfizetésre vonatkozó AML-erőforrások korlátait.

static list_usages(workspace, show_all=False, location=None)

Paraméterek

Name	Description
workspace Kötelező	Workspace
show_all	Megadja, hogy szükség van-e a gyermekerőforrások részletes használatára. Alapértelmezés szerint False (Hamis) Alapértelmezett érték: False
location	str Az erőforrások helye. Ha nincs megadva, akkor alapértelmezés szerint a munkaterület helye lesz. Alapértelmezett érték: None

Válaszok

Típus	Description
list	Az aktuális használati adatok és az AML-erőforrások korlátainak listája

provisioning_configuration

Hozzon létre egy konfigurációs objektumot egy AmlCompute-cél kiépítéséhez.

static provisioning_configuration(vm_size='', vm_priority='dedicated', min_nodes=0, max_nodes=None, idle_seconds_before_scaledown=1800, admin_username=None, admin_user_password=None, admin_user_ssh_key=None, vnet_resourcegroup_name=None, vnet_name=None, subnet_name=None, tags=None, description=None, remote_login_port_public_access='NotSpecified', identity_type=None, identity_id=None, location=None, enable_node_public_ip=True)

Paraméterek

Name	Description
vm_size Kötelező	str Az ügynök virtuális gépeinek mérete. További részletek itt találhatók: https://aka.ms/azureml-vm-details. Vegye figyelembe, hogy nem minden méret érhető el minden régióban az előző hivatkozásban leírtak szerint. Ha nincs megadva, alapértelmezés szerint Standard_NC6.
vm_priority	str A virtuális gép prioritása , dedikált vagy alacsonyprioritás. Alapértelmezett érték: dedicated
min_nodes	int A fürtön használandó csomópontok minimális száma. Ha nincs megadva, az alapértelmezett érték 0. Alapértelmezett érték: 0
max_nodes	int A fürtön használandó csomópontok maximális száma. Ha nincs megadva, alapértelmezés szerint 4. Alapértelmezett érték: None
idle_seconds_before_scaledown	int A csomópont üresjárati ideje másodpercben a fürt vertikális leskálázása előtt. Ha nincs megadva, az alapértelmezett érték 1800. Alapértelmezett érték: 1800
admin_username	str Annak a rendszergazdai felhasználói fióknak a neve, amely a csomópontokba való SSH-hoz használható. Alapértelmezett érték: None
admin_user_password	str A rendszergazdai felhasználói fiók jelszava. Alapértelmezett érték: None
admin_user_ssh_key	str A rendszergazdai felhasználói fiók nyilvános SSH-kulcsa. Alapértelmezett érték: None
vnet_resourcegroup_name	str Annak az erőforráscsoportnak a neve, ahol a virtuális hálózat található. Alapértelmezett érték: None
vnet_name	str A virtuális hálózat neve. Alapértelmezett érték: None
subnet_name	str A virtuális hálózaton belüli alhálózat neve. Alapértelmezett érték: None
tags	dict[str, str] A számítási objektum számára biztosítandó kulcsértékcímkék szótára. Alapértelmezett érték: None
description	str A számítási objektumnak megadható leírás. Alapértelmezett érték: None
remote_login_port_public_access	str A nyilvános SSH-port állapota. Lehetséges értékek: Letiltva – Azt jelzi, hogy a nyilvános SSH-port a fürt összes csomópontján le van zárva. Engedélyezve – Azt jelzi, hogy a nyilvános SSH-port nyitva van a fürt összes csomópontján. NotSpecified – Azt jelzi, hogy a nyilvános SSH-port a fürt összes csomópontján le van zárva, ha a virtuális hálózat meg van határozva, máskülönben az összes nyilvános csomópont meg van nyitva. Ez az alapértelmezett érték csak a fürtlétrehozás során lehet. A létrehozás után az engedélyezve vagy letiltva lesz. Alapértelmezett érték: NotSpecified
identity_type	string Lehetséges értékek: SystemAssigned – Rendszer által hozzárendelt identitás UserAssigned – Felhasználó által hozzárendelt identitás. Be kell állítani az identitásazonosítót. Alapértelmezett érték: None
identity_id	list[str] A felhasználó által hozzárendelt identitás erőforrás-azonosítóinak listája. például: ['./subscriptions//resourceGroups//providers/Microsoft.ManagedIdentity/userAssignedIdentities/] Alapértelmezett érték: None
location	str A fürt üzembe helyezésének helye. Alapértelmezett érték: None
enable_node_public_ip	bool A csomópont nyilvános IP-címének engedélyezése. Lehetséges értékek: True – A csomópont nyilvános IP-címének engedélyezése. False – Tiltsa le a csomópont nyilvános IP-címét. NotSpecified – A csomópont nyilvános IP-címének engedélyezése. Alapértelmezett érték: True

Válaszok

Típus	Description
AmlComputeProvisioningConfiguration	Számítási objektum létrehozásakor használandó konfigurációs objektum.

Kivételek

Típus	Description
ComputeTargetException

refresh_state

Végezze el az objektum tulajdonságainak helyben történő frissítését.

Ez a módszer a megfelelő felhőobjektum aktuális állapota alapján frissíti a tulajdonságokat. Ezt elsősorban a számítási állapot manuális lekérdezésére használják.

refresh_state()

remove_identity

Távolítsa el az identitást a számításban.

remove_identity(identity_id=None)

Paraméterek

Name	Description
identity_id	list[str] Felhasználó által hozzárendelt identitások Alapértelmezett érték: None

Megjegyzések

A rendszer automatikusan eltávolítja a rendszer által hozzárendelt identitást, ha nincs megadva identity_id

serialize

Konvertálja ezt az AmlCompute objektumot JSON szerializált szótárlá.

serialize()

Válaszok

Típus	Description
dict	Az AmlCompute objektum JSON-ábrázolása.

supported_vmsizes

A támogatott virtuálisgép-méretek listázása egy régióban.

static supported_vmsizes(workspace, location=None)

Paraméterek

Name	Description
workspace Kötelező	Workspace
location	str A fürt helye. Ha nincs megadva, alapértelmezés szerint a munkaterület helye lesz. Alapértelmezett érték: None

Válaszok

Típus	Description
list	A támogatott virtuálisgép-méretek listája egy régióban a virtuális gép, a virtuális processzorok és a RAM nevével.

update

Frissítse az ScaleSettings AmlCompute-célhoz tartozó értéket.

update(min_nodes=None, max_nodes=None, idle_seconds_before_scaledown=None)

Paraméterek

Name	Description
min_nodes	int A fürtön használandó csomópontok minimális száma. Alapértelmezett érték: None
max_nodes	int A fürtön használandó csomópontok maximális száma. Alapértelmezett érték: None
idle_seconds_before_scaledown	int A csomópont üresjárati ideje másodpercben, mielőtt leskálázható a fürt. Alapértelmezett érték: None

update_quotas

Virtuálisgép-család kvótájának frissítése a munkaterületen.

static update_quotas(workspace, vm_family, limit=None, location=None)

Paraméterek

Name	Description
workspace Kötelező	Workspace
vm_family Kötelező	str Virtuális gép családneve
limit	int Az erőforrás megengedett maximális kvótája Alapértelmezett érték: None
location	str A kvóta helye. Ha nincs megadva, alapértelmezés szerint a munkaterület helye lesz. Alapértelmezett érték: None

wait_for_completion

Várja meg, amíg az AmlCompute fürt befejezi a kiépítést.

Ez úgy konfigurálható, hogy megvárja a csomópontok minimális számát, és egy megadott idő elteltével időtúllépést állítson be.

wait_for_completion(show_output=False, min_node_count=None, timeout_in_minutes=25, is_delete_operation=False)

Paraméterek

Name	Description
show_output	bool Logikai érték, amely részletesebb kimenetet biztosít. Alapértelmezett érték: False
min_node_count	int A kiépítés befejezése előtt meg kell várni a csomópontok minimális számát. Ennek nem kell megegyeznie azoknak a csomópontoknak a minimális számával, amelyekkel a számítás ki lett építve, de nem lehet nagyobb ennél. Alapértelmezett érték: None
timeout_in_minutes	int Az üzembe helyezés sikertelenségének megfontolása előtt várakozási idő percekben. Alapértelmezett érték: 25
is_delete_operation	bool Azt jelzi, hogy a művelet törlésre van-e szánva. Alapértelmezett érték: False

Kivételek

Típus	Description
ComputeTargetException

Megosztás a következőn keresztül:

AmlCompute Osztály

Konstruktor

Paraméterek

Megjegyzések

Metódusok

add_identity

Paraméterek

Megjegyzések

delete

Kivételek

Megjegyzések

deserialize

Paraméterek

Válaszok

Kivételek

Megjegyzések

detach

Kivételek

get

get_active_runs

Paraméterek

Válaszok

get_status

Válaszok

list_nodes

Válaszok

list_quotas

Paraméterek

Válaszok

list_usages

Paraméterek

Válaszok

provisioning_configuration

Paraméterek

Válaszok

Kivételek

refresh_state

remove_identity

Paraméterek

Megjegyzések

serialize

Válaszok

supported_vmsizes

Paraméterek

Válaszok

update

Paraméterek

update_quotas

Paraméterek

wait_for_completion

Paraméterek

Kivételek

Visszajelzés

További források