Udostępnij za pośrednictwem

AmlCompute Klasa

  • Odwołanie

Zarządza obliczeniami usługi Azure Machine Learning w usłudze Azure Machine Learning.

Usługa Azure Machine Learning Compute (AmlCompute) to zarządzana infrastruktura obliczeniowa, która umożliwia łatwe tworzenie pojedynczego lub wielowęźle obliczeniowego. Zasoby obliczeniowe są tworzone w regionie obszaru roboczego jako zasób, który może być udostępniany innym użytkownikom. Aby uzyskać więcej informacji, zobacz Co to są docelowe obiekty obliczeniowe w usłudze Azure Machine Learning?

Klasa ComputeTarget, konstruktor.

Pobieranie reprezentacji chmury obiektu obliczeniowego skojarzonego z podanym obszarem roboczym. Zwraca wystąpienie klasy podrzędnej odpowiadające określonemu typowi pobranego obiektu obliczeniowego.

Dziedziczenie
ComputeTarget
AmlCompute

Konstruktor

AmlCompute(workspace, name)

Parametry

Nazwa Opis
workspace
Wymagane
Workspace

Obiekt obszaru roboczego zawierający obiekt AmlCompute do pobrania.
name
Wymagane
str

Nazwa obiektu AmlCompute do pobrania.
workspace
Wymagane
Workspace

Obiekt obszaru roboczego zawierający obiekt Compute do pobrania.
name
Wymagane
str

Nazwa obiektu Compute do pobrania.

Uwagi

W poniższym przykładzie jest tworzony trwały docelowy obiekt obliczeniowy aprowizowany przez AmlCompute program . Parametr provisioning_configuration w tym przykładzie jest typu AmlComputeProvisioningConfiguration, który jest klasą podrzędną klasy 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)

Pełna próbka jest dostępna w witrynie https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/training/train-on-amlcompute/train-on-amlcompute.ipynb

Metody

add_identity

Dodaj identyfikatory tożsamości i/lub typu tożsamości dla tego obiektu docelowego AmlCompute.
delete

Usuń obiekt AmlCompute z skojarzonego obszaru roboczego.
deserialize

Przekonwertuj obiekt JSON na obiekt AmlCompute.
detach

Odłączanie nie jest obsługiwane dla obiektu AmlCompute. Zamiast tego użyj polecenia cmdlet delete.
get

Zwracanie obiektu obliczeniowego.
get_active_runs

Zwróć generator przebiegów dla tego obliczenia.
get_status

Pobierz bieżący szczegółowy stan klastra AmlCompute.
list_nodes

Pobierz szczegóły (np. adres IP, port itp.) wszystkich węzłów obliczeniowych w docelowym obiekcie obliczeniowym.
list_quotas

Pobierz obecnie przypisane limity przydziału obszaru roboczego na podstawie maszyny wirtualnejFamily dla danego obszaru roboczego i subskrypcji.
list_usages

Pobierz bieżące informacje o użyciu, a także limity zasobów AML dla danego obszaru roboczego i subskrypcji.
provisioning_configuration

Utwórz obiekt konfiguracji na potrzeby aprowizacji obiektu docelowego AmlCompute.
refresh_state

Wykonaj aktualizację w miejscu właściwości obiektu.

Ta metoda aktualizuje właściwości na podstawie bieżącego stanu odpowiedniego obiektu w chmurze. Jest to używane głównie do ręcznego sondowania stanu obliczeniowego.
remove_identity

Usuń tożsamość w obliczeniach.
serialize

Przekonwertuj ten obiekt AmlCompute na słownik serializowany JSON.
supported_vmsizes

Wyświetl listę obsługiwanych rozmiarów maszyn wirtualnych w regionie.
update

Zaktualizuj element ScaleSettings dla tego obiektu docelowego AmlCompute.
update_quotas

Aktualizowanie limitu przydziału dla rodziny maszyn wirtualnych w obszarze roboczym.
wait_for_completion

Poczekaj na zakończenie aprowizacji klastra AmlCompute.

Można to skonfigurować do oczekiwania na minimalną liczbę węzłów i limit czasu po upływie określonego czasu.

