Aracılığıyla paylaş

AmlCompute Sınıf

  • Başvuru

Azure Machine Learning'de bir Azure Machine Learning işlem yönetir.

Azure Machine Learning İşlem (AmlCompute), tek veya çok düğümlü bir işlemi kolayca oluşturmanıza olanak tanıyan bir yönetilen işlem altyapısıdır. İşlem, çalışma alanı bölgenizde diğer kullanıcılarla paylaşılabilen bir kaynak olarak oluşturulur. Daha fazla bilgi için bkz. Azure Machine Learning'de işlem hedefleri nelerdir?

Class ComputeTarget oluşturucu.

Sağlanan çalışma alanıyla ilişkili bir İşlem nesnesinin bulut gösterimini alın. Alınan İşlem nesnesinin belirli türüne karşılık gelen bir alt sınıfın örneğini döndürür.

Devralma
ComputeTarget
AmlCompute

Oluşturucu

AmlCompute(workspace, name)

Parametreler

Name Description
workspace
Gerekli
Workspace

Alınacak AmlCompute nesnesini içeren çalışma alanı nesnesi.
name
Gerekli
str

Alınacak AmlCompute nesnesinin adı.
workspace
Gerekli
Workspace

Alınacak İşlem nesnesini içeren çalışma alanı nesnesi.
name
Gerekli
str

Alınacak İşlem nesnesinin adı.

Açıklamalar

Aşağıdaki örnekte, tarafından AmlCompute sağlanan kalıcı bir işlem hedefi oluşturulur. provisioning_configuration Bu örnekteki parametre, alt sınıfı olan türündedirAmlComputeProvisioningConfigurationComputeTargetProvisioningConfiguration.


   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)

Tam örnek şu kaynaktan edinilebilir: https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-amlcompute/train-on-amlcompute.ipynb

Yöntemler

add_identity

Bu AmlCompute hedefi için Kimlik Türü ve/veya Kimlik Kimlikleri ekleyin.
delete

AmlCompute nesnesini ilişkili çalışma alanından kaldırın.
deserialize

JSON nesnesini AmlCompute nesnesine dönüştürün.
detach

AmlCompute nesnesi için ayırma desteklenmiyor. Bunun yerine delete kullanın.
get

dönüş işlem nesnesi.
get_active_runs

Bu işlem için çalıştırmaların oluşturucusunu döndürür.
get_status

AmlCompute kümesi için geçerli ayrıntılı durumu alın.
list_nodes

İşlem hedefindeki tüm işlem düğümlerinin ayrıntılarını (örneğin, IP adresi, bağlantı noktası vb.) alın.
list_quotas

Verilen çalışma alanı ve abonelik için VMFamily temelinde şu anda atanmış olan Çalışma Alanı kotalarını alın.
list_usages

Geçerli kullanım bilgilerinin yanı sıra verilen çalışma alanı ve abonelik için AML kaynaklarının sınırlarını alın.
provisioning_configuration

AmlCompute hedefi sağlamak için bir yapılandırma nesnesi oluşturun.
refresh_state

Nesnenin özelliklerinin yerinde güncelleştirmesini gerçekleştirin.

Bu yöntem, ilgili bulut nesnesinin geçerli durumuna göre özellikleri güncelleştirir. Bu öncelikle işlem durumunun el ile yoklanması için kullanılır.
remove_identity

İşlemdeki kimliği kaldırın.
serialize

Bu AmlCompute nesnesini JSON serileştirilmiş sözlüğüne dönüştürün.
supported_vmsizes

Bir bölgede desteklenen VM boyutlarını listeleyin.
update

Bu AmlCompute hedefi için öğesini ScaleSettings güncelleştirin.
update_quotas

Çalışma alanında bir VM ailesi için kotayı güncelleştirin.
wait_for_completion

AmlCompute kümesinin sağlamayı tamamlamasını bekleyin.

Bu, en az sayıda düğüm bekleyecek ve belirli bir süre sonra zaman aşımına neden olacak şekilde yapılandırılabilir.

