Bagikan melalui

AmlCompute Kelas

  • Referensi

Mengelola komputasi Azure Machine Learning di Azure Machine Learning.

Azure Machine Learning Compute (AmlCompute) adalah infrastruktur komputasi terkelola yang memungkinkan Anda membuat komputasi tunggal atau multi-node dengan mudah. Komputasi dibuat dalam wilayah ruang kerja Anda sebagai sumber daya yang dapat dibagikan dengan pengguna lain. Untuk informasi selengkapnya, lihat Apa itu target komputasi di Azure Machine Learning?

Konstruktor Class ComputeTarget.

Ambil representasi cloud dari objek Komputasi yang terkait dengan ruang kerja yang disediakan. Mengembalikan instans kelas anak yang sesuai dengan jenis tertentu dari objek Komputasi yang diambil.

Warisan
ComputeTarget
AmlCompute

Konstruktor

AmlCompute(workspace, name)

Parameter

Nama Deskripsi
workspace
Diperlukan
Workspace

Objek ruang kerja yang berisi objek AmlCompute yang akan diambil.
name
Diperlukan
str

Nama objek AmlCompute yang akan diambil.
workspace
Diperlukan
Workspace

Objek ruang kerja yang berisi objek Azure Compute yang akan diambil.
name
Diperlukan
str

Nama objek Komputasi yang akan diambil.

Keterangan

Dalam contoh berikut, target komputasi persisten yang disediakan oleh AmlCompute dibuat. Parameter provisioning_configuration dalam contoh ini adalah jenis AmlComputeProvisioningConfiguration, yang merupakan kelas turunan dari ComputeTargetProvisioningConfiguration.


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

   # Choose a name for your CPU cluster
   cpu_cluster_name = "cpu-cluster"

   # Verify that cluster does not exist already
   try:
       cpu_cluster = ComputeTarget(workspace=ws, name=cpu_cluster_name)
       print('Found existing cluster, use it.')
   except ComputeTargetException:
       compute_config = AmlCompute.provisioning_configuration(vm_size='STANDARD_D2_V2',
                                                              max_nodes=4)
       cpu_cluster = ComputeTarget.create(ws, cpu_cluster_name, compute_config)

   cpu_cluster.wait_for_completion(show_output=True)

Sampel lengkap tersedia dari https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-amlcompute/train-on-amlcompute.ipynb

Metode

add_identity

Tambahkan Jenis Identitas dan/atau Id Identitas untuk target AmlCompute ini.
delete

Hapus objek AmlCompute dari ruang kerja yang terkait.
deserialize

Konversi objek JSON menjadi objek AmlCompute.
detach

Pelepasan untuk objek AmlCompute tidak didukung. Gunakan delete sebagai gantinya.
get

Kembalikan objek komputasi.
get_active_runs

Menampilkan generator eksekusi untuk komputasi ini.
get_status

Ambil status terperinci saat ini untuk kluster AmlCompute.
list_nodes

Dapatkan detailnya (misalnya, alamat IP, port, dll.) dari semua simpul komputasi dalam target komputasi.
list_quotas

Dapatkan kuota Ruang Kerja yang saat ini ditetapkan berdasarkan VMFamily untuk ruang kerja dan langganan tertentu.
list_usages

Dapatkan informasi penggunaan saat ini serta batasan sumber daya AML untuk ruang kerja dan langganan tertentu.
provisioning_configuration

Buat objek konfigurasi untuk menyediakan target AmlCompute.
refresh_state

Lakukan pembaruan di tempat dari properti objek.

Metode ini memperbarui properti berdasarkan status objek cloud yang sesuai saat ini. Ini terutama digunakan untuk polling manual status komputasi.
remove_identity

Hapus identitas pada komputasi.
serialize

Konversi objek AmlCompute ini menjadi kamus serial JSON.
supported_vmsizes

Cantumkan ukuran mesin virtual yang didukung di suatu wilayah.
update

Perbarui ScaleSettings untuk target AmlCompute.
update_quotas

Perbarui kuota untuk keluarga mesin virtual di ruang kerja.
wait_for_completion

