Condividi tramite

ComputeInstance Classe

  • Riferimento

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 un'istanza computeInstance è possibile creare, eseguire il training e distribuire modelli in un'esperienza notebook completamente integrata nell'area di lavoro. Per altre informazioni, vedere Informazioni su un'istanza di calcolo di Azure Machine Learning?

Costruttore ComputeTarget di 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à
ComputeTarget
ComputeInstance

Costruttore

ComputeInstance(workspace, name)

Parametri

Nome Descrizione
workspace
Necessario
Workspace

Oggetto dell'area di lavoro contenente l'oggetto Compute da recuperare.
name
Necessario
str

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 è associata all'area di lavoro ComputeInstance.
detach

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

Restituisce l'oggetto ComputeInstance.
get_active_runs

Restituisce un generatore di 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ò è principalmente utile 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 della macchina virtuale supportate in un'area.
wait_for_completion

Attendere il completamento del provisioning di ComputeInstance.

delete

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

delete(wait_for_completion=False, show_output=False)

Parametri

Nome Descrizione
wait_for_completion
Valore predefinito: False
show_output
Valore predefinito: False

Eccezioni

Tipo Descrizione
ComputeTargetException

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à l'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 è associata all'area di lavoro ComputeInstance.

static deserialize(workspace, object_dict)

Parametri

Nome Descrizione
workspace
Necessario
Workspace

L'oggetto workspace l'oggetto ComputeInstance è associato.
object_dict
Necessario
dict

Oggetto JSON da convertire in un oggetto ComputeInstance.

Restituisce

Tipo Descrizione
ComputeInstance

Rappresentazione ComputeInstance dell'oggetto JSON specificato.

Eccezioni

Tipo Descrizione
ComputeTargetException

detach

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

detach()

Eccezioni

Tipo Descrizione
ComputeTargetException

L'operazione non è supprota.

get

Restituisce l'oggetto ComputeInstance.

get()

Restituisce

Tipo Descrizione
ComputeInstance

Rappresentazione ComputeInstance dell'oggetto JSON specificato.

Eccezioni

Tipo Descrizione
ComputeTargetException

get_active_runs

Restituisce un generatore di esecuzioni per questo calcolo.

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

Parametri

Nome Descrizione
type
str

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

Valore predefinito: None
tags
str oppure dict

Filtro eseguito da "tag" o {"tag": "value"}

Valore predefinito: None
properties
str oppure dict

Filtro eseguito da "property" o {"property": "value"}

Valore predefinito: None
status
str

Lo stato di esecuzione può essere "In esecuzione" o "Accodato".

Valore predefinito: None

Restituisce

Tipo Descrizione
<xref:builtin.generator>

Generatore di azureml._restclient.models.RunDto

Eccezioni

Tipo Descrizione
ComputeTargetException

get_docs_url

Url della documentazione per questa classe.

get_docs_url()

Restituisce

Tipo Descrizione
str

url

Eccezioni

Tipo Descrizione
ComputeTargetException

get_status

Recuperare lo stato dettagliato corrente per ComputeInstance.

get_status()

Restituisce

Tipo Descrizione
ComputeInstanceStatus

Oggetto stato dettagliato per il calcolo

Eccezioni

Tipo Descrizione
ComputeTargetException

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

Nome Descrizione
vm_size
Necessario
str

Dimensioni delle macchine virtuali dell'agente. Altre informazioni sono disponibili qui: https://aka.ms/azureml-vm-details. Si noti che non tutte le dimensioni sono disponibili in tutte le aree, come illustrato nel collegamento precedente. Impostazione predefinita per Standard_NC6.
ssh_public_access
bool

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

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

Chiave pubblica SSH dell'account utente amministratore.

Valore predefinito: None
vnet_resourcegroup_name
str

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

Valore predefinito: None
vnet_name
str

nome della rete virtuale.

Valore predefinito: None
subnet_name
str

Nome della subnet all'interno della rete virtuale.

Valore predefinito: None
tags
dict[str, str]

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

Valore predefinito: None
description
str

Descrizione facoltativa per l'oggetto di calcolo.

Valore predefinito: None
assigned_user_object_id
str

ID oggetto AAD dell'utente assegnato (anteprima).

Valore predefinito: None
assigned_user_tenant_id
str

ID tenant AAD dell'utente assegnato (anteprima).

Valore predefinito: None

Restituisce

Tipo Descrizione
ComputeInstanceProvisioningConfiguration

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

Eccezioni

Tipo Descrizione
ComputeTargetException

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ò è principalmente utile per il polling manuale dello stato di calcolo.

refresh_state()

Eccezioni

Tipo Descrizione
ComputeTargetException

restart

Riavviare ComputeInstance.

restart(wait_for_completion=False, show_output=False)

Parametri

Nome Descrizione
wait_for_completion
bool

Boolean per attendere l'aggiornamento dello stato. Il valore predefinito è False.

Valore predefinito: False
show_output
bool

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

Valore predefinito: False

Restituisce

Tipo Descrizione
None

Nessuno

Eccezioni

Tipo Descrizione
azureml.exceptions.ComputeTargetException:

serialize

Convertire questo oggetto ComputeInstance in un dizionario serializzato JSON.

serialize()

Restituisce

Tipo Descrizione
dict

Rappresentazione JSON di questo oggetto ComputeInstance.

Eccezioni

Tipo Descrizione
ComputeTargetException

start

Avviare ComputeInstance.

start(wait_for_completion=False, show_output=False)

Parametri

Nome Descrizione
wait_for_completion
bool

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

Valore predefinito: False
show_output
bool

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

Valore predefinito: False

Restituisce

Tipo Descrizione
None

Nessuno

Eccezioni

Tipo Descrizione
ComputeTargetException

stop

Arrestare ComputeInstance.

stop(wait_for_completion=False, show_output=False)

Parametri

Nome Descrizione
wait_for_completion
bool

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

Valore predefinito: False
show_output
bool

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

Valore predefinito: False

Restituisce

Tipo Descrizione
None

Nessuno

Eccezioni

Tipo Descrizione
ComputeTargetException

supported_vmsizes

Elencare le dimensioni della macchina virtuale supportate in un'area.

static supported_vmsizes(workspace, location=None)

Parametri

Nome Descrizione
workspace
Necessario
Workspace

Area di lavoro.
location
str

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

Valore predefinito: None

Restituisce

Tipo Descrizione
list

Elenco delle dimensioni della macchina virtuale supportate in un'area con nome della macchina virtuale, delle macchine virtuali, delle macchine virtuali e della RAM.

Eccezioni

Tipo Descrizione
ComputeTargetException

wait_for_completion

Attendere il completamento del provisioning di ComputeInstance.

wait_for_completion(show_output=False, is_delete_operation=False)

Parametri

Nome Descrizione
show_output
bool

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

Valore predefinito: False
is_delete_operation
bool

Indica se l'operazione è destinata all'eliminazione.

Valore predefinito: False

Eccezioni

Tipo Descrizione
ComputeTargetException