RemoteCompute Klas

Hiermee beheert u een extern rekendoel voor gebruik in Azure Machine Learning.

Azure Machine Learning ondersteunt het koppelen van een externe rekenresource aan uw werkruimte. De externe resource kan een Azure-VM, een externe server in uw organisatie of on-premises zijn, zolang de resource maar toegankelijk is voor Azure Machine Learning. Zie Wat zijn rekendoelen in Azure Machine Learning? voor meer informatie.

Klasse ComputeTarget-constructor.

Haal een cloudweergave op van een compute-object dat is gekoppeld aan de opgegeven werkruimte. Retourneert een exemplaar van een onderliggende klasse die overeenkomt met het specifieke type van het opgehaalde Compute-object.

Overname

ComputeTarget

RemoteCompute

Constructor

RemoteCompute(workspace, name)

Parameters

workspace

Workspace

Vereist

Het werkruimteobject met het remotecompute-object dat moet worden opgehaald.

name

str

Vereist

De naam van de van het RemoteCompute-object dat moet worden opgehaald.

workspace

Workspace

Vereist

Het werkruimteobject met het rekenobject dat moet worden opgehaald.

name

str

Vereist

De naam van het rekenobject dat moet worden opgehaald.

Opmerkingen

De volgende Azure-regio's bieden geen ondersteuning voor het gebruik van het openbare IP-adres van een virtuele machine of HDInsight-cluster om het rekendoel te koppelen.

• US - oost

• US - west 2

• US - zuid-centraal

Gebruik in plaats daarvan de Azure Resource Manager-id van de VM of het HDInsight-cluster. De resource-id van de VM kan worden samengesteld met behulp van de abonnements-id, de naam van de resourcegroep en de naam van de VM met de volgende tekenreeksindeling: /subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.Compute/virtualMachines/<vm_name>.

In het volgende voorbeeld ziet u hoe u een Data Science Virtual Machine (DSVM) maakt en koppelt als een rekendoel.

   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)

Het volledige voorbeeld is beschikbaar via https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-remote-vm/train-on-remote-vm.ipynb

Methoden

attach	AFGEKEURD. Gebruik in plaats daarvan de attach_configuration methode. Koppel een bestaande externe rekenresource aan de opgegeven werkruimte.
attach_configuration	Maak een configuratieobject voor het koppelen van een extern rekendoel. Het koppelen van een virtuele machine met behulp van het openbare IP-adres van de VM wordt niet meer ondersteund. Gebruik in plaats daarvan de resourceId van de VM. De resourceId van de VM kan worden samengesteld met behulp van de volgende tekenreeksindeling: "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/ providers/Microsoft.Compute/virtualMachines/<vm_name>". U kunt ook subscription_id, resource_group en vm_name gebruiken zonder resourceId te maken. Voor meer informatie raadpleegt u https://aka.ms/azureml-compute-vm.
delete	Verwijderen wordt niet ondersteund voor een RemoteCompute-object. Gebruik in plaats daarvan detach.
deserialize	Converteer een JSON-object naar een RemoteCompute-object.
detach	Koppel het RemoteCompute-object los van de bijbehorende werkruimte. Onderliggende cloudobjecten worden niet verwijderd, alleen de koppeling wordt verwijderd.
get_credentials	Haal de referenties voor het RemoteCompute-doel op.
refresh_state	Voer een in-place update van de eigenschappen van het object uit. Met deze methode worden de eigenschappen bijgewerkt op basis van de huidige status van het bijbehorende cloudobject. Dit wordt voornamelijk gebruikt voor handmatige polling van de rekenstatus.
serialize	Converteer dit RemoteCompute-object naar een geserialiseerde JSON-woordenlijst.

attach

AFGEKEURD. Gebruik in plaats daarvan de attach_configuration methode.

Koppel een bestaande externe rekenresource aan de opgegeven werkruimte.

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

Parameters

workspace

Workspace

Vereist

Het werkruimteobject waaraan de rekenresource moet worden gekoppeld.

name

str

Vereist

De naam die moet worden gekoppeld aan de rekenresource in de opgegeven werkruimte. Hoeft niet overeen te komen met de naam van de rekenresource die moet worden gekoppeld.

username

str

Vereist

De gebruikersnaam die nodig is voor toegang tot de resource.

address

str

Vereist

