Image Classe

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

Questa classe è DEPRECATA. Utilizzare invece la classe Environment.

Costruttore di immagini.

Questa classe è DEPRECATA. Utilizzare invece la classe Environment.

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

Ereditarietà
Image

Costruttore

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

Parametri

workspace
Workspace
Necessario

Oggetto Workspace contenente l'immagine da recuperare.

name
str
valore predefinito: None

Nome dell'immagine da recuperare. Restituisce la versione più recente dell'immagine, se esistente.

id
str
valore predefinito: None

ID specifico dell'immagine da recuperare. (ID è "<name>:<version>")

tags
list
valore predefinito: None

Filtra i risultati dell'immagine in base all'elenco fornito, in base a 'key' o '[key, value]'. Ex. ['key', ['key2', 'key2 value']]

properties
list
valore predefinito: None

Filtra i risultati dell'immagine in base all'elenco fornito, in base a 'key' o '[key, value]'. Ex. ['key', ['key2', 'key2 value']]

version
str
valore predefinito: None

Quando la versione e il nome sono entrambi specificati, restituirà la versione specifica dell'immagine.

workspace
Workspace
Necessario

Oggetto dell'area di lavoro contenente l'immagine da recuperare

name
str
Necessario

Nome dell'immagine da recuperare. Restituirà la versione più recente, se esistente

id
str
Necessario

ID specifico dell'immagine da recuperare. (ID è ":")

tags
list
Necessario

Filtra i risultati dell'immagine in base all'elenco fornito, in base a 'key' o '[key, value]'. Ex. ['key', ['key2', 'key2 value']]

properties
list
Necessario

Filtra i risultati dell'immagine in base all'elenco fornito, in base a 'key' o '[key, value]'. Ex. ['key', ['key2', 'key2 value']]

version
str
Necessario

Quando la versione e il nome sono entrambi specificati, 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 le dipendenze necessarie per la distribuzione del modello. La classe Image include più sottoclassi, ad esempio ContainerImage per 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, è invece consigliabile usare la classe per definire l'immagine Environment . È quindi possibile usare l'oggetto Environment con il metodo per distribuire il Modeldeploy() 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.

Vedere il collegamento seguente per una panoramica sulla distribuzione di modelli in Azure: 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 dell'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. Principalmente utile per il polling manuale dello stato di creazione.

wait_for_creation

Attendere il completamento della creazione dell'immagine.

Attendere che la creazione di immagini raggiunga uno stato del terminale. Genera un'eccezione WebserviceException se raggiunge uno stato del terminale non riuscito.

add_properties

Aggiungere proprietà all'immagine.

add_properties(properties)

Parametri

properties
dict[str, str]
Necessario

Dizionario delle proprietà da aggiungere.

Eccezioni

add_tags

Aggiungere tag all'immagine.

add_tags(tags)

Parametri

tags
dict[str, str]
Necessario

Dizionario di tag da aggiungere.

Eccezioni

create

Creare un'immagine nell'area di lavoro specificata.

static create(workspace, name, models, image_config)

Parametri

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

Area di lavoro da associare a questa immagine.

name
str
Necessario

Nome da associare all'immagine.

models
list[Model]
Necessario

Elenco di oggetti Model da creare in pacchetto con questa immagine. Può essere un elenco vuoto.

image_config
ImageConfig
Necessario

Oggetto config immagine da usare per configurare questa immagine.

Restituisce

Oggetto Image creato.

Tipo restituito

Eccezioni

delete

Eliminare un'immagine dall'area di lavoro corrispondente.

delete()

Eccezioni

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

cls
Necessario

Indica il metodo di classe.

workspace
Workspace
Necessario

L'oggetto area di lavoro in cui è registrato Image.

image_payload
dict
Necessario

Oggetto JSON da convertire in un oggetto Image.

Restituisce

Rappresentazione image dell'oggetto JSON specificato.

Tipo restituito

Eccezioni

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 dell'immagine.

abstract static image_configuration()

Eccezioni

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

workspace
Workspace
Necessario

Oggetto Workspace in cui elencare le immagini.

image_name
str
valore predefinito: None

Elenco di filtri per includere solo immagini distribuite con il nome dell'immagine specifico.

model_name
str
valore predefinito: None

Elenco di filtri per includere solo immagini distribuite con il nome del modello specifico.

model_id
str
valore predefinito: None

Elenco di filtri per includere solo immagini distribuite con l'ID modello specifico.

tags
list
valore predefinito: None

Filtra in base all'elenco specificato, in base a 'key' o '[key, value]'. Ex. ['key', ['key2', 'key2 value']]

properties
list
valore predefinito: None

Filtra in base all'elenco specificato, in base a 'key' o '[key, value]'. Ex. ['key', ['key2', 'key2 value']]

Restituisce

Elenco filtrato di immagini nell'area di lavoro fornita.

Tipo restituito

list[<xref:Images>]

Eccezioni

remove_tags

Rimuovere i tag dall'immagine.

remove_tags(tags)

Parametri

tags
list[str]
Necessario

Elenco di chiavi corrispondenti ai tag da rimuovere.

Eccezioni

serialize

Convertire questo oggetto Image in un dizionario serializzato JSON.

serialize()

Restituisce

Rappresentazione JSON di questo oggetto Image.

Tipo restituito

Eccezioni

update

Aggiornare l'immagine.

update(tags)

Parametri

tags
dict[str, str]
Necessario

Dizionario di tag con cui aggiornare l'immagine. Sovrascriverà tutti i tag esistenti.

Eccezioni

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. Principalmente utile per il polling manuale dello stato di creazione.

update_creation_state()

Eccezioni

wait_for_creation

Attendere il completamento della creazione dell'immagine.

Attendere che la creazione di immagini raggiunga uno stato del terminale. Genera un'eccezione WebserviceException se raggiunge uno stato del terminale non riuscito.

wait_for_creation(show_output=False)

Parametri

show_output
bool
valore predefinito: False

Opzione booleana per stampare un output più dettagliato. Il valore predefinito è False.

Eccezioni