Partager via

ComputeInstance Classe

  • Référence

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