Image Klass

Definierar den abstrakta överordnade klassen för Azure Machine Learning-avbildningar.

Den här klassen är INAKTUELL. Environment Använd klassen i stället.

Bildkonstruktor.

Den här klassen är INAKTUELL. Environment Använd klassen i stället.

Bildkonstruktorn används för att hämta en molnrepresentation av ett bildobjekt som är associerat med den angivna arbetsytan. Returnerar en instans av en underordnad klass som motsvarar den specifika typen av det hämtade bildobjektet.

Arv

ABC

Image

Konstruktor

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

Parametrar

Name	Description
workspace Obligatorisk	Workspace Arbetsyteobjektet som innehåller avbildningen som ska hämtas.
name	str Namnet på den avbildning som ska hämtas. Returnerar den senaste versionen av avbildningen, om den finns. standardvärde: None
id	str Det specifika ID för avbildningen som ska hämtas. (ID är "<name>:<version>") standardvärde: None
tags	list Filtrerar bildresultat baserat på den angivna listan, antingen efter "nyckel" eller "[nyckel, värde]". t.ex. ['key', ['key2', 'key2 value']] standardvärde: None
properties	list Filtrerar bildresultat baserat på den angivna listan, antingen efter "nyckel" eller "[nyckel, värde]". t.ex. ['key', ['key2', 'key2 value']] standardvärde: None
version	str När både version och namn anges returneras den specifika versionen av avbildningen. standardvärde: None
workspace Obligatorisk	Workspace Arbetsyteobjektet som innehåller avbildningen som ska hämtas
name Obligatorisk	str Namnet på den avbildning som ska hämtas. Returnerar den senaste versionen om den finns
id Obligatorisk	str Det specifika ID för avbildningen som ska hämtas. (ID är ":")
tags Obligatorisk	list Filtrerar bildresultat baserat på den angivna listan, antingen efter "nyckel" eller "[nyckel, värde]". t.ex. ['key', ['key2', 'key2 value']]
properties Obligatorisk	list Filtrerar bildresultat baserat på den angivna listan, antingen efter "nyckel" eller "[nyckel, värde]". t.ex. ['key', ['key2', 'key2 value']]
version Obligatorisk	str När både version och namn anges returneras den specifika versionen av avbildningen.

Kommentarer

Bildkonstruktorn hämtar en molnrepresentation av ett bildobjekt som är associerat med den angivna arbetsytan. Den returnerar en instans av en underordnad klass som motsvarar den specifika typen av det hämtade bildobjektet.

Ett bildobjekt används för att distribuera en användares Model som en Webservice. Bildobjektet innehåller vanligtvis en modell, ett körningsskript och eventuella beroenden som behövs för modelldistribution. Klassen Image har flera underklasser, till exempel ContainerImage för Docker-avbildningar och Avbildningar som FPGA.

ContainerImage Se klassen för ett exempel på en klass som ärver från klassen Image.

Bilder används vanligtvis i arbetsflöden som kräver användning av en bild. För de flesta arbetsflöden bör du i stället använda klassen för att definiera avbildningen Environment . Sedan kan du använda miljöobjektet Modeldeploy() med -metoden för att distribuera modellen som en webbtjänst. Du kan också använda metoden Modell package() för att skapa en avbildning som kan laddas ned till din lokala Docker-installation som en avbildning eller som en Dockerfile.

Se följande länk för en översikt över distribution av modeller i Azure: https://aka.ms/azureml-how-deploy.

Metoder

add_properties	Lägg till egenskaper i bilden.
add_tags	Lägg till taggar i bilden.
create	Skapa en avbildning på den angivna arbetsytan.
delete	Ta bort en bild från motsvarande arbetsyta.
deserialize	Konvertera ett json-objekt till ett bildobjekt.
image_configuration	Abstrakt metod för att skapa ett bildkonfigurationsobjekt.
list	Visa en lista över de bilder som är associerade med motsvarande arbetsyta. Kan filtreras med specifika parametrar.
remove_tags	Ta bort taggar från bilden.
serialize	Konvertera det här bildobjektet till en serialiserad JSON-ordlista.
update	Uppdatera avbildningen.
update_creation_state	Uppdatera det aktuella tillståndet för det minnesinterna objektet. Utför en uppdatering på plats av objektets egenskaper baserat på aktuellt tillstånd för motsvarande molnobjekt. Främst användbart för manuell avsökning av skapandetillstånd.
wait_for_creation	Vänta tills avbildningen har skapats. Vänta tills avbildningen har skapats för att nå ett terminaltillstånd. Genererar en WebserviceException om den når ett icke-lyckat terminaltillstånd.

add_properties

Lägg till egenskaper i bilden.

add_properties(properties)

Parametrar

Name	Description
properties Obligatorisk	dict[str, str] En ordlista med egenskaper att lägga till.

