Partager via


Image Classe

Définit la classe parente abstraite des images Azure Machine Learning.

Cette classe est DÉPRÉCIÉE. Utilisez plutôt la classe Environment.

Constructeur d’image.

Cette classe est DÉPRÉCIÉE. Utilisez plutôt la classe Environment.

Le constructeur d’image est utilisé pour récupérer une représentation cloud d’un objet Image associé à l’espace de travail fourni. Retourne une instance d’une classe enfant correspondant au type spécifique de l’objet Image récupéré.

Héritage
Image

Constructeur

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

Paramètres

Nom Description
workspace
Obligatoire

Objet d’espace de travail contenant l’image à récupérer.

name
str

Nom de l’image à récupérer. Retourne la dernière version de l’image, si elle existe.

Valeur par défaut: None
id
str

ID spécifique de l’image à récupérer. (L’ID est "<name>:<version>")

Valeur par défaut: None
tags

Filtre les résultats d’image en fonction de la liste fournie, par « key » ou « [key, value] ». Ex. ['key', ['key2', 'key2 value']]

Valeur par défaut: None
properties

Filtre les résultats d’image en fonction de la liste fournie, par « key » ou « [key, value] ». Ex. ['key', ['key2', 'key2 value']]

Valeur par défaut: None
version
str

Quand la version et le nom sont tous les deux spécifiés, retourne la version spécifique de l’image.

Valeur par défaut: None
workspace
Obligatoire

Objet d’espace de travail contenant l’image à récupérer

name
Obligatoire
str

Nom de l’image à récupérer. Retourne la dernière version, le cas échéant

id
Obligatoire
str

ID spécifique de l’image à récupérer. (L’ID est « : »)

tags
Obligatoire

Filtre les résultats d’image en fonction de la liste fournie, par « key » ou « [key, value] ». Ex. ['key', ['key2', 'key2 value']]

properties
Obligatoire

Filtre les résultats d’image en fonction de la liste fournie, par « key » ou « [key, value] ». Ex. ['key', ['key2', 'key2 value']]

version
Obligatoire
str

Quand la version et le nom sont tous les deux spécifiés, retourne la version spécifique de l’image.

Remarques

Le constructeur de Image récupère une représentation cloud d’un objet Image associé à l’espace de travail fourni. Il retourne une instance d’une classe enfant correspondant au type spécifique de l’objet Image récupéré.

Un objet Image permet de déployer le Model d’un utilisateur en tant que Webservice. L’objet Image contient généralement un modèle, un script d’exécution et toutes les dépendances nécessaires au déploiement du modèle. La classe Image a plusieurs sous-classes telles que ContainerImage pour les images Docker et des images telles que FPGA.

Consultez la classe ContainerImage pour obtenir un exemple de classe qui hérite de la classe Image.

Les images sont généralement utilisées dans les workflows qui nécessitent l’utilisation d’une image. Dans la plupart des workflows, utilisez à la place la classe Environment pour définir votre image. Vous pouvez ensuite utiliser l’objet Environnement avec la Model deploy() méthode pour déployer le modèle en tant que service web. Vous pouvez également utiliser la méthode package() de Model pour créer une image qui peut être téléchargée sur votre installation Docker locale sous forme d’image ou de fichier Dockerfile.

Pour obtenir une vue d’ensemble du déploiement de modèles dans Azure, consultez le lien suivant : https://aka.ms/azureml-how-deploy.

Méthodes

add_properties

Ajoute des propriétés à l’image.

add_tags

Ajoute des étiquettes à l’image.

create

Crée une image dans l’espace de travail fourni.

delete

Supprime une image de son espace de travail correspondant.

deserialize

Convertit un objet JSON en objet Image.

image_configuration

Méthode abstraite pour la création d’un objet de configuration d’image.

list

Liste les images associées à l’espace de travail correspondant. Peut être filtré avec des paramètres spécifiques.

remove_tags

Supprime les étiquettes de l’image.

serialize

Convertit cet objet Image en dictionnaire sérialisé JSON.

update

Met à jour l’image.

update_creation_state

Actualise l’état actuel de l’objet en mémoire.

Effectue une mise à jour sur place des propriétés de l’objet en fonction de l’état actuel de l’objet cloud correspondant. Sert principalement à interroger manuellement l’état de la création.

wait_for_creation

Attend la fin de la création de l’image.

Attend que la création de l’image atteigne un état terminal. Lève WebserviceException si l’état terminal atteint est un échec.

