Delen via


Image Klas

Definieert de abstracte bovenliggende klasse voor Azure Machine Learning-installatiekopieën.

Deze klasse is AFGESCHAFT. Gebruik in plaats daarvan de Environment klasse.

Installatiekopieënconstructor.

Deze klasse is AFGESCHAFT. Gebruik in plaats daarvan de Environment klasse.

Image constructor wordt gebruikt om een cloudweergave op te halen van een afbeeldingsobject dat is gekoppeld aan de opgegeven werkruimte. Retourneert een exemplaar van een onderliggende klasse die overeenkomt met het specifieke type van het opgehaalde afbeeldingsobject.

Overname
Image

Constructor

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

Parameters

workspace
Workspace
Vereist

Het werkruimteobject met de afbeelding die moet worden opgehaald.

name
str
standaardwaarde: None

De naam van de afbeelding die moet worden opgehaald. Retourneert de meest recente versie van de installatiekopieën, als deze bestaat.

id
str
standaardwaarde: None

De specifieke id van de afbeelding die moet worden opgehaald. (Id is '<naam>:<versie>')

tags
list
standaardwaarde: None

Filtert de afbeeldingsresultaten op basis van de opgegeven lijst, op 'sleutel' of '[sleutel, waarde]'. Bijvoorbeeld ['key', ['key2', 'key2 value']]

properties
list
standaardwaarde: None

Filtert de afbeeldingsresultaten op basis van de opgegeven lijst, op 'sleutel' of '[sleutel, waarde]'. Bijvoorbeeld ['key', ['key2', 'key2 value']]

version
str
standaardwaarde: None

Wanneer versie en naam beide zijn opgegeven, retourneert de specifieke versie van de installatiekopieën.

workspace
Workspace
Vereist

Het werkruimteobject met de afbeelding die moet worden opgehaald

name
str
Vereist

De naam van de afbeelding die moet worden opgehaald. Retourneert de nieuwste versie, als deze bestaat

id
str
Vereist

De specifieke id van de afbeelding die moet worden opgehaald. (Id is ":")

tags
list
Vereist

Filtert de afbeeldingsresultaten op basis van de opgegeven lijst, op 'sleutel' of '[sleutel, waarde]'. Bijvoorbeeld ['key', ['key2', 'key2 value']]

properties
list
Vereist

Filtert de afbeeldingsresultaten op basis van de opgegeven lijst, op 'sleutel' of '[sleutel, waarde]'. Bijvoorbeeld ['key', ['key2', 'key2 value']]

version
str
Vereist

Wanneer versie en naam beide zijn opgegeven, retourneert de specifieke versie van de installatiekopieën.

Opmerkingen

De constructor Image haalt een cloudweergave op van een afbeeldingsobject dat is gekoppeld aan de opgegeven werkruimte. Het retourneert een exemplaar van een onderliggende klasse die overeenkomt met het specifieke type van het opgehaalde afbeeldingsobject.

Een afbeeldingsobject wordt gebruikt om de van een gebruiker Model te implementeren als een Webservice. Het object Image bevat doorgaans een model, een uitvoeringsscript en eventuele afhankelijkheden die nodig zijn voor modelimplementatie. De klasse Image heeft meerdere subklassen, zoals ContainerImage voor Docker-installatiekopieën en installatiekopieën zoals FPGA.

Zie de ContainerImage klasse voor een voorbeeld van een klasse die wordt overgenomen van de klasse Image.

Afbeeldingen worden doorgaans gebruikt in werkstromen waarvoor het gebruik van een installatiekopieën is vereist. Voor de meeste werkstromen moet u in plaats daarvan de Environment klasse gebruiken om uw installatiekopieën te definiëren. Vervolgens kunt u het object Environment gebruiken met de Modeldeploy() methode om het model als een webservice te implementeren. U kunt ook de methode Model package() gebruiken om een installatiekopieën te maken die kan worden gedownload naar uw lokale Docker-installatie als installatiekopieën of als dockerbestand.

Zie de volgende koppeling voor een overzicht van het implementeren van modellen in Azure: https://aka.ms/azureml-how-deploy.

Methoden

add_properties

Eigenschappen toevoegen aan de afbeelding.

add_tags

Tags toevoegen aan de afbeelding.

create

Maak een installatiekopieën in de opgegeven werkruimte.

delete

Een afbeelding verwijderen uit de bijbehorende werkruimte.

deserialize

Converteer een json-object naar een afbeeldingsobject.

image_configuration

Abstracte methode voor het maken van een afbeeldingsconfiguratieobject.

list

Vermeld de installatiekopieën die zijn gekoppeld aan de bijbehorende werkruimte. Kan worden gefilterd met specifieke parameters.

remove_tags

Verwijder tags uit de afbeelding.

serialize

Converteer dit afbeeldingsobject naar een geserialiseerde JSON-woordenlijst.

update

Werk de installatiekopieën bij.

update_creation_state

Vernieuw de huidige status van het object in het geheugen.

Voer een in-place update uit van de eigenschappen van het object op basis van de huidige status van het bijbehorende cloudobject. Vooral handig voor het handmatig peilen van de aanmaakstatus.

