ComputeInstance Classe

Gère un environnement de développement ML optimisé basé sur le cloud dans Azure Machine Learning.

Une instance de calcul Azure Machine Learning est un environnement de développement entièrement configuré et managé dans le cloud, qui est optimisé pour les workflows de développement de Machine Learning. ComputeInstance est généralement utilisé pour créer un environnement de développement, ou en tant que cible de calcul pour l’apprentissage et en tant qu’inférence pour le développement et les tests. Avec ComputeInstance, vous pouvez créer, effectuer l’apprentissage et déployer des modèles dans le cadre d’une expérience de notebook entièrement intégrée dans votre espace de travail. Pour plus d’informations, consultez Qu’est-ce qu’une instance de calcul Azure Machine Learning ?

Constructeur ComputeTarget de classe.

Récupérez une représentation cloud d’un objet Compute associé à l’espace de travail fourni. Renvoie une instance d’une classe enfant correspondant au type spécifique de l’objet Compute récupéré.

Héritage

ComputeTarget

ComputeInstance

Constructeur

ComputeInstance(workspace, name)

Paramètres

Nom	Description
workspace Obligatoire	Workspace Objet de l’espace de travail contenant l’objet de calcul à récupérer.
name Obligatoire	str Nom de l’objet Compute à récupérer.

Méthodes

delete	Supprime l’objet ComputeInstance de l’espace de travail associé.
deserialize	Convertit un objet JSON en objet ComputeInstance. Cette opération échoue si l’espace de travail fourni n’est pas l’espace de travail associé à ComputeInstance.
detach	Le détachement n’est pas pris en charge pour l’objet ComputeInstance. Utilisez delete à la place.
get	Retourne l’objet ComputeInstance.
get_active_runs	Retourne un générateur des exécutions pour ce calcul.
get_docs_url	URL de la documentation pour cette classe.
get_status	Récupère l’état détaillé actuel de ComputeInstance.
provisioning_configuration	Crée un objet de configuration pour approvisionner une cible ComputeInstance.
refresh_state	Effectue une mise à jour sur place des propriétés de l’objet. Cette méthode met à jour les propriétés en fonction de l’état actuel de l’objet cloud correspondant. Surtout utile pour l’interrogation manuelle de l’état de calcul.
restart	Redémarre l’objet ComputeInstance.
serialize	Convertit cet objet ComputeInstance en dictionnaire JSON sérialisé.
start	Démarre l’objet ComputeInstance.
stop	Arrête l’objet ComputeInstance.
supported_vmsizes	Répertorie les tailles de machines virtuelles prises en charge dans une région.
wait_for_completion	Attend la fin de la configuration de l’objet ComputeInstance.

delete

Supprime l’objet ComputeInstance de l’espace de travail associé.

delete(wait_for_completion=False, show_output=False)

Paramètres

Nom	Description
wait_for_completion	Valeur par défaut: False
show_output	Valeur par défaut: False

Exceptions

Type	Description
ComputeTargetException

Remarques

Si cet objet a été créé via Azure Machine Learning, les objets cloud correspondants sont également supprimés. Si cet objet a été créé en externe et attaché uniquement à l’espace de travail, il déclenche une exception et aucune modification n’est apportée.

deserialize

Convertit un objet JSON en objet ComputeInstance.

Cette opération échoue si l’espace de travail fourni n’est pas l’espace de travail associé à ComputeInstance.

static deserialize(workspace, object_dict)

Paramètres

Nom	Description
workspace Obligatoire	Workspace Objet de l’espace de travail auquel l’objet ComputeInstance est associé.
object_dict Obligatoire	dict Objet JSON à convertir en objet ComputeInstance.

Retours

Type	Description
ComputeInstance	Représentation ComputeInstance de l’objet JSON fourni.

Exceptions

Type	Description
ComputeTargetException

detach

Le détachement n’est pas pris en charge pour l’objet ComputeInstance. Utilisez delete à la place.

detach()

Exceptions

Type	Description
ComputeTargetException	L'opération n'est pas prise en charge.

get

Retourne l’objet ComputeInstance.

get()

Retours

Type	Description
ComputeInstance	Représentation ComputeInstance de l’objet JSON fourni.

Exceptions

Type	Description
ComputeTargetException

get_active_runs

Retourne un générateur des exécutions pour ce calcul.

get_active_runs(type=None, tags=None, properties=None, status=None)

Paramètres

Nom	Description
type	str Filtre le générateur d’exécutions renvoyé par le type fourni. Consultez add_type_provider pour la création de types d’exécution. Valeur par défaut: None
tags	str ou dict Le filtre s’exécute par "balise" ou {"tag": "value"} Valeur par défaut: None
properties	str ou dict Le filtre s’exécute par "propriété" ou {"property": "value"} Valeur par défaut: None
status	str État de l’exécution, peut être « en cours d’exécution » ou « en file d’attente ». Valeur par défaut: None

Retours

Type	Description
<xref:builtin.generator>	Générateur de azureml._restclient.models.RunDto

Exceptions

Type	Description
ComputeTargetException

get_docs_url

URL de la documentation pour cette classe.

get_docs_url()

Retours

Type	Description
str	url

Exceptions

Type	Description
ComputeTargetException

get_status

