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.

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.

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 '<name>:<version>')
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 Modeldeploy() 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.

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()

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.

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. De standaardwaarde is False.

Default value: False

Uitzonderingen

Type Description
WebserviceException