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

Dziedziczenie
Image

Konstruktor

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

Parametry

workspace
Workspace
Wymagane

Obiekt Obszar roboczy zawierający obraz do pobrania.

name
str
wartość domyślna: None

Nazwa obrazu do pobrania. Zwróci najnowszą wersję obrazu, jeśli istnieje.

id
str
wartość domyślna: None

Określony identyfikator obrazu do pobrania. (Identyfikator to "<name>:<version>")

tags
list
wartość domyślna: None

Filtruje wyniki obrazów na podstawie podanej listy według wartości "key" lub "[key, value]". Np. ['key', ['key2', 'key2 value']]

properties
list
wartość domyślna: None

Filtruje wyniki obrazów na podstawie podanej listy według wartości "key" lub "[key, value]". Np. ['key', ['key2', 'key2 value']]

version
str
wartość domyślna: None

Gdy zostanie określona wersja i nazwa, zwróci określoną wersję obrazu.

workspace
Workspace
Wymagane

Obiekt obszaru roboczego zawierający obraz do pobrania

name
str
Wymagane

Nazwa obrazu do pobrania. Zwróci najnowszą wersję, jeśli istnieje

id
str
Wymagane

Określony identyfikator obrazu do pobrania. (Identyfikator to ":")

tags
list
Wymagane

Filtruje wyniki obrazów na podstawie podanej listy według wartości "key" lub "[key, value]". Np. ['key', ['key2', 'key2 value']]

properties
list
Wymagane

Filtruje wyniki obrazów na podstawie podanej listy według wartości "key" lub "[key, value]". Np. ['key', ['key2', 'key2 value']]

version
str
Wymagane

Gdy zostanie określona wersja i nazwa, zwróci określoną wersję 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 Image.

Obiekt Image służy do wdrażania użytkowników Model jako Webservice. 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 po klasie 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 Modeldeploy() 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 obraz lub jako plik Dockerfile.

Zapoznaj się z następującym linkiem, 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

Abstrakcyjna metoda 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.

Wykonaj aktualizację właściwości obiektu w miejscu 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. Jeśli stan terminalu nie powiedzie się, zostanie zgłoszony wyjątek WebserviceException.

add_properties

Dodaj właściwości do obrazu.

add_properties(properties)

Parametry

properties
dict[str, str]
Wymagane

Słownik właściwości do dodania.

Wyjątki

add_tags

Dodaj tagi do obrazu.

add_tags(tags)

Parametry

tags
dict[str, str]
Wymagane

Słownik tagów do dodania.

Wyjątki

create

Utwórz obraz w podanym obszarze roboczym.

static create(workspace, name, models, image_config)

Parametry

workspace
<xref:<xref:workspace: azureml.core.workspace.Workspace>>
Wymagane

Obszar roboczy do skojarzenia z tym obrazem.

name
str
Wymagane

Nazwa do skojarzenia z tym obrazem.

models
list[Model]
Wymagane

Lista obiektów modelu do spakowania przy użyciu tego obrazu. Może być pustą listą.

image_config
ImageConfig
Wymagane

Obiekt konfiguracji obrazu używany do konfigurowania tego obrazu.

Zwraca

Utworzony obiekt Obraz.

Typ zwracany

Wyjątki

delete

Usuń obraz z odpowiedniego obszaru roboczego.

delete()

Wyjątki

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

cls
Wymagane

Wskazuje metodę klasy.

workspace
Workspace
Wymagane

Obiekt obszaru roboczego, w ramach których jest zarejestrowany obraz.

image_payload
dict
Wymagane

Obiekt JSON do konwersji na obiekt Image.

Zwraca

Reprezentacja obrazu dostarczonego obiektu JSON.

Typ zwracany

Wyjątki

Uwagi

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

image_configuration

Abstrakcyjna metoda tworzenia obiektu konfiguracji obrazu.

abstract static image_configuration()

Wyjątki

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

workspace
Workspace
Wymagane

Obiekt Obszar roboczy, w ramach których ma być wyświetlona lista Obrazów.

image_name
str
wartość domyślna: None

Filtruj listę, aby uwzględnić tylko obrazy wdrożone przy użyciu określonej nazwy obrazu.

model_name
str
wartość domyślna: None

Filtruj listę, aby uwzględnić tylko obrazy wdrożone z określoną nazwą modelu.

model_id
str
wartość domyślna: None

Filtruj listę, aby uwzględnić tylko obrazy wdrożone przy użyciu określonego identyfikatora modelu.

tags
list
wartość domyślna: None

Filtruje na podstawie podanej listy według wartości "key" lub "[key, value]". Np. ['key', ['key2', 'key2 value']]

properties
list
wartość domyślna: None

Filtruje na podstawie podanej listy według wartości "key" lub "[key, value]". Np. ['key', ['key2', 'key2 value']]

Zwraca

Filtrowana lista obrazów w podanym obszarze roboczym.

Typ zwracany

list[<xref:Images>]

Wyjątki

remove_tags

Usuń tagi z obrazu.

remove_tags(tags)

Parametry

tags
list[str]
Wymagane

Lista kluczy odpowiadających tagom do usunięcia.

Wyjątki

serialize

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

serialize()

Zwraca

Reprezentacja JSON tego obiektu Image.

Typ zwracany

Wyjątki

update

Zaktualizuj obraz.

update(tags)

Parametry

tags
dict[str, str]
Wymagane

Słownik tagów do aktualizowania obrazu za pomocą polecenia . Spowoduje zastąpienie wszystkich istniejących tagów.

Wyjątki

update_creation_state

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

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

update_creation_state()

Wyjątki

wait_for_creation

Poczekaj na zakończenie tworzenia obrazu.

Poczekaj na utworzenie obrazu, aby osiągnąć stan terminalu. Jeśli stan terminalu nie powiedzie się, zostanie zgłoszony wyjątek WebserviceException.

wait_for_creation(show_output=False)

Parametry

show_output
bool
wartość domyślna: False

Opcja logiczna umożliwiająca drukowanie bardziej pełnych danych wyjściowych. Wartość domyślna to False.

Wyjątki