Het adres van de resource die moet worden gekoppeld.

ssh_port

int

standaardwaarde: 22

De weergegeven poort voor de resource. De standaardwaarde is 22.

password

str

Vereist

Het wachtwoord dat nodig is voor toegang tot de resource.

private_key_file

str

Vereist

Pad naar een bestand met de persoonlijke sleutel voor de resource.

private_key_passphrase

str

Vereist

Persoonlijke sleutelzin die nodig is voor toegang tot de resource.

Retouren

Een RemoteCompute-objectweergave van het rekenobject.

Retourtype

RemoteCompute

Uitzonderingen

ComputeTargetException

attach_configuration

Maak een configuratieobject voor het koppelen van een extern rekendoel.

Het koppelen van een virtuele machine met behulp van het openbare IP-adres van de VM wordt niet meer ondersteund. Gebruik in plaats daarvan de resourceId van de VM. De resourceId van de VM kan worden samengesteld met behulp van de volgende tekenreeksindeling: "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/ providers/Microsoft.Compute/virtualMachines/<vm_name>".

U kunt ook subscription_id, resource_group en vm_name gebruiken zonder resourceId te maken. Voor meer informatie raadpleegt u 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='')

Parameters

username

str

Vereist

De gebruikersnaam die nodig is voor toegang tot de resource.

subscription_id

str

standaardwaarde: None

De Azure-abonnements-id waarin de virtuele machine zich bevindt.

resource_group

str

standaardwaarde: None

De naam van de resourcegroep waarin de virtuele machine zich bevindt.

vm_name

str

standaardwaarde: None

De naam van de virtuele machine.

resource_id

str

standaardwaarde: None

De ARM-resource-id (Azure Resource Manager) voor de bestaande resource.

address

str

standaardwaarde: None

Het adres voor de bestaande resource.

ssh_port

int

standaardwaarde: 22

De weergegeven poort voor de resource. De standaardwaarde is 22.

password

str

Vereist

Het wachtwoord dat nodig is voor toegang tot de resource.

private_key_file

str

Vereist

Pad naar een bestand met de persoonlijke sleutel voor de resource.

private_key_passphrase

str

Vereist

De woordgroep met de persoonlijke sleutel die nodig is voor toegang tot de resource.

Retouren

Een configuratieobject dat moet worden gebruikt bij het koppelen van een compute-object.

Retourtype

RemoteComputeAttachConfiguration

Uitzonderingen

ComputeTargetException

delete

Verwijderen wordt niet ondersteund voor een RemoteCompute-object. Gebruik in plaats daarvan detach.

delete()

Uitzonderingen

ComputeTargetException

deserialize

Converteer een JSON-object naar een RemoteCompute-object.

static deserialize(workspace, object_dict)

Parameters

workspace

Workspace

Vereist

Het werkruimteobject waar het RemoteCompute-object aan is gekoppeld.

object_dict

dict

Vereist

Een JSON-object dat moet worden geconverteerd naar een RemoteCompute-object.

Retouren

De RemoteCompute-weergave van het opgegeven JSON-object.

Retourtype

RemoteCompute

Uitzonderingen

ComputeTargetException

Opmerkingen

Genereert een ComputeTargetException als de opgegeven werkruimte niet de werkruimte is waar de compute aan is gekoppeld.

detach

Koppel het RemoteCompute-object los van de bijbehorende werkruimte.

Onderliggende cloudobjecten worden niet verwijderd, alleen de koppeling wordt verwijderd.

detach()

Uitzonderingen

ComputeTargetException

get_credentials

Haal de referenties voor het RemoteCompute-doel op.

get_credentials()

Retouren

De referenties voor het RemoteCompute-doel.

Retourtype

dict

Uitzonderingen

ComputeTargetException

refresh_state

Voer een in-place update van de eigenschappen van het object uit.

Met deze methode worden de eigenschappen bijgewerkt op basis van de huidige status van het bijbehorende cloudobject. Dit wordt voornamelijk gebruikt voor handmatige polling van de rekenstatus.

refresh_state()

Uitzonderingen

ComputeTargetException

serialize

Converteer dit RemoteCompute-object naar een geserialiseerde JSON-woordenlijst.

serialize()

Retouren

De JSON-weergave van dit RemoteCompute-object.

Retourtype

dict

Uitzonderingen

ComputeTargetException