Share via


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

Konstruktor

ComputeInstance(workspace, name)

Parameter

workspace
Workspace
Erforderlich

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

name
str
Erforderlich

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

wait_for_completion
Standardwert: False
show_output
Standardwert: False

Ausnahmen

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

workspace
Workspace
Erforderlich

Das Arbeitsbereichsobjekt, das dem ComputeInstance-Objekt zugeordnet ist.

object_dict
dict
Erforderlich

Ein JSON-Objekt, das in ein ComputeInstance-Objekt konvertiert werden soll.

Gibt zurück

Die ComputeInstance-Darstellung des bereitgestellten JSON-Objekts.

Rückgabetyp

Ausnahmen

detach

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

detach()

Ausnahmen

Der Vorgang wird nicht unterstützt.

get

Geben Sie das ComputeInstance-Objekt zurück.

get()

Gibt zurück

Die ComputeInstance-Darstellung des bereitgestellten JSON-Objekts.

Rückgabetyp

Ausnahmen

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

type
str
Standardwert: None

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

tags
str oder dict
Standardwert: None

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

properties
str oder dict
Standardwert: None

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

status
str
Standardwert: None

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

Gibt zurück

Ein Generator von azureml._restclient.models.RunDto

Rückgabetyp

<xref:builtin.generator>

Ausnahmen

get_docs_url

URL zur Dokumentation für diese Klasse.

get_docs_url()

Gibt zurück

url

Rückgabetyp

str

Ausnahmen

get_status

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

get_status()

Gibt zurück

Ein detailliertes Status-Objekt für die Computeinstanz

Rückgabetyp

Ausnahmen

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

vm_size
str
Erforderlich

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
Standardwert: False

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.
admin_user_ssh_public_key
str
Standardwert: None

Der öffentliche SSH-Schlüssel des Administrator-Benutzerkontos.

vnet_resourcegroup_name
str
Standardwert: None

Der Name der Ressourcengruppe, in der sich das virtuelle Netzwerk befindet.

vnet_name
str
Standardwert: None

Den Namen des virtuellen Netzwerks.

subnet_name
str
Standardwert: None

Der Name des Subnetzes innerhalb des VNet.

tags
dict[str, str]
Standardwert: None

Ein optionales Wörterbuch mit Schlüsselwerttags, die dem Compute-Objekt zugeordnet werden sollen.

description
str
Standardwert: None

Eine optionale Beschreibung des Compute-Objekts.

assigned_user_object_id
str
Standardwert: None

Die AAD-Objekt-ID des zugewiesenen Benutzers (Vorschau).

assigned_user_tenant_id
str
Standardwert: None

Die AAD-Mandanten-ID des zugewiesenen Benutzers (Vorschau).

Gibt zurück

Ein Configuration-Objekt, das beim Erstellen eines Compute-Objekts verwendet werden soll.

Rückgabetyp

Ausnahmen

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

restart

Starten Sie die ComputeInstance neu.

restart(wait_for_completion=False, show_output=False)

Parameter

wait_for_completion
bool
Standardwert: False

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

show_output
bool
Standardwert: False

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

Gibt zurück

Keine

Rückgabetyp

Ausnahmen

azureml.exceptions.ComputeTargetException:

serialize

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

serialize()

Gibt zurück

Die JSON-Darstellung dieses ComputeInstance-Objekts.

Rückgabetyp

Ausnahmen

start

Starten Sie die ComputeInstance neu.

start(wait_for_completion=False, show_output=False)

Parameter

wait_for_completion
bool
Standardwert: False

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

show_output
bool
Standardwert: False

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

Gibt zurück

Keine

Rückgabetyp

Ausnahmen

stop

Beenden Sie die ComputeInstance.

stop(wait_for_completion=False, show_output=False)

Parameter

wait_for_completion
bool
Standardwert: False

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

show_output
bool
Standardwert: False

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

Gibt zurück

Keine

Rückgabetyp

Ausnahmen

supported_vmsizes

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

static supported_vmsizes(workspace, location=None)

Parameter

workspace
Workspace
Erforderlich

Der Arbeitsbereich.

location
str
Standardwert: None

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

Gibt zurück

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

Rückgabetyp

Ausnahmen

wait_for_completion

Warten auf den Abschluss der Bereitstellung der ComputeInstance.

wait_for_completion(show_output=False, is_delete_operation=False)

Parameter

show_output
bool
Standardwert: False

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

is_delete_operation
bool
Standardwert: False

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

Ausnahmen