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 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
-
AmlCompute
Konstruktor
AmlCompute(workspace, name)Paraméterek
- workspace
- Workspace
A lekérni kívánt AmlCompute objektumot tartalmazó munkaterület-objektum.
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
- 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.
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/]
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
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
Válaszok
A megadott JSON-objektum AmlCompute-ábrázolása.
Visszatérési típus
Kivételek
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
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
- 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.
A szűrő a következő szerint fut: "tag" vagy {"tag": "value"}
A szűrő a következő szerint fut: "property" vagy {"property": "value"}
Válaszok
a ~_restclient.models.RunDto generátora
Visszatérési típus
get_status
Kérje le az AmlCompute fürt aktuális részletes állapotát.
get_status()Válaszok
A fürt részletes állapotobjektuma
Visszatérési típus
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
A számítási cél összes számítási csomópontjának részletei.
Visszatérési típus
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
- workspace
- Workspace
- location
- str
A kvóták helye. Ha nincs megadva, akkor alapértelmezés szerint a munkaterület helye lesz.
Válaszok
A jelenleg hozzárendelt munkaterületkvóták listája a VMFamily alapján
Visszatérési típus
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
- workspace
- 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)
- location
- str
Az erőforrások helye. Ha nincs megadva, akkor alapértelmezés szerint a munkaterület helye lesz.
Válaszok
Az aktuális használati adatok és az AML-erőforrások korlátainak listája
Visszatérési típus
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
- vm_size
- 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.
- min_nodes
- int
A fürtön használandó csomópontok minimális száma. Ha nincs megadva, az 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.
- 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.
- admin_username
- str
Annak a rendszergazdai felhasználói fióknak a neve, amely a csomópontokba való SSH-hoz használható.
- admin_user_ssh_key
- str
A rendszergazdai felhasználói fiók nyilvános SSH-kulcsa.
- vnet_resourcegroup_name
- str
Annak az erőforráscsoportnak a neve, ahol a virtuális hálózat található.
A számítási objektum számára biztosítandó kulcsértékcímkék szótára.
- 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.
- identity_type
- string
Lehetséges értékek:
SystemAssigned – Rendszer által hozzárendelt identitás
UserAssigned – Felhasználó által hozzárendelt identitás. Meg kell adni az identitásazonosítót.
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/]
- 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.
Válaszok
Számítási objektum létrehozásakor használandó konfigurációs objektum.
Visszatérési típus
Kivételek
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
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
Az AmlCompute objektum JSON-ábrázolása.
Visszatérési típus
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
- workspace
- Workspace
- location
- str
A fürt helye. Ha nincs megadva, alapértelmezés szerint a munkaterület helye lesz.
Válaszok
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.
Visszatérési típus
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
- idle_seconds_before_scaledown
- int
A csomópont üresjárati ideje másodpercben, mielőtt leskálázható a fürt.
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
- workspace
- Workspace
- location
- str
A kvóta helye. Ha nincs megadva, alapértelmezés szerint a munkaterület helye lesz.
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
- 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.
- timeout_in_minutes
- int
Az üzembe helyezés sikertelenségének megfontolása előtt várakozási idő percekben.
- is_delete_operation
- bool
Azt jelzi, hogy a művelet törlésre van-e szánva.
Kivételek
Visszajelzés
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ: https://aka.ms/ContentUserFeedback.
Visszajelzés küldése és megtekintése a következőhöz: