AmlCompute Třída

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

workspace

Workspace

Vyžadováno

Objekt pracovního prostoru obsahující objekt AmlCompute, který se má načíst.

name

str

Vyžadováno

Název objektu AmlCompute, který se má načíst.

workspace

Workspace

Vyžadováno

Objekt pracovního prostoru obsahující objekt Compute, který se má načíst.

name

str

Vyžadováno

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

identity_type

string

Vyžadováno

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]

výchozí hodnota: None

Seznam ID prostředků pro identitu přiřazenou uživatelem např. ['/subscriptions//resourceGroups//providers/Microsoft.ManagedIdentity /userAssignedIdentities/']

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

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

workspace

Workspace

Vyžadováno

Objekt pracovního prostoru, ke které je přidružen objekt AmlCompute.

object_dict

dict

Vyžadováno

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

Návraty

Reprezentace AmlCompute poskytnutého objektu JSON.

Návratový typ

AmlCompute

Výjimky

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

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

type

str

výchozí hodnota: None

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 .

tags

str nebo dict

výchozí hodnota: None

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

properties

str nebo dict

výchozí hodnota: None

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

status

str

výchozí hodnota: None

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

Návraty

generátor ~_restclient.models.RunDto

Návratový typ

<xref:builtin.generator>

get_status

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

get_status()

Návraty

Podrobný stavový objekt pro cluster

Návratový typ

AmlComputeStatus

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

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

Návratový typ

list

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

workspace

Workspace

Vyžadováno

location

str

výchozí hodnota: None

Umístění kvót. Pokud není zadáno, bude výchozí umístění pracovního prostoru.

Návraty

Seznam aktuálně přiřazených kvót pracovních prostorů na základě VMFamily

Návratový typ

list

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

workspace

Workspace

Vyžadováno

show_all

výchozí hodnota: False

Určuje, jestli se vyžaduje podrobné použití podřízených prostředků. Výchozí hodnota je Nepravda.

location

str

výchozí hodnota: None

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

Návraty

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

Návratový typ

list

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

vm_size

str

Vyžadováno

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

výchozí hodnota: dedicated

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

min_nodes

int

výchozí hodnota: 0

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

max_nodes

int

výchozí hodnota: None

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

idle_seconds_before_scaledown

int

výchozí hodnota: 1800

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.

admin_username

str

výchozí hodnota: None

Název uživatelského účtu správce, který lze použít k připojení SSH do uzlů.

admin_user_password

str

výchozí hodnota: None

Heslo uživatelského účtu správce.

admin_user_ssh_key

str

výchozí hodnota: None

Veřejný klíč SSH uživatelského účtu správce.

vnet_resourcegroup_name

str

výchozí hodnota: None

Název skupiny prostředků, ve které se nachází virtuální síť.

vnet_name

str

výchozí hodnota: None

Název virtuální sítě.

subnet_name

str

výchozí hodnota: None

Název podsítě uvnitř virtuální sítě.

tags

dict[str, str]

výchozí hodnota: None

Slovník značek klíčových hodnot, které se mají poskytnout výpočetnímu objektu.

description

str

výchozí hodnota: None

Popis, který se má poskytnout výpočetnímu objektu.

remote_login_port_public_access

str

výchozí hodnota: NotSpecified

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ý.

identity_type

string

výchozí hodnota: None

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]

výchozí hodnota: None

Seznam ID prostředků pro identitu přiřazenou uživatelem např. ['/subscriptions//resourceGroups//providers/Microsoft.ManagedIdentity/userAssignedIdentities/']

location

str

výchozí hodnota: None

Umístění pro zřízení clusteru

enable_node_public_ip

bool

výchozí hodnota: True

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.

Návraty

Objekt konfigurace, který se má použít při vytváření objektu Compute.

Návratový typ

AmlComputeProvisioningConfiguration

Výjimky

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

identity_id

list[str]

výchozí hodnota: None

Identity přiřazené uživatelem

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

Reprezentace JSON tohoto objektu AmlCompute.

Návratový typ

dict

supported_vmsizes

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

static supported_vmsizes(workspace, location=None)

Parametry

workspace

Workspace

Vyžadováno

location

str

výchozí hodnota: None

Umístění clusteru Pokud není zadaný, ve výchozím nastavení se použije umístění pracovního prostoru.

Návraty

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.

Návratový typ

list

update

ScaleSettings Aktualizujte pro tento cíl AmlCompute.

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

Parametry

min_nodes

int

výchozí hodnota: None

Minimální počet uzlů, které se mají použít v clusteru.

max_nodes

int

výchozí hodnota: None

Maximální počet uzlů, které se mají použít v clusteru.

idle_seconds_before_scaledown

int

výchozí hodnota: None

Doba nečinnosti uzlu v sekundách před vertikálním snížením kapacity clusteru.

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

workspace

Workspace

Vyžadováno

vm_family

str

Vyžadováno

Název rodiny virtuálních počítačů

limit

int

výchozí hodnota: None

Maximální povolená kvóta prostředku

location

str

výchozí hodnota: None

Umístění kvóty Pokud není zadaný, ve výchozím nastavení se použije umístění pracovního 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.

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

Parametry

show_output

bool

výchozí hodnota: False

Logická hodnota, která poskytuje podrobnější výstup.

min_node_count

int

výchozí hodnota: None

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.

timeout_in_minutes

int

výchozí hodnota: 25

Doba čekání v minutách před zvážením zřízení se nezdařila.

is_delete_operation

bool

výchozí hodnota: False

Určuje, jestli je operace určená k odstranění.

Výjimky

ComputeTargetException