AmlCompute Klass

Referens

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: ComputeTarget

AmlCompute

Konstruktor

AmlCompute(workspace, name)

Parametrar

Name	Description
workspace Obligatorisk	Workspace Arbetsyteobjektet som innehåller det AmlCompute-objekt som ska hämtas.
name Obligatorisk	str Namnet på det AmlCompute-objekt som ska hämtas.
workspace Obligatorisk	Workspace Arbetsyteobjektet som innehåller beräkningsobjektet som ska hämtas.
name Obligatorisk	str Namnet på det Compute-objekt 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

Name	Description
identity_type Obligatorisk	string Möjliga värden: SystemAssigned – Systemtilldelad identitet UserAssigned – Användartilldelad identitet. Kräver att identitets-ID anges.
identity_id	list[str] Lista över resurs-ID:t för den användartilldelade identiteten. t.ex. ['/subscriptions//resourceGroups//providers/Microsoft.ManagedIdentity /userAssignedIdentities/'] Standardvärde: None

Kommentarer

identity_id ska endast anges när identity_type == UserAssigned

delete

Ta bort AmlCompute-objektet från dess associerade arbetsyta.

delete()

Undantag

Typ	Description
ComputeTargetException

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

Name	Description
workspace Obligatorisk	Workspace Arbetsyteobjektet som AmlCompute-objektet är associerat med.
object_dict Obligatorisk	dict Ett JSON-objekt som ska konverteras till ett AmlCompute-objekt.

Returer

Typ	Description
AmlCompute	AmlCompute-representationen av det angivna JSON-objektet.

Undantag

Typ	Description
ComputeTargetException

Kommentarer

Genererar en ComputeTargetException om den angivna arbetsytan inte är den arbetsyta som Compute är associerad med.

detach

Det går inte att koppla från för AmlCompute-objekt. Använd delete i stället.

detach()

Undantag

Typ	Description
ComputeTargetException

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

Name	Description
type	str Filtrera den returnerade generatorn för körningar efter den angivna typen. Se add_type_provider för att skapa körningstyper. Standardvärde: None
tags	str eller dict Filtret körs efter "tag" eller {"tag": "value"} Standardvärde: None
properties	str eller dict Filtret körs efter "property" eller {"property": "value"} Standardvärde: None
status	str Körningsstatus – antingen "Körs" eller "I kö" Standardvärde: None

Returer

Typ	Description
<xref:builtin.generator>	en generator av ~_restclient.models.RunDto

get_status

Hämta den aktuella detaljerade statusen för AmlCompute-klustret.

get_status()

Returer

Typ	Description
AmlComputeStatus	Ett detaljerat statusobjekt för klustret

list_nodes

Hämta information (t.ex. IP-adress, port osv.) för alla beräkningsnoder i beräkningsmålet.

list_nodes()

Returer

Typ	Description
list	Information om 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.

static list_quotas(workspace, location=None)

Parametrar

Name	Description
workspace Obligatorisk	Workspace
location	str Kvoternas plats. Om detta inte anges används standardplatsen för arbetsytan. Standardvärde: None

Returer

Typ	Description
list	Lista över kvoter för tilldelade arbetsytor baserat på VMFamily

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

Name	Description
workspace Obligatorisk	Workspace
show_all	Anger om detaljerad användning av underordnade resurser krävs. Standardvärdet är Falskt Standardvärde: False
location	str Platsen för resurserna. Om detta inte anges används standardplatsen för arbetsytan. Standardvärde: None

Returer

Typ	Description
list	Lista över aktuell användningsinformation samt begränsningar för AML-resurser

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

