AmlCompute Třída

Spravuje výpočetní prostředky Azure Machine Learning ve službě Azure Machine Learning.

Výpočetní prostředí Azure Machine Learning (AmlCompute) je spravovaná výpočetní infrastruktura, která umožňuje snadno vytvořit výpočetní prostředky s jedním nebo více uzly. Výpočetní prostředky se vytvoří ve vaší oblasti pracovního prostoru jako prostředek, který se dá sdílet s ostatními uživateli. Další informace najdete v tématu Co jsou cílové výpočetní objekty ve službě Azure Machine Learning?

Třída ComputeTarget konstruktor.

Načtení cloudové reprezentace výpočetního objektu přidruženého k poskytnutému pracovnímu prostoru Vrátí instanci podřízené třídy odpovídající určitému typu načteného výpočetního objektu.

Konstruktor

AmlCompute(workspace, name)

Parametry

Name	Description
workspace Vyžadováno	Workspace Objekt pracovního prostoru obsahující objekt AmlCompute, který se má načíst.
name Vyžadováno	str Název objektu AmlCompute, který se má načíst.
workspace Vyžadováno	Workspace Objekt pracovního prostoru obsahující výpočetní objekt, který se má načíst.
name Vyžadováno	str Název výpočetního objektu, který se má načíst.

Poznámky

V následujícím příkladu se vytvoří trvalý cílový výpočetní objekt zřízený službou AmlCompute . Parametr provisioning_configuration v tomto příkladu je typu AmlComputeProvisioningConfiguration, což je podřízená třída 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)

Úplná ukázka je k dispozici od https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-amlcompute/train-on-amlcompute.ipynb

Metody

add_identity	Přidejte typ identity nebo ID identity pro tento cíl AmlCompute.
delete	Odeberte objekt AmlCompute z přidruženého pracovního prostoru.
deserialize	Převede objekt JSON na objekt AmlCompute.
detach	Odpojení není podporováno pro objekt AmlCompute. Místo toho použijte delete.
get	Vrácení výpočetního objektu
get_active_runs	Vrátí generátor spuštění pro tento výpočetní objekt.
get_status	Načtěte aktuální podrobný stav clusteru AmlCompute.
list_nodes	Získejte podrobnosti (např. IP adresu, port atd.) všech výpočetních uzlů v cílovém výpočetním objektu.
list_quotas	Získejte aktuálně přiřazené kvóty pracovního prostoru na základě VMFamily pro daný pracovní prostor a předplatné.
list_usages	Získejte aktuální informace o využití a omezení pro prostředky AML pro daný pracovní prostor a předplatné.
provisioning_configuration	Vytvořte objekt konfigurace pro zřízení cíle AmlCompute.
refresh_state	Proveďte místní aktualizaci vlastností objektu. Tato metoda aktualizuje vlastnosti na základě aktuálního stavu odpovídajícího cloudového objektu. Používá se primárně pro ruční dotazování výpočetního stavu.
remove_identity	Odeberte identitu na výpočetních prostředcích.
serialize	Převeďte tento objekt AmlCompute na serializovaný slovník JSON.
supported_vmsizes	Uveďte seznam podporovaných velikostí virtuálních počítačů v oblasti.
update	ScaleSettings Aktualizujte pro tento cíl AmlCompute.
update_quotas	Aktualizujte kvótu pro řadu virtuálních počítačů v pracovním prostoru.
wait_for_completion	Počkejte, až cluster AmlCompute dokončí zřizování. Tato možnost se dá nakonfigurovat tak, aby po určitou dobu čekala na minimální počet uzlů a na vypršení časového limitu.

add_identity

Přidejte typ identity nebo ID identity pro tento cíl AmlCompute.

add_identity(identity_type, identity_id=None)

Parametry

Name	Description
identity_type Vyžadováno	string Možné hodnoty: SystemAssigned – Identita přiřazená systémem UserAssigned – identita přiřazená uživatelem Vyžaduje nastavení ID identity.
identity_id	list[str] Seznam ID prostředků pro identitu přiřazenou uživatelem Např. ['/subscriptions/<subid>/resourceGroups/<rg>/providers/Microsoft.ManagedIdentity /userAssignedIdentities/<id>'] Default value: None

Poznámky

identity_id by měla být zadána pouze v případě, že identity_type == UserAssigned

delete

Odeberte objekt AmlCompute z přidruženého pracovního prostoru.

delete()

Výjimky

Typ	Description
ComputeTargetException

Poznámky

Pokud byl tento objekt vytvořen prostřednictvím služby Azure Machine Learning, odstraní se také odpovídající cloudové objekty. Pokud byl tento objekt vytvořen externě a připojen pouze k pracovnímu prostoru, tato metoda vyvolá ComputeTargetException a nic se nezmění.

deserialize

Převede objekt JSON na objekt AmlCompute.

static deserialize(workspace, object_dict)

Parametry

