AmlCompute Klasa
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ęźleowego środowiska obliczeniowego. Obliczenia są tworzone w regionie obszaru roboczego jako zasób, który można udostępnić innym użytkownikom. Aby uzyskać więcej informacji, zobacz Co to są cele obliczeniowe w usłudze Azure Machine Learning?
Konstruktor Klasy ComputeTarget.
Pobierz reprezentację chmury obiektu obliczeniowego skojarzonego z podanym obszarem roboczym. Zwraca wystąpienie klasy podrzędnej odpowiadające określonemu typowi pobranego obiektu obliczeniowego.
- Dziedziczenie
-
AmlCompute
Konstruktor
AmlCompute(workspace, name)Parametry
Uwagi
W poniższym przykładzie tworzony jest 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 z witryny 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 serializacji JSON. |
| supported_vmsizes |
Wyświetl listę obsługiwanych rozmiarów maszyn wirtualnych w regionie. |
| update |
Zaktualizuj dla ScaleSettings 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ć pod kątem oczekiwania na minimalną liczbę węzłów i przekroczenie limitu czasu po określonym przedziale 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
- 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.
Lista identyfikatorów zasobów dla tożsamości przypisanej przez użytkownika. np. ['/subscriptions//resourceGroups//providers/Microsoft.ManagedIdentity /userAssignedIdentities/']
Uwagi
identity_id należy określić tylko wtedy, gdy identity_type == UserAssigned
delete
Usuń obiekt AmlCompute z skojarzonego obszaru roboczego.
delete()Wyjątki
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
Zwraca
Reprezentacja AmlCompute dostarczonego obiektu JSON.
Typ zwracany
Wyjątki
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
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
- type
- str
Filtruj zwrócony generator przebiegów według podanego typu. Zobacz add_type_provider tworzenie typów przebiegów.
Filtrowanie jest uruchamiane według "tag" lub {"tag": "value"}
Filtry są uruchamiane według właściwości lub {"property": "value"}
Zwraca
generator ~_restclient.models.RunDto
Typ zwracany
get_status
Pobierz bieżący szczegółowy stan klastra AmlCompute.
get_status()Zwraca
Szczegółowy obiekt stanu klastra
Typ zwracany
list_nodes
Pobierz szczegóły (np. adres IP, port itp.) wszystkich węzłów obliczeniowych w docelowym obiekcie obliczeniowym.
list_nodes()Zwraca
Szczegóły wszystkich węzłów obliczeniowych w docelowym obiekcie obliczeniowym.
Typ zwracany
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
- workspace
- Workspace
- location
- str
Lokalizacja przydziałów. Jeśli nie zostanie określony, wartość domyślna to lokalizacja obszaru roboczego.
Zwraca
Lista aktualnie przypisanych przydziałów obszarów roboczych na podstawie elementu VMFamily
Typ zwracany
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
- workspace
- Workspace
- show_all
Określa, czy wymagane są szczegółowe użycie zasobów podrzędnych. Wartości domyślne to False
- location
- str
Lokalizacja zasobów. Jeśli nie zostanie określony, wartość domyślna to lokalizacja obszaru roboczego.
Zwraca
Lista bieżących informacji o użyciu oraz limitów dla zasobów AML
Typ zwracany
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
- vm_size
- 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.
- min_nodes
- int
Minimalna liczba węzłów do użycia w klastrze. Jeśli nie zostanie określony, wartość domyślna to 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.
- 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.
- admin_username
- str
Nazwa konta użytkownika administratora, które może służyć do SSH w węzłach.
- vnet_resourcegroup_name
- str
Nazwa grupy zasobów, w której znajduje się sieć wirtualna.
Słownik tagów wartości klucza w celu udostępnienia obiektu obliczeniowego.
- 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.
- 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.
Lista identyfikatorów zasobów dla tożsamości przypisanej przez użytkownika. np. ['/subscriptions//resourceGroups//providers/Microsoft.ManagedIdentity/userAssignedIdentities/']
- 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.
False — wyłącz publiczny adres IP węzła.
NotSpecified — włącz publiczny adres IP węzła.
Zwraca
Obiekt konfiguracji, który ma być używany podczas tworzenia obiektu obliczeniowego.
Typ zwracany
Wyjątki
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
Uwagi
Tożsamość przypisana przez system zostanie usunięta automatycznie, jeśli nie określono identity_id
serialize
Przekonwertuj ten obiekt AmlCompute na słownik serializacji JSON.
serialize()Zwraca
Reprezentacja JSON tego obiektu AmlCompute.
Typ zwracany
supported_vmsizes
Wyświetl listę obsługiwanych rozmiarów maszyn wirtualnych w regionie.
static supported_vmsizes(workspace, location=None)Parametry
- workspace
- Workspace
- location
- str
Lokalizacja klastra. Jeśli nie zostanie określony, wartość domyślna to lokalizacja obszaru roboczego.
Zwraca
Lista obsługiwanych rozmiarów maszyn wirtualnych w regionie z nazwami maszyn wirtualnych, procesorów wirtualnych i pamięci RAM.
Typ zwracany
update
Zaktualizuj dla ScaleSettings tego obiektu docelowego AmlCompute.
update(min_nodes=None, max_nodes=None, idle_seconds_before_scaledown=None)Parametry
- idle_seconds_before_scaledown
- int
Czas bezczynności węzła w sekundach przed skalowaniem w dół klastra.
update_quotas
Aktualizowanie limitu przydziału dla rodziny maszyn wirtualnych w obszarze roboczym.
static update_quotas(workspace, vm_family, limit=None, location=None)Parametry
- workspace
- Workspace
- location
- str
Lokalizacja limitu przydziału. Jeśli nie zostanie określony, wartość domyślna to lokalizacja obszaru roboczego.
wait_for_completion
Poczekaj na zakończenie aprowizacji klastra AmlCompute.
Można to skonfigurować pod kątem oczekiwania na minimalną liczbę węzłów i przekroczenie limitu czasu po określonym przedziale czasu.
wait_for_completion(show_output=False, min_node_count=None, timeout_in_minutes=25, is_delete_operation=False)Parametry
- show_output
- bool
Wartość logiczna zapewniająca bardziej pełne dane wyjściowe.
- 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 aprowizacji zasobów obliczeniowych, jednak nie powinna być większa od tego.
- timeout_in_minutes
- int
Czas trwania w minutach oczekiwania przed rozważeniem niepowodzenia aprowizacji.
- is_delete_operation
- bool
Wskazuje, czy operacja jest przeznaczona do usuwania.
Wyjątki
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla