Image Klas

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

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

Afbeeldingsconstructor.

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

Afbeeldingsconstructor 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

ABC

Image

Constructor

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

Parameters

Name	Description
workspace Vereist	Workspace Het werkruimteobject met de afbeelding die moet worden opgehaald.
name	str De naam van de afbeelding die moet worden opgehaald. Retourneert de nieuwste versie van de installatiekopieën, als deze bestaat. Default value: None
id	str De specifieke id van de afbeelding die moet worden opgehaald. (Id is '<name>:<version>') Default value: None
tags	list Filtert afbeeldingsresultaten op basis van de opgegeven lijst, op basis van 'sleutel' of '[sleutel, waarde]'. Bijvoorbeeld: ['key', ['key2', 'key2 value']] Default value: None
properties	list Filtert afbeeldingsresultaten op basis van de opgegeven lijst, op basis van 'sleutel' of '[sleutel, waarde]'. Bijvoorbeeld: ['key', ['key2', 'key2 value']] Default value: None
version	str Wanneer versie en naam beide zijn opgegeven, wordt de specifieke versie van de installatiekopieën geretourneerd. Default value: None
workspace Vereist	Workspace Het werkruimteobject met de afbeelding die moet worden opgehaald
name Vereist	str De naam van de afbeelding die moet worden opgehaald. Retourneert de nieuwste versie, als deze bestaat
id Vereist	str De specifieke id van de afbeelding die moet worden opgehaald. (Id is ':')
tags Vereist	list Filtert afbeeldingsresultaten op basis van de opgegeven lijst, op basis van 'sleutel' of '[sleutel, waarde]'. Bijvoorbeeld: ['key', ['key2', 'key2 value']]
properties Vereist	list Filtert afbeeldingsresultaten op basis van de opgegeven lijst, op basis van 'sleutel' of '[sleutel, waarde]'. Bijvoorbeeld: ['key', ['key2', 'key2 value']]
version Vereist	str Wanneer versie en naam beide zijn opgegeven, wordt de specifieke versie van de installatiekopieën geretourneerd.

Opmerkingen

Met de afbeeldingsconstructor wordt een cloudweergave opgehaald 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 voor het implementeren van Model een gebruiker als een Webservice. Het afbeeldingsobject 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 Afbeelding.

Afbeeldingen worden meestal gebruikt in werkstromen waarvoor een installatiekopieën moeten worden gebruikt. Voor de meeste werkstromen moet u in plaats daarvan de Environment klasse gebruiken om uw installatiekopieën te definiëren. Vervolgens kunt u het omgevingsobject gebruiken met de Model deploy() methode om het model als een webservice te implementeren. U kunt ook de modelmethode package() gebruiken om een installatiekopieën te maken die kunnen worden gedownload naar uw lokale Docker-installatiekopieën of als dockerfile.

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

Methoden

add_properties	Voeg eigenschappen toe aan de afbeelding.
add_tags	Voeg tags toe aan de afbeelding.
create	Maak een installatiekopieën in de opgegeven werkruimte.
delete	Verwijder een afbeelding uit de bijbehorende werkruimte.
deserialize	Converteer een json-object naar een afbeeldingsobject.
image_configuration	Abstracte methode voor het maken van een afbeeldingsconfiguratieobject.
list	Geef de afbeeldingen weer 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 afbeelding 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. Voornamelijk handig voor handmatige polling van de aanmaakstatus.
wait_for_creation	Wacht totdat de installatiekopieën zijn gemaakt. Wacht totdat de installatiekopie een terminalstatus heeft bereikt. Genereert een WebserviceException als deze een niet-geslaagde terminalstatus bereikt.

add_properties

Voeg eigenschappen toe aan de afbeelding.

add_properties(properties)

Parameters

Name	Description
properties Vereist	dict[str, str] Een woordenlijst met eigenschappen die u wilt toevoegen.

Uitzonderingen

Type	Description
WebserviceException

add_tags

Voeg tags toe aan de afbeelding.

add_tags(tags)

Parameters

Name	Description
tags Vereist	dict[str, str] Een woordenlijst met tags die moeten worden toegevoegd.

