ComputeTarget Klasa

Odwołanie

Abstrakcyjna klasa nadrzędna dla wszystkich docelowych obiektów obliczeniowych zarządzanych przez usługę Azure Machine Learning.

Docelowy obiekt obliczeniowy to wyznaczony zasób obliczeniowy/środowisko, w którym uruchamiasz skrypt trenowania lub hostujesz wdrożenie usługi. Ta lokalizacja może być komputerem lokalnym lub zasobem obliczeniowym opartym na chmurze. 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: ABC

ComputeTarget

Konstruktor

ComputeTarget(workspace, name)

Parametry

Nazwa	Opis
workspace Wymagane	Workspace Obiekt obszaru roboczego zawierający obiekt Compute do pobrania.
name Wymagane	str Nazwa obiektu Compute do pobrania.
workspace Wymagane	Workspace Obiekt obszaru roboczego zawierający obiekt Compute do pobrania.
name Wymagane	str Nazwa obiektu Compute do pobrania.

Uwagi

Użyj konstruktora ComputeTarget, aby pobrać reprezentację w chmurze obiektu obliczeniowego skojarzonego z podanym obszarem roboczym. Konstruktor zwraca wystąpienie klasy podrzędnej odpowiadające określonemu typowi pobranego obiektu Compute. Jeśli obiekt Compute nie zostanie znaleziony, ComputeTargetException zostanie zgłoszony obiekt .

Metody

attach	Dołącz obiekt Compute do obszaru roboczego przy użyciu określonej nazwy i informacji o konfiguracji.
create	Aprowizowanie obiektu obliczeniowego przez określenie typu obliczeniowego i powiązanej konfiguracji. Ta metoda tworzy nowy docelowy obiekt obliczeniowy zamiast dołączania istniejącego.
delete	Usuń obiekt Compute ze skojarzonego obszaru roboczego. Ta metoda abstrakcyjna jest implementowana przez klasy podrzędne klasy ComputeTarget.
deserialize	Przekonwertuj obiekt JSON na obiekt Compute.
detach	Odłącz obiekt Compute od skojarzonego obszaru roboczego. Ta metoda abstrakcyjna jest implementowana przez klasy podrzędne klasy ComputeTarget. Bazowe obiekty w chmurze nie są usuwane, a ich skojarzenia są usuwane.
get_status	Pobierz bieżący stan aprowizacji obiektu Compute.
list	Wyświetl listę wszystkich obiektów ComputeTarget w obszarze roboczym. Zwraca listę wystąpień obiektów podrzędnych odpowiadających określonemu typowi obliczeń. Obiekty są elementami podrzędnymi ComputeTarget.
refresh_state	Wykonaj aktualizację w miejscu właściwości obiektu. Aktualizuj właściwości na podstawie bieżącego stanu odpowiedniego obiektu w chmurze. Jest to przydatne w przypadku ręcznego sondowania stanu obliczeniowego. Ta metoda abstrakcyjna jest implementowana przez klasy podrzędne klasy ComputeTarget.
serialize	Przekonwertuj ten obiekt Compute na słownik serializowany JSON.
wait_for_completion	Poczekaj na zakończenie bieżącej operacji aprowizacji w klastrze. Ta metoda zwraca ComputeTargetException wartość , jeśli wystąpił problem podczas sondowania obiektu obliczeniowego.

attach

Dołącz obiekt Compute do obszaru roboczego przy użyciu określonej nazwy i informacji o konfiguracji.

static attach(workspace, name, attach_configuration)

Parametry

Nazwa	Opis
workspace Wymagane	Workspace Obiekt obszaru roboczego, do który ma zostać dołączony obiekt Compute.
name Wymagane	str Nazwa do skojarzenia z obiektem Compute.
attach_configuration Wymagane	ComputeTargetAttachConfiguration Obiekt ComputeTargetAttachConfiguration używany do określania typu obiektu Obliczeniowego do dołączenia i sposobu jego konfigurowania.

Zwraca

Typ	Opis
ComputeTarget	Wystąpienie podrzędne obiektu ComputeTarget odpowiadające typowi dołączonego obiektu.

Wyjątki

Typ	Opis
ComputeTargetException

Uwagi

Typ obiektu do przekazania do parametru attach_configuration jest obiektem utworzonym ComputeTargetAttachConfiguration przy użyciu attach_configuration funkcji w dowolnej z klas podrzędnych klasy ComputeTarget.

W poniższym przykładzie pokazano, jak dołączyć konto usługi ADLA do obszaru roboczego przy użyciu attach_configuration metody AdlaCompute.


   adla_compute_name = 'testadl' # Name to associate with new compute in workspace

   # ADLA account details needed to attach as compute to workspace
   adla_account_name = "<adla_account_name>" # Name of the Azure Data Lake Analytics account
   adla_resource_group = "<adla_resource_group>" # Name of the resource group which contains this account

   try:
       # check if already attached
       adla_compute = AdlaCompute(ws, adla_compute_name)
   except ComputeTargetException:
       print('attaching adla compute...')
       attach_config = AdlaCompute.attach_configuration(resource_group=adla_resource_group, account_name=adla_account_name)
       adla_compute = ComputeTarget.attach(ws, adla_compute_name, attach_config)
       adla_compute.wait_for_completion()

   print("Using ADLA compute:{}".format(adla_compute.cluster_resource_id))
   print("Provisioning state:{}".format(adla_compute.provisioning_state))
   print("Provisioning errors:{}".format(adla_compute.provisioning_errors))

Pełna próbka jest dostępna w witrynie https://github.com/Azure/MachineLearningNotebooks/blob/master/how-to-use-azureml/machine-learning-pipelines/intro-to-pipelines/aml-pipelines-use-adla-as-compute-target.ipynb