add_identity

Dodaj identyfikatory tożsamości i/lub typu tożsamości dla tego obiektu docelowego AmlCompute.

add_identity(identity_type, identity_id=None)

Parametry

Nazwa Opis
identity_type
Wymagane
string

Możliwe wartości:

  • SystemAssigned — tożsamość przypisana przez system

  • UserAssigned — tożsamość przypisana przez użytkownika. Wymaga ustawienia identyfikatora tożsamości.
identity_id
list[str]

Lista identyfikatorów zasobów dla tożsamości przypisanej przez użytkownika. np. ['/subscriptions//resourceGroups//providers/Microsoft.ManagedIdentity /userAssignedIdentities/']

Domyślna wartość: None

Uwagi

identity_id należy określić tylko wtedy, gdy identity_type == UserAssigned

delete

Usuń obiekt AmlCompute z skojarzonego obszaru roboczego.

delete()

Wyjątki

Typ Opis
ComputeTargetException

Uwagi

Jeśli ten obiekt został utworzony za pośrednictwem usługi Azure Machine Learning, odpowiednie obiekty oparte na chmurze zostaną również usunięte. Jeśli ten obiekt został utworzony zewnętrznie i dołączony tylko do obszaru roboczego, ta metoda zgłasza ComputeTargetException wartość i nic nie zostanie zmienione.

deserialize

Przekonwertuj obiekt JSON na obiekt AmlCompute.

static deserialize(workspace, object_dict)

Parametry

Nazwa Opis
workspace
Wymagane
Workspace

Obiekt obszaru roboczego, z który jest skojarzony obiekt AmlCompute.
object_dict
Wymagane
dict

Obiekt JSON do konwersji na obiekt AmlCompute.

Zwraca

Typ Opis
AmlCompute

Reprezentacja AmlCompute dostarczonego obiektu JSON.

Wyjątki

Typ Opis
ComputeTargetException

Uwagi

Zgłasza wartość , ComputeTargetException jeśli podany obszar roboczy nie jest obszarem roboczym skojarzonym z usługą Compute.

detach

Odłączanie nie jest obsługiwane dla obiektu AmlCompute. Zamiast tego użyj polecenia cmdlet delete.

detach()

Wyjątki

Typ Opis
ComputeTargetException

get

Zwracanie obiektu obliczeniowego.

get()

get_active_runs

Zwróć generator przebiegów dla tego obliczenia.

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

Parametry

Nazwa Opis
type
str

Filtruj zwrócony generator przebiegów według podanego typu. Zobacz add_type_provider tworzenie typów przebiegów.

Domyślna wartość: None
tags
str lub dict

Filtrowanie jest uruchamiane według "tag" lub {"tag": "value"}

Domyślna wartość: None
properties
str lub dict

Filtry są uruchamiane według właściwości lub {"property": "value"}

Domyślna wartość: None
status
str

Stan uruchomienia — "Uruchomiono" lub "W kolejce"

Domyślna wartość: None

Zwraca

Typ Opis
<xref:builtin.generator>

generator ~_restclient.models.RunDto

get_status

Pobierz bieżący szczegółowy stan klastra AmlCompute.

get_status()

Zwraca

Typ Opis
AmlComputeStatus

Szczegółowy obiekt stanu klastra

list_nodes

Pobierz szczegóły (np. adres IP, port itp.) wszystkich węzłów obliczeniowych w docelowym obiekcie obliczeniowym.

list_nodes()

Zwraca

Typ Opis
list

Szczegóły wszystkich węzłów obliczeniowych w docelowym obiekcie obliczeniowym.

list_quotas

Pobierz obecnie przypisane limity przydziału obszaru roboczego na podstawie maszyny wirtualnejFamily dla danego obszaru roboczego i subskrypcji.

static list_quotas(workspace, location=None)

Parametry

Nazwa Opis
workspace
Wymagane
Workspace
location
str

Lokalizacja przydziałów. Jeśli nie zostanie określony, wartość domyślna to lokalizacja obszaru roboczego.

Domyślna wartość: None

Zwraca

Typ Opis
list