add_properties

Ajoute des propriétés à l’image.

add_properties(properties)

Paramètres

Nom Description
properties
Obligatoire

Dictionnaire de propriétés à ajouter.

Exceptions

Type Description

add_tags

Ajoute des étiquettes à l’image.

add_tags(tags)

Paramètres

Nom Description
tags
Obligatoire

Dictionnaire d’étiquettes à ajouter.

Exceptions

Type Description

create

Crée une image dans l’espace de travail fourni.

static create(workspace, name, models, image_config)

Paramètres

Nom Description
workspace
Obligatoire
<xref:<xref:workspace: azureml.core.workspace.Workspace>>

Espace de travail à associer à cette image.

name
Obligatoire
str

Nom à associer à cette image.

models
Obligatoire

Liste d’objets Model à packager avec cette image. Il peut s’agir d’une liste vide.

image_config
Obligatoire

Objet de configuration d’image à utiliser pour configurer cette image.

Retours

Type Description

Objet Image créé.

Exceptions

Type Description

delete

Supprime une image de son espace de travail correspondant.

delete()

Exceptions

Type Description

Remarques

Cette méthode échoue si l’image a été déployée sur un service web actif.

deserialize

Convertit un objet JSON en objet Image.

deserialize(workspace, image_payload)

Paramètres

Nom Description
cls
Obligatoire

Indique la méthode de classe.

workspace
Obligatoire

Objet d’espace de travail sous lequel l’image est inscrite.

image_payload
Obligatoire

Objet JSON à convertir en objet Image.

Retours

Type Description

Représentation sous forme d’objet Image de l’objet JSON fourni.

Exceptions

Type Description

Remarques

Cette méthode échoue si l’espace de travail fourni n’est pas l’espace de travail sous lequel l’image est inscrite.

image_configuration

Méthode abstraite pour la création d’un objet de configuration d’image.

abstract static image_configuration()

Exceptions

Type Description

list

Liste les images associées à l’espace de travail correspondant. Peut être filtré avec des paramètres spécifiques.

static list(workspace, image_name=None, model_name=None, model_id=None, tags=None, properties=None)

Paramètres

Nom Description
workspace
Obligatoire

Objet Workspace dans lequel lister les images.

image_name
str

Filtre la liste pour inclure uniquement les images déployées avec le nom d’image spécifique.

Valeur par défaut: None
model_name
str

Filtre la liste pour inclure uniquement les images déployées avec le nom de modèle spécifique.

Valeur par défaut: None
model_id
str

Filtre la liste pour inclure uniquement les images déployées avec l’ID de modèle spécifique.

Valeur par défaut: None
tags

Filtre en fonction de la liste fournie, par « key » ou « [key, value] ». Ex. ['key', ['key2', 'key2 value']]

Valeur par défaut: None
properties

Filtre en fonction de la liste fournie, par « key » ou « [key, value] ». Ex. ['key', ['key2', 'key2 value']]

Valeur par défaut: None

Retours

Type Description
list[<xref:Images>]

Liste filtrée des Images dans l’espace de travail fourni.

Exceptions

Type Description

remove_tags

Supprime les étiquettes de l’image.

remove_tags(tags)

Paramètres

Nom Description
tags
Obligatoire

Liste de clés correspondant aux étiquettes à supprimer.

Exceptions

Type Description

serialize

Convertit cet objet Image en dictionnaire sérialisé JSON.

serialize()

Retours

Type Description

Représentation JSON de cet objet Image.

Exceptions

Type Description

update

Met à jour l’image.

update(tags)

Paramètres

Nom Description
tags
Obligatoire

Dictionnaire d’étiquettes avec lesquelles mettre à jour l’image. Remplace toutes les étiquettes existantes.

Exceptions

Type Description

update_creation_state

Actualise l’état actuel de l’objet en mémoire.

Effectue une mise à jour sur place des propriétés de l’objet en fonction de l’état actuel de l’objet cloud correspondant. Sert principalement à interroger manuellement l’état de la création.

update_creation_state()

Exceptions

Type Description

wait_for_creation

Attend la fin de la création de l’image.

Attend que la création de l’image atteigne un état terminal. Lève WebserviceException si l’état terminal atteint est un échec.

wait_for_creation(show_output=False)

Paramètres

Nom Description
show_output

Option booléenne permettant d’afficher une sortie plus détaillée. Valeur par défaut False.

Valeur par défaut: False

Exceptions

Type Description