Récupère l’état détaillé actuel de ComputeInstance.

get_status()

Retours

Type	Description
ComputeInstanceStatus	Objet d’état détaillé pour le calcul

Exceptions

Type	Description
ComputeTargetException

provisioning_configuration

Crée un objet de configuration pour approvisionner une cible ComputeInstance.

static provisioning_configuration(vm_size='', ssh_public_access=False, admin_user_ssh_public_key=None, vnet_resourcegroup_name=None, vnet_name=None, subnet_name=None, tags=None, description=None, assigned_user_object_id=None, assigned_user_tenant_id=None)

Paramètres

Nom	Description
vm_size Obligatoire	str Taille des machines virtuelles de l’agent. Vous trouverez plus d’informations ici : https://aka.ms/azureml-vm-details. Notez que toutes les tailles ne sont pas disponibles dans toutes les régions, comme indiqué dans le lien précédent. La valeur par défaut est Standard_NC6.
ssh_public_access	bool Indique l’état du port SSH public. Les valeurs possibles sont les suivantes : False : le port SSH public est fermé. True : le port SSH public est ouvert. Valeur par défaut: False
admin_user_ssh_public_key	str Clé publique SSH du compte d’utilisateur administrateur. Valeur par défaut: None
vnet_resourcegroup_name	str Nom du groupe de ressources dans lequel se trouve le réseau virtuel. Valeur par défaut: None
vnet_name	str nom du réseau virtuel. Valeur par défaut: None
subnet_name	str Nom du sous-réseau dans le réseau virtuel. Valeur par défaut: None
tags	dict[str, str] Dictionnaire facultatif de balises clé-valeur à associer à l’objet de calcul. Valeur par défaut: None
description	str Description facultative de l’objet Compute. Valeur par défaut: None
assigned_user_object_id	str ID d’objet AAD de l’utilisateur attribué (préversion). Valeur par défaut: None
assigned_user_tenant_id	str ID de locataire AAD de l’utilisateur attribué (préversion). Valeur par défaut: None

Retours

Type	Description
ComputeInstanceProvisioningConfiguration	Objet de configuration à utiliser au moment de la création d’un objet Compute.

Exceptions

Type	Description
ComputeTargetException

refresh_state

Effectue une mise à jour sur place des propriétés de l’objet.

Cette méthode met à jour les propriétés en fonction de l’état actuel de l’objet cloud correspondant. Surtout utile pour l’interrogation manuelle de l’état de calcul.

refresh_state()

Exceptions

Type	Description
ComputeTargetException

restart

Redémarre l’objet ComputeInstance.

restart(wait_for_completion=False, show_output=False)

Paramètres

Nom	Description
wait_for_completion	bool Valeur booléenne à utiliser pour attendre la mise à jour de l’état. Valeur par défaut False. Valeur par défaut: False
show_output	bool Valeur booléenne à utiliser pour fournir une sortie plus détaillée. Valeur par défaut False. Valeur par défaut: False

Retours

Type	Description
None	Aucun

Exceptions

Type	Description
azureml.exceptions.ComputeTargetException:

serialize

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

serialize()

Retours

Type	Description
dict	Représentation JSON de cet objet ComputeInstance.

Exceptions

Type	Description
ComputeTargetException

start

Démarre l’objet ComputeInstance.

start(wait_for_completion=False, show_output=False)

Paramètres

Nom	Description
wait_for_completion	bool Indique s’il faut attendre la mise à jour de l’état. Valeur par défaut False. Valeur par défaut: False
show_output	bool Indique s’il faut fournir une sortie plus détaillée. Valeur par défaut False. Valeur par défaut: False

Retours

Type	Description
None	None

Exceptions

Type	Description
ComputeTargetException

stop

Arrête l’objet ComputeInstance.

stop(wait_for_completion=False, show_output=False)

Paramètres

Nom	Description
wait_for_completion	bool Indique s’il faut attendre la mise à jour de l’état. Valeur par défaut False. Valeur par défaut: False
show_output	bool Indique s’il faut fournir une sortie plus détaillée. Valeur par défaut False. Valeur par défaut: False

Retours

Type	Description
None	None

Exceptions

Type	Description
ComputeTargetException

supported_vmsizes

Répertorie les tailles de machines virtuelles prises en charge dans une région.

static supported_vmsizes(workspace, location=None)

Paramètres

Nom	Description
workspace Obligatoire	Workspace Espace de travail.
location	str Emplacement de l’instance. S’il n’est pas spécifié, l’emplacement par défaut est celui de l’espace de travail. Valeur par défaut: None

Retours

Type	Description
list	Liste des tailles de machines virtuelles prises en charge dans une région avec le nom de la machine virtuelle, les processeurs virtuels et la RAM.

Exceptions

Type	Description
ComputeTargetException

wait_for_completion

Attend la fin de la configuration de l’objet ComputeInstance.

wait_for_completion(show_output=False, is_delete_operation=False)

Paramètres

Nom	Description
show_output	bool Indique s’il faut fournir une sortie plus détaillée. Valeur par défaut False. Valeur par défaut: False
is_delete_operation	bool Indique si l’opération est destinée à être supprimée. Valeur par défaut: False

Exceptions

Type	Description
ComputeTargetException