Lista aktualnie przypisanych przydziałów obszarów roboczych na podstawie elementu VMFamily

list_usages

Pobierz bieżące informacje o użyciu, a także limity zasobów AML dla danego obszaru roboczego i subskrypcji.

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

Parametry

Nazwa Opis
workspace
Wymagane
Workspace
show_all

Określa, czy wymagane są szczegółowe użycie zasobów podrzędnych. Wartości domyślne to False

Domyślna wartość: False
location
str

Lokalizacja zasobów. Jeśli nie zostanie określony, wartość domyślna to lokalizacja obszaru roboczego.

Domyślna wartość: None

Zwraca

Typ Opis
list

Lista bieżących informacji o użyciu oraz limitów dla zasobów AML

provisioning_configuration

Utwórz obiekt konfiguracji na potrzeby aprowizacji obiektu docelowego 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

Nazwa Opis
vm_size
Wymagane
str

Rozmiar maszyn wirtualnych agenta. Więcej szczegółów można znaleźć tutaj: https://aka.ms/azureml-vm-details. Należy pamiętać, że nie wszystkie rozmiary są dostępne we wszystkich regionach, zgodnie z opisem w poprzednim linku. Jeśli nie zostanie określony, wartości domyślne to Standard_NC6.
vm_priority
str

Priorytet maszyny wirtualnej, dedykowany lub niski.

Domyślna wartość: dedicated
min_nodes
int

Minimalna liczba węzłów do użycia w klastrze. Jeśli nie zostanie określony, wartość domyślna to 0.

Domyślna wartość: 0
max_nodes
int

Maksymalna liczba węzłów do użycia w klastrze. Jeśli nie zostanie określony, wartość domyślna to 4.

Domyślna wartość: None
idle_seconds_before_scaledown
int

Czas bezczynności węzła w sekundach przed skalowaniem w dół klastra. Jeśli nie zostanie określony, wartość domyślna to 1800.

Domyślna wartość: 1800
admin_username
str

Nazwa konta użytkownika administratora, które może służyć do SSH w węzłach.

Domyślna wartość: None
admin_user_password
str

Hasło konta użytkownika administratora.

Domyślna wartość: None
admin_user_ssh_key
str

Klucz publiczny SSH konta użytkownika administratora.

Domyślna wartość: None
vnet_resourcegroup_name
str

Nazwa grupy zasobów, w której znajduje się sieć wirtualna.

Domyślna wartość: None
vnet_name
str

Nazwa sieci wirtualnej.

Domyślna wartość: None
subnet_name
str

Nazwa podsieci wewnątrz sieci wirtualnej.

Domyślna wartość: None
tags
dict[str, str]

Słownik tagów wartości klucza w celu udostępnienia obiektu obliczeniowego.

Domyślna wartość: None
description
str

Opis umożliwiający podanie obiektu obliczeniowego.

Domyślna wartość: None
remote_login_port_public_access
str

Stan publicznego portu SSH. Możliwe wartości:

  • Wyłączone — wskazuje, że publiczny port SSH jest zamknięty we wszystkich węzłach klastra.

  • Włączone — wskazuje, że publiczny port SSH jest otwarty we wszystkich węzłach klastra.

  • NotSpecified — wskazuje, że publiczny port SSH jest zamknięty we wszystkich węzłach klastra, jeśli sieć wirtualna jest zdefiniowana, inne jest otwarte wszystkie węzły publiczne. Może to być ta wartość domyślna tylko w czasie tworzenia klastra. Po utworzeniu zostanie ona włączona lub wyłączona.

Domyślna wartość: NotSpecified
identity_type
string

Możliwe wartości:

  • SystemAssigned — tożsamość przypisana przez system

  • UserAssigned — tożsamość przypisana przez użytkownika. Wymaga ustawienia identyfikatora tożsamości.

Domyślna wartość: None
identity_id
list[str]

Lista identyfikatorów zasobów dla tożsamości przypisanej przez użytkownika. np. ['/subscriptions//resourceGroups//providers/Microsoft.ManagedIdentity/userAssignedIdentities/']

Domyślna wartość: None
location
str

