ComputeInstance Klasse

Verwaltet eine cloudbasierte, optimierte ML-Entwicklungsumgebung in Azure Machine Learning.

Eine Azure Machine Learning-Computeinstanz ist eine vollständig konfigurierte und verwaltete Entwicklungsumgebung in der Cloud, die für Machine Learning-Entwicklungsworkflows optimiert ist. ComputeInstance wird in der Regel verwendet, um eine Entwicklungsumgebung oder als Computeziel für Schulungen und Ableitungen für Entwicklung und Tests zu erstellen. Mit einer ComputeInstance können Sie Modelle in einem vollständig integrierten Notizbuch in Ihrem Arbeitsbereich erstellen, trainieren und bereitstellen. Weitere Informationen hierzu finden Sie unter Was ist eine Azure Machine Learning-Compute-Instanz?

Class ComputeTarget-Konstruktor.

Rufen Sie eine Clouddarstellung eines Compute-Objekts ab, das dem bereitgestellten Arbeitsbereich zugeordnet ist. Gibt eine Instanz einer untergeordneten Klasse zurück, die dem spezifischen Typ des abgerufenen Compute-Objekts entspricht.

Konstruktor

ComputeInstance(workspace, name)

Parameter

Name	Beschreibung
workspace Erforderlich	Workspace Das Arbeitsbereichsobjekt, das das compute-Objekt enthält, das abgerufen werden soll.
name Erforderlich	str Der Name des abzurufenden Compute-Objekts.

Methoden

delete	Entfernen Sie das ComputeInstance-Objekt aus dem zugeordneten Arbeitsbereich.
deserialize	Konvertieren Sie ein JSON-Objekt in ein ComputeInstance-Objekt. Dies schlägt fehl, wenn der bereitgestellte Arbeitsbereich nicht der Arbeitsbereich ist, dem die ComputeInstance zugeordnet ist.
detach	Das Trennen wird für das ComputeInstance-Objekt nicht unterstützt. Verwenden Sie stattdessen delete.
get	Gibt computeInstance-Objekt zurück.
get_active_runs	Gibt einen Generator der Ausführung für diese Berechnung zurück.
get_docs_url	Url zur Dokumentation für diese Klasse.
get_status	Rufen Sie den aktuellen detaillierten Status für die ComputeInstance ab.
provisioning_configuration	Erstellen Sie ein Konfigurationsobjekt für die Bereitstellung eines ComputeInstance-Ziels.
refresh_state	Führen Sie eine direkte Aktualisierung der Eigenschaften des Objekts durch. Diese Methode aktualisiert die Eigenschaften basierend auf dem aktuellen Zustand des entsprechenden Cloudobjekts. Dies ist in erster Linie nützlich für die manuelle Abfrage des Berechnungszustands.
restart	Starten Sie die ComputeInstance neu.
serialize	Konvertieren Sie dieses ComputeInstance-Objekt in ein serialisiertes JSON-Wörterbuch.
start	Starten Sie die ComputeInstance.
stop	Beenden Sie die ComputeInstance.
supported_vmsizes	Listet die unterstützten VM-Größen in einer Region auf.
update_sso_settings	Aktualisieren Sie die Einstellungen für einmaliges Anmelden der Computeinstanz.
wait_for_completion	Warten Sie, bis die Bereitstellung abgeschlossen ist.

delete

Entfernen Sie das ComputeInstance-Objekt aus dem zugeordneten Arbeitsbereich.

delete(wait_for_completion=False, show_output=False)

Parameter

Name	Beschreibung
wait_for_completion	Standardwert: False
show_output	Standardwert: False

Ausnahmen

Typ	Beschreibung
ComputeTargetException

Hinweise

Wenn dieses Objekt über Azure ML erstellt wurde, werden auch die entsprechenden cloudbasierten Objekte gelöscht. Wenn dieses Objekt extern erstellt und nur an den Arbeitsbereich angefügt wurde, löst es eine Ausnahme aus, und nichts wird geändert.

deserialize

Konvertieren Sie ein JSON-Objekt in ein ComputeInstance-Objekt.

Dies schlägt fehl, wenn der bereitgestellte Arbeitsbereich nicht der Arbeitsbereich ist, dem die ComputeInstance zugeordnet ist.

static deserialize(workspace, object_dict)

Parameter

