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

workspace

Workspace

Obligatoire

Objet de l’espace de travail contenant l’objet de calcul à récupérer.

name

str

Obligatoire

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

wait_for_completion

valeur par défaut: False

show_output

valeur par défaut: False

Exceptions

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

workspace

Workspace

Obligatoire

Objet de l’espace de travail auquel l’objet ComputeInstance est associé.

object_dict

dict

Obligatoire

Objet JSON à convertir en objet ComputeInstance.

Retours

Représentation ComputeInstance de l’objet JSON fourni.

Type de retour

ComputeInstance

Exceptions

ComputeTargetException

detach

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

detach()

Exceptions

ComputeTargetException

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

get

Retourne l’objet ComputeInstance.

get()

Retours

Représentation ComputeInstance de l’objet JSON fourni.

Type de retour

ComputeInstance

Exceptions

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

type

str

valeur par défaut: None

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.

tags

str ou dict

valeur par défaut: None

Le filtre s’exécute par "balise" ou {"tag": "value"}

properties

str ou dict

valeur par défaut: None

Le filtre s’exécute par "propriété" ou {"property": "value"}

status

str

valeur par défaut: None

État de l’exécution, peut être « en cours d’exécution » ou « en file d’attente ».

Retours

Générateur de azureml._restclient.models.RunDto

Type de retour

<xref:builtin.generator>

Exceptions

ComputeTargetException

get_docs_url

URL de la documentation pour cette classe.

get_docs_url()

Retours

url

Type de retour

str

Exceptions

ComputeTargetException

get_status

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

get_status()

Retours

Objet d’état détaillé pour le calcul

Type de retour

ComputeInstanceStatus

Exceptions

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

vm_size

str

Obligatoire

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

valeur par défaut: False

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.

admin_user_ssh_public_key

str

valeur par défaut: None

Clé publique SSH du compte d’utilisateur administrateur.

vnet_resourcegroup_name

str

valeur par défaut: None

Nom du groupe de ressources dans lequel se trouve le réseau virtuel.

vnet_name

str

valeur par défaut: None

nom du réseau virtuel.

subnet_name

str

valeur par défaut: None

Nom du sous-réseau dans le réseau virtuel.

tags

dict[str, str]

valeur par défaut: None

Dictionnaire facultatif de balises clé-valeur à associer à l’objet de calcul.

description

str

valeur par défaut: None

Description facultative de l’objet Compute.

assigned_user_object_id

str

valeur par défaut: None

ID d’objet AAD de l’utilisateur attribué (préversion).

assigned_user_tenant_id

str

valeur par défaut: None

ID de locataire AAD de l’utilisateur attribué (préversion).

Retours

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

Type de retour

ComputeInstanceProvisioningConfiguration

Exceptions

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

ComputeTargetException

restart

Redémarre l’objet ComputeInstance.

restart(wait_for_completion=False, show_output=False)

Paramètres

wait_for_completion

bool

valeur par défaut: False

Valeur booléenne à utiliser pour attendre la mise à jour de l’état. Valeur par défaut False.

show_output

bool

valeur par défaut: False

Valeur booléenne à utiliser pour fournir une sortie plus détaillée. Valeur par défaut False.

Retours

None

Type de retour

None

Exceptions

azureml.exceptions.ComputeTargetException:

serialize

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

serialize()

Retours

Représentation JSON de cet objet ComputeInstance.

Type de retour

dict

Exceptions

ComputeTargetException

start

Démarre l’objet ComputeInstance.

start(wait_for_completion=False, show_output=False)

Paramètres

wait_for_completion

bool

valeur par défaut: False

Indique s’il faut attendre la mise à jour de l’état. Valeur par défaut False.

show_output

bool

valeur par défaut: False

Indique s’il faut fournir une sortie plus détaillée. Valeur par défaut False.

Retours

None

Type de retour

None

Exceptions

ComputeTargetException

stop

Arrête l’objet ComputeInstance.

stop(wait_for_completion=False, show_output=False)

Paramètres

wait_for_completion

bool

valeur par défaut: False

Indique s’il faut attendre la mise à jour de l’état. Valeur par défaut False.

show_output

bool

valeur par défaut: False

Indique s’il faut fournir une sortie plus détaillée. Valeur par défaut False.

Retours

None

Type de retour

None

Exceptions

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

workspace

Workspace

Obligatoire

Espace de travail.

location

str

valeur par défaut: None

Emplacement de l’instance. S’il n’est pas spécifié, l’emplacement par défaut est celui de l’espace de travail.

Retours

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.

Type de retour

list

Exceptions

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

show_output

bool

valeur par défaut: False

Indique s’il faut fournir une sortie plus détaillée. Valeur par défaut False.

is_delete_operation

bool

valeur par défaut: False

Indique si l’opération est destinée à être supprimée.

Exceptions

ComputeTargetException