Image Třída

Definuje abstraktní nadřazenou třídu pro image služby Azure Machine Learning.

Tato třída je ZASTARALÁ. Místo toho Environment použijte třídu .

Konstruktor image.

Tato třída je ZASTARALÁ. Místo toho Environment použijte třídu .

Konstruktor image se používá k načtení cloudové reprezentace objektu Image přidruženého k poskytnutému pracovnímu prostoru. Vrátí instanci podřízené třídy odpovídající určitému typu načteného objektu Image.

Dědičnost

ABC

Image

Konstruktor

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

Parametry

workspace

Workspace

Vyžadováno

Objekt Workspace obsahující obrázek, který se má načíst.

name

str

výchozí hodnota: None

Název obrázku, který se má načíst. Vrátí nejnovější verzi image, pokud existuje.

id

str

výchozí hodnota: None

Konkrétní ID obrázku, který se má načíst. (ID je "<name>:<version>")

tags

list

výchozí hodnota: None

Bude filtrovat výsledky obrázků na základě poskytnutého seznamu podle klíče nebo [klíč, hodnota]. Například ['klíč', ['klíč2', 'hodnota klíče2']]

properties

list

výchozí hodnota: None

Bude filtrovat výsledky obrázků na základě poskytnutého seznamu podle klíče nebo [klíč, hodnota]. Například ['klíč', ['klíč2', 'hodnota klíče2']]

version

str

výchozí hodnota: None

Pokud je zadána verze a název, vrátí konkrétní verzi image.

workspace

Workspace

Vyžadováno

Objekt pracovního prostoru obsahující obrázek, který se má načíst

name

str

Vyžadováno

Název obrázku, který se má načíst. Vrátí nejnovější verzi, pokud existuje.

id

str

Vyžadováno

Konkrétní ID obrázku, který se má načíst. (ID je ":")

tags

list

Vyžadováno

Bude filtrovat výsledky obrázků na základě poskytnutého seznamu podle klíče nebo [klíč, hodnota]. Například ['klíč', ['klíč2', 'hodnota klíče2']]

properties

list

Vyžadováno

Bude filtrovat výsledky obrázků na základě poskytnutého seznamu podle klíče nebo [klíč, hodnota]. Například ['klíč', ['klíč2', 'hodnota klíče2']]

version

str

Vyžadováno

Pokud je zadána verze a název, vrátí konkrétní verzi image.

Poznámky

Konstruktor Image načte cloudovou reprezentaci objektu Image přidruženého k poskytnutému pracovnímu prostoru. Vrátí instanci podřízené třídy odpovídající konkrétnímu typu načteného objektu Image.

Objekt Image se používá k nasazení uživatele Model jako objekt .Webservice Objekt Image obvykle obsahuje model, spouštěcí skript a všechny závislosti potřebné pro nasazení modelu. Třída Image má několik podtříd, jako jsou ContainerImage pro Image Dockeru a Image jako FPGA.

Podívejte se na ContainerImage třídu, kde najdete příklad třídy, která dědí z třídy Image.

Obrázky se obvykle používají v pracovních postupech, které vyžadují použití obrázku. U většiny pracovních postupů byste místo toho měli k definování image použít Environment třídu . Pak můžete pomocí objektu Environment s metodou Modeldeploy() nasadit model jako webovou službu. Můžete také použít metodu Model package() k vytvoření image, kterou můžete stáhnout do místní instalace Dockeru jako image nebo jako soubor Dockerfile.

Přehled nasazení modelů v Azure najdete na následujícím odkazu: https://aka.ms/azureml-how-deploy.

Metody

add_properties	Přidejte do image vlastnosti.
add_tags	Přidejte do obrázku značky.
create	Vytvořte image v poskytnutém pracovním prostoru.
delete	Odstraní image z odpovídajícího pracovního prostoru.
deserialize	Převeďte objekt JSON na objekt Image.
image_configuration	Abstraktní metoda pro vytvoření objektu konfigurace image.
list	Zobrazí seznam obrázků přidružených k odpovídajícímu pracovnímu prostoru. Lze filtrovat s konkrétními parametry.
remove_tags	Odeberte z obrázku značky.
serialize	Převeďte tento objekt Image na serializovaný slovník JSON.
update	Aktualizujte image.
update_creation_state	Aktualizujte aktuální stav objektu v paměti. Proveďte místní aktualizaci vlastností objektu na základě aktuálního stavu odpovídajícího cloudového objektu. Primárně užitečné pro ruční dotazování stavu vytvoření.
wait_for_creation	Počkejte, až se image vytvoří. Počkejte, až se vytvoření image dostane do stavu terminálu. Vyvolá výjimku WebserviceException, pokud dosáhne stavu terminálu, který není úspěšný.

add_properties

Přidejte do image vlastnosti.

