Freigeben über

ComputeInstance Klasse

  • Referenz

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. Eine ComputeInstance wird in der Regel zum Erstellen einer Entwicklungsumgebung oder als Computeziel für das Trainieren und Rückschließen in der Entwicklung und bei Tests verwendet. Mit einer ComputeInstance können Sie Modelle in einer vollständig integrierten Notebook-Benutzeroberfläche in Ihrem Arbeitsbereich erstellen, trainieren und bereitstellen. Weitere Informationen hierzu finden Sie unter Was ist eine Azure Machine Learning-Compute-Instanz?

ComputeTarget-Konstruktor der Klasse.

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

Vererbung
ComputeTarget
ComputeInstance

Konstruktor

ComputeInstance(workspace, name)

Parameter

Name Beschreibung
workspace
Erforderlich
Workspace

Das Workspace-Objekt, das das abzurufende Compute-Objekt enthält.
name
Erforderlich
str

Der Name des abzurufenden Compute-Objekts.

Methoden

delete

Entfernen des ComputeInstance-Objekts aus dem zugeordneten Arbeitsbereich.
deserialize

Konvertieren eines JSON-Objekts in ein ComputeInstance-Objekt.

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

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

Geben Sie das ComputeInstance-Objekt zurück.
get_active_runs

Geben Sie einen Generator der Ausführungen für diese Computeinstanz 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 eines 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 Cloud-Objekts. Sie wird in erster Linie zum manuellen Abrufen des Compute-Zustands verwendet.
restart

Starten Sie die ComputeInstance neu.
serialize

Konvertieren dieses ComputeInstance-Objekts in ein serialisiertes JSON-Wörterbuch.
start

Starten Sie die ComputeInstance neu.
stop

Beenden Sie die ComputeInstance.
supported_vmsizes

Auflisten der unterstützten VM-Größen in einer Region.
wait_for_completion

Warten auf den Abschluss der Bereitstellung der ComputeInstance.

delete

Entfernen des ComputeInstance-Objekts 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, wird eine Ausnahme ausgelöst, und es wird nichts geändert.

deserialize

Konvertieren eines JSON-Objekts 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, das dem 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

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

detach()

Ausnahmen

Typ Beschreibung
ComputeTargetException

Der Vorgang wird nicht unterstützt.

get

Geben Sie das 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

Geben Sie einen Generator der Ausführungen für diese Computeinstanz zurück.

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

Parameter

Name Beschreibung
type
str

Filtern des zurückgegeben Generators von Ausführungen nach dem angegebenen Typ. Informationen zum Erstellen von Ausführungstypen finden Sie unter add_type_provider.

Standardwert: None
tags
str oder dict

Filtern von Ausführungen nach „tag“ oder „{"tag": "value"}“.

Standardwert: None
properties
str oder dict

Filtern von Ausführungen nach „property“ oder „{"property": "value"}“.

Standardwert: None
status
str

Führen Sie den Status aus, der „Ausgeführt“ oder „In der Warteschlange“ sein kann.

Standardwert: None

Gibt zurück

Typ Beschreibung
<xref:builtin.generator>

Ein Generator von azureml._restclient.models.RunDto

Ausnahmen

Typ Beschreibung
ComputeTargetException

get_docs_url

URL zur Dokumentation für diese Klasse.

get_docs_url()

Gibt zurück

Typ Beschreibung
str

url

Ausnahmen

Typ Beschreibung
ComputeTargetException

get_status

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

get_status()

Gibt zurück

Typ Beschreibung
ComputeInstanceStatus

Ein detailliertes Status-Objekt für die Computeinstanz

Ausnahmen

Typ Beschreibung
ComputeTargetException

provisioning_configuration

Erstellen eines 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 der Agent-VMs. Weitere Informationen finden Sie hier: https://aka.ms/azureml-vm-details. Beachten Sie, dass nicht alle Größen in allen Regionen verfügbar sind. Weitere Information finden Sie unter dem obigen Link. Der Standardwert ist Standard_NC6.
ssh_public_access
bool

Gibt den Status des öffentlichen SSH-Ports an. Mögliche Werte:

  • False - Der öffentliche SSH-Port ist geschlossen.
  • True - Der öffentliche SSH-Port ist offen.
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, die dem Compute-Objekt zugeordnet werden sollen.

Standardwert: None
description
str

Eine optionale Beschreibung des Compute-Objekts.

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 Configuration-Objekt, 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 Cloud-Objekts. Sie wird in erster Linie zum manuellen Abrufen des Compute-Zustands verwendet.

refresh_state()

Ausnahmen

Typ Beschreibung
ComputeTargetException

restart

Starten Sie die ComputeInstance neu.

restart(wait_for_completion=False, show_output=False)

Parameter

Name Beschreibung
wait_for_completion
bool

Boolescher Wert, der angibt, dass auf die Aktualisierung des Status gewartet werden soll. Der Standardwert lautet „False“.

Standardwert: False
show_output
bool

Boolescher Wert, mit dem eine ausführlichere Ausgabe bereitgestellt werden kann. Der Standardwert lautet „False“.

Standardwert: False

Gibt zurück

Typ Beschreibung
None

Keine

Ausnahmen

Typ Beschreibung
azureml.exceptions.ComputeTargetException:

serialize

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

serialize()

Gibt zurück

Typ Beschreibung
dict

Die JSON-Darstellung dieses ComputeInstance-Objekts.

Ausnahmen

Typ Beschreibung
ComputeTargetException

start

Starten Sie die ComputeInstance neu.

start(wait_for_completion=False, show_output=False)

Parameter

Name Beschreibung
wait_for_completion
bool

Gibt an, ob auf die Zustandsaktualisierung gewartet werden soll. Der Standardwert lautet „False“.

Standardwert: False
show_output
bool

Gibt an, ob eine ausführlichere Ausgabe ausgegeben werden soll. Der Standardwert lautet „False“.

Standardwert: False

Gibt zurück

Typ Beschreibung
None

Keine

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 die Zustandsaktualisierung gewartet werden soll. Der Standardwert lautet „False“.

Standardwert: False
show_output
bool

Gibt an, ob eine ausführlichere Ausgabe ausgegeben werden soll. Der Standardwert lautet „False“.

Standardwert: False

Gibt zurück

Typ Beschreibung
None

Keine

Ausnahmen

Typ Beschreibung
ComputeTargetException

supported_vmsizes

Auflisten der unterstützten VM-Größen in einer Region.

static supported_vmsizes(workspace, location=None)

Parameter

Name Beschreibung
workspace
Erforderlich
Workspace

Der Arbeitsbereich.
location
str

Der Speicherort der Instanz. Wenn er nicht angegeben wird, ist der Speicherort der Standard-Arbeitsbereichs.

Standardwert: None

Gibt zurück

Typ Beschreibung
list

Eine Liste der unterstützten VM-Größen in einer Region mit dem Namen der VM, den vCPUs und dem RAM.

Ausnahmen

Typ Beschreibung
ComputeTargetException

wait_for_completion

Warten auf den Abschluss der Bereitstellung der ComputeInstance.

wait_for_completion(show_output=False, is_delete_operation=False)

Parameter

Name Beschreibung
show_output
bool

Gibt an, ob eine ausführlichere Ausgabe ausgegeben werden soll. Der Standardwert lautet „False“.

Standardwert: False
is_delete_operation
bool

Gibt an, ob es sich um einen Löschvorgang handelt.

Standardwert: False

Ausnahmen

Typ Beschreibung
ComputeTargetException