RemoteCompute Klasse

Referenz

Dient zum Verwalten eines Remotecomputeziels für die Verwendung in Azure Machine Learning

Azure Machine Learning unterstützt das Anfügen einer Remotecomputeressource an Ihren Arbeitsbereich. Die Remoteressource kann eine Azure-VM, ein Remoteserver in Ihrer Organisation oder ein lokaler Computer sein, solange Azure Machine Learning auf die Ressource zugreifen kann. Weitere Informationen finden Sie unter Was sind Computeziele in Azure Machine Learning?.

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

RemoteCompute

Konstruktor

RemoteCompute(workspace, name)

Parameter

Name	Beschreibung
workspace Erforderlich	Workspace Arbeitsbereichsobjekt, das das abzurufende RemoteCompute-Objekt enthält
name Erforderlich	str Name des abzurufenden RemoteCompute-Objekts
workspace Erforderlich	Workspace Das Workspace-Objekt, das das abzurufende Compute-Objekt enthält.
name Erforderlich	str Der Name des abzurufenden Compute-Objekts.

Hinweise

Die folgenden Azure-Regionen unterstützen die Verwendung der öffentlichen IP-Adresse eines virtuellen Computers oder HDInsight-Clusters zum Anfügen des Computeziels nicht.

USA, Osten
USA, Westen 2
USA, Süden-Mitte

Verwenden Sie stattdessen die Azure Resource Manager-ID der VM oder des HDInsight-Clusters. Die Ressourcen-ID der VM kann mithilfe der Abonnement-ID sowie des Ressourcengruppennamens und VM-Namens im folgendem Zeichenfolgenformat konstruiert werden: „/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.Compute/virtualMachines/<vm_name>“.

Im folgenden Beispiel wird gezeigt, wie sie eine DSVM-Instanz (Data Science Virtual Machine) als Computeziel erstellen und anfügen.


   from azureml.core.compute import ComputeTarget, RemoteCompute
   from azureml.core.compute_target import ComputeTargetException

   username = os.getenv('AZUREML_DSVM_USERNAME', default='<my_username>')
   address = os.getenv('AZUREML_DSVM_ADDRESS', default='<ip_address_or_fqdn>')

   compute_target_name = 'cpudsvm'
   # if you want to connect using SSH key instead of username/password you can provide parameters private_key_file and private_key_passphrase
   try:
       attached_dsvm_compute = RemoteCompute(workspace=ws, name=compute_target_name)
       print('found existing:', attached_dsvm_compute.name)
   except ComputeTargetException:
       attach_config = RemoteCompute.attach_configuration(address=address,
                                                          ssh_port=22,
                                                          username=username,
                                                          private_key_file='./.ssh/id_rsa')


   # Attaching a virtual machine using the public IP address of the VM is no longer supported.
   # Instead, use resourceId of the VM.
   # The resourceId of the VM can be constructed using the following string format:
   # /subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.Compute/virtualMachines/<vm_name>.
   # You can also use subscription_id, resource_group and vm_name without constructing resourceId.
       attach_config = RemoteCompute.attach_configuration(resource_id='<resource_id>',
                                                          ssh_port=22,
                                                          username='username',
                                                          private_key_file='./.ssh/id_rsa')

       attached_dsvm_compute = ComputeTarget.attach(ws, compute_target_name, attach_config)

       attached_dsvm_compute.wait_for_completion(show_output=True)

Das vollständige Beispiel finden Sie unter https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-remote-vm/train-on-remote-vm.ipynb.

Methoden