Name	Description
workspace Vyžadováno	Workspace Objekt pracovního prostoru, ke které je objekt AmlCompute přidružen.
object_dict Vyžadováno	dict Objekt JSON, který se má převést na objekt AmlCompute.

Návraty

Typ	Description
AmlCompute	AmlCompute reprezentace poskytnutého objektu JSON.

Výjimky

Typ	Description
ComputeTargetException

Poznámky

ComputeTargetException Vyvolá, pokud zadaný pracovní prostor není pracovním prostorem, ke kterým je přidružený výpočetní objekt.

detach

Odpojení není podporováno pro objekt AmlCompute. Místo toho použijte delete.

detach()

Výjimky

Typ	Description
ComputeTargetException

get

Vrácení výpočetního objektu

get()

get_active_runs

Vrátí generátor spuštění pro tento výpočetní objekt.

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

Parametry

Name	Description
type	str Vyfiltrujte vrácený generátor spuštění podle zadaného typu. Viz add_type_provider vytváření typů spuštění. Default value: None
tags	str nebo dict Filtrování se spouští podle značky nebo {"tag": "value"} Default value: None
properties	str nebo dict Filtrování se spouští podle vlastnosti nebo {"property": "value"} Default value: None
status	str Stav spuštění – Buď Spuštěno, nebo Zařazeno do fronty Default value: None

Návraty

Typ	Description
<xref:builtin.generator>	generátor ~_restclient.models.RunDto

get_status

Načtěte aktuální podrobný stav clusteru AmlCompute.

get_status()

Návraty

Typ	Description
AmlComputeStatus	Podrobný stavový objekt clusteru

list_nodes

Získejte podrobnosti (např. IP adresu, port atd.) všech výpočetních uzlů v cílovém výpočetním objektu.

list_nodes()

Návraty

Typ	Description
list	Podrobnosti o všech výpočetních uzlech v cílovém výpočetním objektu

list_quotas

Získejte aktuálně přiřazené kvóty pracovního prostoru na základě VMFamily pro daný pracovní prostor a předplatné.

static list_quotas(workspace, location=None)

Parametry

Name	Description
workspace Vyžadováno	Workspace
location	str Umístění kvót. Pokud není zadáno, použije se výchozí umístění pracovního prostoru. Default value: None

Návraty

Typ	Description
list	Seznam aktuálně přiřazených kvót pracovního prostoru na základě VMFamily

list_usages

Získejte aktuální informace o využití a omezení pro prostředky AML pro daný pracovní prostor a předplatné.

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

Parametry

Name	Description
workspace Vyžadováno	Workspace
show_all	Určuje, jestli jsou vyžadována podrobná použití podřízených prostředků. Výchozí hodnota je False Default value: False
location	str Umístění prostředků. Pokud není zadáno, použije se výchozí umístění pracovního prostoru. Default value: None

Návraty

Typ	Description
list	Seznamaktuálních

provisioning_configuration

Vytvořte objekt konfigurace pro zřízení cíle 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)

Parametry

Name	Description
vm_size Vyžadováno	str Velikost virtuálních počítačů agenta Další podrobnosti najdete tady: https://aka.ms/azureml-vm-details. Všimněte si, že ne všechny velikosti jsou dostupné ve všech oblastech, jak je podrobně popsáno na předchozím odkazu. Pokud není zadáno, je výchozí hodnota Standard_NC6.
vm_priority	str Priorita virtuálního počítače, vyhrazená nebo nízkápriorita. Default value: dedicated
min_nodes	int Minimální početuzlůch Pokud není zadáno, výchozí hodnota je 0. Default value: 0
max_nodes	int Maximální počet uzlů, které se mají použít v clusteru. Pokud není zadáno, výchozí hodnota je 4. Default value: None
idle_seconds_before_scaledown	int Doba nečinnosti uzlu v sekundách před vertikálním snížením kapacity clusteru Pokud není zadáno, výchozí hodnota je 1800. Default value: 1800
admin_username	str Jméno uživatelského účtu správce, který lze použít k připojení SSH do uzlů. Default value: None
admin_user_password	str Heslo uživatelského účtu správce. Default value: None
admin_user_ssh_key	str Veřejný klíč SSH uživatelského účtu správce. Default value: None
vnet_resourcegroup_name	str Název skupiny prostředků, ve které se nachází virtuální síť. Default value: None
vnet_name	str Název virtuální sítě. Default value: None
subnet_name	str Název podsítě uvnitř virtuální sítě. Default value: None
tags	dict[str, str] Slovník značek klíčových hodnot, které se mají poskytnout výpočetnímu objektu. Default value: None
description	str Popis, který se má poskytnout výpočetnímu objektu. Default value: None
remote_login_port_public_access	str Stav veřejného portu SSH Možné hodnoty: Zakázáno – Označuje, že veřejný port ssh je uzavřen na všech uzlech clusteru. Povoleno – Označuje, že veřejný port ssh je otevřený na všech uzlech clusteru. Není zadáno – Označuje, že veřejný port ssh je uzavřen na všech uzlech clusteru, pokud je definovaná virtuální síť, jinak je otevřen všechny veřejné uzly. Může se jednat o tuto výchozí hodnotu pouze během vytváření clusteru. Po vytvoření se povolí nebo zakáže. Default value: NotSpecified
identity_type	string Možné hodnoty: SystemAssigned – Identita přiřazená systémem UserAssigned – identita přiřazená uživatelem Vyžaduje nastavení ID identity. Default value: None
identity_id	list[str] Seznam ID prostředků pro identitu přiřazenou uživatelem Např. ['/subscriptions/<subid>/resourceGroups/<rg>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<id>'] Default value: None
location	str Umístění pro zřízení clusteru. Default value: None
enable_node_public_ip	bool Povolte veřejnou IP adresu uzlu. Možné hodnoty: True – Povolte veřejnou IP adresu uzlu. False – Zakažte veřejnou IP adresu uzlu. Není zadáno – Povolte veřejnou IP adresu uzlu. Default value: True