Undantag

Typ	Description
WebserviceException

add_tags

Lägg till taggar i bilden.

add_tags(tags)

Parametrar

Name	Description
tags Obligatorisk	dict[str, str] En ordlista med taggar att lägga till.

Undantag

Typ	Description
WebserviceException

create

Skapa en avbildning på den angivna arbetsytan.

static create(workspace, name, models, image_config)

Parametrar

Name	Description
workspace Obligatorisk	<xref:<xref:workspace: azureml.core.workspace.Workspace>> Arbetsytan som ska associeras med den här avbildningen.
name Obligatorisk	str Namnet som ska associeras med den här bilden.
models Obligatorisk	list[Model] En lista över modellobjekt som ska paketera med den här avbildningen. Kan vara en tom lista.
image_config Obligatorisk	ImageConfig Avbildningskonfigurationsobjektet som ska användas för att konfigurera den här avbildningen.

Returer

Typ	Description
Image	Det skapade bildobjektet.

Undantag

Typ	Description
WebserviceException

delete

Ta bort en bild från motsvarande arbetsyta.

delete()

Undantag

Typ	Description
WebserviceException

Kommentarer

Den här metoden misslyckas om avbildningen har distribuerats till en live-webbtjänst.

deserialize

Konvertera ett json-objekt till ett bildobjekt.

deserialize(workspace, image_payload)

Parametrar

Name	Description
cls Obligatorisk	Anger klassmetod.
workspace Obligatorisk	Workspace Arbetsytans objekt som avbildningen är registrerad under.
image_payload Obligatorisk	dict Ett JSON-objekt som ska konverteras till ett bildobjekt.

Returer

Typ	Description
Image	Bildrepresentationen av det angivna JSON-objektet.

Undantag

Typ	Description
WebserviceException

Kommentarer

Den här metoden misslyckas om den angivna arbetsytan inte är den arbetsyta som avbildningen är registrerad under.

image_configuration

Abstrakt metod för att skapa ett bildkonfigurationsobjekt.

abstract static image_configuration()

Undantag

Typ	Description
WebserviceException

list

Visa en lista över de bilder som är associerade med motsvarande arbetsyta. Kan filtreras med specifika parametrar.

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

Parametrar

Name	Description
workspace Obligatorisk	Workspace Det arbetsyteobjekt som bilderna ska visas i.
image_name	str Filterlista för att endast inkludera avbildningar som distribuerats med det specifika avbildningsnamnet. standardvärde: None
model_name	str Filterlista för att endast inkludera avbildningar som distribuerats med det specifika modellnamnet. standardvärde: None
model_id	str Filterlista för att endast inkludera avbildningar som distribuerats med det specifika modell-ID:t. standardvärde: None
tags	list Filtrerar baserat på den angivna listan, antingen efter "nyckel" eller "[nyckel, värde]". t.ex. ['key', ['key2', 'key2 value']] standardvärde: None
properties	list Filtrerar baserat på den angivna listan, antingen efter "nyckel" eller "[nyckel, värde]". t.ex. ['key', ['key2', 'key2 value']] standardvärde: None

Returer

Typ	Description
list[<xref:Images>]	En filtrerad lista över bilder på den angivna arbetsytan.

Undantag

Typ	Description
WebserviceException

remove_tags

Ta bort taggar från bilden.

remove_tags(tags)

Parametrar

Name	Description
tags Obligatorisk	list[str] En lista över nycklar som motsvarar taggar som ska tas bort.

Undantag

Typ	Description
WebserviceException

serialize

Konvertera det här bildobjektet till en serialiserad JSON-ordlista.

serialize()

Returer

Typ	Description
dict	JSON-representationen av det här bildobjektet.

Undantag

Typ	Description
WebserviceException

update

Uppdatera avbildningen.

update(tags)

Parametrar

Name	Description
tags Obligatorisk	dict[str, str] En ordlista med taggar att uppdatera bilden med. Skriver över alla befintliga taggar.

Undantag

Typ	Description
WebserviceException

update_creation_state

Uppdatera det aktuella tillståndet för det minnesinterna objektet.

Utför en uppdatering på plats av objektets egenskaper baserat på aktuellt tillstånd för motsvarande molnobjekt. Främst användbart för manuell avsökning av skapandetillstånd.

update_creation_state()

Undantag

Typ	Description
WebserviceException

wait_for_creation

Vänta tills avbildningen har skapats.

Vänta tills avbildningen har skapats för att nå ett terminaltillstånd. Genererar en WebserviceException om den når ett icke-lyckat terminaltillstånd.

wait_for_creation(show_output=False)

Parametrar

Name	Description
show_output	bool Booleskt alternativ för att skriva ut mer utförliga utdata. Standardvärdet är Falskt. standardvärde: False

Undantag

Typ	Description
WebserviceException