Sdílet prostřednictvím

AmlCompute Třída

  • Reference

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

Azure Machine Learning Compute (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ří v rámci oblasti pracovního prostoru jako prostředek, který je možné 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?

Konstruktor Třídy ComputeTarget.

Načtěte cloudovou reprezentaci objektu Compute přidruženého k zadanému pracovnímu prostoru. Vrátí instanci podřízené třídy odpovídající konkrétnímu typu načteného objektu Compute.

Dědičnost
ComputeTarget
AmlCompute

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í objekt Compute, který se má načíst.
name
Vyžadováno
str

Název objektu Compute, 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ý uživatelem 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 na webu 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 jeho přidruženého pracovního prostoru.
deserialize

Převede objekt JSON na objekt AmlCompute.
detach

Pro objekt AmlCompute není podporováno odpojení. 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í výkon.
get_status

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

Získejte podrobnosti (například IP adresu, port atd.) všech výpočetních uzlů ve výpočetním cíli.
list_quotas

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

Získejte informace o aktuálním 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. To se primárně používá pro ruční dotazování výpočetního stavu.
remove_identity

Odeberte identitu z výpočetního prostředí.
serialize

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

Uveďte podporované velikosti virtuálních počítačů v oblasti.
update

ScaleSettings Aktualizujte pro tento cíl AmlCompute.
update_quotas

Aktualizace kvóty pro řadu virtuálních počítačů v pracovním prostoru
wait_for_completion

Počkejte na dokončení zřizování clusteru AmlCompute.

To se dá nakonfigurovat tak, aby čekalo na minimální počet uzlů a po uplynutí nastaveného časového období vypršel časový limit.

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//resourceGroups//providers/Microsoft.ManagedIdentity /userAssignedIdentities/']

Default value: None

Poznámky

identity_id by se měly zadat pouze při identity_type == UserAssigned

delete

Odeberte objekt AmlCompute z jeho 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 pouze připojen 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 přidružen objekt AmlCompute.
object_dict
Vyžadováno
dict

Objekt JSON, který se má převést na objekt AmlCompute.

Návraty

Typ Description
AmlCompute

Reprezentace AmlCompute poskytnutého objektu JSON.

Výjimky

Typ Description
ComputeTargetException

Poznámky

Vyvolá, ComputeTargetException pokud zadaný pracovní prostor není pracovním prostorem, ke který je přidružen compute.

detach

Pro objekt AmlCompute není podporováno odpojení. 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í výkon.

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. Informace o vytváření typů spuštění najdete v tématu add_type_provider .

Default value: None
tags
str nebo dict

Filtr se spouští podle značky nebo {"tag": "value"}

Default value: None
properties
str nebo dict

Filtr se spouští podle vlastnosti nebo {"vlastnosti": "value"}

Default value: None
status
str

Stav spuštění – buď Spuštěno, nebo Ve frontě

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 pro cluster

list_nodes

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

list_nodes()

Návraty

Typ Description
list

Podrobnosti o všech výpočetních uzlech ve výpočetním cíli.

list_quotas

Získejte aktuálně přiřazené kvóty pracovních prostorů 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, bude 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ích prostorů na základě VMFamily

list_usages

Získejte informace o aktuálním 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 se vyžaduje podrobné použití podřízených prostředků. Výchozí hodnota je Nepravda.

Default value: False
location
str

Umístění prostředků. Pokud není zadáno, bude výchozí umístění pracovního prostoru.

Default value: None

Návraty

Typ Description
list

Seznam aktuálních informací o využití a omezení pro prostředky AML

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í zadaný, ve výchozím nastavení Standard_NC6.
vm_priority
str

Priorita virtuálního počítače, vyhrazená nebo nízká.

Default value: dedicated
min_nodes
int

Minimální počet uzlů, které se mají použít v clusteru. Pokud není zadaný, má výchozí hodnotu 0.

Default value: 0
max_nodes
int

Maximální počet uzlů, které se mají v clusteru použít. Pokud není zadaný, má výchozí hodnotu 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í zadaný, použije se výchozí hodnota 1800.

Default value: 1800
admin_username
str

Název 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.

  • Nezadřené – označuje, že veřejný port SSH je zavřený na všech uzlech clusteru, pokud je definovaná virtuální síť, jinak je otevřená všechny veřejné uzly. Tato výchozí hodnota může být pouze během vytváření clusteru. Po vytvoření bude buď povolený, nebo zakázaný.

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//resourceGroups//providers/Microsoft.ManagedIdentity/userAssignedIdentities/']

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 má použít při vytváření objektu Compute.

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. To se primárně používá pro ruční dotazování výpočetního stavu.

refresh_state()

remove_identity

Odeberte identitu z výpočetního prostředí.

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 automaticky odebere, pokud není zadána identity_id.

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 podporované velikosti 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í zadaný, ve výchozím nastavení se použije 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čet uzlů, které se mají použít v clusteru.

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

Aktualizace kvóty 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

Název 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í zadaný, ve výchozím nastavení se použije umístění pracovního prostoru.

Default value: None

wait_for_completion

Počkejte na dokončení zřizování clusteru AmlCompute.

To se dá nakonfigurovat tak, aby čekalo na minimální počet uzlů a po uplynutí nastaveného časového období vypršel časový limit.

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, která poskytuje podrobnější výstup.

Default value: False
min_node_count
int

Minimální počet uzlů, na které se má čekat, než se zváží dokončení zřizování. 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ší než tento počet.

Default value: None
timeout_in_minutes
int

Doba čekání v minutách před zvážením zřízení 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