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 |
---|---|
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per