AmlCompute Sınıf
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
-
AmlCompute
Oluşturucu
AmlCompute(workspace, name)Parametreler
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
- 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.
Kullanıcı tarafından atanan kimliğin kaynak kimliklerinin listesi. Örneğin ['/subscriptions//resourceGroups//providers/Microsoft.ManagedIdentity /userAssignedIdentities/']
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
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
Döndürülenler
Sağlanan JSON nesnesinin AmlCompute gösterimi.
Dönüş türü
Özel durumlar
Açıklamalar
Sağlanan çalışma alanı İşlem'in ilişkili olduğu çalışma alanı değilse bir ComputeTargetException oluşturur.
detach
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
- 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 .
Filtre "özellik" veya {"özellik": "value"} tarafından çalıştırılır
Döndürülenler
~_restclient.models.RunDto oluşturucusu
Dönüş türü
get_status
AmlCompute kümesi için geçerli ayrıntılı durumu alın.
get_status()Döndürülenler
Küme için ayrıntılı bir durum nesnesi
Dönüş türü
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
İşlem hedefindeki tüm işlem düğümlerinin ayrıntıları.
Dönüş türü
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
- workspace
- Workspace
- location
- str
Kotaların konumu. Belirtilmezse, varsayılan olarak çalışma alanı konumu olur.
Döndürülenler
VMFamily'ye göre atanmış durumdaki Çalışma Alanı Kotalarının listesi
Dönüş türü
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
- workspace
- Workspace
- show_all
Alt kaynakların ayrıntılı kullanımlarının gerekli olup olmadığını belirtir. Varsayılan değer False'tur
- location
- str
Kaynakların konumu. Belirtilmezse, varsayılan olarak çalışma alanı konumu olur.
Döndürülenler
AmL kaynakları için geçerli kullanım bilgilerinin yanı sıra sınırlar listesi
Dönüş türü
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
- vm_size
- 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.
- min_nodes
- int
Kümede kullanılacak en az düğüm sayısı. Belirtilmezse, varsayılan olarak 0 olur.
- max_nodes
- int
Kümede kullanılacak en fazla düğüm sayısı. Belirtilmezse, varsayılan olarak 4 olur.
- 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.
- admin_username
- str
Düğümlere SSH uygulamak için kullanılabilecek yönetici kullanıcı hesabının adı.
İşlem nesnesine sağlanmış anahtar değer etiketleri sözlüğü.
- 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.
- 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.
Kullanıcı tarafından atanan kimliğin kaynak kimliklerinin listesi. Örneğin ['/subscriptions//resourceGroups//providers/Microsoft.ManagedIdentity/userAssignedIdentities/']
- 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.
Döndürülenler
İşlem nesnesi oluşturulurken kullanılacak yapılandırma nesnesi.
Dönüş türü
Özel durumlar
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
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
Bu AmlCompute nesnesinin JSON gösterimi.
Dönüş türü
supported_vmsizes
Bir bölgede desteklenen VM boyutlarını listeleyin.
static supported_vmsizes(workspace, location=None)Parametreler
- workspace
- Workspace
- location
- str
Kümenin konumu. Belirtilmezse, varsayılan olarak çalışma alanı konumuna ayarlanır.
Döndürülenler
Vm, VCPU'lar ve RAM adlarıyla bir bölgede desteklenen VM boyutlarının listesi.
Dönüş türü
update
Bu AmlCompute hedefi için öğesini ScaleSettings güncelleştirin.
update(min_nodes=None, max_nodes=None, idle_seconds_before_scaledown=None)Parametreler
- idle_seconds_before_scaledown
- int
Kümenin ölçeğini azaltmadan önce saniyeler içinde düğüm boşta kalma süresi.
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
- workspace
- Workspace
- location
- str
Kotanın konumu. Belirtilmezse, varsayılan olarak çalışma alanı konumuna ayarlanır.
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
- 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.
- timeout_in_minutes
- int
Sağlamanın başarısız olması düşünülmeden önce beklenmesi gereken dakika cinsinden süre.
Özel durumlar
Geri Bildirim
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin