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à
Image

Costruttore

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

Parametri

Nome Descrizione
workspace
Necessario

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

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

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

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

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

properties
Necessario

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

Dizionario di proprietà da aggiungere.

Eccezioni

Tipo Descrizione

add_tags

Aggiungere tag all'immagine.

add_tags(tags)

Parametri

Nome Descrizione
tags
Necessario

Dizionario di tag da aggiungere.

Eccezioni

Tipo Descrizione

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

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

image_config
Necessario

Oggetto config immagine da usare per configurare questa immagine.

Restituisce

Tipo Descrizione

Oggetto Image creato.

Eccezioni

Tipo Descrizione

delete

Eliminare un'immagine dall'area di lavoro corrispondente.

delete()

Eccezioni

Tipo Descrizione

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

Oggetto dell'area di lavoro in cui è registrato Image.

image_payload
Necessario

Oggetto JSON da convertire in un oggetto Image.

Restituisce

Tipo Descrizione

Rappresentazione image dell'oggetto JSON fornito.

Eccezioni

Tipo Descrizione

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

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

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

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

Valore predefinito: None
properties

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

remove_tags

Rimuovere i tag dall'immagine.

remove_tags(tags)

Parametri

Nome Descrizione
tags
Necessario

Elenco di chiavi corrispondenti ai tag da rimuovere.

Eccezioni

Tipo Descrizione

serialize

Convertire questo oggetto Image in un dizionario serializzato JSON.

serialize()

Restituisce

Tipo Descrizione

Rappresentazione JSON di questo oggetto Image.

Eccezioni

Tipo Descrizione

update

Aggiornare l'immagine.

update(tags)

Parametri

Nome Descrizione
tags
Necessario

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

Eccezioni

Tipo Descrizione

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

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

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

Valore predefinito: False

Eccezioni

Tipo Descrizione