Image Klasse
Definiert die abstrakte übergeordnete Klasse für Azure Machine Learning-Images.
Diese Klasse ist VERALTET. Verwenden Sie stattdessen die Environment-Klasse.
Bildkonstruktor.
Diese Klasse ist VERALTET. Verwenden Sie stattdessen die Environment-Klasse.
Der Bildkonstruktor wird verwendet, um eine Clouddarstellung eines Image-Objekts abzurufen, das dem bereitgestellten Arbeitsbereich zugeordnet ist. Gibt eine Instanz einer untergeordneten Klasse zurück, die dem spezifischen Typ des abgerufenen Image-Objekts entspricht.
- Vererbung
-
Image
Konstruktor
Image(workspace, name=None, id=None, tags=None, properties=None, version=None)Parameter
| Name | Beschreibung |
|---|---|
|
workspace
Erforderlich
|
Arbeitsbereichsobjekt, das das abzurufende Image enthält |
|
name
|
Der Name des abzurufenden Images. Gibt die neueste Version des Images zurück (sofern vorhanden). Standardwert: None
|
|
id
|
Die spezifische ID des abzurufenden Images. (Die ID hat das Format „<Name>:<Version>“.) Standardwert: None
|
|
tags
|
Filtert Imageergebnisse basierend auf der bereitgestellten Liste, entweder nach „Schlüssel“ oder nach „[Schlüssel, Wert]“. Ex. ['Schlüssel', ['Schlüssel2', 'Wert von Schlüssel2']] Standardwert: None
|
|
properties
|
Filtert Imageergebnisse basierend auf der bereitgestellten Liste, entweder nach „Schlüssel“ oder nach „[Schlüssel, Wert]“. Ex. ['Schlüssel', ['Schlüssel2', 'Wert von Schlüssel2']] Standardwert: None
|
|
version
|
Wenn sowohl die Version als auch der Name angegeben sind, wird die spezifische Version des Images zurückgegeben. Standardwert: None
|
|
workspace
Erforderlich
|
Das Arbeitsbereichsobjekt, das das abzurufende Bild enthält |
|
name
Erforderlich
|
Der Name des abzurufenden Images. Gibt die neueste Version zurück, sofern vorhanden |
|
id
Erforderlich
|
Die spezifische ID des abzurufenden Images. (ID ist ":") |
|
tags
Erforderlich
|
Filtert Imageergebnisse basierend auf der bereitgestellten Liste, entweder nach „Schlüssel“ oder nach „[Schlüssel, Wert]“. Ex. ['Schlüssel', ['Schlüssel2', 'Wert von Schlüssel2']] |
|
properties
Erforderlich
|
Filtert Imageergebnisse basierend auf der bereitgestellten Liste, entweder nach „Schlüssel“ oder nach „[Schlüssel, Wert]“. Ex. ['Schlüssel', ['Schlüssel2', 'Wert von Schlüssel2']] |
|
version
Erforderlich
|
Wenn sowohl die Version als auch der Name angegeben sind, wird die spezifische Version des Images zurückgegeben. |
Hinweise
Der Image-Konstruktor ruft eine Clouddarstellung eines Image-Objekts ab, das dem bereitgestellten Arbeitsbereich zugeordnet ist. Er gibt eine Instanz einer untergeordneten Klasse zurück, die dem spezifischen Typ des abgerufenen Image-Objekts entspricht.
Ein Image-Objekt wird verwendet, um ein Modell (Model) der Benutzer als Webdienst (Webservice) bereitzustellen. Das Image-Objekt enthält in der Regel ein Modell, ein Ausführungsskript und alle Abhängigkeiten, die für die Modellimplementierung erforderlich sind. Die Image-Klasse verfügt über mehrere Unterklassen wie „ContainerImage“ für Docker-Images und Images wie FPGA.
Ein Beispiel für eine Klasse, die von der Image-Klasse erbt, finden Sie im Artikel zur ContainerImage-Klasse.
Images werden in der Regel in Workflows verwendet, die die Verwendung eines Images erfordern. Für die meisten Workflows sollten Sie stattdessen die Environment-Klasse verwenden, um Ihr Image zu definieren. Anschließend können Sie das Environment-Objekt mit der Model deploy() Methode verwenden, um das Modell als Webdienst bereitzustellen.
Sie können auch die Model-Methode package() verwenden, um ein Image zu erstellen, das als Image oder Dockerfile in Ihre lokale Docker-Installation heruntergeladen werden kann.
Eine Übersicht über die Bereitstellung von Modellen in Azure finden Sie unter https://aka.ms/azureml-how-deploy.
Methoden
| add_properties |
Fügen Sie dem Image Eigenschaften hinzu. |
| add_tags |
Fügen Sie dem Image Tags hinzu. |
| create |
Erstellen Sie ein Image im angegebenen Arbeitsbereich. |
| delete |
Löschen Sie ein Image aus dem entsprechenden Arbeitsbereich. |
| deserialize |
Konvertieren Sie ein JSON-Objekt in ein Image-Objekt. |
| image_configuration |
Abstrakte Methode zum Erstellen eines Imagekonfigurationsobjekts. |
| list |
Listen Sie die Images auf, die dem entsprechenden Arbeitsbereich zugeordnet sind. Kann mit bestimmten Parametern gefiltert werden. |
| remove_tags |
Entfernen Sie Tags aus dem Image. |
| serialize |
Konvertieren Sie dieses Image-Objekts in ein serialisiertes JSON-Wörterbuch. |
| update |
Aktualisieren Sie das Image. |
| update_creation_state |
Aktualisieren des aktuellen Zustands des In-Memory-Objekts. Führen Sie ein direktes Update der Eigenschaften des Objekts basierend auf dem aktuellen Zustand des entsprechenden Cloudobjekts durch. In erster Linie hilfreich zum manuellen Abruf des Erstellungsstatus. |
| wait_for_creation |
Warten Sie auf den Abschluss der Imageerstellung. Warten Sie, bis die Imageerstellung einen Endzustand erreicht. Löst eine Ausnahme vom Typ „WebserviceException“ aus, wenn kein erfolgreicher Endzustand erreicht wird. |
add_properties
Fügen Sie dem Image Eigenschaften hinzu.
add_properties(properties)Parameter
| Name | Beschreibung |
|---|---|
|
properties
Erforderlich
|
Ein Wörterbuch mit hinzuzufügenden Eigenschaften. |
Ausnahmen
| Typ | Beschreibung |
|---|---|
add_tags
Fügen Sie dem Image Tags hinzu.
add_tags(tags)Parameter
| Name | Beschreibung |
|---|---|
|
tags
Erforderlich
|
Ein Wörterbuch mit hinzuzufügenden Tags. |
Ausnahmen
| Typ | Beschreibung |
|---|---|
create
Erstellen Sie ein Image im angegebenen Arbeitsbereich.
static create(workspace, name, models, image_config)Parameter
| Name | Beschreibung |
|---|---|
|
workspace
Erforderlich
|
<xref:<xref:workspace: azureml.core.workspace.Workspace>>
Der Arbeitsbereich, der diesem Image zugeordnet werden soll. |
|
name
Erforderlich
|
Der Name, der diesem Image zugeordnet werden soll. |
|
models
Erforderlich
|
Eine Liste mit den Modellobjekten, die mit diesem Image gepackt werden sollen. Die Liste kann leer sein. |
|
image_config
Erforderlich
|
Die Imagekonfigurationsobjekt, das zum Konfigurieren dieses Images verwendet werden soll. |
Gibt zurück
| Typ | Beschreibung |
|---|---|
|
Das erstellte Image-Objekt. |
Ausnahmen
| Typ | Beschreibung |
|---|---|
delete
Löschen Sie ein Image aus dem entsprechenden Arbeitsbereich.
delete()Ausnahmen
| Typ | Beschreibung |
|---|---|
Hinweise
Diese Methode ist nicht erfolgreich, wenn das Image in einem Livewebdienst bereitgestellt wurde.
deserialize
Konvertieren Sie ein JSON-Objekt in ein Image-Objekt.
deserialize(workspace, image_payload)Parameter
| Name | Beschreibung |
|---|---|
|
cls
Erforderlich
|
Gibt die Klassenmethode an. |
|
workspace
Erforderlich
|
Das Arbeitsbereichsobjekt, unter dem das Image registriert ist. |
|
image_payload
Erforderlich
|
Ein JSON-Objekt, das in ein Image-Objekt konvertiert werden soll. |
Gibt zurück
| Typ | Beschreibung |
|---|---|
|
Die Image-Darstellung des bereitgestellten JSON-Objekts. |
Ausnahmen
| Typ | Beschreibung |
|---|---|
Hinweise
Diese Methode ist nicht erfolgreich, wenn der bereitgestellte Arbeitsbereich nicht der Arbeitsbereich ist, unter dem das Image registriert ist.
image_configuration
Abstrakte Methode zum Erstellen eines Imagekonfigurationsobjekts.
abstract static image_configuration()Ausnahmen
| Typ | Beschreibung |
|---|---|
list
Listen Sie die Images auf, die dem entsprechenden Arbeitsbereich zugeordnet sind. Kann mit bestimmten Parametern gefiltert werden.
static list(workspace, image_name=None, model_name=None, model_id=None, tags=None, properties=None)Parameter
| Name | Beschreibung |
|---|---|
|
workspace
Erforderlich
|
Arbeitsbereichsobjekt, in dem die Images aufgeführt werden sollen. |
|
image_name
|
Filtern Sie die Liste so, dass sie nur Images enthält, die mit dem spezifischen Imagenamen bereitgestellt wurden. Standardwert: None
|
|
model_name
|
Filtern Sie die Liste so, dass sie nur Images enthält, die mit dem spezifischen Modellnamen bereitgestellt wurden. Standardwert: None
|
|
model_id
|
Filtert die Liste so, dass sie nur Images enthält, die mit der spezifischen Modell-ID bereitgestellt wurden. Standardwert: None
|
|
tags
|
Filtert basierend auf der bereitgestellten Liste entweder nach „Schlüssel“ oder nach „[Schlüssel, Wert]“. Ex. ['Schlüssel', ['Schlüssel2', 'Wert von Schlüssel2']] Standardwert: None
|
|
properties
|
Filtert basierend auf der bereitgestellten Liste entweder nach „Schlüssel“ oder nach „[Schlüssel, Wert]“. Ex. ['Schlüssel', ['Schlüssel2', 'Wert von Schlüssel2']] Standardwert: None
|
Gibt zurück
| Typ | Beschreibung |
|---|---|
|
list[<xref:Images>]
|
Eine gefilterte Liste mit Images im bereitgestellten Arbeitsbereich. |
Ausnahmen
| Typ | Beschreibung |
|---|---|
remove_tags
Entfernen Sie Tags aus dem Image.
remove_tags(tags)Parameter
| Name | Beschreibung |
|---|---|
|
tags
Erforderlich
|
Eine Liste mit Schlüsseln, die den zu entfernenden Tags entsprechen. |
Ausnahmen
| Typ | Beschreibung |
|---|---|
serialize
Konvertieren Sie dieses Image-Objekts in ein serialisiertes JSON-Wörterbuch.
serialize()Gibt zurück
| Typ | Beschreibung |
|---|---|
|
Die JSON-Darstellung dieses Image-Objekts. |
Ausnahmen
| Typ | Beschreibung |
|---|---|
update
Aktualisieren Sie das Image.
update(tags)Parameter
| Name | Beschreibung |
|---|---|
|
tags
Erforderlich
|
Ein Wörterbuch mit Tags, mit denen das Image aktualisiert werden soll. Überschreibt alle vorhandenen Tags. |
Ausnahmen
| Typ | Beschreibung |
|---|---|
update_creation_state
Aktualisieren des aktuellen Zustands des In-Memory-Objekts.
Führen Sie ein direktes Update der Eigenschaften des Objekts basierend auf dem aktuellen Zustand des entsprechenden Cloudobjekts durch. In erster Linie hilfreich zum manuellen Abruf des Erstellungsstatus.
update_creation_state()Ausnahmen
| Typ | Beschreibung |
|---|---|
wait_for_creation
Warten Sie auf den Abschluss der Imageerstellung.
Warten Sie, bis die Imageerstellung einen Endzustand erreicht. Löst eine Ausnahme vom Typ „WebserviceException“ aus, wenn kein erfolgreicher Endzustand erreicht wird.
wait_for_creation(show_output=False)Parameter
| Name | Beschreibung |
|---|---|
|
show_output
|
Boolesche Option für eine ausführlichere Ausgabe. Der Standardwert lautet „False“. Standardwert: False
|
Ausnahmen
| Typ | Beschreibung |
|---|---|