Image Classe

Definisce la classe padre astratta per le immagini di Azure Machine Learning.

Questa classe è DEPRECATA. Utilizzare invece la classe Environment.

Costruttore di immagine.

Questa classe è DEPRECATA. Utilizzare invece la classe Environment.

Il costruttore di immagine viene usato per recuperare una rappresentazione cloud di un oggetto Image associato all'area di lavoro specificata. Restituisce un'istanza di una classe figlio corrispondente al tipo specifico dell'oggetto Image recuperato.

Ereditarietà

ABC

Image

Costruttore

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

Parametri

Nome	Descrizione
workspace Necessario	Workspace Oggetto Workspace contenente l'oggetto Image da recuperare.
name	str Nome dell'immagine da recuperare. Restituisce la versione più recente dell'immagine, se esistente. Valore predefinito: None
id	str ID specifico dell'immagine da recuperare. (ID è "<name>:<version>") Valore predefinito: None
tags	list Filtra i risultati dell'immagine in base all'elenco specificato, in base a 'key' o '[key, value]'. Ex. ['key', ['key2', 'key2 value']] Valore predefinito: None
properties	list Filtra i risultati dell'immagine in base all'elenco specificato, in base a 'key' o '[key, value]'. Ex. ['key', ['key2', 'key2 value']] Valore predefinito: None
version	str Quando vengono specificati sia la versione che il nome, restituirà la versione specifica dell'immagine. Valore predefinito: None
workspace Necessario	Workspace Oggetto dell'area di lavoro contenente l'immagine da recuperare
name Necessario	str Nome dell'immagine da recuperare. Restituisce la versione più recente, se esistente
id Necessario	str ID specifico dell'immagine da recuperare. (ID è ":")
tags Necessario	list Filtra i risultati dell'immagine in base all'elenco specificato, in base a 'key' o '[key, value]'. Ex. ['key', ['key2', 'key2 value']]
properties Necessario	list Filtra i risultati dell'immagine in base all'elenco specificato, in base a 'key' o '[key, value]'. Ex. ['key', ['key2', 'key2 value']]
version Necessario	str Quando vengono specificati sia la versione che il nome, restituirà la versione specifica dell'immagine.

Commenti

Il costruttore Image recupera una rappresentazione cloud di un oggetto Image associato all'area di lavoro specificata. Restituisce un'istanza di una classe figlio corrispondente al tipo specifico dell'oggetto Image recuperato.

Un oggetto Image viene usato per distribuire un utente Model come Webservice. L'oggetto Image contiene in genere un modello, uno script di esecuzione e tutte le dipendenze necessarie per la distribuzione del modello. La classe Image include più sottoclassi, ad esempio ContainerImage per le immagini Docker e Immagini come FPGA.

Vedere la ContainerImage classe per un esempio di classe che eredita dalla classe Image.

Le immagini vengono in genere usate nei flussi di lavoro che richiedono l'uso di un'immagine. Per la maggior parte dei flussi di lavoro, è consigliabile usare invece la classe per definire l'immagine Environment . È quindi possibile usare l'oggetto Environment con il Model deploy() metodo per distribuire il modello come servizio Web. È anche possibile usare il metodo Model package() per creare un'immagine che può essere scaricata nell'installazione docker locale come immagine o come Dockerfile.

Per una panoramica sulla distribuzione di modelli in Azure, vedere il collegamento seguente: https://aka.ms/azureml-how-deploy.

Metodi

add_properties	Aggiungere proprietà all'immagine.
add_tags	Aggiungere tag all'immagine.
create	Creare un'immagine nell'area di lavoro specificata.
delete	Eliminare un'immagine dall'area di lavoro corrispondente.
deserialize	Convertire un oggetto JSON in un oggetto Image.
image_configuration	Metodo astratto per la creazione di un oggetto di configurazione immagine.
list	Elencare le immagini associate all'area di lavoro corrispondente. Può essere filtrato con parametri specifici.
remove_tags	Rimuovere i tag dall'immagine.
serialize	Convertire questo oggetto Image in un dizionario serializzato JSON.
update	Aggiornare l'immagine.
update_creation_state	Aggiornare lo stato corrente dell'oggetto in memoria. Eseguire un aggiornamento sul posto delle proprietà dell'oggetto in base allo stato corrente dell'oggetto cloud corrispondente. Utile principalmente per il polling manuale dello stato di creazione.
wait_for_creation	Attendere il completamento della creazione dell'immagine. Attendere che la creazione dell'immagine raggiunga uno stato terminale. Genera un'eccezione WebserviceException se raggiunge uno stato terminale non riuscito.

add_properties

Aggiungere proprietà all'immagine.

add_properties(properties)

Parametri

Nome	Descrizione
properties Necessario	dict[str, str] Dizionario di proprietà da aggiungere.

Eccezioni

Tipo	Descrizione
WebserviceException