add_identity

Bu AmlCompute hedefi için Kimlik Türü ve/veya Kimlik Kimlikleri ekleyin.

add_identity(identity_type, identity_id=None)

Parametreler

Name Description
identity_type
Gerekli
string

Olası değerler şunlardır:

  • SystemAssigned - Sistem tarafından atanan kimlik

  • UserAssigned - Kullanıcı tarafından atanan kimlik. Kimlik kimliğinin ayarlanmasını gerektirir.
identity_id
list[str]

Kullanıcı tarafından atanan kimliğin kaynak kimliklerinin listesi. Örneğin ['/subscriptions//resourceGroups//providers/Microsoft.ManagedIdentity /userAssignedIdentities/']

Default value: None

Açıklamalar

identity_id yalnızca identity_type == UserAssigned olduğunda belirtilmelidir

delete

AmlCompute nesnesini ilişkili çalışma alanından kaldırın.

delete()

Özel durumlar

Tür Description
ComputeTargetException

Açıklamalar

Bu nesne Azure Machine Learning aracılığıyla oluşturulduysa ilgili bulut tabanlı nesneler de silinir. Bu nesne dışarıdan oluşturulduysa ve yalnızca çalışma alanına eklendiyse, bu yöntem bir ComputeTargetException oluşturur ve hiçbir şey değişmez.

deserialize

JSON nesnesini AmlCompute nesnesine dönüştürün.

static deserialize(workspace, object_dict)

Parametreler

Name Description
workspace
Gerekli
Workspace

AmlCompute nesnesinin ilişkili olduğu çalışma alanı nesnesi.
object_dict
Gerekli
dict

AmlCompute nesnesine dönüştürülecek JSON nesnesi.

Döndürülenler

Tür Description
AmlCompute

Sağlanan JSON nesnesinin AmlCompute gösterimi.

Özel durumlar

Tür Description
ComputeTargetException

Açıklamalar

Sağlanan çalışma alanı İşlem'in ilişkili olduğu çalışma alanı değilse bir ComputeTargetException oluşturur.

detach

AmlCompute nesnesi için ayırma desteklenmiyor. Bunun yerine delete kullanın.

detach()

Özel durumlar

Tür Description
ComputeTargetException

get

dönüş işlem nesnesi.

get()

get_active_runs

Bu işlem için çalıştırmaların oluşturucusunu döndürür.

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

Parametreler

Name Description
type
str

Döndürülen çalıştırma oluşturucuyu sağlanan türe göre filtreleyin. Çalıştırma türleri oluşturmak için bkz add_type_provider .

Default value: None
tags
str veya dict

Filtre çalıştırmalarını "etiket" veya {"tag": "value"}

Default value: None
properties
str veya dict

Filtre "özellik" veya {"özellik": "value"} tarafından çalıştırılır

Default value: None
status
str

Çalıştırma durumu - "Çalışıyor" veya "Kuyruğa Alındı"

Default value: None

Döndürülenler

Tür Description
<xref:builtin.generator>

~_restclient.models.RunDto oluşturucusu

get_status

AmlCompute kümesi için geçerli ayrıntılı durumu alın.

get_status()

Döndürülenler

Tür Description
AmlComputeStatus

Küme için ayrıntılı bir durum nesnesi

list_nodes

İşlem hedefindeki tüm işlem düğümlerinin ayrıntılarını (örneğin, IP adresi, bağlantı noktası vb.) alın.

list_nodes()

Döndürülenler

Tür Description
list

İşlem hedefindeki tüm işlem düğümlerinin ayrıntıları.

list_quotas

Verilen çalışma alanı ve abonelik için VMFamily temelinde şu anda atanmış olan Çalışma Alanı kotalarını alın.

static list_quotas(workspace, location=None)

Parametreler

Name Description
workspace
Gerekli
Workspace
location
str

Kotaların konumu. Belirtilmezse, varsayılan olarak çalışma alanı konumu olur.

Default value: None

Döndürülenler