Lokalizacja do aprowizowania klastra w programie.

Domyślna wartość: None
enable_node_public_ip
bool

Włącz publiczny adres IP węzła. Możliwe wartości:

  • True — włącz publiczny adres IP węzła.

  • Fałsz — wyłącz publiczny adres IP węzła.

  • NotSpecified — włącz publiczny adres IP węzła.

Domyślna wartość: True

Zwraca

Typ Opis
AmlComputeProvisioningConfiguration

Obiekt konfiguracji, który ma być używany podczas tworzenia obiektu obliczeniowego.

Wyjątki

Typ Opis
ComputeTargetException

refresh_state

Wykonaj aktualizację w miejscu właściwości obiektu.

Ta metoda aktualizuje właściwości na podstawie bieżącego stanu odpowiedniego obiektu w chmurze. Jest to używane głównie do ręcznego sondowania stanu obliczeniowego.

refresh_state()

remove_identity

Usuń tożsamość w obliczeniach.

remove_identity(identity_id=None)

Parametry

Nazwa Opis
identity_id
list[str]

Tożsamości przypisane przez użytkownika

Domyślna wartość: None

Uwagi

Tożsamość przypisana przez system zostanie usunięta automatycznie, jeśli identity_id nie zostanie określona

serialize

Przekonwertuj ten obiekt AmlCompute na słownik serializowany JSON.

serialize()

Zwraca

Typ Opis
dict

Reprezentacja JSON tego obiektu AmlCompute.

supported_vmsizes

Wyświetl listę obsługiwanych rozmiarów maszyn wirtualnych w regionie.

static supported_vmsizes(workspace, location=None)

Parametry

Nazwa Opis
workspace
Wymagane
Workspace
location
str

Lokalizacja klastra. Jeśli nie zostanie określony, wartość domyślna to lokalizacja obszaru roboczego.

Domyślna wartość: None

Zwraca

Typ Opis
list

Lista obsługiwanych rozmiarów maszyn wirtualnych w regionie z nazwami maszyn wirtualnych, procesorów wirtualnych i pamięci RAM.

update

Zaktualizuj element ScaleSettings dla tego obiektu docelowego AmlCompute.

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

Parametry

Nazwa Opis
min_nodes
int

Minimalna liczba węzłów do użycia w klastrze.

Domyślna wartość: None
max_nodes
int

Maksymalna liczba węzłów do użycia w klastrze.

Domyślna wartość: None
idle_seconds_before_scaledown
int

Czas bezczynności węzła w sekundach przed skalowaniem klastra w dół.

Domyślna wartość: None

update_quotas

Aktualizowanie limitu przydziału dla rodziny maszyn wirtualnych w obszarze roboczym.

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

Parametry

Nazwa Opis
workspace
Wymagane
Workspace
vm_family
Wymagane
str

Nazwa rodziny maszyn wirtualnych
limit
int

Maksymalny dozwolony limit przydziału zasobu

Domyślna wartość: None
location
str

Lokalizacja limitu przydziału. Jeśli nie zostanie określony, wartość domyślna to lokalizacja obszaru roboczego.

Domyślna wartość: None

wait_for_completion

Poczekaj na zakończenie aprowizacji klastra AmlCompute.

Można to skonfigurować do oczekiwania na minimalną liczbę węzłów i limit czasu po upływie określonego czasu.

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

Parametry

Nazwa Opis
show_output
bool

Wartość logiczna zapewniająca bardziej pełne dane wyjściowe.

Domyślna wartość: False
min_node_count
int

Minimalna liczba węzłów do oczekiwania przed rozważeniem ukończenia aprowizacji. Nie musi to być równa minimalnej liczbie węzłów, za pomocą których zainicjowano aprowizację obliczeniową, ale nie powinna być większa.

Domyślna wartość: None
timeout_in_minutes
int

Czas trwania w minutach oczekiwania przed rozważeniem niepowodzenia aprowizacji.

Domyślna wartość: 25
is_delete_operation
bool

Wskazuje, czy operacja jest przeznaczona do usunięcia.

Domyślna wartość: False

Wyjątki

Typ Opis
ComputeTargetException