Condividi tramite


ComputeInstance Classe

Gestisce un ambiente di sviluppo ml ottimizzato basato sul cloud in Azure Machine Learning.

Un'istanza di calcolo di Azure Machine Learning è un ambiente di sviluppo completamente configurato e gestito nel cloud ottimizzato per i flussi di lavoro di sviluppo di Machine Learning. ComputeInstance viene in genere usato per creare un ambiente di sviluppo o come destinazione di calcolo per il training e l'inferenza per lo sviluppo e il test. Con una ComputeInstance è possibile creare, eseguire il training e distribuire modelli in un'esperienza notebook completamente integrata nell'area di lavoro. Per altre informazioni, vedere Che cos'è un'istanza di calcolo di Azure Machine Learning?.

Costruttore ComputeTarget della classe.

Recuperare una rappresentazione cloud di un oggetto Compute associato all'area di lavoro specificata. Restituisce un'istanza di una classe figlio corrispondente al tipo specifico dell'oggetto Compute recuperato.

Ereditarietà
ComputeInstance

Costruttore

ComputeInstance(workspace, name)

Parametri

workspace
Workspace
Necessario

Oggetto workspace contenente l'oggetto Compute da recuperare.

name
str
Necessario

Nome dell'oggetto Compute da recuperare.

Metodi

delete

Rimuovere l'oggetto ComputeInstance dall'area di lavoro associata.

deserialize

Convertire un oggetto JSON in un oggetto ComputeInstance.

Questo errore ha esito negativo se l'area di lavoro specificata non è l'area di lavoro a cui è associata l'istanza di calcolo.

detach

Lo scollegamento non è supportato per l'oggetto ComputeInstance. Usare invece delete.

get

Restituisce l'oggetto ComputeInstance.

get_active_runs

Restituisce un generatore delle esecuzioni per questo calcolo.

get_docs_url

URL della documentazione per questa classe.

get_status

Recuperare lo stato dettagliato corrente per ComputeInstance.

provisioning_configuration

Creare un oggetto di configurazione per il provisioning di una destinazione ComputeInstance.

refresh_state

Eseguire un aggiornamento sul posto delle proprietà dell'oggetto .

Questo metodo aggiorna le proprietà in base allo stato corrente dell'oggetto cloud corrispondente. Ciò è utile principalmente per il polling manuale dello stato di calcolo.

restart

Riavviare ComputeInstance.

serialize

Convertire questo oggetto ComputeInstance in un dizionario serializzato JSON.

start

Avviare ComputeInstance.

stop

Arrestare ComputeInstance.

supported_vmsizes

Elencare le dimensioni delle macchine virtuali supportate in un'area.

wait_for_completion

Attendere che ComputeInstance finisca il provisioning.

delete

Rimuovere l'oggetto ComputeInstance dall'area di lavoro associata.

delete(wait_for_completion=False, show_output=False)

Parametri

wait_for_completion
valore predefinito: False
show_output
valore predefinito: False

Eccezioni

Commenti

Se questo oggetto è stato creato tramite Azure ML, verranno eliminati anche gli oggetti basati sul cloud corrispondenti. Se questo oggetto è stato creato esternamente e collegato solo all'area di lavoro, genererà un'eccezione e non verrà modificato nulla.

deserialize

Convertire un oggetto JSON in un oggetto ComputeInstance.

Questo errore ha esito negativo se l'area di lavoro specificata non è l'area di lavoro a cui è associata l'istanza di calcolo.

static deserialize(workspace, object_dict)

Parametri

workspace
Workspace
Necessario

L'oggetto workspace a cui è associato l'oggetto ComputeInstance.

object_dict
dict
Necessario

Oggetto JSON da convertire in un oggetto ComputeInstance.

Restituisce

Rappresentazione ComputeInstance dell'oggetto JSON fornito.

Tipo restituito

Eccezioni

detach

Lo scollegamento non è supportato per l'oggetto ComputeInstance. Usare invece delete.

detach()

Eccezioni

L'operazione non è supprota.

get

Restituisce l'oggetto ComputeInstance.

get()

Restituisce

Rappresentazione ComputeInstance dell'oggetto JSON fornito.

Tipo restituito

Eccezioni

get_active_runs

Restituisce un generatore delle esecuzioni per questo calcolo.

get_active_runs(type=None, tags=None, properties=None, status=None)

Parametri

type
str
valore predefinito: None

Filtrare il generatore restituito di esecuzioni in base al tipo specificato. Vedere add_type_provider per la creazione di tipi di esecuzione.

tags
str oppure dict
valore predefinito: None

Il filtro viene eseguito in base a "tag" o {"tag": "value"}

properties
str oppure dict
valore predefinito: None

Il filtro viene eseguito in base a "property" o {"property": "value"}

status
str
valore predefinito: None

Lo stato dell'esecuzione può essere "In esecuzione" o "In coda".

Restituisce

Generatore di azureml._restclient.models.RunDto

Tipo restituito

<xref:builtin.generator>

Eccezioni