Uitzonderingen

Type	Description
WebserviceException

create

Maak een installatiekopieën in de opgegeven werkruimte.

static create(workspace, name, models, image_config)

Parameters

Name	Description
workspace Vereist	<xref:<xref:workspace: azureml.core.workspace.Workspace>> De werkruimte die moet worden gekoppeld aan deze installatiekopieën.
name Vereist	str De naam die u aan deze afbeelding wilt koppelen.
models Vereist	list[Model] Een lijst met modelobjecten die moeten worden verpakt met deze afbeelding. Kan een lege lijst zijn.
image_config Vereist	ImageConfig Het configuratieobject van de installatiekopieën dat moet worden gebruikt om deze installatiekopieën te configureren.

Retouren

Type	Description
Image	Het gemaakte afbeeldingsobject.

Uitzonderingen

Type	Description
WebserviceException

delete

Verwijder een afbeelding uit de bijbehorende werkruimte.

delete()

Uitzonderingen

Type	Description
WebserviceException

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

Name	Description
cls Vereist	Geeft de klassemethode aan.
workspace Vereist	Workspace Het werkruimteobject waaronder de afbeelding is geregistreerd.
image_payload Vereist	dict Een JSON-object dat moet worden geconverteerd naar een afbeeldingsobject.

Retouren

Type	Description
Image	De afbeeldingsweergave van het opgegeven JSON-object.

Uitzonderingen

Type	Description
WebserviceException

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

Type	Description
WebserviceException

list

Geef de afbeeldingen weer 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

Name	Description
workspace Vereist	Workspace Het werkruimteobject waarin de afbeeldingen worden weergegeven.
image_name	str Filterlijst om alleen installatiekopieën op te nemen die zijn geïmplementeerd met de specifieke installatiekopienaam. Default value: None
model_name	str Filterlijst om alleen installatiekopieën op te nemen die zijn geïmplementeerd met de specifieke modelnaam. Default value: None
model_id	str Filterlijst om alleen installatiekopieën op te nemen die zijn geïmplementeerd met de specifieke model-id. Default value: None
tags	list Filtert op basis van de opgegeven lijst op basis van 'sleutel' of '[sleutel, waarde]'. Bijvoorbeeld: ['key', ['key2', 'key2 value']] Default value: None
properties	list Filtert op basis van de opgegeven lijst op basis van 'sleutel' of '[sleutel, waarde]'. Bijvoorbeeld: ['key', ['key2', 'key2 value']] Default value: None

Retouren

Type	Description
list[<xref:Images>]	Een gefilterde lijst met afbeeldingen in de opgegeven werkruimte.

Uitzonderingen

Type	Description
WebserviceException

remove_tags

Verwijder tags uit de afbeelding.

remove_tags(tags)

Parameters

Name	Description
tags Vereist	list[str] Een lijst met sleutels die overeenkomen met tags die moeten worden verwijderd.

Uitzonderingen

Type	Description
WebserviceException

serialize

Converteer dit afbeeldingsobject naar een geserialiseerde JSON-woordenlijst.

serialize()

Retouren

Type	Description
dict	De JSON-weergave van dit afbeeldingsobject.

Uitzonderingen

Type	Description
WebserviceException

update

Werk de afbeelding bij.

update(tags)

Parameters

Name	Description
tags Vereist	dict[str, str] Een woordenlijst met tags waarmee de afbeelding kan worden bijgewerkt. Alle bestaande tags worden overschreven.

Uitzonderingen

Type	Description
WebserviceException

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. Voornamelijk handig voor handmatige polling van de aanmaakstatus.

update_creation_state()

Uitzonderingen

Type	Description
WebserviceException

wait_for_creation

Wacht totdat de installatiekopieën zijn gemaakt.

Wacht totdat de installatiekopie een terminalstatus heeft bereikt. Genereert een WebserviceException als deze een niet-geslaagde terminalstatus bereikt.

wait_for_creation(show_output=False)

Parameters

Name	Description
show_output	bool Booleaanse optie om uitgebreidere uitvoer af te drukken. Standaard ingesteld op False. Default value: False

Uitzonderingen

Type	Description
WebserviceException