Name	Beschreibung
workspace Erforderlich	Workspace Das Arbeitsbereichsobjekt, dem das ComputeInstance-Objekt zugeordnet ist.
object_dict Erforderlich	dict Ein JSON-Objekt, das in ein ComputeInstance-Objekt konvertiert werden soll.

Gibt zurück

Typ	Beschreibung
ComputeInstance	Die ComputeInstance-Darstellung des bereitgestellten JSON-Objekts.

Ausnahmen

Typ	Beschreibung
ComputeTargetException

detach

Das Trennen wird für das ComputeInstance-Objekt nicht unterstützt. Verwenden Sie stattdessen delete.

detach()

Ausnahmen

Typ	Beschreibung
ComputeTargetException	Der Vorgang wird nicht angenommen.

get

Gibt computeInstance-Objekt zurück.

get()

Gibt zurück

Typ	Beschreibung
ComputeInstance	Die ComputeInstance-Darstellung des bereitgestellten JSON-Objekts.

Ausnahmen

Typ	Beschreibung
ComputeTargetException

get_active_runs

Gibt einen Generator der Ausführung für diese Berechnung zurück.

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

Parameter

Name	Beschreibung
type	str Filtern Sie den zurückgegebenen Generator, der vom angegebenen Typ ausgeführt wird. Informationen zum Erstellen von Ausführungstypen finden Sie unter.See add_type_provider for creating run types. Standardwert: None
tags	str oder dict Filter wird von "tag" oder {"tag": "value"} ausgeführt. Standardwert: None
properties	str oder dict Filter wird von "property" oder {"property" ausgeführt: "value"} Standardwert: None
status	str Der Ausführungsstatus kann "Ausführen" oder "In der Warteschlange" sein. Standardwert: None

Gibt zurück

Typ	Beschreibung
<xref:builtin.generator>	Ein Generator von azureml._restclient.models.RunDto

get_docs_url

Url zur Dokumentation für diese Klasse.

get_docs_url()

Gibt zurück

Typ	Beschreibung
str	URL

get_status

Rufen Sie den aktuellen detaillierten Status für die ComputeInstance ab.

get_status()

Gibt zurück

Typ	Beschreibung
ComputeInstanceStatus	Ein detailliertes Statusobjekt für die Berechnung

provisioning_configuration

Erstellen Sie ein Konfigurationsobjekt für die Bereitstellung eines ComputeInstance-Ziels.

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)

Parameter

Name	Beschreibung
vm_size Erforderlich	str Die Größe von Agent-VMs. Weitere Details finden Sie hier: https://aka.ms/azureml-vm-details. Beachten Sie, dass nicht alle Größen in allen Regionen verfügbar sind, wie im vorherigen Link beschrieben. Standardmäßig wird Standard_NC6.
ssh_public_access	bool Gibt den Status des öffentlichen SSH-Ports an. Mögliche Werte sind: False – Der öffentliche SSH-Port ist geschlossen. True – Der öffentliche SSH-Port ist geöffnet. Standardwert: False
admin_user_ssh_public_key	str Der öffentliche SSH-Schlüssel des Administrator-Benutzerkontos. Standardwert: None
vnet_resourcegroup_name	str Der Name der Ressourcengruppe, in der sich das virtuelle Netzwerk befindet. Standardwert: None
vnet_name	str Den Namen des virtuellen Netzwerks. Standardwert: None
subnet_name	str Der Name des Subnetzes innerhalb des vnet. Standardwert: None
tags	dict[str, str] Ein optionales Wörterbuch mit Schlüsselwerttags, das dem Computeobjekt zugeordnet werden soll. Standardwert: None
description	str Eine optionale Beschreibung für das Computeobjekt. Standardwert: None
assigned_user_object_id	str Die AAD-Objekt-ID des zugewiesenen Benutzers (Vorschau). Standardwert: None
assigned_user_tenant_id	str Die AAD-Mandanten-ID des zugewiesenen Benutzers (Vorschau). Standardwert: None

Gibt zurück

Typ	Beschreibung
ComputeInstanceProvisioningConfiguration	Ein Konfigurationsobjekt, das beim Erstellen eines Compute-Objekts verwendet werden soll.

Ausnahmen

Typ	Beschreibung
ComputeTargetException

refresh_state

Führen Sie eine direkte Aktualisierung der Eigenschaften des Objekts durch.

Diese Methode aktualisiert die Eigenschaften basierend auf dem aktuellen Zustand des entsprechenden Cloudobjekts. Dies ist in erster Linie nützlich für die manuelle Abfrage des Berechnungszustands.

