Image Classe
Définit la classe parente abstraite pour Les images Azure Machine Learning.
Cette classe est DÉCONSEILLÉE. Utilisez plutôt la classe Environment.
Constructeur d’image.
Cette classe est DÉCONSEILLÉ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é.
Constructeur
Image(workspace, name=None, id=None, tags=None, properties=None, version=None)Paramètres
| Nom | Description |
|---|---|
|
workspace
Obligatoire
|
Objet Workspace contenant l’image à récupérer. |
|
name
|
Nom de l’image à récupérer. Retourne la dernière version de l’image, le cas échéant. 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 de l’image en fonction de la liste fournie, par « clé » ou « [clé, valeur] ». Ex. ['key', ['key2', 'key2 value']] Valeur par défaut: None
|
|
properties
|
Filtre les résultats de l’image en fonction de la liste fournie, par « clé » ou « [clé, valeur] ». Ex. ['key', ['key2', 'key2 value']] Valeur par défaut: None
|
|
version
|
Lorsque 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 «< name> :<version> ») |
|
tags
Obligatoire
|
Filtre les résultats de l’image en fonction de la liste fournie, par « clé » ou « [clé, valeur] ». Ex. ['key', ['key2', 'key2 value']] |
|
properties
Obligatoire
|
Filtre les résultats de l’image en fonction de la liste fournie, par « clé » ou « [clé, valeur] ». Ex. ['key', ['key2', 'key2 value']] |
|
version
Obligatoire
|
Lorsque la version et le nom sont tous les deux spécifiés, retourne la version spécifique de l’image. |
Remarques
Le constructeur d’image récupère une représentation cloud d’un objet Image associé à l’espace de travail fourni. Elle retourne une instance d’une classe enfant correspondant au type spécifique de l’objet Image récupéré.
Un objet Image est utilisé pour déployer les données d’un Model 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 pour le déploiement de modèle. La classe Image comporte plusieurs sous-classes telles que ContainerImage pour les images Docker et des images comme FPGA.
Consultez la ContainerImage classe pour obtenir un exemple de classe qui hérite de la classe Image.
Les images sont généralement utilisées dans les flux de travail qui nécessitent l’utilisation d’une image. Pour la plupart des flux de travail, vous devez utiliser plutôt la Environment classe pour définir votre image. Vous pouvez ensuite utiliser l’objet Environnement avec la Modeldeploy() méthode pour déployer le modèle en tant que service web.
Vous pouvez également utiliser la méthode Model 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 fichier Dockerfile.
Consultez le lien suivant pour obtenir une vue d’ensemble du déploiement de modèles dans Azure : https://aka.ms/azureml-how-deploy
Méthodes
| add_properties |
Ajoutez des propriétés à l’image. |
| add_tags |
Ajoutez des balises à l’image. |
| create |
Créez une image dans l’espace de travail fourni. |
| delete |
Supprimez une image de son espace de travail correspondant. |
| deserialize |
Convertissez un objet json en objet Image. |
| image_configuration |
Méthode abstraite pour la création d’un objet de configuration d’image. |
| list |
Répertoriez les images associées à l’espace de travail correspondant. Peut être filtré avec des paramètres spécifiques. |
| remove_tags |
Supprimez les balises de l’image. |
| serialize |
Convertissez cet objet Image en dictionnaire sérialisé JSON. |
| update |
Mettez à jour l’image. |
| update_creation_state |
Actualisez l’état actuel de l’objet en mémoire. Effectuez une mise à jour sur place des propriétés de l’objet en fonction de l’état actuel de l’objet cloud correspondant. Principalement utile pour l’interrogation manuelle de l’état de création. |
| wait_for_creation |
Attendez que l’image termine la création. Attendez que la création d’images atteigne un état terminal. Lève une exception WebserviceException si elle atteint un état terminal non réussi. |
add_properties
Ajoutez 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
Ajoutez des balises à l’image.
add_tags(tags)Paramètres
| Nom | Description |
|---|---|
|
tags
Obligatoire
|
Dictionnaire de balises à ajouter. |
Exceptions
| Type | Description |
|---|---|
create
Créez 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 des objets Model à empaqueter 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
Supprimez 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 en direct.
deserialize
Convertissez 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 image de l’objet JSON fourni. |
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()list
Répertoriez 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 répertorier les images. |
|
image_name
|
Filtrez la liste pour inclure uniquement les images déployées avec le nom d’image spécifique. Valeur par défaut: None
|
|
model_name
|
Filtrez 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
|
Liste de filtres 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 « clé » ou « [clé, valeur] ». Ex. ['key', ['key2', 'key2 value']] Valeur par défaut: None
|
|
properties
|
Filtre en fonction de la liste fournie, par « clé » ou « [clé, valeur] ». Ex. ['key', ['key2', 'key2 value']] Valeur par défaut: None
|
Retours
| Type | Description |
|---|---|
|
list[<xref:Images>]
|
Liste filtrée d’images dans l’espace de travail fourni. |
Exceptions
| Type | Description |
|---|---|
remove_tags
Supprimez les balises de l’image.
remove_tags(tags)Paramètres
| Nom | Description |
|---|---|
|
tags
Obligatoire
|
Liste des clés correspondant aux balises à supprimer. |
Exceptions
| Type | Description |
|---|---|
serialize
Convertissez cet objet Image en dictionnaire sérialisé JSON.
serialize()Retours
| Type | Description |
|---|---|
|
Représentation JSON de cet objet Image. |
update
Mettez à jour l’image.
update(tags)Paramètres
| Nom | Description |
|---|---|
|
tags
Obligatoire
|
Dictionnaire de balises avec utilisant l’image. Remplace toutes les balises existantes. |
Exceptions
| Type | Description |
|---|---|
update_creation_state
Actualisez l’état actuel de l’objet en mémoire.
Effectuez une mise à jour sur place des propriétés de l’objet en fonction de l’état actuel de l’objet cloud correspondant. Principalement utile pour l’interrogation manuelle de l’état de création.
update_creation_state()Exceptions
| Type | Description |
|---|---|
wait_for_creation
Attendez que l’image termine la création.
Attendez que la création d’images atteigne un état terminal. Lève une exception WebserviceException si elle atteint un état terminal non réussi.
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 |
|---|---|