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
|
Nome dell'immagine da recuperare. Restituisce la versione più recente dell'immagine, se esistente. Valore predefinito: None
|
|
id
|
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
|
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
|
Nome dell'immagine da recuperare. Restituisce la versione più recente, se esistente |
|
id
Necessario
|
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
|
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
|
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
|
Elenco di filtri per includere solo le immagini distribuite con il nome dell'immagine specifico. Valore predefinito: None
|
|
model_name
|
Elenco di filtri per includere solo le immagini distribuite con il nome del modello specifico. Valore predefinito: None
|
|
model_id
|
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 |
|---|---|