wait_for_creation

Wacht tot de installatiekopieën zijn gemaakt.

Wacht totdat de installatiekopieën een terminalstatus hebben bereikt. Genereert een WebserviceException als deze een niet-geslaagde terminalstatus bereikt.

add_properties

Eigenschappen toevoegen aan de afbeelding.

add_properties(properties)

Parameters

properties
dict[str, str]
Vereist

Een woordenlijst met eigenschappen die u wilt toevoegen.

Uitzonderingen

add_tags

Tags toevoegen aan de afbeelding.

add_tags(tags)

Parameters

tags
dict[str, str]
Vereist

Een woordenlijst met tags die u wilt toevoegen.

Uitzonderingen

create

Maak een installatiekopieën in de opgegeven werkruimte.

static create(workspace, name, models, image_config)

Parameters

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

De werkruimte die aan deze afbeelding moet worden gekoppeld.

name
str
Vereist

De naam die aan deze afbeelding moet worden gekoppeld.

models
list[Model]
Vereist

Een lijst met modelobjecten die met deze afbeelding moeten worden verpakt. Kan een lege lijst zijn.

image_config
ImageConfig
Vereist

Het installatiekopieënconfiguratieobject dat moet worden gebruikt om deze installatiekopieën te configureren.

Retouren

Het gemaakte afbeeldingsobject.

Retourtype

Uitzonderingen

delete

Een afbeelding verwijderen uit de bijbehorende werkruimte.

delete()

Uitzonderingen

Opmerkingen

Deze methode mislukt als de installatiekopie is geïmplementeerd in een live webservice.

deserialize

Converteer een json-object naar een afbeeldingsobject.

deserialize(workspace, image_payload)

Parameters

cls
Vereist

Geeft de klassemethode aan.

workspace
Workspace
Vereist

Het werkruimteobject waaronder de afbeelding is geregistreerd.

image_payload
dict
Vereist

Een JSON-object dat moet worden geconverteerd naar een afbeeldingsobject.

Retouren

De afbeeldingsweergave van het opgegeven JSON-object.

Retourtype

Uitzonderingen

Opmerkingen

Deze methode mislukt als de opgegeven werkruimte niet de werkruimte is waaronder de installatiekopieën zijn geregistreerd.

image_configuration

Abstracte methode voor het maken van een afbeeldingsconfiguratieobject.

abstract static image_configuration()

Uitzonderingen

list

Vermeld de installatiekopieën die zijn gekoppeld aan de bijbehorende werkruimte. Kan worden gefilterd met specifieke parameters.

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

Parameters

workspace
Workspace
Vereist

Het werkruimteobject om de afbeeldingen in weer te geven.

image_name
str
standaardwaarde: None

Filter de lijst om alleen installatiekopieën op te nemen die zijn geïmplementeerd met de specifieke installatiekopienaam.

model_name
str
standaardwaarde: None

Filter de lijst om alleen installatiekopieën op te nemen die zijn geïmplementeerd met de specifieke modelnaam.

model_id
str
standaardwaarde: None

Filter de lijst om alleen installatiekopieën op te nemen die zijn geïmplementeerd met de specifieke model-id.

tags
list
standaardwaarde: None

Filtert op basis van de opgegeven lijst, op 'sleutel' of '[sleutel, waarde]'. Bijvoorbeeld ['key', ['key2', 'key2 value']]

properties
list
standaardwaarde: None

Filtert op basis van de opgegeven lijst, op 'sleutel' of '[sleutel, waarde]'. Bijvoorbeeld ['key', ['key2', 'key2 value']]

Retouren

Een gefilterde lijst met afbeeldingen in de opgegeven werkruimte.

Retourtype

list[<xref:Images>]

Uitzonderingen

remove_tags

Verwijder tags uit de afbeelding.

remove_tags(tags)

Parameters

tags
list[str]
Vereist

Een lijst met sleutels die overeenkomen met tags die moeten worden verwijderd.

Uitzonderingen

serialize

Converteer dit afbeeldingsobject naar een geserialiseerde JSON-woordenlijst.

serialize()

Retouren

De JSON-weergave van dit afbeeldingsobject.

Retourtype

Uitzonderingen

update

Werk de installatiekopieën bij.

update(tags)

Parameters

tags
dict[str, str]
Vereist

Een woordenlijst met tags waarmee u de afbeelding kunt bijwerken. Alle bestaande tags worden overschreven.

Uitzonderingen

update_creation_state

Vernieuw de huidige status van het object in het geheugen.

Voer een in-place update uit van de eigenschappen van het object op basis van de huidige status van het bijbehorende cloudobject. Vooral handig voor het handmatig peilen van de aanmaakstatus.

update_creation_state()

Uitzonderingen

wait_for_creation

Wacht tot de installatiekopieën zijn gemaakt.

Wacht totdat de installatiekopieën een terminalstatus hebben bereikt. Genereert een WebserviceException als deze een niet-geslaagde terminalstatus bereikt.

wait_for_creation(show_output=False)

Parameters

show_output
bool
standaardwaarde: False

Booleaanse optie om uitgebreidere uitvoer af te drukken. Standaard ingesteld op False.

Uitzonderingen