Dela via

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