attach	VERALTET. Verwenden Sie stattdessen die `attach_configuration`-Methode. Ordnet dem bereitgestellten Arbeitsbereich eine vorhandene Remotecomputeressource zu
attach_configuration	Erstellt ein Konfigurationsobjekt zum Anfügen eines Remotecomputeziels Das Anfügen einer VM mit deren öffentlicher IP-Adresse wird nicht mehr unterstützt. Verwenden Sie stattdessen die Ressourcen-ID (resourceId) der VM. Die Ressourcen-ID (resourceId) der VM kann mithilfe des folgenden Zeichenfolgenformats konstruiert werden: „/subscriptions/<subscription_id>/resourceGroups/<resource_group>/ providers/Microsoft.Compute/virtualMachines/<vm_name>“. Sie können „subscription_id“, „resource_group“ und „vm_name“ auch verwenden, ohne „resourceId“ zu konstruieren. Weitere Informationen finden Sie unter https://aka.ms/azureml-compute-vm.
delete	Das Löschen wird für ein RemoteCompute-Objekt nicht unterstützt. Verwenden Sie stattdessen detach.
deserialize	Konvertiert ein JSON-Objekt in ein RemoteCompute-Objekt
detach	Trennt das RemoteCompute-Objekt vom zugeordneten Arbeitsbereich Zugrunde liegende Cloudobjekte werden nicht gelöscht, nur die Zuordnung wird entfernt.
get_credentials	Ruft die Anmeldeinformationen für das RemoteCompute-Ziel ab
refresh_state	Führt eine direkte Aktualisierung der Eigenschaften des Objekts durch Mit dieser Methode werden die Eigenschaften basierend auf dem aktuellen Zustand des entsprechenden Cloud-Objekts aktualisiert. Sie wird in erster Linie zum manuellen Abrufen des Computestatus verwendet.
serialize	Konvertiert dieses RemoteCompute-Objekt in ein serialisiertes JSON-Wörterbuch

attach

VERALTET. Verwenden Sie stattdessen die attach_configuration-Methode.

Ordnet dem bereitgestellten Arbeitsbereich eine vorhandene Remotecomputeressource zu

static attach(workspace, name, username, address, ssh_port=22, password='', private_key_file='', private_key_passphrase='')

Parameter

Name	Beschreibung
workspace Erforderlich	Workspace Das Arbeitsbereichsobjekt, dem die Computeressource zugeordnet werden soll.
name Erforderlich	str Name, der der Computeressource innerhalb des bereitgestellten Arbeitsbereichs zugeordnet werden soll. Muss nicht mit dem Namen der anzufügenden Computeressource übereinstimmen.
username Erforderlich	str Der für den Zugriff auf die Ressource erforderliche Benutzername
address Erforderlich	str Adresse der Ressource, die angefügt werden soll.
ssh_port	int Der für die Ressource verfügbar gemachte Port. Der Standardwert ist 22. Standardwert: 22
password Erforderlich	str Das für den Zugriff auf die Ressource erforderliche Kennwort
private_key_file Erforderlich	str Der Pfad zu einer Datei, die den privaten Schlüssel für die Ressource enthält
private_key_passphrase Erforderlich	str Der private Schlüsselbegriff, der für den Zugriff auf die Ressource erforderlich ist

Gibt zurück

Typ	Beschreibung
RemoteCompute	Eine RemoteCompute-Objektdarstellung des Computeobjekts

Ausnahmen

Typ	Beschreibung
ComputeTargetException

attach_configuration

Erstellt ein Konfigurationsobjekt zum Anfügen eines Remotecomputeziels

Das Anfügen einer VM mit deren öffentlicher IP-Adresse wird nicht mehr unterstützt. Verwenden Sie stattdessen die Ressourcen-ID (resourceId) der VM. Die Ressourcen-ID (resourceId) der VM kann mithilfe des folgenden Zeichenfolgenformats konstruiert werden: „/subscriptions/<subscription_id>/resourceGroups/<resource_group>/ providers/Microsoft.Compute/virtualMachines/<vm_name>“.

Sie können „subscription_id“, „resource_group“ und „vm_name“ auch verwenden, ohne „resourceId“ zu konstruieren. Weitere Informationen finden Sie unter https://aka.ms/azureml-compute-vm.

static attach_configuration(username, subscription_id=None, resource_group=None, vm_name=None, resource_id=None, address=None, ssh_port=22, password='', private_key_file='', private_key_passphrase='')

