AmlCompute Klass
Hanterar en Azure Machine Learning-beräkning i Azure Machine Learning.
En Azure Machine Learning Compute (AmlCompute) är en infrastruktur för hanterad beräkning som gör att du enkelt kan skapa en beräkning med en enda eller flera noder. Beräkningen skapas i din arbetsyteregion som en resurs som kan delas med andra användare. Mer information finns i Vad är beräkningsmål i Azure Machine Learning?
ComputeTarget-konstruktor för klass.
Hämta en molnrepresentation av ett Compute-objekt som är associerat med den angivna arbetsytan. Returnerar en instans av en underordnad klass som motsvarar den specifika typen av det hämtade beräkningsobjektet.
- Arv
-
AmlCompute
Konstruktor
AmlCompute(workspace, name)
Parametrar
- workspace
- Workspace
Arbetsyteobjektet som innehåller AmlCompute-objektet som ska hämtas.
Kommentarer
I följande exempel skapas ett beständigt beräkningsmål som etablerats av AmlCompute . Parametern provisioning_configuration
i det här exemplet är av typen AmlComputeProvisioningConfiguration, som är en underordnad klass till 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)
Fullständigt exempel är tillgängligt från https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-amlcompute/train-on-amlcompute.ipynb
Metoder
add_identity |
Lägg till identitetstyp och/eller identitets-ID för det här AmlCompute-målet. |
delete |
Ta bort AmlCompute-objektet från dess associerade arbetsyta. |
deserialize |
Konvertera ett JSON-objekt till ett AmlCompute-objekt. |
detach |
Detach stöds inte för AmlCompute-objekt. Använd delete i stället. |
get |
Returnera beräkningsobjekt. |
get_active_runs |
Returnera en generator av körningarna för den här beräkningen. |
get_status |
Hämta den aktuella detaljerade statusen för AmlCompute-klustret. |
list_nodes |
Hämta information (t.ex. IP-adress, port osv.) för alla beräkningsnoder i beräkningsmålet. |
list_quotas |
Hämta de för närvarande tilldelade kvoterna för arbetsytor baserat på VMFamily för en viss arbetsyta och prenumeration. |
list_usages |
Hämta aktuell användningsinformation samt begränsningar för AML-resurser för angiven arbetsyta och prenumeration. |
provisioning_configuration |
Skapa ett konfigurationsobjekt för etablering av ett AmlCompute-mål. |
refresh_state |
Utför en uppdatering på plats av objektets egenskaper. Den här metoden uppdaterar egenskaperna baserat på det aktuella tillståndet för motsvarande molnobjekt. Detta används främst för manuell avsökning av beräkningstillstånd. |
remove_identity |
Ta bort identiteten för beräkningen. |
serialize |
Konvertera det här AmlCompute-objektet till en JSON-serialiserad ordlista. |
supported_vmsizes |
Visa en lista över vm-storlekar som stöds i en region. |
update |
ScaleSettings Uppdatera för det här AmlCompute-målet. |
update_quotas |
Uppdatera kvoten för en VM-familj på arbetsytan. |
wait_for_completion |
Vänta tills AmlCompute-klustret har slutfört etableringen. Detta kan konfigureras för att vänta på ett minsta antal noder och till timeout efter en angiven tidsperiod. |
add_identity
Lägg till identitetstyp och/eller identitets-ID för det här AmlCompute-målet.
add_identity(identity_type, identity_id=None)
Parametrar
- identity_type
- string
Möjliga värden:
SystemAssigned – Systemtilldelad identitet
UserAssigned – Användartilldelad identitet. Kräver att identitets-ID anges.
Lista över resurs-ID:t för den användartilldelade identiteten. t.ex. ['/subscriptions//resourceGroups//providers/Microsoft.ManagedIdentity /userAssignedIdentities/']
Kommentarer
identity_id bör endast anges när identity_type == UserAssigned
delete
Ta bort AmlCompute-objektet från dess associerade arbetsyta.
delete()
Undantag
Kommentarer
Om det här objektet skapades via Azure Machine Learning tas även motsvarande molnbaserade objekt bort. Om det här objektet skapades externt och endast kopplades till arbetsytan genererar den här metoden en ComputeTargetException och ingenting ändras.
deserialize
Konvertera ett JSON-objekt till ett AmlCompute-objekt.
static deserialize(workspace, object_dict)
Parametrar
Returer
AmlCompute-representationen av det angivna JSON-objektet.
Returtyp
Undantag
Kommentarer
Genererar en ComputeTargetException om den angivna arbetsytan inte är den arbetsyta som beräkning är associerad med.
detach
get
Returnera beräkningsobjekt.
get()
get_active_runs
Returnera en generator av körningarna för den här beräkningen.
get_active_runs(type=None, tags=None, properties=None, status=None)
Parametrar
- type
- str
Filtrera den returnerade generatorn för körningar efter den angivna typen. Se add_type_provider för att skapa körningstyper.
Filterkörningar efter "egenskap" eller {"egenskap": "värde"}
Returer
en generator av ~_restclient.models.RunDto
Returtyp
get_status
Hämta den aktuella detaljerade statusen för AmlCompute-klustret.
get_status()
Returer
Ett detaljerat statusobjekt för klustret
Returtyp
list_nodes
Hämta information (t.ex. IP-adress, port osv.) för alla beräkningsnoder i beräkningsmålet.
list_nodes()
Returer
Information om alla beräkningsnoder i beräkningsmålet.
Returtyp
list_quotas
Hämta de för närvarande tilldelade kvoterna för arbetsytor baserat på VMFamily för en viss arbetsyta och prenumeration.
static list_quotas(workspace, location=None)
Parametrar
- workspace
- Workspace
- location
- str
Platsen för kvoterna. Om det inte anges används standardplatsen för arbetsytan.
Returer
Lista över tilldelade arbetsytekvoter baserat på VMFamily
Returtyp
list_usages
Hämta aktuell användningsinformation samt begränsningar för AML-resurser för angiven arbetsyta och prenumeration.
static list_usages(workspace, show_all=False, location=None)
Parametrar
- workspace
- Workspace
- show_all
Anger om detaljerad användning av underordnade resurser krävs. Standardvärdet är Falskt
- location
- str
Platsen för resurserna. Om det inte anges används standardplatsen för arbetsytan.
Returer
Lista över aktuell användningsinformation samt gränser för AML-resurser
Returtyp
provisioning_configuration
Skapa ett konfigurationsobjekt för etablering av ett AmlCompute-mål.
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)
Parametrar
- vm_size
- str
Storleken på de virtuella agentdatorerna. Mer information finns här: https://aka.ms/azureml-vm-details. Observera att inte alla storlekar är tillgängliga i alla regioner, enligt beskrivningen i föregående länk. Om det inte anges Standard_NC6 som standard.
- min_nodes
- int
Det minsta antalet noder som ska användas i klustret. Om det inte anges är standardvärdet 0.
- max_nodes
- int
Det maximala antalet noder som ska användas i klustret. Om det inte anges är standardvärdet 4.
- idle_seconds_before_scaledown
- int
Nodens inaktiva tid i sekunder innan klustret skalas ned. Om det inte anges är standardvärdet 1800.
- admin_username
- str
Namnet på administratörsanvändarkontot som kan användas för att SSH i noder.
- admin_user_ssh_key
- str
Den offentliga SSH-nyckeln för administratörsanvändarkontot.
- vnet_resourcegroup_name
- str
Namnet på resursgruppen där det virtuella nätverket finns.
En ordlista med nyckelvärdetaggar som ska anges för beräkningsobjektet.
- remote_login_port_public_access
- str
Tillstånd för den offentliga SSH-porten. Möjliga värden:
Inaktiverad – Anger att den offentliga ssh-porten är stängd på alla noder i klustret.
Aktiverad – Anger att den offentliga ssh-porten är öppen på alla noder i klustret.
NotSpecified – Anger att den offentliga ssh-porten är stängd på alla noder i klustret om det virtuella nätverket har definierats, annars är alla offentliga noder öppna. Det kan bara vara det här standardvärdet när klustret skapas. När den har skapats aktiveras eller inaktiveras den.
- identity_type
- string
Möjliga värden:
SystemAssigned – Systemtilldelad identitet
UserAssigned – Användartilldelad identitet. Kräver att identitets-ID anges.
Lista över resurs-ID:t för den användartilldelade identiteten. t.ex. ['/subscriptions//resourceGroups//providers/Microsoft.ManagedIdentity/userAssignedIdentities/']
- enable_node_public_ip
- bool
Aktivera nodens offentliga IP-adress. Möjliga värden:
True – Aktivera nodens offentliga IP-adress.
Falskt – Inaktivera offentlig IP-adress för nod.
NotSpecified – Aktivera offentlig IP-adress för nod.
Returer
Ett konfigurationsobjekt som ska användas när du skapar ett Compute-objekt.
Returtyp
Undantag
refresh_state
Utför en uppdatering på plats av objektets egenskaper.
Den här metoden uppdaterar egenskaperna baserat på det aktuella tillståndet för motsvarande molnobjekt. Detta används främst för manuell avsökning av beräkningstillstånd.
refresh_state()
remove_identity
Ta bort identiteten för beräkningen.
remove_identity(identity_id=None)
Parametrar
Kommentarer
Systemtilldelad identitet tas bort automatiskt om identity_id inte anges
serialize
Konvertera det här AmlCompute-objektet till en JSON-serialiserad ordlista.
serialize()
Returer
JSON-representationen av det här AmlCompute-objektet.
Returtyp
supported_vmsizes
Visa en lista över vm-storlekar som stöds i en region.
static supported_vmsizes(workspace, location=None)
Parametrar
- workspace
- Workspace
- location
- str
Platsen för klustret. Om detta inte anges används standardplatsen för arbetsytan.
Returer
En lista över VM-storlekar som stöds i en region med namnen på den virtuella datorn, VVCPU:er och RAM-minne.
Returtyp
update
ScaleSettings Uppdatera för det här AmlCompute-målet.
update(min_nodes=None, max_nodes=None, idle_seconds_before_scaledown=None)
Parametrar
- idle_seconds_before_scaledown
- int
Nodens inaktiva tid i sekunder innan klustret skalas ned.
update_quotas
Uppdatera kvoten för en VM-familj på arbetsytan.
static update_quotas(workspace, vm_family, limit=None, location=None)
Parametrar
- workspace
- Workspace
- location
- str
Kvotens plats. Om detta inte anges används standardplatsen för arbetsytan.
wait_for_completion
Vänta tills AmlCompute-klustret har slutfört etableringen.
Detta kan konfigureras för att vänta på ett minsta antal noder och till timeout efter en angiven tidsperiod.
wait_for_completion(show_output=False, min_node_count=None, timeout_in_minutes=25, is_delete_operation=False)
Parametrar
- min_node_count
- int
Minsta antal noder att vänta på innan etableringen ska slutföras. Detta behöver inte vara lika med det minsta antalet noder som beräkningen etablerades med, men den bör inte vara större än så.
- timeout_in_minutes
- int
Varaktigheten i minuter att vänta innan etableringen övervägs har misslyckats.
Undantag
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för