Image Klasa

Definiuje abstrakcyjną klasę nadrzędną dla obrazów usługi Azure Machine Learning.

Ta klasa jest PRZESTARZAŁA. Environment Zamiast tego użyj klasy .

Konstruktor obrazu.

Ta klasa jest PRZESTARZAŁA. Environment Zamiast tego użyj klasy .

Konstruktor obrazu służy do pobierania reprezentacji chmury obiektu Image skojarzonego z podanym obszarem roboczym. Zwróci wystąpienie klasy podrzędnej odpowiadające określonemu typowi pobranego obiektu obrazu.

Dziedziczenie

ABC

Image

Konstruktor

Image(workspace, name=None, id=None, tags=None, properties=None, version=None)

Parametry

Nazwa	Opis
workspace Wymagane	Workspace Obiekt Workspace zawierający obraz do pobrania.
name	str Nazwa obrazu do pobrania. Jeśli istnieje, zostanie zwrócona najnowsza wersja obrazu. Domyślna wartość: None
id	str Określony identyfikator obrazu do pobrania. (Identyfikator to "<name>:<version>") Domyślna wartość: None
tags	list Filtruje wyniki obrazów na podstawie podanej listy według wartości "key" lub "[key, value]". Np. ['key', ['key2', 'key2 value']] Domyślna wartość: None
properties	list Filtruje wyniki obrazów na podstawie podanej listy według wartości "key" lub "[key, value]". Np. ['key', ['key2', 'key2 value']] Domyślna wartość: None
version	str Po określeniu wersji i nazwy zostanie zwrócona określona wersja obrazu. Domyślna wartość: None
workspace Wymagane	Workspace Obiekt obszaru roboczego zawierający obraz do pobrania
name Wymagane	str Nazwa obrazu do pobrania. Zwróci najnowszą wersję, jeśli istnieje
id Wymagane	str Określony identyfikator obrazu do pobrania. (Identyfikator to ":")
tags Wymagane	list Filtruje wyniki obrazów na podstawie podanej listy według wartości "key" lub "[key, value]". Np. ['key', ['key2', 'key2 value']]
properties Wymagane	list Filtruje wyniki obrazów na podstawie podanej listy według wartości "key" lub "[key, value]". Np. ['key', ['key2', 'key2 value']]
version Wymagane	str Po określeniu wersji i nazwy zostanie zwrócona określona wersja obrazu.

Uwagi

Konstruktor obrazu pobiera reprezentację w chmurze obiektu Image skojarzonego z podanym obszarem roboczym. Zwraca wystąpienie klasy podrzędnej odpowiadające określonemu typowi pobranego obiektu Obrazu.

Obiekt Image służy do wdrażania użytkowników Model jako Webserviceobiektu . Obiekt Image zwykle zawiera model, skrypt wykonywania i wszelkie zależności wymagane do wdrożenia modelu. Klasa Image ma wiele podklas, takich jak ContainerImage for Docker Images, i Obrazy, takie jak FPGA.

Zobacz klasę ContainerImage , aby zapoznać się z przykładem klasy dziedziczonej z klasy Image.

Obrazy są zwykle używane w przepływach pracy, które wymagają użycia obrazu. W przypadku większości przepływów pracy należy zamiast tego użyć Environment klasy do zdefiniowania obrazu. Następnie możesz użyć obiektu Environment z Model deploy() metodą , aby wdrożyć model jako usługę internetową. Możesz również użyć metody Model package() , aby utworzyć obraz, który można pobrać do lokalnej instalacji platformy Docker jako obrazu lub jako pliku Dockerfile.

Zobacz następujący link, aby zapoznać się z omówieniem wdrażania modeli na platformie Azure: https://aka.ms/azureml-how-deploy.

Metody

add_properties	Dodaj właściwości do obrazu.
add_tags	Dodaj tagi do obrazu.
create	Utwórz obraz w podanym obszarze roboczym.
delete	Usuń obraz z odpowiedniego obszaru roboczego.
deserialize	Przekonwertuj obiekt JSON na obiekt Image.
image_configuration	Metoda abstrakcyjna do tworzenia obiektu konfiguracji obrazu.
list	Wyświetl listę obrazów skojarzonych z odpowiednim obszarem roboczym. Można filtrować przy użyciu określonych parametrów.
remove_tags	Usuń tagi z obrazu.
serialize	Przekonwertuj ten obiekt obrazu na słownik serializowany w formacie JSON.
update	Zaktualizuj obraz.
update_creation_state	Odśwież bieżący stan obiektu w pamięci. Przeprowadź aktualizację w miejscu właściwości obiektu na podstawie bieżącego stanu odpowiedniego obiektu w chmurze. Przede wszystkim przydatne w przypadku ręcznego sondowania stanu tworzenia.
wait_for_creation	Poczekaj na zakończenie tworzenia obrazu. Poczekaj na utworzenie obrazu, aby osiągnąć stan terminalu. Zgłosi wyjątek WebserviceException, jeśli osiągnie stan terminalu, który nie powiedzie się.

add_properties

Dodaj właściwości do obrazu.

add_properties(properties)

Parametry

Nazwa	Opis
properties Wymagane	dict[str, str] Słownik właściwości do dodania.

Wyjątki

Typ	Opis
WebserviceException

add_tags

