RemoteCompute Osztály

Távoli számítási célt kezel az Azure Machine Learningben való használathoz.

Az Azure Machine Learning támogatja egy távoli számítási erőforrás munkaterülethez csatolását. A távoli erőforrás lehet Azure-beli virtuális gép, a szervezet távoli kiszolgálója vagy a helyszíni, feltéve, hogy az erőforrás elérhető az Azure Machine Learning számára. További információ: Mik azok a számítási célok az Azure Machine Learningben?

ComputeTarget-konstruktor osztály.

A megadott munkaterülethez társított számítási objektum felhőbeli ábrázolásának lekérése. Egy gyermekosztály egy példányát adja vissza, amely a lekért számítási objektum adott típusának felel meg.

Öröklődés

ComputeTarget

RemoteCompute

Konstruktor

RemoteCompute(workspace, name)

Paraméterek

workspace

Workspace

Kötelező

A lekérendő RemoteCompute objektumot tartalmazó munkaterület-objektum.

name

str

Kötelező

A lekérendő RemoteCompute objektum neve.

workspace

Workspace

Kötelező

A lekérendő számítási objektumot tartalmazó munkaterület-objektum.

name

str

Kötelező

A lekérendő számítási objektum neve.

Megjegyzések

A következő Azure-régiók nem támogatják a virtuális gép vagy HDInsight-fürt nyilvános IP-címének használatát a számítási cél csatolásához.

• USA keleti régiója

• USA 2. nyugati régiója

• USA déli középső régiója

Ehelyett használja a virtuális gép vagy a HDInsight-fürt Azure Resource Manager azonosítóját. A virtuális gép erőforrás-azonosítója az előfizetés-azonosító, az erőforráscsoport neve és a virtuális gép neve alapján hozható létre a következő sztringformátum használatával: /subscriptions/<subscription_id>/resourceGroups/<resource_group>/providers/Microsoft.Compute/virtualMachines/<vm_name>.

Az alábbi példa bemutatja, hogyan hozhat létre és csatolhat egy Data Science Virtual Machine (DSVM) számítási célként.

   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)

A teljes minta a következő forrásból érhető el: https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-remote-vm/train-on-remote-vm.ipynb

Metódusok

attach	ELAVULT. Használja inkább a metódust attach_configuration . Társítson egy meglévő távoli számítási erőforrást a megadott munkaterülethez.
attach_configuration	Hozzon létre egy konfigurációs objektumot egy távoli számítási cél csatolásához. A virtuális gép nyilvános IP-címmel való csatolása már nem támogatott. Ehelyett használja a virtuális gép resourceId azonosítóját. A virtuális gép resourceId azonosítója a következő sztringformátummal hozható létre: "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/ providers/Microsoft.Compute/virtualMachines/<vm_name>". Subscription_id, resource_group és vm_name is használhatja resourceId létrehozása nélkül. További információ: https://aka.ms/azureml-compute-vm.
delete	RemoteCompute objektum esetében a törlés nem támogatott. A detach használható helyette.
deserialize	JSON-objektum konvertálása RemoteCompute objektummá.
detach	Válassza le a RemoteCompute objektumot a társított munkaterületről. A mögöttes felhőobjektumok nem törlődnek, csak a társítás törlődik.
get_credentials	Kérje le a RemoteCompute-cél hitelesítő adatait.
refresh_state	Végezze el az objektum tulajdonságainak helyben történő frissítését. Ez a módszer a megfelelő felhőobjektum aktuális állapota alapján frissíti a tulajdonságokat. Ezt elsősorban a számítási állapot manuális lekérdezésére használják.
serialize	Konvertálja ezt a RemoteCompute objektumot JSON szerializált szótárlá.

attach

ELAVULT. Használja inkább a metódust attach_configuration .

Társítson egy meglévő távoli számítási erőforrást a megadott munkaterülethez.

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

Paraméterek

workspace

Workspace

Kötelező

A számítási erőforrás társításához a munkaterület objektuma.

name

str

Kötelező

A megadott munkaterületen belüli számítási erőforráshoz társítandó név. Nem kell megegyeznie a csatolandó számítási erőforrás nevével.

username

str

Kötelező

Az erőforrás eléréséhez szükséges felhasználónév.

address

str

Kötelező

A csatolandó erőforrás címe.

