Image Classe
Définit la classe parente abstraite pour les 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
- name
- str
Nom de l’image à récupérer. Retourne la dernière version de l’image, si elle existe.
- tags
- list
Filtre les résultats d’image en fonction de la liste fournie, par « key » ou « [key, value] ». Ex. ['key', ['key2', 'key2 value']]
- properties
- list
Filtre les résultats d’image en fonction de la liste fournie, par « key » ou « [key, value] ». Ex. ['key', ['key2', 'key2 value']]
- version
- str
Quand la version et le nom sont tous les deux spécifiés, retourne la version spécifique de l’image.
- tags
- list
Filtre les résultats d’image en fonction de la liste fournie, par « key » ou « [key, value] ». Ex. ['key', ['key2', 'key2 value']]
- properties
- list
Filtre les résultats d’image en fonction de la liste fournie, par « key » ou « [key, value] ». Ex. ['key', ['key2', 'key2 value']]
- version
- 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 d’environnement avec la méthode Modeldeploy() pour déployer le modèle en tant que service Web.
Vous pouvez également utiliser la méthode de modèle package() pour créer une image qui peut être téléchargée sur votre installation Docker locale en tant qu’image ou en tant que 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
Exceptions
add_tags
Ajoute des étiquettes à l’image.
add_tags(tags)Paramètres
Exceptions
create
Crée une image dans l’espace de travail fourni.
static create(workspace, name, models, image_config)Paramètres
- workspace
- <xref:<xref:workspace: azureml.core.workspace.Workspace>>
Espace de travail à associer à cette image.
Liste d’objets Model à packager avec cette image. Peut être une liste vide.
- image_config
- ImageConfig
Objet de configuration d’image à utiliser pour configurer cette image.
Retours
Objet Image créé.
Type de retour
Exceptions
delete
Supprime une image de son espace de travail correspondant.
delete()Exceptions
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
- cls
Indique la méthode de classe.
Retours
Représentation sous forme d’objet Image de l’objet JSON fourni.
Type de retour
Exceptions
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
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
- image_name
- str
Filtre la liste pour inclure uniquement les images déployées avec le nom d’image spécifique.
- model_name
- str
Filtre la liste pour inclure uniquement les images déployées avec le nom de modèle spécifique.
- model_id
- str
Filtre la liste pour inclure uniquement les images déployées avec l’ID de modèle spécifique.
- tags
- list
Applique un filtre en fonction de la liste fournie, selon les paramètres « key » ou « [key, value] ». Ex. ['key', ['key2', 'key2 value']]
- properties
- list
Applique un filtre en fonction de la liste fournie, selon les paramètres « key » ou « [key, value] ». Ex. ['key', ['key2', 'key2 value']]
Retours
Liste filtrée des Images dans l’espace de travail fourni.
Type de retour
Exceptions
remove_tags
Supprime les étiquettes de l’image.
remove_tags(tags)Paramètres
Exceptions
serialize
Convertit cet objet Image en dictionnaire sérialisé JSON.
serialize()Retours
Représentation JSON de cet objet Image.
Type de retour
Exceptions
update
Met à jour l’image.
update(tags)Paramètres
Dictionnaire d’étiquettes avec lesquelles mettre à jour l’image. Remplace toutes les étiquettes existantes.
Exceptions
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
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
- show_output
- bool
Option booléenne pour imprimer une sortie plus détaillée. Valeur par défaut False.
Exceptions
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour