AmlCompute Osztály

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 egyetlen vagy többcsomópontos számítás egyszerű létrehozását. A számítás a munkaterület régióján belül 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.

Kérje le a megadott munkaterülethez társított számítási objektum felhőbeli ábrázolását. A lekért számítási objektum adott típusának megfelelő gyermekosztálypéldányt ad vissza.

Konstruktor

AmlCompute(workspace, name)

Paraméterek

Name	Description
workspace Kötelező	Workspace A lekérendő 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 Számítási objektumot tartalmazó munkaterület-objektum.
name Kötelező	str A lekérni kívánt Számítási objektum neve.

Megjegyzések

Az alábbi példában létrejön egy állandó számítási cél, amelyet AmlCompute kiépített. A provisioning_configuration példában szereplő paraméter típusa AmlComputeProvisioningConfigurationa gyermekosztály 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 objektum visszaadása.
get_active_runs	Adja vissza a számításhoz tartozó futtatások generátorát.
get_status	Az AmlCompute-fürt aktuális részletes állapotának lekérése.
list_nodes	Kérje le a számítási cél összes számítási csomópontjának adatait (pl. IP-cím, port stb.).
list_quotas	Szerezze be a jelenleg hozzárendelt munkaterületi kvótákat az adott munkaterülethez és előfizetéshez tartozó VMFamily alapján.
list_usages	Szerezze be 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	Az AmlCompute objektum átalakítása 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 ennek az ScaleSettings AmlCompute-célnak a frissítését.
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 minimális számú csomópontot várjon, és hogy egy megadott idő elteltével időtúllépést érjen el.

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 A lehetséges értékek a következők: SystemAssigned – Rendszer által hozzárendelt identitás UserAssigned – Felhasználó által hozzárendelt identitás. Meg kell adni 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. Pl.. ['./subscriptions/<subid>/resourceGroups/<rg>/providers/Microsoft.ManagedIdentity /userAssignedIdentities/<id>] 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 Learning használatával 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 van csatolva, ez a metódus létrehoz egy ComputeTargetException értéket, é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á alakítható.

Válaszok

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

Kivételek

Típus	Description
ComputeTargetException

Megjegyzések

Felvesz egy értéket ComputeTargetException , ha a megadott munkaterület nem az a munkaterület, amelyhez a Compute 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 objektum visszaadása.

get()

get_active_runs

Adja vissza a számításhoz tartozó futtatások generátorát.

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

Paraméterek

Name	Description
type	str Szűrje a megadott típusú futtatások visszaadott generátorát. 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ő "tag" vagy {"tag": "value"} szerint fut Alapértelmezett érték: None
properties	str vagy dict A szűrő "tulajdonság" vagy {"tulajdonság" szerint fut: "value"} Alapértelmezett érték: None
status	str Futtatás állapota – "Futtatás" vagy "Queued" Alapértelmezett érték: None

Válaszok

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

get_status

Az AmlCompute-fürt aktuális részletes állapotának lekérése.

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 (pl. IP-cím, port 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

Szerezze be a jelenleg hozzárendelt munkaterületi kvó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	Az aktuálisan hozzárendelt munkaterületi kvóták listája a VMFamily alapján

list_usages

Szerezze be 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értelmezett érték 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 Ügynök virtuális gépek 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álisgép-prioritás, dedikált vagy alacsony árprioritá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, az alapértelmezett érték a 4. 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. Ha nincs megadva, az alapértelmezett érték 1800. Alapértelmezett érték: 1800
admin_username	str A csomópontokba SSH-hoz használható rendszergazdai felhasználói fiók neve. 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 SSH nyilvános kulcsa. Alapértelmezett érték: None
vnet_resourcegroup_name	str Annak az erőforráscsoportnak a neve, amelyben 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. A lehetséges értékek a következők: Letiltva – Azt jelzi, hogy a nyilvános ssh-port a fürt összes csomópontján zárva van. 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 definiálva van, 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 engedélyezve vagy letiltva lesz. Alapértelmezett érték: NotSpecified
identity_type	string A lehetséges értékek a következők: SystemAssigned – Rendszer által hozzárendelt identitás UserAssigned – Felhasználó által hozzárendelt identitás. Meg kell adni 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. Pl.. ['./subscriptions/<subid>/resourceGroups/<rg>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<id>] 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. A lehetséges értékek a következők: Igaz – A csomópont nyilvános IP-címének engedélyezése. Hamis – A csomópont nyilvános IP-címének letiltása. Nincs megadva – 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

Az AmlCompute objektum átalakítása 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, akkor 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 ennek az ScaleSettings AmlCompute-célnak a frissítését.

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 tétlenségi 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, akkor 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 minimális számú csomópontot várjon, és hogy egy megadott idő elteltével időtúllépést érjen el.

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 várandó csomópontok minimális száma. 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 A kiépítés sikertelenségének mérlegelése 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 szolgál-e. Alapértelmezett érték: False

Kivételek

Típus	Description
ComputeTargetException

Visszajelzés

Hasznosnak találta ezt az oldalt?

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