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
| 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, si elle existe |
|
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 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
| 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 de balises à 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. Peut être 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
|
Applique un filtre en fonction de la liste fournie, selon les paramètres « key » ou « [key, value] ». Ex. ['key', ['key2', 'key2 value']] valeur par défaut: None
|
|
properties
|
Applique un filtre en fonction de la liste fournie, selon les paramètres « 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 pour imprimer une sortie plus détaillée. Valeur par défaut False. valeur par défaut: False
|
Exceptions
| Type | Description |
|---|---|
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