RemoteCompute Klasse

Verwaltet ein Remote-Computeziel für die Verwendung in Azure Machine Learning.

Azure Machine Learning unterstützt die Verwendung des Anfügens einer Remote-Computeressource an Ihren Arbeitsbereich. Die Remoteressource kann eine Azure-VM, ein Remoteserver in Ihrer Organisation oder lokal sein, sofern auf die Ressource für Azure Machine Learning zugegriffen werden kann. Weitere Informationen finden Sie unter Was sind Computeziele in Azure Machine Learning?

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

RemoteCompute(workspace, name)

Parameter

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

Hinweise

Die folgenden Azure-Regionen unterstützen nicht die Verwendung der öffentlichen IP-Adresse eines virtuellen Computers oder HDInsight-Clusters, um das Computeziel anzufügen.

USA Ost
USA West 2
USA Süd-Mittel

Verwenden Sie stattdessen die Azure Resource Manager-ID des VM- oder HDInsight-Clusters. Die Ressourcen-ID der VM kann mithilfe der Abonnement-ID, des Ressourcengruppennamens und des VM-Namens mithilfe des folgenden Zeichenfolgenformats erstellt werden: /subscriptions/<subscription_id/resourceGroups/>resource_group</providers/Microsoft.Compute/virtualMachines/>vm_name<>.

Das folgende Beispiel zeigt, wie Sie einen virtuellen Data Science-Computer (DATA Science Virtual Machine, DSVM) 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)

Vollständiges Beispiel ist verfügbar von 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. Ordnen Sie eine vorhandene Remote-Computeressource dem bereitgestellten Arbeitsbereich zu.
attach_configuration	Erstellen Sie ein Konfigurationsobjekt zum Anfügen eines Remote-Computeziels. Das Anfügen eines virtuellen Computers mit der öffentlichen IP-Adresse des virtuellen Computers wird nicht mehr unterstützt. Verwenden Sie stattdessen die resourceId der VM. Die resourceId der VM kann mit dem folgenden Zeichenfolgenformat erstellt werden: "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.Compute/virtualMachines/<vm_name>". Sie können auch subscription_id, resource_group und vm_name verwenden, ohne resourceId zu erstellen. 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	Konvertieren Sie ein JSON-Objekt in ein RemoteCompute-Objekt.
detach	Trennen Sie das RemoteCompute-Objekt vom zugeordneten Arbeitsbereich. Zugrunde liegende Cloudobjekte werden nicht gelöscht, nur die Zuordnung wird entfernt.
get_credentials	Rufen Sie die Anmeldeinformationen für das RemoteCompute-Ziel ab.
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 wird in erster Linie für die manuelle Abfrage des Berechnungszustands verwendet.
serialize	Konvertieren Sie dieses RemoteCompute-Objekt in ein serialisiertes JSON-Wörterbuch.

attach

VERALTET. Verwenden Sie stattdessen die attach_configuration Methode.

Ordnen Sie eine vorhandene Remote-Computeressource dem bereitgestellten Arbeitsbereich 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 Der Name, der der Computeressource innerhalb des bereitgestellten Arbeitsbereichs zugeordnet werden soll. Muss nicht mit dem Namen der compute-Ressource übereinstimmen, die angefügt werden soll.
username Erforderlich	str Der Benutzername, der für den Zugriff auf die Ressource erforderlich ist.
address Erforderlich	str Die Adresse der ressource, die angefügt werden soll.
ssh_port	int Der verfügbar gemachte Port für die Ressource. Standardwert ist 22. Standardwert: 22
password Erforderlich	str Das Kennwort, das für den Zugriff auf die Ressource erforderlich ist.
private_key_file Erforderlich	str Pfad zu einer Datei, die den privaten Schlüssel für die Ressource enthält.
private_key_passphrase Erforderlich	str Privater Schlüsselausdruck, 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

Erstellen Sie ein Konfigurationsobjekt zum Anfügen eines Remote-Computeziels.

Das Anfügen eines virtuellen Computers mit der öffentlichen IP-Adresse des virtuellen Computers wird nicht mehr unterstützt. Verwenden Sie stattdessen die resourceId der VM. Die resourceId der VM kann mit dem folgenden Zeichenfolgenformat erstellt werden: "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.Compute/virtualMachines/<vm_name>".

Sie können auch subscription_id, resource_group und vm_name verwenden, ohne resourceId zu erstellen. 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 Benutzername, der für den Zugriff auf die Ressource erforderlich ist.
subscription_id	str Die Azure-Abonnement-ID, in der sich der virtuelle Computer befindet. Standardwert: None
resource_group	str Der Name der Ressourcengruppe, in der sich der virtuelle Computer befindet. Standardwert: None
vm_name	str Der Name des virtuellen Computers. Standardwert: None
resource_id	str Die Ressourcen-ID des Azure Resource Manager (ARM) für die vorhandene Ressource. Standardwert: None
address	str Die Adresse für die vorhandene Ressource. Standardwert: None
ssh_port	int Der verfügbar gemachte Port für die Ressource. Standardwert ist 22. Standardwert: 22
password Erforderlich	str Das Kennwort, das für den Zugriff auf die Ressource erforderlich ist.
private_key_file Erforderlich	str Pfad zu einer Datei, die den privaten Schlüssel für die Ressource enthält.
private_key_passphrase Erforderlich	str Der private Schlüsselausdruck, der für den Zugriff auf die Ressource erforderlich ist.

Gibt zurück

Typ	Beschreibung
RemoteComputeAttachConfiguration	Ein Konfigurationsobjekt, das beim Anfügen eines Compute-Objekts verwendet werden soll.

delete

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

delete()

Ausnahmen

Typ	Beschreibung
ComputeTargetException

deserialize

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

static deserialize(workspace, object_dict)

Parameter

Name	Beschreibung
workspace Erforderlich	Workspace Das Arbeitsbereichsobjekt, dem das RemoteCompute-Objekt zugeordnet ist.
object_dict Erforderlich	dict Ein 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

Löst ein ComputeTargetException , wenn der bereitgestellte Arbeitsbereich nicht der Arbeitsbereich ist, dem die Compute zugeordnet ist.

detach

Trennen Sie 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

Rufen Sie 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ühren Sie eine direkte Aktualisierung der Eigenschaften des Objekts durch.

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

refresh_state()

serialize

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

serialize()

Gibt zurück

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

Freigeben über

RemoteCompute Klasse

Konstruktor

Parameter

Hinweise

Methoden

attach

Parameter

Gibt zurück

Ausnahmen

attach_configuration

Parameter

Gibt zurück

delete

Ausnahmen

deserialize

Parameter

Gibt zurück

Ausnahmen

Hinweise

detach

Ausnahmen

get_credentials

Gibt zurück

Ausnahmen

refresh_state

serialize

Gibt zurück

Feedback