create

Aprowizowanie obiektu obliczeniowego przez określenie typu obliczeniowego i powiązanej konfiguracji.

Ta metoda tworzy nowy docelowy obiekt obliczeniowy zamiast dołączania istniejącego.

static create(workspace, name, provisioning_configuration)

Parametry

Nazwa	Opis
workspace Wymagane	Workspace Obiekt obszaru roboczego do utworzenia obiektu Compute w obszarze.
name Wymagane	str Nazwa do skojarzenia z obiektem Compute.
provisioning_configuration Wymagane	ComputeTargetProvisioningConfiguration Obiekt ComputeTargetProvisioningConfiguration używany do określania typu obiektu obliczeniowego do aprowizacji i sposobu jego konfigurowania.

Zwraca

Typ	Opis
ComputeTarget	Wystąpienie podrzędne obiektu ComputeTarget odpowiadające typowi aprowizowanego obiektu.

Wyjątki

Typ	Opis
ComputeTargetException

Uwagi

Typ aprowizowanego obiektu jest określany przez podaną konfigurację aprowizacji.

W poniższym przykładzie jest tworzony trwały docelowy obiekt obliczeniowy aprowizowany przez AmlCompute program . Parametr provisioning_configuration w tym przykładzie ma typ AmlComputeProvisioningConfiguration.


   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

delete

Usuń obiekt Compute ze skojarzonego obszaru roboczego.

Ta metoda abstrakcyjna jest implementowana przez klasy podrzędne klasy ComputeTarget.

abstract delete()

Wyjątki

Typ	Opis
ComputeTargetException

Uwagi

Jeśli ten obiekt został utworzony za pomocą usługi Azure Machine Learning, odpowiednie obiekty oparte na chmurze również zostaną usunięte. Jeśli ten obiekt został utworzony zewnętrznie i dołączony tylko do obszaru roboczego, ta metoda zgłasza wyjątek i nic się nie zmienia.

deserialize

Przekonwertuj obiekt JSON na obiekt Compute.

abstract static deserialize(workspace, object_dict)

Parametry

Nazwa	Opis
workspace Wymagane	Workspace Obiekt obszaru roboczego, z który jest skojarzony obiekt Compute.
object_dict Wymagane	dict Obiekt JSON do konwersji na obiekt Compute.

Zwraca

Typ	Opis
ComputeTarget	Reprezentacja obliczeniowa 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łącz obiekt Compute od skojarzonego obszaru roboczego.

Ta metoda abstrakcyjna jest implementowana przez klasy podrzędne klasy ComputeTarget. Bazowe obiekty w chmurze nie są usuwane, a ich skojarzenia są usuwane.

abstract detach()

Wyjątki

Typ	Opis
ComputeTargetException

get_status

Pobierz bieżący stan aprowizacji obiektu Compute.

get_status()

Zwraca

Typ	Opis
str	Bieżąca klasa `provisioning_state`.

Wyjątki

Typ	Opis
ComputeTargetException

Uwagi

Zwrócone wartości są wymienione w dokumentacji interfejsu API REST platformy Azure dla parametru ProvisioningState.

list

Wyświetl listę wszystkich obiektów ComputeTarget w obszarze roboczym.

Zwraca listę wystąpień obiektów podrzędnych odpowiadających określonemu typowi obliczeń. Obiekty są elementami podrzędnymi ComputeTarget.

static list(workspace)

Parametry

Nazwa	Opis
workspace Wymagane	Workspace Obiekt obszaru roboczego zawierający obiekty do wyświetlenia.

Zwraca

Typ	Opis
list[ComputeTarget]	Lista obiektów docelowych obliczeniowych w obszarze roboczym.

Wyjątki

Typ	Opis
ComputeTargetException

refresh_state

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

Aktualizuj właściwości na podstawie bieżącego stanu odpowiedniego obiektu w chmurze. Jest to przydatne w przypadku ręcznego sondowania stanu obliczeniowego.

Ta metoda abstrakcyjna jest implementowana przez klasy podrzędne klasy ComputeTarget.

abstract refresh_state()

Wyjątki

Typ	Opis
ComputeTargetException

serialize

Przekonwertuj ten obiekt Compute na słownik serializowany JSON.

abstract serialize()

Zwraca

Typ	Opis
dict	Reprezentacja JSON tego obiektu Compute.

Wyjątki

Typ	Opis
ComputeTargetException

wait_for_completion

Poczekaj na zakończenie bieżącej operacji aprowizacji w klastrze.

Ta metoda zwraca ComputeTargetException wartość , jeśli wystąpił problem podczas sondowania obiektu obliczeniowego.

wait_for_completion(show_output=False, is_delete_operation=False)

Parametry

Nazwa	Opis
show_output	bool Wskazuje, czy należy podać więcej pełnych danych wyjściowych. wartość domyślna: False
is_delete_operation	bool Wskazuje, czy operacja jest przeznaczona do usunięcia. wartość domyślna: False

Wyjątki

Typ	Opis
ComputeTargetException

ComputeTarget Klasa

Konstruktor

Parametry

Uwagi

Metody

attach

Parametry

Zwraca

Wyjątki

Uwagi

create

Parametry

Zwraca

Wyjątki

Uwagi

delete

Wyjątki

Uwagi

deserialize

Parametry

Zwraca

Wyjątki

Uwagi

detach

Wyjątki

get_status

Zwraca

Wyjątki

Uwagi

list

Parametry

Zwraca

Wyjątki

refresh_state

Wyjątki

serialize

Zwraca

Wyjątki

wait_for_completion

Parametry

Wyjątki

Opinia

Opinia

Dodatkowe zasoby