Tür Description
list

VMFamily'ye göre atanmış durumdaki Çalışma Alanı Kotalarının listesi

list_usages

Geçerli kullanım bilgilerinin yanı sıra verilen çalışma alanı ve abonelik için AML kaynaklarının sınırlarını alın.

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

Parametreler

Name Description
workspace
Gerekli
Workspace
show_all

Alt kaynakların ayrıntılı kullanımlarının gerekli olup olmadığını belirtir. Varsayılan değer False'tur

Default value: False
location
str

Kaynakların konumu. Belirtilmezse, varsayılan olarak çalışma alanı konumu olur.

Default value: None

Döndürülenler

Tür Description
list

AmL kaynakları için geçerli kullanım bilgilerinin yanı sıra sınırlar listesi

provisioning_configuration

AmlCompute hedefi sağlamak için bir yapılandırma nesnesi oluşturun.

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)

Parametreler

Name Description
vm_size
Gerekli
str

Aracı VM'lerin boyutu. Daha fazla ayrıntıya şuradan ulaşabilirsiniz: https://aka.ms/azureml-vm-details. Önceki bağlantıda ayrıntılı olarak açıklandığı gibi tüm boyutların tüm bölgelerde kullanılamadığını unutmayın. Belirtilmezse, varsayılan olarak Standard_NC6.
vm_priority
str

VM önceliği, ayrılmış veya düşük ayrıcalık.

Default value: dedicated
min_nodes
int

Kümede kullanılacak en az düğüm sayısı. Belirtilmezse, varsayılan olarak 0 olur.

Default value: 0
max_nodes
int

Kümede kullanılacak en fazla düğüm sayısı. Belirtilmezse, varsayılan olarak 4 olur.

Default value: None
idle_seconds_before_scaledown
int

Kümenin ölçeğini azaltmadan önce saniyeler içinde düğüm boşta kalma süresi. Belirtilmezse, varsayılan olarak 1800 olur.

Default value: 1800
admin_username
str

Düğümlere SSH uygulamak için kullanılabilecek yönetici kullanıcı hesabının adı.

Default value: None
admin_user_password
str

Yönetici kullanıcı hesabının parolası.

Default value: None
admin_user_ssh_key
str

Yönetici kullanıcı hesabının SSH ortak anahtarı.

Default value: None
vnet_resourcegroup_name
str

Sanal ağın bulunduğu kaynak grubunun adı.

Default value: None
vnet_name
str

Sanal ağın adı.

Default value: None
subnet_name
str

Sanal ağın içindeki alt ağın adı.

Default value: None
tags
dict[str, str]

İşlem nesnesine sağlanmış anahtar değer etiketleri sözlüğü.

Default value: None
description
str

İşlem nesnesine sağlanmış bir açıklama.

Default value: None
remote_login_port_public_access
str

Genel SSH bağlantı noktasının durumu. Olası değerler şunlardır:

  • Disabled - Kümenin tüm düğümlerinde genel ssh bağlantı noktasının kapatıldığını gösterir.

  • Etkin - Genel ssh bağlantı noktasının kümenin tüm düğümlerinde açık olduğunu gösterir.

  • NotSpecified - Sanal ağ tanımlanırsa kümenin tüm düğümlerinde ortak ssh bağlantı noktasının kapatıldığını, aksi takdirde tüm ortak düğümlerin açık olduğunu gösterir. Yalnızca küme oluşturma sırasında bu varsayılan değer olabilir. Oluşturulduktan sonra etkinleştirilir veya devre dışı bırakılır.

Default value: NotSpecified
identity_type
string

Olası değerler şunlardır:

  • SystemAssigned - Sistem tarafından atanan kimlik

  • UserAssigned - Kullanıcı tarafından atanan kimlik. Kimlik kimliğinin ayarlanmasını gerektirir.

Default value: None
identity_id
list[str]

Kullanıcı tarafından atanan kimliğin kaynak kimliklerinin listesi. Örneğin ['/subscriptions//resourceGroups//providers/Microsoft.ManagedIdentity/userAssignedIdentities/']