Dodaj tagi do obrazu.

add_tags(tags)

Parametry

Nazwa	Opis
tags Wymagane	dict[str, str] Słownik tagów do dodania.

Wyjątki

Typ	Opis
WebserviceException

create

Utwórz obraz w podanym obszarze roboczym.

static create(workspace, name, models, image_config)

Parametry

Nazwa	Opis
workspace Wymagane	<xref:<xref:workspace: azureml.core.workspace.Workspace>> Obszar roboczy do skojarzenia z tym obrazem.
name Wymagane	str Nazwa do skojarzenia z tym obrazem.
models Wymagane	list[Model] Lista obiektów modelu do spakowania przy użyciu tego obrazu. Może być pustą listą.
image_config Wymagane	ImageConfig Obiekt konfiguracji obrazu używany do konfigurowania tego obrazu.

Zwraca

Typ	Opis
Image	Utworzony obiekt Image.

Wyjątki

Typ	Opis
WebserviceException

delete

Usuń obraz z odpowiedniego obszaru roboczego.

delete()

Wyjątki

Typ	Opis
WebserviceException

Uwagi

Ta metoda kończy się niepowodzeniem, jeśli obraz został wdrożony w aktywnej usłudze internetowej.

deserialize

Przekonwertuj obiekt JSON na obiekt Image.

deserialize(workspace, image_payload)

Parametry

Nazwa	Opis
cls Wymagane	Wskazuje metodę klasy.
workspace Wymagane	Workspace Obiekt obszaru roboczego, w ramach których zarejestrowano obraz.
image_payload Wymagane	dict Obiekt JSON do konwersji na obiekt Image.

Zwraca

Typ	Opis
Image	Reprezentacja obrazu dostarczonego obiektu JSON.

Wyjątki

Typ	Opis
WebserviceException

Uwagi

Ta metoda nie powiedzie się, jeśli podany obszar roboczy nie jest obszarem roboczym, w ramach których obraz jest zarejestrowany.

image_configuration

Metoda abstrakcyjna do tworzenia obiektu konfiguracji obrazu.

abstract static image_configuration()

Wyjątki

Typ	Opis
WebserviceException

list

Wyświetl listę obrazów skojarzonych z odpowiednim obszarem roboczym. Można filtrować przy użyciu określonych parametrów.

static list(workspace, image_name=None, model_name=None, model_id=None, tags=None, properties=None)

Parametry

Nazwa	Opis
workspace Wymagane	Workspace Obiekt Obszar roboczy do wyświetlenia listy obrazów.
image_name	str Filtruj listę, aby uwzględnić tylko obrazy wdrożone z określoną nazwą obrazu. Domyślna wartość: None
model_name	str Lista filtrów do uwzględnienia tylko obrazów wdrożonych z określoną nazwą modelu. Domyślna wartość: None
model_id	str Lista filtrów umożliwia uwzględnianie tylko obrazów wdrożonych przy użyciu określonego identyfikatora modelu. Domyślna wartość: None
tags	list Filtruje na podstawie podanej listy według wartości "klucz" lub "[klucz, wartość]". Np. ['key', ['key2', 'key2 value']] Domyślna wartość: None
properties	list Filtruje na podstawie podanej listy według wartości "klucz" lub "[klucz, wartość]". Np. ['key', ['key2', 'key2 value']] Domyślna wartość: None

Zwraca

Typ	Opis
list[<xref:Images>]	Filtrowana lista obrazów w podanym obszarze roboczym.

Wyjątki

Typ	Opis
WebserviceException

remove_tags

Usuń tagi z obrazu.

remove_tags(tags)

Parametry

Nazwa	Opis
tags Wymagane	list[str] Lista kluczy odpowiadających tagom do usunięcia.

Wyjątki

Typ	Opis
WebserviceException

serialize

Przekonwertuj ten obiekt obrazu na słownik serializowany w formacie JSON.

serialize()

Zwraca

Typ	Opis
dict	Reprezentacja JSON tego obiektu Image.

Wyjątki

Typ	Opis
WebserviceException

update

Zaktualizuj obraz.

update(tags)

Parametry

Nazwa	Opis
tags Wymagane	dict[str, str] Słownik tagów do aktualizowania obrazu za pomocą polecenia . Zastąpi wszystkie istniejące tagi.

Wyjątki

Typ	Opis
WebserviceException

update_creation_state

Odśwież bieżący stan obiektu w pamięci.

Przeprowadź aktualizację w miejscu właściwości obiektu na podstawie bieżącego stanu odpowiedniego obiektu w chmurze. Przede wszystkim przydatne w przypadku ręcznego sondowania stanu tworzenia.

update_creation_state()

Wyjątki

Typ	Opis
WebserviceException

wait_for_creation

Poczekaj na zakończenie tworzenia obrazu.

Poczekaj na utworzenie obrazu, aby osiągnąć stan terminalu. Zgłosi wyjątek WebserviceException, jeśli osiągnie stan terminalu, który nie powiedzie się.

wait_for_creation(show_output=False)

Parametry

Nazwa	Opis
show_output	bool Opcja logiczna umożliwiająca drukowanie większej liczby pełnych danych wyjściowych. Wartość domyślna to False. Domyślna wartość: False

Wyjątki

Typ	Opis
WebserviceException