get_docs_url

URL della documentazione per questa classe.

get_docs_url()

Restituisce

url

Tipo restituito

str

Eccezioni

get_status

Recuperare lo stato dettagliato corrente per ComputeInstance.

get_status()

Restituisce

Oggetto stato dettagliato per il calcolo

Tipo restituito

Eccezioni

provisioning_configuration

Creare un oggetto di configurazione per il provisioning di una destinazione ComputeInstance.

static provisioning_configuration(vm_size='', ssh_public_access=False, admin_user_ssh_public_key=None, vnet_resourcegroup_name=None, vnet_name=None, subnet_name=None, tags=None, description=None, assigned_user_object_id=None, assigned_user_tenant_id=None)

Parametri

vm_size
str
Necessario

Dimensioni delle macchine virtuali dell'agente. Altri dettagli sono disponibili qui: https://aka.ms/azureml-vm-details. Si noti che non tutte le dimensioni sono disponibili in tutte le aree, come descritto nel collegamento precedente. Il valore predefinito è Standard_NC6.

ssh_public_access
bool
valore predefinito: False

Indica lo stato della porta SSH pubblica. I valori possibili sono:

  • False: la porta SSH pubblica è chiusa.
  • True: la porta SSH pubblica è aperta.
admin_user_ssh_public_key
str
valore predefinito: None

Chiave pubblica SSH dell'account utente amministratore.

vnet_resourcegroup_name
str
valore predefinito: None

Nome del gruppo di risorse in cui si trova la rete virtuale.

vnet_name
str
valore predefinito: None

nome della rete virtuale.

subnet_name
str
valore predefinito: None

Nome della subnet all'interno della rete virtuale.

tags
dict[str, str]
valore predefinito: None

Dizionario facoltativo di tag chiave valore da associare all'oggetto di calcolo.

description
str
valore predefinito: None

Descrizione facoltativa per l'oggetto di calcolo.

assigned_user_object_id
str
valore predefinito: None

ID oggetto AAD dell'utente assegnato (anteprima).

assigned_user_tenant_id
str
valore predefinito: None

ID tenant di AAD dell'utente assegnato (anteprima).

Restituisce

Oggetto di configurazione da utilizzare durante la creazione di un oggetto Compute.

Tipo restituito

Eccezioni

refresh_state

Eseguire un aggiornamento sul posto delle proprietà dell'oggetto .

Questo metodo aggiorna le proprietà in base allo stato corrente dell'oggetto cloud corrispondente. Ciò è utile principalmente per il polling manuale dello stato di calcolo.

refresh_state()

Eccezioni

restart

Riavviare ComputeInstance.

restart(wait_for_completion=False, show_output=False)

Parametri

wait_for_completion
bool
valore predefinito: False

Valore booleano in attesa dell'aggiornamento dello stato. Il valore predefinito è False.

show_output
bool
valore predefinito: False

Valore booleano per fornire un output più dettagliato. Il valore predefinito è False.

Restituisce

Nessuno

Tipo restituito

Eccezioni

azureml.exceptions.ComputeTargetException:

serialize

Convertire questo oggetto ComputeInstance in un dizionario serializzato JSON.

serialize()

Restituisce

Rappresentazione JSON di questo oggetto ComputeInstance.

Tipo restituito

Eccezioni

start

Avviare ComputeInstance.

start(wait_for_completion=False, show_output=False)

Parametri

wait_for_completion
bool
valore predefinito: False

Indica se attendere l'aggiornamento dello stato. Il valore predefinito è False.

show_output
bool
valore predefinito: False

Indica se fornire un output più dettagliato. Il valore predefinito è False.

Restituisce

Nessuno

Tipo restituito

Eccezioni

stop

Arrestare ComputeInstance.

stop(wait_for_completion=False, show_output=False)

Parametri

wait_for_completion
bool
valore predefinito: False

Indica se attendere l'aggiornamento dello stato. Il valore predefinito è False.

show_output
bool
valore predefinito: False

Indica se fornire un output più dettagliato. Il valore predefinito è False.

Restituisce

Nessuno

Tipo restituito

Eccezioni

supported_vmsizes

Elencare le dimensioni delle macchine virtuali supportate in un'area.

static supported_vmsizes(workspace, location=None)

Parametri

workspace
Workspace
Necessario

Area di lavoro.

location
str
valore predefinito: None

Posizione dell'istanza. Se non specificato, il valore predefinito è il percorso dell'area di lavoro.

Restituisce

Elenco delle dimensioni di VM supportate in un'area con nome della macchina virtuale, delle VCPU e della RAM.

Tipo restituito

Eccezioni

wait_for_completion

Attendere che ComputeInstance finisca il provisioning.

wait_for_completion(show_output=False, is_delete_operation=False)

Parametri

show_output
bool
valore predefinito: False

Indica se fornire un output più dettagliato. Il valore predefinito è False.

is_delete_operation
bool
valore predefinito: False

Indica se l'operazione è destinata all'eliminazione.

Eccezioni