Default value: None
location
str

Kümenin sağ bağlanacak konumu.

Default value: None
enable_node_public_ip
bool

Düğüm genel IP'sini etkinleştirin. Olası değerler şunlardır:

  • True - Düğüm genel IP'sini etkinleştirin.

  • False - Düğüm genel IP'sini devre dışı bırakın.

  • NotSpecified - Düğüm genel IP'sini etkinleştirin.

Default value: True

Döndürülenler

Tür Description
AmlComputeProvisioningConfiguration

İşlem nesnesi oluşturulurken kullanılacak yapılandırma nesnesi.

Özel durumlar

Tür Description
ComputeTargetException

refresh_state

Nesnenin özelliklerinin yerinde güncelleştirmesini gerçekleştirin.

Bu yöntem, ilgili bulut nesnesinin geçerli durumuna göre özellikleri güncelleştirir. Bu öncelikle işlem durumunun el ile yoklanması için kullanılır.

refresh_state()

remove_identity

İşlemdeki kimliği kaldırın.

remove_identity(identity_id=None)

Parametreler

Name Description
identity_id
list[str]

Kullanıcı tarafından atanan kimlikler

Default value: None

Açıklamalar

Identity_id belirtilmezse Sistem Tarafından Atanan kimlik otomatik olarak kaldırılır

serialize

Bu AmlCompute nesnesini JSON serileştirilmiş sözlüğüne dönüştürün.

serialize()

Döndürülenler

Tür Description
dict

Bu AmlCompute nesnesinin JSON gösterimi.

supported_vmsizes

Bir bölgede desteklenen VM boyutlarını listeleyin.

static supported_vmsizes(workspace, location=None)

Parametreler

Name Description
workspace
Gerekli
Workspace
location
str

Kümenin konumu. Belirtilmezse, varsayılan olarak çalışma alanı konumuna ayarlanır.

Default value: None

Döndürülenler

Tür Description
list

Vm, VCPU'lar ve RAM adlarıyla bir bölgede desteklenen VM boyutlarının listesi.

update

Bu AmlCompute hedefi için öğesini ScaleSettings güncelleştirin.

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

Parametreler

Name Description
min_nodes
int

Kümede kullanılacak en az düğüm sayısı.

Default value: None
max_nodes
int

Kümede kullanılacak en fazla düğüm sayısı.

Default value: None
idle_seconds_before_scaledown
int

Kümenin ölçeğini azaltmadan önce saniyeler içinde düğüm boşta kalma süresi.

Default value: None

update_quotas

Çalışma alanında bir VM ailesi için kotayı güncelleştirin.

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

Parametreler

Name Description
workspace
Gerekli
Workspace
vm_family
Gerekli
str

VM aile adı
limit
int

Kaynağın izin verilen en yüksek kotası

Default value: None
location
str

Kotanın konumu. Belirtilmezse, varsayılan olarak çalışma alanı konumuna ayarlanır.

Default value: None

wait_for_completion

AmlCompute kümesinin sağlamayı tamamlamasını bekleyin.

Bu, en az sayıda düğüm bekleyecek ve belirli bir süre sonra zaman aşımına neden olacak şekilde yapılandırılabilir.

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

Parametreler

Name Description
show_output
bool

Daha ayrıntılı çıkış sağlamak için Boole değeri.

Default value: False
min_node_count
int

Sağlamanın tamamlanmasını dikkate almadan önce beklenecek en az düğüm sayısı. Bunun, işlem tarafından sağlanan en az düğüm sayısına eşit olması gerekmez, ancak bundan büyük olmamalıdır.

Default value: None
timeout_in_minutes
int

Sağlamanın başarısız olması düşünülmeden önce beklenmesi gereken dakika cinsinden süre.

Default value: 25
is_delete_operation
bool

İşlemin silme amaçlı olup olmadığını gösterir.

Default value: False

Özel durumlar

Tür Description
ComputeTargetException