Parameter

Name	Beschreibung
username Erforderlich	str Der für den Zugriff auf die Ressource erforderliche Benutzername
subscription_id	str Die ID des Azure-Abonnements, in dem sich die VM befindet. Standardwert: None
resource_group	str Der Name der Ressourcengruppe, in der sich die VM befindet. Standardwert: None
vm_name	str Name der VM Standardwert: None
resource_id	str ARM-Ressourcen-ID (Azure Resource Manager) für die vorhandene Ressource Standardwert: None
address	str Adresse für die vorhandene Ressource Standardwert: None
ssh_port	int Der für die Ressource verfügbar gemachte Port. Der Standardwert ist 22. Standardwert: 22
password Erforderlich	str Das für den Zugriff auf die Ressource erforderliche Kennwort
private_key_file Erforderlich	str Der Pfad zu einer Datei, die den privaten Schlüssel für die Ressource enthält
private_key_passphrase Erforderlich	str Der private Schlüsselbegriff, der für den Zugriff auf die Ressource erforderlich ist

Gibt zurück

Typ	Beschreibung
RemoteComputeAttachConfiguration	Ein Konfigurationsobjekt, das beim Anfügen eines Computeobjekts verwendet werden soll

Ausnahmen

Typ	Beschreibung
ComputeTargetException

delete

Das Löschen wird für ein RemoteCompute-Objekt nicht unterstützt. Verwenden Sie stattdessen detach.

delete()

Ausnahmen

Typ	Beschreibung
ComputeTargetException

deserialize

Konvertiert ein JSON-Objekt in ein RemoteCompute-Objekt

static deserialize(workspace, object_dict)

Parameter

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

Gibt zurück

Typ	Beschreibung
RemoteCompute	Die RemoteCompute-Darstellung des bereitgestellten JSON-Objekts

Ausnahmen

Typ	Beschreibung
ComputeTargetException

Hinweise

Wenn der bereitgestellte Arbeitsbereich nicht der Arbeitsbereich ist, dem das Compute-Objekt zugeordnet ist, wird ComputeTargetException ausgelöst.

detach

Trennt das RemoteCompute-Objekt vom zugeordneten Arbeitsbereich

Zugrunde liegende Cloudobjekte werden nicht gelöscht, nur die Zuordnung wird entfernt.

detach()

Ausnahmen

Typ	Beschreibung
ComputeTargetException

get_credentials

Ruft die Anmeldeinformationen für das RemoteCompute-Ziel ab

get_credentials()

Gibt zurück

Typ	Beschreibung
dict	Die Anmeldeinformationen für das RemoteCompute-Ziel

Ausnahmen

Typ	Beschreibung
ComputeTargetException

refresh_state

Führt eine direkte Aktualisierung der Eigenschaften des Objekts durch

Mit dieser Methode werden die Eigenschaften basierend auf dem aktuellen Zustand des entsprechenden Cloud-Objekts aktualisiert. Sie wird in erster Linie zum manuellen Abrufen des Computestatus verwendet.

refresh_state()

Ausnahmen

Typ	Beschreibung
ComputeTargetException

serialize

Konvertiert dieses RemoteCompute-Objekt in ein serialisiertes JSON-Wörterbuch

serialize()

Gibt zurück

Typ	Beschreibung
dict	Die JSON-Darstellung dieses RemoteCompute-Objekts

Ausnahmen

Typ	Beschreibung
ComputeTargetException

Freigeben über

RemoteCompute Klasse

Konstruktor

Parameter

Hinweise

Methoden

attach

Parameter

Gibt zurück

Ausnahmen

attach_configuration

Parameter

Gibt zurück

Ausnahmen

delete

Ausnahmen

deserialize

Parameter

Gibt zurück

Ausnahmen

Hinweise

detach

Ausnahmen

get_credentials

Gibt zurück

Ausnahmen

refresh_state

Ausnahmen

serialize

Gibt zurück

Ausnahmen

Feedback

Zusätzliche Ressourcen