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
|
Nom de l’image à récupérer. Retourne la dernière version de l’image, si elle existe. Valeur par défaut: None
|
|
id
|
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
|
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
|
Nom de l’image à récupérer. Retourne la dernière version, le cas échéant |
|
id
Obligatoire
|
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
|
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
|
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
|
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
|
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
|
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 |
|---|---|