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?
Class ComputeTarget-konstruktor.
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 det AmlCompute-objekt som ska hämtas.
- workspace
- Workspace
Arbetsyteobjektet som innehåller beräkningsobjektet 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 |
Det går inte att koppla från 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 tilldelade kvoterna för arbetsytan 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 en viss 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 serialiserad JSON-ordlista. |
| supported_vmsizes |
Visa en lista över storlekar på virtuella datorer 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 ska 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 har skapats 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 Compute ä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.
Filtret körs efter "property" eller {"property": "value"}
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 tilldelade kvoterna för arbetsytan baserat på VMFamily för en viss arbetsyta och prenumeration.
static list_quotas(workspace, location=None)Parametrar
- workspace
- Workspace
- location
- str
Kvoternas plats. Om detta inte anges används standardplatsen för arbetsytan.
Returer
Lista över kvoter för tilldelade arbetsytor baserat på VMFamily
Returtyp
list_usages
Hämta aktuell användningsinformation samt begränsningar för AML-resurser för en viss 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 detta inte anges används standardplatsen för arbetsytan.
Returer
Lista över aktuell användningsinformation samt begränsningar 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å virtuella agentdatorer. 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 inget anges är standardvärdet 1800.
- admin_username
- str
Namnet på administratörsanvändarkontot som kan användas för att SSH till 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ärdestaggar som ska tillhandahållas till 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 VNet har definierats, annars är öppen alla offentliga noder. 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 offentlig IP-adress för noden. Möjliga värden:
True – Aktivera offentlig IP-adress för noden.
False – Inaktivera offentlig IP-adress för noden.
NotSpecified – Aktivera nodens offentliga IP-adress.
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 har angetts
serialize
Konvertera det här AmlCompute-objektet till en serialiserad JSON-ordlista.
serialize()Returer
JSON-representationen av det här AmlCompute-objektet.
Returtyp
supported_vmsizes
Visa en lista över storlekar på virtuella datorer som stöds i en region.
static supported_vmsizes(workspace, location=None)Parametrar
- workspace
- Workspace
- location
- str
Platsen för klustret. Om det inte anges används standardplatsen för arbetsytan.
Returer
En lista över vm-storlekar som stöds i en region med namn på den virtuella datorn, VCPU: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 det 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 är klar. 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 har misslyckats.
Undantag
Feedback
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: https://aka.ms/ContentUserFeedback.
Skicka och visa feedback för