Návraty

Typ	Description
AmlComputeProvisioningConfiguration	Objekt konfigurace, který se použije při vytváření výpočetního objektu.

Výjimky

Typ	Description
ComputeTargetException

refresh_state

Proveďte místní aktualizaci vlastností objektu.

Tato metoda aktualizuje vlastnosti na základě aktuálního stavu odpovídajícího cloudového objektu. Používá se primárně pro ruční dotazování výpočetního stavu.

refresh_state()

remove_identity

Odeberte identitu na výpočetních prostředcích.

remove_identity(identity_id=None)

Parametry

Name	Description
identity_id	list[str] Identity přiřazené uživatelem Default value: None

Poznámky

Identita přiřazená systémem se odebere automaticky, pokud identity_id není zadána.

serialize

Převeďte tento objekt AmlCompute na serializovaný slovník JSON.

serialize()

Návraty

Typ	Description
dict	Reprezentace JSON tohoto objektu AmlCompute.

supported_vmsizes

Uveďte seznam podporovaných velikostí virtuálních počítačů v oblasti.

static supported_vmsizes(workspace, location=None)

Parametry

Name	Description
workspace Vyžadováno	Workspace
location	str Umístění clusteru. Pokud není zadáno, použije se výchozí umístění pracovního prostoru. Default value: None

Návraty

Typ	Description
list	Seznam podporovaných velikostí virtuálních počítačů v oblasti s názvy virtuálních počítačů, virtuálních procesorů a paměti RAM

update

ScaleSettings Aktualizujte pro tento cíl AmlCompute.

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

Parametry

Name	Description
min_nodes	int Minimální početuzlůch Default value: None
max_nodes	int Maximální počet uzlů, které se mají použít v clusteru. Default value: None
idle_seconds_before_scaledown	int Doba nečinnosti uzlu v sekundách před vertikálním snížením kapacity clusteru. Default value: None

update_quotas

Aktualizujte kvótu pro řadu virtuálních počítačů v pracovním prostoru.

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

Parametry

Name	Description
workspace Vyžadováno	Workspace
vm_family Vyžadováno	str Jméno rodiny virtuálních počítačů
limit	int Maximální povolená kvóta prostředku Default value: None
location	str Umístění kvóty. Pokud není zadáno, použije se výchozí umístění pracovního prostoru. Default value: None

wait_for_completion

Počkejte, až cluster AmlCompute dokončí zřizování.

Tato možnost se dá nakonfigurovat tak, aby po určitou dobu čekala na minimální počet uzlů a na vypršení časového limitu.

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

Parametry

Name	Description
show_output	bool Logická hodnota pro poskytování podrobnějšího výstupu Default value: False
min_node_count	int Minimální početuzlůch Nemusí se rovnat minimálnímu počtu uzlů, se kterými byl výpočetní výkon zřízený, ale neměl by být větší. Default value: None
timeout_in_minutes	int Doba trvání v minutách, po které se má počkat, než se zřídí, se nezdařila. Default value: 25
is_delete_operation	bool Určuje, jestli je operace určená k odstranění. Default value: False

Výjimky

Typ	Description
ComputeTargetException

Váš názor

Byla tato stránka užitečná?

Sdílet prostřednictvím

AmlCompute Třída

Konstruktor

Parametry

Poznámky

Metody

add_identity

Parametry

Poznámky

delete

Výjimky

Poznámky

deserialize

Parametry

Návraty

Výjimky

Poznámky

detach

Výjimky

get

get_active_runs

Parametry

Návraty

get_status

Návraty

list_nodes

Návraty

list_quotas

Parametry

Návraty

list_usages

Parametry

Návraty

provisioning_configuration

Parametry

Návraty

Výjimky

refresh_state

remove_identity

Parametry

Poznámky

serialize

Návraty

supported_vmsizes

Parametry

Návraty

update

Parametry

update_quotas

Parametry

wait_for_completion

Parametry

Výjimky

Váš názor