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 einen instance 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
- str
Der Name des abzurufenden Images. Gibt die neueste Version des Images zurück (sofern vorhanden).
- id
- str
Die spezifische ID des abzurufenden Images. (Die ID hat das Format „<Name>:<Version>“.)
- tags
- list
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
- list
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
- str
Wenn sowohl die Version als auch der Name angegeben sind, wird die spezifische Version des Images zurückgegeben.
- name
- str
Der Name des abzurufenden Images. Gibt die neueste Version zurück, sofern vorhanden
- tags
- list
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
- list
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
- str
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 Umgebungsobjekt mit der deploy()-Methode von Model 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
Ausnahmen
add_tags
Fügen Sie dem Image Tags hinzu.
add_tags(tags)Parameter
Ausnahmen
create
Erstellen Sie ein Image im angegebenen Arbeitsbereich.
static create(workspace, name, models, image_config)Parameter
- workspace
- <xref:<xref:workspace: azureml.core.workspace.Workspace>>
Der Arbeitsbereich, der diesem Image zugeordnet werden soll.
Eine Liste mit den Modellobjekten, die mit diesem Image gepackt werden sollen. Die Liste kann leer sein.
- image_config
- ImageConfig
Die Imagekonfigurationsobjekt, das zum Konfigurieren dieses Images verwendet werden soll.
Gibt zurück
Das erstellte Image-Objekt.
Rückgabetyp
Ausnahmen
delete
Löschen Sie ein Image aus dem entsprechenden Arbeitsbereich.
delete()Ausnahmen
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
- cls
Gibt die Klassenmethode an.
Gibt zurück
Die Image-Darstellung des bereitgestellten JSON-Objekts.
Rückgabetyp
Ausnahmen
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
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
- image_name
- str
Filtern Sie die Liste so, dass sie nur Images enthält, die mit dem spezifischen Imagenamen bereitgestellt wurden.
- model_name
- str
Filtern Sie die Liste so, dass sie nur Images enthält, die mit dem spezifischen Modellnamen bereitgestellt wurden.
- model_id
- str
Filtert die Liste so, dass sie nur Images enthält, die mit der spezifischen Modell-ID bereitgestellt wurden.
- tags
- list
Filtert basierend auf der bereitgestellten Liste entweder nach „Schlüssel“ oder nach „[Schlüssel, Wert]“. Ex. ['Schlüssel', ['Schlüssel2', 'Wert von Schlüssel2']]
- properties
- list
Filtert basierend auf der bereitgestellten Liste entweder nach „key“ oder nach „[key, value]“. Ex. ['Schlüssel', ['Schlüssel2', 'Wert von Schlüssel2']]
Gibt zurück
Eine gefilterte Liste mit Images im bereitgestellten Arbeitsbereich.
Rückgabetyp
Ausnahmen
remove_tags
Entfernen Sie Tags aus dem Image.
remove_tags(tags)Parameter
Ausnahmen
serialize
Konvertieren Sie dieses Image-Objekts in ein serialisiertes JSON-Wörterbuch.
serialize()Gibt zurück
Die JSON-Darstellung dieses Image-Objekts.
Rückgabetyp
Ausnahmen
update
Aktualisieren Sie das Image.
update(tags)Parameter
Ein Wörterbuch mit Tags, mit denen das Image aktualisiert werden soll. Überschreibt alle vorhandenen Tags.
Ausnahmen
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
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
- show_output
- bool
Boolesche Option für eine ausführlichere Ausgabe. Der Standardwert lautet „False“.
Ausnahmen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für