add_tags

Aggiungere tag all'immagine.

add_tags(tags)

Parametri

Nome	Descrizione
tags Necessario	dict[str, str] Dizionario di tag da aggiungere.

Eccezioni

Tipo	Descrizione
WebserviceException

create

Creare un'immagine nell'area di lavoro specificata.

static create(workspace, name, models, image_config)

Parametri

Nome	Descrizione
workspace Necessario	<xref:<xref:workspace: azureml.core.workspace.Workspace>> Area di lavoro da associare a questa immagine.
name Necessario	str Nome da associare all'immagine.
models Necessario	list[Model] Elenco di oggetti Model da creare in un pacchetto con questa immagine. Può essere un elenco vuoto.
image_config Necessario	ImageConfig Oggetto config immagine da usare per configurare questa immagine.

Restituisce

Tipo	Descrizione
Image	Oggetto Image creato.

Eccezioni

Tipo	Descrizione
WebserviceException

delete

Eliminare un'immagine dall'area di lavoro corrispondente.

delete()

Eccezioni

Tipo	Descrizione
WebserviceException

Commenti

Questo metodo ha esito negativo se l'immagine è stata distribuita in un servizio Web live.

deserialize

Convertire un oggetto JSON in un oggetto Image.

deserialize(workspace, image_payload)

Parametri

Nome	Descrizione
cls Necessario	Indica il metodo della classe.
workspace Necessario	Workspace Oggetto dell'area di lavoro in cui è registrato Image.
image_payload Necessario	dict Oggetto JSON da convertire in un oggetto Image.

Restituisce

Tipo	Descrizione
Image	Rappresentazione image dell'oggetto JSON fornito.

Eccezioni

Tipo	Descrizione
WebserviceException

Commenti

Questo metodo ha esito negativo se l'area di lavoro specificata non è l'area di lavoro in cui è registrata l'immagine.

image_configuration

Metodo astratto per la creazione di un oggetto di configurazione immagine.

abstract static image_configuration()

Eccezioni

Tipo	Descrizione
WebserviceException

list

Elencare le immagini associate all'area di lavoro corrispondente. Può essere filtrato con parametri specifici.

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

Parametri

Nome	Descrizione
workspace Necessario	Workspace Oggetto Workspace in cui elencare le immagini.
image_name	str Elenco di filtri per includere solo le immagini distribuite con il nome dell'immagine specifico. Valore predefinito: None
model_name	str Elenco di filtri per includere solo le immagini distribuite con il nome del modello specifico. Valore predefinito: None
model_id	str Elenco di filtri per includere solo le immagini distribuite con l'ID modello specifico. Valore predefinito: None
tags	list Filtra in base all'elenco specificato, in base a 'key' o '[key, value]'. Ex. ['key', ['key2', 'key2 value']] Valore predefinito: None
properties	list Filtra in base all'elenco specificato, in base a 'key' o '[key, value]'. Ex. ['key', ['key2', 'key2 value']] Valore predefinito: None

Restituisce

Tipo	Descrizione
list[<xref:Images>]	Elenco filtrato di immagini nell'area di lavoro specificata.

Eccezioni

Tipo	Descrizione
WebserviceException

remove_tags

Rimuovere i tag dall'immagine.

remove_tags(tags)

Parametri

Nome	Descrizione
tags Necessario	list[str] Elenco di chiavi corrispondenti ai tag da rimuovere.

Eccezioni

Tipo	Descrizione
WebserviceException

serialize

Convertire questo oggetto Image in un dizionario serializzato JSON.

serialize()

Restituisce

Tipo	Descrizione
dict	Rappresentazione JSON di questo oggetto Image.

Eccezioni

Tipo	Descrizione
WebserviceException

update

Aggiornare l'immagine.

update(tags)

Parametri

Nome	Descrizione
tags Necessario	dict[str, str] Dizionario di tag con cui aggiornare l'immagine. Sovrascriverà eventuali tag esistenti.

Eccezioni

Tipo	Descrizione
WebserviceException

update_creation_state

Aggiornare lo stato corrente dell'oggetto in memoria.

Eseguire un aggiornamento sul posto delle proprietà dell'oggetto in base allo stato corrente dell'oggetto cloud corrispondente. Utile principalmente per il polling manuale dello stato di creazione.

update_creation_state()

Eccezioni

Tipo	Descrizione
WebserviceException

wait_for_creation

Attendere il completamento della creazione dell'immagine.

Attendere che la creazione dell'immagine raggiunga uno stato terminale. Genera un'eccezione WebserviceException se raggiunge uno stato terminale non riuscito.

wait_for_creation(show_output=False)

Parametri

Nome	Descrizione
show_output	bool Opzione booleana per stampare un output più dettagliato. Il valore predefinito è False. Valore predefinito: False

Eccezioni

Tipo	Descrizione
WebserviceException