Share 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

Name Description
workspace
Vereist

Het werkruimteobject met de afbeelding die moet worden opgehaald.

name
str

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

standaardwaarde: None
id
str

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

standaardwaarde: None
tags

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

standaardwaarde: None
properties

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

standaardwaarde: None
version
str

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

standaardwaarde: None
workspace
Vereist

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

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

properties
Vereist

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

version
Vereist
str

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 naar uw lokale Docker-installatie kan worden gedownload als een installatiekopieën of als een Dockerfile.

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

Name Description
properties
Vereist

Een woordenlijst met eigenschappen die u wilt toevoegen.

Uitzonderingen

Type Description

add_tags

Tags toevoegen aan de afbeelding.

add_tags(tags)

Parameters

Name Description
tags
Vereist

Een woordenlijst met tags die u wilt toevoegen.

Uitzonderingen

Type Description

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 aan deze afbeelding moet worden gekoppeld.

name
Vereist
str

De naam die aan deze afbeelding moet worden gekoppeld.

models
Vereist

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

image_config
Vereist

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

Retouren

Type Description

Het gemaakte afbeeldingsobject.

Uitzonderingen

Type Description

delete

Een afbeelding verwijderen uit de bijbehorende werkruimte.

delete()

Uitzonderingen

Type Description

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

Het werkruimteobject waaronder de afbeelding is geregistreerd.

image_payload
Vereist

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

Retouren

Type Description

De afbeeldingsweergave van het opgegeven JSON-object.

Uitzonderingen

Type Description

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

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

Name Description
workspace
Vereist

Het werkruimteobject om de afbeeldingen in weer te geven.

image_name
str

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

standaardwaarde: None
model_name
str

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

standaardwaarde: None
model_id
str

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

standaardwaarde: None
tags

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

standaardwaarde: None
properties

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

standaardwaarde: None

Retouren

Type Description
list[<xref:Images>]

Een gefilterde lijst met afbeeldingen in de opgegeven werkruimte.

Uitzonderingen

Type Description

remove_tags

Verwijder tags uit de afbeelding.

remove_tags(tags)

Parameters

Name Description
tags
Vereist

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

Uitzonderingen

Type Description

serialize

Converteer dit afbeeldingsobject naar een geserialiseerde JSON-woordenlijst.

serialize()

Retouren

Type Description

De JSON-weergave van dit afbeeldingsobject.

Uitzonderingen

Type Description

update

Werk de installatiekopieën bij.

update(tags)

Parameters

Name Description
tags
Vereist

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

Uitzonderingen

Type Description

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

Type Description

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

Name Description
show_output

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

standaardwaarde: False

Uitzonderingen

Type Description