refresh_state()

restart

Starten Sie die ComputeInstance neu.

restart(wait_for_completion=False, show_output=False)

Parameter

Name	Beschreibung
wait_for_completion	bool Boolescher Wert, um auf das Statusupdate zu warten. Der Standardwert lautet „False“. Standardwert: False
show_output	bool Boolescher Wert, um ausführlichere Ausgaben bereitzustellen. Der Standardwert lautet „False“. Standardwert: False

Gibt zurück

Typ	Beschreibung
None	Nichts

Ausnahmen

Typ	Beschreibung
azureml.exceptions.ComputeTargetException:

serialize

Konvertieren Sie dieses ComputeInstance-Objekt in ein serialisiertes JSON-Wörterbuch.

serialize()

Gibt zurück

Typ	Beschreibung
dict	Die JSON-Darstellung dieses ComputeInstance-Objekts.

start

Starten Sie die ComputeInstance.

start(wait_for_completion=False, show_output=False)

Parameter

Name	Beschreibung
wait_for_completion	bool Gibt an, ob auf das Statusupdate gewartet werden soll. Der Standardwert lautet „False“. Standardwert: False
show_output	bool Gibt an, ob eine ausführlichere Ausgabe bereitgestellt werden soll. Der Standardwert lautet „False“. Standardwert: False

Gibt zurück

Typ	Beschreibung
None	Nichts

Ausnahmen

Typ	Beschreibung
ComputeTargetException

stop

Beenden Sie die ComputeInstance.

stop(wait_for_completion=False, show_output=False)

Parameter

Name	Beschreibung
wait_for_completion	bool Gibt an, ob auf das Statusupdate gewartet werden soll. Der Standardwert lautet „False“. Standardwert: False
show_output	bool Gibt an, ob eine ausführlichere Ausgabe bereitgestellt werden soll. Der Standardwert lautet „False“. Standardwert: False

Gibt zurück

Typ	Beschreibung
None	Nichts

Ausnahmen

Typ	Beschreibung
ComputeTargetException

supported_vmsizes

Listet die unterstützten VM-Größen in einer Region auf.

static supported_vmsizes(workspace, location=None)

Parameter

Name	Beschreibung
workspace Erforderlich	Workspace Der Arbeitsbereich.
location	str Der Speicherort der Instanz. Wenn nicht angegeben, ist die Standardeinstellung der Arbeitsbereichsspeicherort. Standardwert: None

Gibt zurück

Typ	Beschreibung
list	Eine Liste der unterstützten VM-Größen in einer Region mit dem Namen der VM, VCPUs und RAM.

update_sso_settings

Aktualisieren Sie die Einstellungen für einmaliges Anmelden der Computeinstanz.

update_sso_settings(value)

Parameter

Name	Beschreibung
value Erforderlich	bool Der Wert der sso-Einstellungen

Gibt zurück

Typ	Beschreibung
bool	Ob das Update erfolgreich war oder nicht

wait_for_completion

Warten Sie, bis die Bereitstellung abgeschlossen ist.

wait_for_completion(show_output=False, is_delete_operation=False)

Parameter

Name	Beschreibung
show_output	bool Gibt an, ob eine ausführlichere Ausgabe bereitgestellt werden soll. Der Standardwert lautet „False“. Standardwert: False
is_delete_operation	bool Gibt an, ob der Vorgang zum Löschen vorgesehen ist. Standardwert: False

Ausnahmen

Typ	Beschreibung
ComputeTargetException

Feedback

War diese Seite hilfreich?

Freigeben über

ComputeInstance Klasse

Konstruktor

Parameter

Methoden

delete

Parameter

Ausnahmen

Hinweise

deserialize

Parameter

Gibt zurück

Ausnahmen

detach

Ausnahmen

get

Gibt zurück

Ausnahmen

get_active_runs

Parameter

Gibt zurück

get_docs_url

Gibt zurück

get_status

Gibt zurück

provisioning_configuration

Parameter

Gibt zurück

Ausnahmen

refresh_state

restart

Parameter

Gibt zurück

Ausnahmen

serialize

Gibt zurück

start

Parameter

Gibt zurück

Ausnahmen

stop

Parameter

Gibt zurück

Ausnahmen

supported_vmsizes

Parameter

Gibt zurück

update_sso_settings

Parameter

Gibt zurück

wait_for_completion

Parameter

Ausnahmen

Feedback