Tunggu hingga kluster AmlCompute selesai melakukan provisi.

Ini dapat dikonfigurasi untuk menunggu jumlah minimum node, dan untuk batas waktu setelah jangka waktu tertentu.

add_identity

Tambahkan Jenis Identitas dan/atau Id Identitas untuk target AmlCompute ini.

add_identity(identity_type, identity_id=None)

Parameter

Nama Deskripsi
identity_type
Diperlukan
string

Potensi nilai:

  • SystemAssigned - Identitas yang ditetapkan sistem

  • UserAssigned - Identitas yang ditetapkan pengguna. Memerlukan id identitas untuk diatur.
identity_id
list[str]

Daftar id sumber daya untuk identitas yang ditetapkan pengguna. misalnya. ['/subscriptions//resourceGroups//providers/Microsoft.ManagedIdentity /userAssignedIdentities/']

Nilai default: None

Keterangan

identity_id hanya boleh ditentukan jika identity_type == UserAssigned

delete

Hapus objek AmlCompute dari ruang kerja yang terkait.

delete()

Pengecualian

Jenis Deskripsi
ComputeTargetException

Keterangan

Jika objek ini dibuat melalui Azure Machine Learning, objek berbasis cloud yang sesuai juga akan dihapus. Jika objek ini dibuat secara eksternal dan hanya dilampirkan ke ruang kerja, metode ini mengajukan ComputeTargetException dan tidak ada yang berubah.

deserialize

Konversi objek JSON menjadi objek AmlCompute.

static deserialize(workspace, object_dict)

Parameter

Nama Deskripsi
workspace
Diperlukan
Workspace

Objek ruang kerja yang dikaitkan dengan objek AmlCompute.
object_dict
Diperlukan
dict

Objek JSON yang akan dikonversi menjadi objek AmlCompute.

Mengembalikan

Jenis Deskripsi
AmlCompute

Representasi AmlCompute dari objek JSON yang disediakan.

Pengecualian

Jenis Deskripsi
ComputeTargetException

Keterangan

Mengajukan ComputeTargetException jika ruang kerja yang disediakan bukan ruang kerja yang dikaitkan dengan Azure Compute.

detach

Pelepasan untuk objek AmlCompute tidak didukung. Gunakan delete sebagai gantinya.

detach()

Pengecualian

Jenis Deskripsi
ComputeTargetException

get

Kembalikan objek komputasi.

get()

get_active_runs

Menampilkan generator eksekusi untuk komputasi ini.

get_active_runs(type=None, tags=None, properties=None, status=None)

Parameter

Nama Deskripsi
type
str

Filter generator yang dikembalikan pada eksekusi dengan jenis yang disediakan. Lihat add_type_provider untuk membuat jenis eksekusi.

Nilai default: None
tags
str atau dict

Filter eksekusi menurut "tag" atau {"tag": "value"}

Nilai default: None
properties
str atau dict

Filter eksekusi menurut "property" atau {"property": "value"}

Nilai default: None
status
str

Status eksekusi - "Running" atau "Queued"

Nilai default: None

Mengembalikan

Jenis Deskripsi
<xref:builtin.generator>

generator ~_restclient.models.RunDto

get_status

Ambil status terperinci saat ini untuk kluster AmlCompute.

get_status()

Mengembalikan

Jenis Deskripsi
AmlComputeStatus

Objek status terperinci untuk kluster

list_nodes

Dapatkan detailnya (misalnya, alamat IP, port, dll.) dari semua simpul komputasi dalam target komputasi.

list_nodes()

Mengembalikan

Jenis Deskripsi
list

Detail semua node komputasi dalam target komputasi.

list_quotas

Dapatkan kuota Ruang Kerja yang saat ini ditetapkan berdasarkan VMFamily untuk ruang kerja dan langganan tertentu.

static list_quotas(workspace, location=None)

Parameter

Nama Deskripsi
workspace
Diperlukan
Workspace
location
str

Lokasi kuota. Jika tidak ditentukan, akan diatur secara default ke lokasi ruang kerja.

Nilai default: None

Mengembalikan

Jenis Deskripsi
list