Name	Description
vm_size Obligatorisk	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.
vm_priority	str Vm-prioritet, dedikerad eller lågprioritet. Standardvärde: dedicated
min_nodes	int Det minsta antalet noder som ska användas i klustret. Om det inte anges är standardvärdet 0. Standardvärde: 0
max_nodes	int Det maximala antalet noder som ska användas i klustret. Om det inte anges är standardvärdet 4. Standardvärde: None
idle_seconds_before_scaledown	int Nodens inaktiva tid i sekunder innan klustret skalas ned. Om inget anges är standardvärdet 1800. Standardvärde: 1800
admin_username	str Namnet på administratörsanvändarkontot som kan användas för att SSH till noder. Standardvärde: None
admin_user_password	str Lösenordet för administratörsanvändarkontot. Standardvärde: None
admin_user_ssh_key	str Den offentliga SSH-nyckeln för administratörsanvändarkontot. Standardvärde: None
vnet_resourcegroup_name	str Namnet på resursgruppen där det virtuella nätverket finns. Standardvärde: None
vnet_name	str Namnet på det virtuella nätverket. Standardvärde: None
subnet_name	str Namnet på undernätet i det virtuella nätverket. Standardvärde: None
tags	dict[str, str] En ordlista med nyckelvärdestaggar som ska tillhandahållas till beräkningsobjektet. Standardvärde: None
description	str En beskrivning som ska tillhandahållas till beräkningsobjektet. Standardvärde: None
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. Standardvärde: NotSpecified
identity_type	string Möjliga värden: SystemAssigned – Systemtilldelad identitet UserAssigned – Användartilldelad identitet. Kräver att identitets-ID anges. Standardvärde: None
identity_id	list[str] Lista över resurs-ID:t för den användartilldelade identiteten. t.ex. ['/subscriptions//resourceGroups//providers/Microsoft.ManagedIdentity/userAssignedIdentities/'] Standardvärde: None
location	str Plats för att etablera kluster i. Standardvärde: None
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. Standardvärde: True

Returer

Typ	Description
AmlComputeProvisioningConfiguration	Ett konfigurationsobjekt som ska användas när du skapar ett Compute-objekt.

Undantag

Typ	Description
ComputeTargetException

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

Name	Description
identity_id	list[str] Användartilldelade identiteter Standardvärde: None

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

Typ	Description
dict	JSON-representationen av det här AmlCompute-objektet.

supported_vmsizes

Visa en lista över storlekar på virtuella datorer som stöds i en region.

static supported_vmsizes(workspace, location=None)

Parametrar

Name	Description
workspace Obligatorisk	Workspace
location	str Platsen för klustret. Om det inte anges används standardplatsen för arbetsytan. Standardvärde: None

Returer

Typ	Description
list	En lista över vm-storlekar som stöds i en region med namn på den virtuella datorn, VCPU:er och RAM-minne.

update

ScaleSettings Uppdatera för det här AmlCompute-målet.

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

Parametrar

Name	Description
min_nodes	int Det minsta antalet noder som ska användas i klustret. Standardvärde: None
max_nodes	int Det maximala antalet noder som ska användas i klustret. Standardvärde: None
idle_seconds_before_scaledown	int Nodens inaktiva tid i sekunder innan klustret skalas ned. Standardvärde: None

update_quotas

Uppdatera kvoten för en VM-familj på arbetsytan.

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

Parametrar

Name	Description
workspace Obligatorisk	Workspace
vm_family Obligatorisk	str Vm-familjenamn
limit	int Den maximala tillåtna kvoten för resursen Standardvärde: None
location	str Kvotens plats. Om det inte anges används standardplatsen för arbetsytan. Standardvärde: None

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

Name	Description
show_output	bool Booleskt värde för att ge mer utförliga utdata. Standardvärde: False
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å. Standardvärde: None
timeout_in_minutes	int Varaktigheten i minuter att vänta innan etableringen har misslyckats. Standardvärde: 25
is_delete_operation	bool Anger om åtgärden är avsedd för borttagning. Standardvärde: False

Undantag

Typ	Description
ComputeTargetException

Dela via

AmlCompute Klass

Konstruktor

Parametrar

Kommentarer

Metoder

add_identity

Parametrar

Kommentarer

delete

Undantag

Kommentarer

deserialize

Parametrar

Returer

Undantag

Kommentarer

detach

Undantag

get

get_active_runs

Parametrar

Returer

get_status

Returer

list_nodes

Returer

list_quotas

Parametrar

Returer

list_usages

Parametrar

Returer

provisioning_configuration

Parametrar

Returer

Undantag

refresh_state

remove_identity

Parametrar

Kommentarer

serialize

Returer

supported_vmsizes

Parametrar

Returer

update

Parametrar

update_quotas

Parametrar

wait_for_completion

Parametrar

Undantag

Feedback

Ytterligare resurser