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

Nome Descrizione
workspace
Necessario

Oggetto workspace 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 è 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

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

Eccezioni

Tipo Descrizione

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

Nome Descrizione
workspace
Necessario

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

object_dict
Necessario

Oggetto JSON da convertire in un oggetto ComputeInstance.

Restituisce

Tipo Descrizione

Rappresentazione ComputeInstance dell'oggetto JSON fornito.

Eccezioni

Tipo Descrizione

detach

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

detach()

Eccezioni

Tipo Descrizione

L'operazione non è supprota.

get

Restituisce l'oggetto ComputeInstance.

get()

Restituisce

Tipo Descrizione

Rappresentazione ComputeInstance dell'oggetto JSON fornito.

Eccezioni

Tipo Descrizione

get_active_runs

Restituisce un generatore delle 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 in base al tipo specificato. Vedere add_type_provider per la creazione di tipi di esecuzione.

Valore predefinito: None
tags
str oppure dict

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

Valore predefinito: None
properties
str oppure dict

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

Valore predefinito: None
status
str

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

Valore predefinito: None

Restituisce

Tipo Descrizione
<xref:builtin.generator>

Generatore di azureml._restclient.models.RunDto

Eccezioni

Tipo Descrizione

get_docs_url

URL della documentazione per questa classe.

get_docs_url()

Restituisce

Tipo Descrizione
str

url

Eccezioni

Tipo Descrizione

get_status

Recuperare lo stato dettagliato corrente per ComputeInstance.

get_status()

Restituisce

Tipo Descrizione

Oggetto stato dettagliato per il calcolo

Eccezioni

Tipo Descrizione

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. 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

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

Dizionario facoltativo di tag chiave valore 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 di AAD dell'utente assegnato (anteprima).

Valore predefinito: None

Restituisce

Tipo Descrizione

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

Eccezioni

Tipo Descrizione

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

Tipo Descrizione

restart

Riavviare ComputeInstance.

restart(wait_for_completion=False, show_output=False)

Parametri

Nome Descrizione
wait_for_completion

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

Valore predefinito: False
show_output

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

Valore predefinito: False

Restituisce

Tipo Descrizione

Nessuno

Eccezioni

Tipo Descrizione
azureml.exceptions.ComputeTargetException:

serialize

Convertire questo oggetto ComputeInstance in un dizionario serializzato JSON.

serialize()

Restituisce

Tipo Descrizione

Rappresentazione JSON di questo oggetto ComputeInstance.

Eccezioni

Tipo Descrizione

start

Avviare ComputeInstance.

start(wait_for_completion=False, show_output=False)

Parametri

Nome Descrizione
wait_for_completion

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

Valore predefinito: False
show_output

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

Valore predefinito: False

Restituisce

Tipo Descrizione

Nessuno

Eccezioni

Tipo Descrizione

stop

Arrestare ComputeInstance.

stop(wait_for_completion=False, show_output=False)

Parametri

Nome Descrizione
wait_for_completion

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

Valore predefinito: False
show_output

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

Valore predefinito: False

Restituisce

Tipo Descrizione

Nessuno

Eccezioni

Tipo Descrizione

supported_vmsizes

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

static supported_vmsizes(workspace, location=None)

Parametri

Nome Descrizione
workspace
Necessario

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

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

Eccezioni

Tipo Descrizione

wait_for_completion

Attendere che ComputeInstance finisca il provisioning.

wait_for_completion(show_output=False, is_delete_operation=False)

Parametri

Nome Descrizione
show_output

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

Valore predefinito: False
is_delete_operation

Indica se l'operazione è destinata all'eliminazione.

Valore predefinito: False

Eccezioni

Tipo Descrizione