ssh_port

int

alapértelmezett érték: 22

Az erőforrás közzétett portja. Alapértelmezés szerint 22.

password

str

Kötelező

Az erőforrás eléréséhez szükséges jelszó.

private_key_file

str

Kötelező

Az erőforrás titkos kulcsát tartalmazó fájl elérési útja.

private_key_passphrase

str

Kötelező

Az erőforrás eléréséhez szükséges titkos kulcskifejezés.

Válaszok

A számítási objektum RemoteCompute objektumábrázolása.

Visszatérési típus

RemoteCompute

Kivételek

ComputeTargetException

attach_configuration

Hozzon létre egy konfigurációs objektumot egy távoli számítási cél csatolásához.

A virtuális gép nyilvános IP-címmel való csatolása már nem támogatott. Ehelyett használja a virtuális gép resourceId azonosítóját. A virtuális gép resourceId azonosítója a következő sztringformátummal hozható létre: "/subscriptions/<subscription_id>/resourceGroups/<resource_group>/ providers/Microsoft.Compute/virtualMachines/<vm_name>".

Subscription_id, resource_group és vm_name is használhatja resourceId létrehozása nélkül. További információ: 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='')

Paraméterek

username

str

Kötelező

Az erőforrás eléréséhez szükséges felhasználónév.

subscription_id

str

alapértelmezett érték: None

Az Azure-előfizetés azonosítója, amelyben a virtuális gép található.

resource_group

str

alapértelmezett érték: None

Annak az erőforráscsoportnak a neve, amelyben a virtuális gép található.

vm_name

str

alapértelmezett érték: None

A virtuális gép neve.

resource_id

str

alapértelmezett érték: None

Az Azure Resource Manager (ARM) erőforrás-azonosítója a meglévő erőforráshoz.

address

str

alapértelmezett érték: None

A meglévő erőforrás címe.

ssh_port

int

alapértelmezett érték: 22

Az erőforrás közzétett portja. Alapértelmezés szerint 22.

password

str

Kötelező

Az erőforrás eléréséhez szükséges jelszó.

private_key_file

str

Kötelező

Az erőforrás titkos kulcsát tartalmazó fájl elérési útja.

private_key_passphrase

str

Kötelező

Az erőforrás eléréséhez szükséges titkos kulcskifejezés.

Válaszok

Számítási objektum csatolásához használandó konfigurációs objektum.

Visszatérési típus

RemoteComputeAttachConfiguration

Kivételek

ComputeTargetException

delete

RemoteCompute objektum esetében a törlés nem támogatott. A detach használható helyette.

delete()

Kivételek

ComputeTargetException

deserialize

JSON-objektum konvertálása RemoteCompute objektummá.

static deserialize(workspace, object_dict)

Paraméterek

workspace

Workspace

Kötelező

A RemoteCompute objektumhoz társított munkaterület-objektum.

object_dict

dict

Kötelező

Egy JSON-objektum, amely RemoteCompute objektummá konvertálható.

Válaszok

A megadott JSON-objektum RemoteCompute ábrázolása.

Visszatérési típus

RemoteCompute

Kivételek

ComputeTargetException

Megjegyzések

Egy értéket ad ComputeTargetException , ha a megadott munkaterület nem az a munkaterület, amelyhez a Számítás társítva van.

detach

Válassza le a RemoteCompute objektumot a társított munkaterületről.

A mögöttes felhőobjektumok nem törlődnek, csak a társítás törlődik.

detach()

Kivételek

ComputeTargetException

get_credentials

Kérje le a RemoteCompute-cél hitelesítő adatait.

get_credentials()

Válaszok

A RemoteCompute cél hitelesítő adatai.

Visszatérési típus

dict

Kivételek

ComputeTargetException

refresh_state

Végezze el az objektum tulajdonságainak helyben történő frissítését.

Ez a módszer a megfelelő felhőobjektum aktuális állapota alapján frissíti a tulajdonságokat. Ezt elsősorban a számítási állapot manuális lekérdezésére használják.

refresh_state()

Kivételek

ComputeTargetException

serialize

Konvertálja ezt a RemoteCompute objektumot JSON szerializált szótárlá.

serialize()

Válaszok

A RemoteCompute objektum JSON-ábrázolása.

Visszatérési típus

dict

Kivételek

ComputeTargetException