Daftar Kuota Ruang Kerja yang saat ini ditetapkan berdasarkan VMFamily

list_usages

Dapatkan informasi penggunaan saat ini serta batasan sumber daya AML untuk ruang kerja dan langganan tertentu.

static list_usages(workspace, show_all=False, location=None)

Parameter

Nama Deskripsi
workspace
Diperlukan
Workspace
show_all

Menentukan apakah penggunaan sumber daya turunan yang terperinci diperlukan. Default ke False

Nilai default: False
location
str

Lokasi sumber daya. Jika tidak ditentukan, akan diatur secara default ke lokasi ruang kerja.

Nilai default: None

Mengembalikan

Jenis Deskripsi
list

Daftar informasi penggunaan saat ini serta batasan untuk sumber daya AML

provisioning_configuration

Buat objek konfigurasi untuk menyediakan target AmlCompute.

static provisioning_configuration(vm_size='', vm_priority='dedicated', min_nodes=0, max_nodes=None, idle_seconds_before_scaledown=1800, admin_username=None, admin_user_password=None, admin_user_ssh_key=None, vnet_resourcegroup_name=None, vnet_name=None, subnet_name=None, tags=None, description=None, remote_login_port_public_access='NotSpecified', identity_type=None, identity_id=None, location=None, enable_node_public_ip=True)

Parameter

Nama Deskripsi
vm_size
Diperlukan
str

Ukuran mesin virtual agen. Detail selengkapnya dapat ditemukan di sini: https://aka.ms/azureml-vm-details. Perhatikan bahwa tidak semua ukuran tersedia di semua wilayah, seperti yang dijelaskan dalam link sebelumnya. Jika tidak ditentukan, default ke Standard_NC6.
vm_priority
str

Prioritas mesin virtual, khusus atau prioritas rendah.

Nilai default: dedicated
min_nodes
int

Jumlah simpul minimum untuk digunakan untuk kluster. Jika tidak ditentukan, default ke 0.

Nilai default: 0
max_nodes
int

Jumlah maksimum node untuk digunakan pada kluster. Jika tidak ditentukan, default ke 4.

Nilai default: None
idle_seconds_before_scaledown
int

Waktu idle simpul dalam hitungan detik sebelum menskalakan kluster. Jika tidak ditentukan, default ke 1800.

Nilai default: 1800
admin_username
str

Nama akun pengguna administrator yang dapat digunakan untuk SSH ke dalam node.

Nilai default: None
admin_user_password
str

Kata sandi akun pengguna administrator.

Nilai default: None
admin_user_ssh_key
str

Kunci umum SSH akun pengguna administrator.

Nilai default: None
vnet_resourcegroup_name
str

Nama grup sumber daya tempat jaringan virtual berada.

Nilai default: None
vnet_name
str

Nama jaringan virtual.

Nilai default: None
subnet_name
str

Nama subnet di dalam VNet.

Nilai default: None
tags
dict[str, str]

Kamus tag nilai kunci yang disediakan untuk objek komputasi.

Nilai default: None
description
str

Deskripsi yang akan disediakan untuk objek komputasi.

Nilai default: None
remote_login_port_public_access
str

Status port SSH publik. Potensi nilai:

  • Dinonaktifkan - Menunjukkan bahwa port ssh publik ditutup pada semua node kluster.

  • Diaktifkan - Menunjukkan bahwa port ssh publik dibuka di semua node kluster.

  • NotSpecified - Menunjukkan bahwa port ssh publik ditutup pada semua node kluster jika VNet ditentukan, yang lain membuka semua node publik. Ini bisa menjadi nilai default hanya selama waktu pembuatan kluster. Setelah dibuat, ini akan diaktifkan atau dinonaktifkan.

Nilai default: NotSpecified
identity_type
string

Potensi nilai:

  • SystemAssigned - Identitas yang ditetapkan sistem

  • UserAssigned - Identitas yang ditetapkan pengguna. Memerlukan id identitas untuk diatur.

Nilai default: None
identity_id
list[str]

Daftar id sumber daya untuk identitas yang ditetapkan pengguna. misalnya. ['/subscriptions//resourceGroups//providers/Microsoft.ManagedIdentity/userAssignedIdentities/']

