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

Nazwa Opis
workspace
Wymagane

Obiekt Obszar roboczy zawierający obraz do pobrania.

name
str

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

wartość domyślna: None
id
str

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

wartość domyślna: None
tags

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

wartość domyślna: None
properties

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

wartość domyślna: None
version
str

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

wartość domyślna: None
workspace
Wymagane

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

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

properties
Wymagane

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

version
Wymagane
str

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

Uwagi

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

Obiekt Obrazu służy do wdrażania użytkownika Model jako Webserviceobiektu . Obiekt Image zazwyczaj 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 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 obrazu lub jako pliku Dockerfile.

Zapoznaj się z poniższym 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. Zgłosi błąd 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

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

Wyjątki

Typ Opis

add_tags

Dodaj tagi do obrazu.

add_tags(tags)

Parametry

Nazwa Opis
tags
Wymagane

Słownik tagów do dodania.

Wyjątki

Typ Opis

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

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

image_config
Wymagane

Obiekt konfiguracji obrazu używany do konfigurowania tego obrazu.

Zwraca

Typ Opis

Utworzony obiekt Obraz.

Wyjątki

Typ Opis

delete

Usuń obraz z odpowiedniego obszaru roboczego.

delete()

Wyjątki

Typ Opis

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

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

image_payload
Wymagane

Obiekt JSON do konwersji na obiekt Image.

Zwraca

Typ Opis

Reprezentacja obrazu dostarczonego obiektu JSON.

Wyjątki

Typ Opis

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

Typ Opis

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

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

image_name
str

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

wartość domyślna: None
model_name
str

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

wartość domyślna: None
model_id
str

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

wartość domyślna: None
tags

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

wartość domyślna: None
properties

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

wartość domyślna: None

Zwraca

Typ Opis
list[<xref:Images>]

Filtrowana lista obrazów w podanym obszarze roboczym.

Wyjątki

Typ Opis

remove_tags

Usuń tagi z obrazu.

remove_tags(tags)

Parametry

Nazwa Opis
tags
Wymagane

Lista kluczy odpowiadających tagom do usunięcia.

Wyjątki

Typ Opis

serialize

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

serialize()

Zwraca

Typ Opis

Reprezentacja JSON tego obiektu Image.

Wyjątki

Typ Opis

update

Zaktualizuj obraz.

update(tags)

Parametry

Nazwa Opis
tags
Wymagane

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

Wyjątki

Typ Opis

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

Typ Opis

wait_for_creation

Poczekaj na zakończenie tworzenia obrazu.

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

wait_for_creation(show_output=False)

Parametry

Nazwa Opis
show_output

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

wartość domyślna: False

Wyjątki

Typ Opis