add_properties(properties)

Parametry

properties

dict[str, str]

Vyžadováno

Slovník vlastností, které chcete přidat.

Výjimky

WebserviceException

add_tags

Přidejte do obrázku značky.

add_tags(tags)

Parametry

tags

dict[str, str]

Vyžadováno

Slovník značek, které chcete přidat.

Výjimky

WebserviceException

create

Vytvořte image v poskytnutém pracovním prostoru.

static create(workspace, name, models, image_config)

Parametry

workspace

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

Vyžadováno

Pracovní prostor, který chcete přidružit k tomuto obrázku.

name

str

Vyžadováno

Název, který chcete přidružit k tomuto obrázku.

models

list[Model]

Vyžadováno

Seznam objektů modelu, které se mají s tímto obrázkem zabalit. Může být prázdný seznam.

image_config

ImageConfig

Vyžadováno

Objekt konfigurace image, který se má použít ke konfiguraci této image.

Návraty

Vytvořený objekt Image.

Návratový typ

Image

Výjimky

WebserviceException

delete

Odstraní image z odpovídajícího pracovního prostoru.

delete()

Výjimky

WebserviceException

Poznámky

Tato metoda selže, pokud byla image nasazena do živé webové služby.

deserialize

Převeďte objekt JSON na objekt Image.

deserialize(workspace, image_payload)

Parametry

cls

Vyžadováno

Označuje metodu třídy.

workspace

Workspace

Vyžadováno

Objekt pracovního prostoru, pod kterým je obrázek zaregistrovaný.

image_payload

dict

Vyžadováno

Objekt JSON, který se má převést na objekt Image.

Návraty

Reprezentace obrázku poskytnutého objektu JSON

Návratový typ

Image

Výjimky

WebserviceException

Poznámky

Tato metoda selže, pokud zadaný pracovní prostor není pracovní prostor, ve které je image zaregistrovaná.

image_configuration

Abstraktní metoda pro vytvoření objektu konfigurace image.

abstract static image_configuration()

Výjimky

WebserviceException

list

Zobrazí seznam obrázků přidružených k odpovídajícímu pracovnímu prostoru. Lze filtrovat s konkrétními parametry.

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

Parametry

workspace

Workspace

Vyžadováno

Objekt Workspace, ve který se zobrazí seznam Obrázků.

image_name

str

výchozí hodnota: None

Vyfiltrujte seznam tak, aby zahrnoval jenom image nasazené s konkrétním názvem image.

model_name

str

výchozí hodnota: None

Vyfiltrujte seznam tak, aby zahrnoval jenom image nasazené s konkrétním názvem modelu.

model_id

str

výchozí hodnota: None

Vyfiltrujte seznam tak, aby zahrnoval jenom image nasazené s konkrétním ID modelu.

tags

list

výchozí hodnota: None

Bude filtrovat podle zadaného seznamu podle klíče nebo [klíč, hodnota]. Například ['klíč', ['klíč2', 'hodnota klíče2']]

properties

list

výchozí hodnota: None

Bude filtrovat podle zadaného seznamu podle klíče nebo [klíč, hodnota]. Například ['klíč', ['klíč2', 'hodnota klíče2']]

Návraty

Filtrovaný seznam obrázků v poskytnutém pracovním prostoru.

Návratový typ

list[<xref:Images>]

Výjimky

WebserviceException

remove_tags

Odeberte z obrázku značky.

remove_tags(tags)

Parametry

tags

list[str]

Vyžadováno

Seznam klíčů odpovídajících značky, které se mají odebrat.

Výjimky

WebserviceException

serialize

Převeďte tento objekt Image na serializovaný slovník JSON.

serialize()

Návraty

Reprezentace JSON tohoto objektu Image.

Návratový typ

dict

Výjimky

WebserviceException

update

Aktualizujte image.

update(tags)

Parametry

tags

dict[str, str]

Vyžadováno

Slovník značek, pomocí které se má obrázek aktualizovat. Přepíše všechny existující značky.

Výjimky

WebserviceException

update_creation_state

Aktualizujte aktuální stav objektu v paměti.

Proveďte místní aktualizaci vlastností objektu na základě aktuálního stavu odpovídajícího cloudového objektu. Primárně užitečné pro ruční dotazování stavu vytvoření.

update_creation_state()

Výjimky

WebserviceException

wait_for_creation

Počkejte, až se image vytvoří.

Počkejte, až se vytvoření image dostane do stavu terminálu. Vyvolá výjimku WebserviceException, pokud dosáhne stavu terminálu, který není úspěšný.

wait_for_creation(show_output=False)

Parametry

show_output

bool

výchozí hodnota: False

Logická možnost pro tisk podrobnějšího výstupu. Výchozí hodnota je False.

Výjimky

WebserviceException