Nilai default: None
location
str

Lokasi untuk menyediakan kluster.

Nilai default: None
enable_node_public_ip
bool

Aktifkan IP publik node. Potensi nilai:

  • True - Aktifkan IP publik node.

  • False - Nonaktifkan IP publik node.

  • NotSpecified - Aktifkan IP publik node.

Nilai default: True

Mengembalikan

Jenis Deskripsi
AmlComputeProvisioningConfiguration

Objek konfigurasi yang akan digunakan saat membuat objek Azure Compute.

Pengecualian

Jenis Deskripsi
ComputeTargetException

refresh_state

Lakukan pembaruan di tempat dari properti objek.

Metode ini memperbarui properti berdasarkan status objek cloud yang sesuai saat ini. Ini terutama digunakan untuk polling manual status komputasi.

refresh_state()

remove_identity

Hapus identitas pada komputasi.

remove_identity(identity_id=None)

Parameter

Nama Deskripsi
identity_id
list[str]

Identitas yang ditetapkan pengguna

Nilai default: None

Keterangan

Identitas yang Ditetapkan sistem akan dihapus secara otomatis jika identity_id tidak ditentukan

serialize

Konversi objek AmlCompute ini menjadi kamus serial JSON.

serialize()

Mengembalikan

Jenis Deskripsi
dict

Representasi JSON dari objek AmlCompute ini.

supported_vmsizes

Cantumkan ukuran mesin virtual yang didukung di suatu wilayah.

static supported_vmsizes(workspace, location=None)

Parameter

Nama Deskripsi
workspace
Diperlukan
Workspace
location
str

Lokasi kluster. Jika tidak ditentukan, akan default ke lokasi ruang kerja.

Nilai default: None

Mengembalikan

Jenis Deskripsi
list

Daftar ukuran mesin virtual yang didukung di wilayah dengan nama VM, VCPU, dan RAM.

update

Perbarui ScaleSettings untuk target AmlCompute.

update(min_nodes=None, max_nodes=None, idle_seconds_before_scaledown=None)

Parameter

Nama Deskripsi
min_nodes
int

Jumlah simpul minimum untuk digunakan untuk kluster.

Nilai default: None
max_nodes
int

Jumlah maksimum node untuk digunakan pada kluster.

Nilai default: None
idle_seconds_before_scaledown
int

Waktu idle node dalam hitungan detik sebelum mengurangi skala kluster.

Nilai default: None

update_quotas

Perbarui kuota untuk keluarga mesin virtual di ruang kerja.

static update_quotas(workspace, vm_family, limit=None, location=None)

Parameter

Nama Deskripsi
workspace
Diperlukan
Workspace
vm_family
Diperlukan
str

Nama keluarga mesin virtual
limit
int

Kuota maksimum sumber daya yang diizinkan

Nilai default: None
location
str

Lokasi kuota. Jika tidak ditentukan, akan diatur secara default ke lokasi ruang kerja.

Nilai default: None

wait_for_completion

Tunggu hingga kluster AmlCompute selesai melakukan provisi.

Ini dapat dikonfigurasi untuk menunggu jumlah minimum node, dan untuk batas waktu setelah jangka waktu tertentu.

wait_for_completion(show_output=False, min_node_count=None, timeout_in_minutes=25, is_delete_operation=False)

Parameter

Nama Deskripsi
show_output
bool

Boolean untuk menyediakan output verbose yang lebih.

Nilai default: False
min_node_count
int

Jumlah minimum node yang harus ditunggu sebelum mempertimbangkan provisi selesai. Ini tidak harus sama dengan jumlah minimum node yang disediakan oleh komputasi, namun tidak boleh lebih besar dari itu.

Nilai default: None
timeout_in_minutes
int

Durasi dalam beberapa menit untuk menunggu sebelum mempertimbangkan provisi telah gagal.

Nilai default: 25
is_delete_operation
bool

Menunjukkan apakah operasi ditujukan untuk menghapus.

Nilai default: False

Pengecualian

Jenis Deskripsi
ComputeTargetException