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 géré dans le cloud optimisé pour les flux de travail de développement Machine Learning. ComputeInstance est généralement utilisé pour créer un environnement de développement ou comme cible de calcul pour l’apprentissage et l’inférence pour le développement et les tests. Avec un ComputeInstance, vous pouvez créer, entraîner et déployer des modèles dans 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. Retourne une instance d’une classe enfant correspondant au type spécifique de l’objet Compute récupéré.

Constructeur

ComputeInstance(workspace, name)

Paramètres

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

Méthodes

delete	Supprimez l’objet ComputeInstance de son espace de travail associé.
deserialize	Convertissez un objet JSON en objet ComputeInstance. Cela é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 de cette classe.
get_status	Récupérez l’état détaillé actuel de ComputeInstance.
provisioning_configuration	Créez un objet de configuration pour l’approvisionnement d’une cible ComputeInstance.
refresh_state	Effectuez 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. Cela est principalement utile pour l’interrogation manuelle de l’état de calcul.
restart	Redémarrez ComputeInstance.
serialize	Convertissez cet objet ComputeInstance en dictionnaire sérialisé JSON.
start	Démarrez ComputeInstance.
stop	Arrêtez ComputeInstance.
supported_vmsizes	Répertoriez les tailles de machine virtuelle prises en charge dans une région.
update_sso_settings	Mettez à jour les paramètres d’authentification unique de l’instance de calcul.
wait_for_completion	Attendez que computeInstance termine l’approvisionnement.

delete

Supprimez l’objet ComputeInstance de son 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 ML, les objets cloud correspondants sont également supprimés. Si cet objet a été créé en externe et attaché uniquement à l’espace de travail, il génère une exception et rien ne sera modifié.

deserialize

Convertissez un objet JSON en objet ComputeInstance.

Cela é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 L’objet d’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 supprotée.

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 Filtrez le générateur retourné d’exécutions par le type fourni. Voir add_type_provider pour créer des types d’exécution. Valeur par défaut: None
tags	str ou dict Filtre s’exécute par « tag » ou {« tag » : « value »} Valeur par défaut: None
properties	str ou dict Filtre s’exécute par « property » ou {« property » : « value »} Valeur par défaut: None
status	str L’é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

get_docs_url

URL de la documentation de cette classe.

get_docs_url()

Retours

Type	Description
str	URL

get_status

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

get_status()

Retours

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

provisioning_configuration

Créez un objet de configuration pour l’approvisionnement d’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 où 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 à l’intérieur du réseau virtuel. Valeur par défaut: None
tags	dict[str, str] Dictionnaire facultatif de balises de valeur clé à associer à l’objet de calcul. Valeur par défaut: None
description	str Description facultative de l’objet de calcul. Valeur par défaut: None
assigned_user_object_id	str ID d’objet AAD de l’utilisateur affecté (préversion). Valeur par défaut: None
assigned_user_tenant_id	str ID de locataire AAD de l’utilisateur affecté (préversion). Valeur par défaut: None

Retours

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

Exceptions

Type	Description
ComputeTargetException

refresh_state

Effectuez 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. Cela est principalement utile pour l’interrogation manuelle de l’état de calcul.

refresh_state()

restart

Redémarrez ComputeInstance.

restart(wait_for_completion=False, show_output=False)

Paramètres

Nom	Description
wait_for_completion	bool Boolean pour attendre la mise à jour de l’état. Valeur par défaut False. Valeur par défaut: False
show_output	bool Boolean 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

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

serialize()

Retours

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

start

Démarrez 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	Aucun

Exceptions

Type	Description
ComputeTargetException

stop

Arrêtez 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	Aucun

Exceptions

Type	Description
ComputeTargetException

supported_vmsizes

Répertoriez les tailles de machine virtuelle 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é, la valeur par défaut est l’emplacement de l’espace de travail. Valeur par défaut: None

Retours

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

update_sso_settings

Mettez à jour les paramètres d’authentification unique de l’instance de calcul.

update_sso_settings(value)

Paramètres

Nom	Description
value Obligatoire	bool Valeur des paramètres d’authentification unique

Retours

Type	Description
bool	Indique si la mise à jour a réussi ou non

wait_for_completion

Attendez que computeInstance termine l’approvisionnement.

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 à la suppression. Valeur par défaut: False

Exceptions

Type	Description
ComputeTargetException

Commentaires

Cette page a-t-elle été utile ?

Partager via

ComputeInstance Classe

Constructeur

Paramètres

Méthodes

delete

Paramètres

Exceptions

Remarques

deserialize

Paramètres

Retours

Exceptions

detach

Exceptions

get

Retours

Exceptions

get_active_runs

Paramètres

Retours

get_docs_url

Retours

get_status

Retours

provisioning_configuration

Paramètres

Retours

Exceptions

refresh_state

restart

Paramètres

Retours

Exceptions

serialize

Retours

start

Paramètres

Retours

Exceptions

stop

Paramètres

Retours

Exceptions

supported_vmsizes

Paramètres

Retours

update_sso_settings

Paramètres

Retours

wait_for_completion

Paramètres

Exceptions

Commentaires