AmlComputeProvisioningConfiguration Classe

  • Référence

Représente les paramètres de configuration pour le provisionnement des cibles AmlCompute.

Utilisez la méthode provisioning_configuration de la classe AmlCompute pour spécifier les paramètres de configuration.

Créez un objet de configuration pour l’approvisionnement d’une cible AmlCompute.

Héritage
ComputeTargetProvisioningConfiguration
AmlComputeProvisioningConfiguration

Constructeur

AmlComputeProvisioningConfiguration(vm_size='', vm_priority='dedicated', min_nodes=0, max_nodes=None, idle_seconds_before_scaledown=1800, admin_username=None, admin_user_password=None, admin_user_ssh_key=None, vnet_resourcegroup_name=None, vnet_name=None, subnet_name=None, tags=None, description=None, remote_login_port_public_access='NotSpecified', identity_type=None, identity_id=None, compute_location=None, enable_node_public_ip=True)

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. Si la valeur n’est pas spécifiée, la valeur par défaut est Standard_NC6.
vm_priority
str

Priorité de la machine virtuelle : « dedicated » ou « lowpriority ». Si la valeur n’est pas spécifiée, la valeur par défaut est « dédié ».

Valeur par défaut: dedicated
min_nodes
int

Nombre minimal de nœuds à utiliser sur le cluster. Si la valeur n’est pas spécifiée, la valeur par défaut est 0.

Valeur par défaut: 0
max_nodes
int

Nombre maximal de nœuds à utiliser sur le cluster. La valeur par défaut est 4.

Valeur par défaut: None
idle_seconds_before_scaledown
int

Durée d’inactivité du nœud, en secondes, avant le scale-down du cluster. Si la valeur n’est pas spécifiée, la valeur par défaut est 1800.

Valeur par défaut: 1800
admin_username
str

Nom du compte d’utilisateur administrateur qui peut être utilisé pour établir une connexion SSH à des nœuds.

Valeur par défaut: None
admin_user_password
str

Mot de passe du compte d’utilisateur administrateur.

Valeur par défaut: None
admin_user_ssh_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 des étiquettes de valeur de clé à fournir à l’objet de calcul.

Valeur par défaut: None
description
str

Description de l’objet de calcul.

Valeur par défaut: None
remote_login_port_public_access
str

État du port SSH public. Les valeurs possibles sont les suivantes :

  • Disabled : indique que le port SSH public est fermé sur tous les nœuds du cluster.

  • Enabled : indique que le port SSH public est ouvert sur tous les nœuds du cluster.

  • NotSpecified : indique que le port SSH public est fermé sur tous les nœuds du cluster si le réseau virtuel est défini, sinon il est ouvert sur tous les nœuds publics. Cette valeur par défaut peut être utilisée uniquement lors de la création du cluster. Après sa création, la valeur est enabled (activé) ou disabled (désactivé).

Valeur par défaut: NotSpecified
identity_type
string

Les valeurs possibles sont les suivantes :

  • SystemAssigned : identité attribuée par le système

  • UserAssigned : identité attribuée par l’utilisateur. Requiert la définition d’un ID d’identité.

Valeur par défaut: None
identity_id
list[str]

Liste des ID de ressource pour l’identité affectée à l’utilisateur. par exemple ['/subscriptions//resourceGroups//providers/Microsoft.ManagedIdentity /userAssignedIdentities/']

Valeur par défaut: None
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. Si la valeur n’est pas spécifiée, la valeur par défaut est Standard_NC6.
vm_priority
Obligatoire
str

Priorité de la machine virtuelle : « dedicated » ou « lowpriority ». Si la valeur n’est pas spécifiée, la valeur par défaut est « dédié ».
min_nodes
Obligatoire
int

Nombre minimal de nœuds à utiliser sur le cluster. Si la valeur n’est pas spécifiée, la valeur par défaut est 0.
max_nodes
Obligatoire
int

Nombre maximal de nœuds à utiliser sur le cluster. La valeur par défaut est 4.
idle_seconds_before_scaledown
Obligatoire
int

Durée d’inactivité du nœud, en secondes, avant le scale-down du cluster. Si la valeur n’est pas spécifiée, la valeur par défaut est 1800.
admin_username
Obligatoire
str

Nom du compte d’utilisateur administrateur qui peut être utilisé pour établir une connexion SSH à des nœuds.
admin_user_password
Obligatoire
str

Mot de passe du compte d’utilisateur administrateur.
admin_user_ssh_key
Obligatoire
str

Clé publique SSH du compte d’utilisateur administrateur.
vnet_resourcegroup_name
Obligatoire
str

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

nom du réseau virtuel.
subnet_name
Obligatoire
str

Nom du sous-réseau dans le réseau virtuel.
tags
Obligatoire
dict[str, str]

Dictionnaire des étiquettes de valeur de clé à fournir à l’objet de calcul.
description
Obligatoire
str

Description de l’objet de calcul.
remote_login_port_public_access
Obligatoire
str

État du port SSH public. Les valeurs possibles sont les suivantes :

  • Disabled : indique que le port SSH public est fermé sur tous les nœuds du cluster.

  • Enabled : indique que le port SSH public est ouvert sur tous les nœuds du cluster.

  • NotSpecified : indique que le port SSH public est fermé sur tous les nœuds du cluster si le réseau virtuel est défini, sinon il est ouvert sur tous les nœuds publics. Il s'agit de la valeur par défaut. L’état peut être dans cette valeur par défaut uniquement au moment de la création du cluster. Après sa création, la valeur est enabled (activé) ou disabled (désactivé).
identity_type
Obligatoire
string

Les valeurs possibles sont les suivantes :

  • SystemAssigned : identité attribuée par le système

  • UserAssigned : identité attribuée par l’utilisateur. Requiert la définition d’un ID d’identité.
identity_id
Obligatoire
list[str]

Liste des ID de ressource pour l’identité affectée à l’utilisateur. par exemple ['/subscriptions//resourceGroups//providers/Microsoft.ManagedIdentity /userAssignedIdentities/']
compute_location
str

Emplacement dans lequel approvisionner le cluster.

Valeur par défaut: None
enable_node_public_ip
bool

Active l’adresse IP publique du nœud. Les valeurs possibles sont les suivantes :

  • True - activer l’adresse IP publique du nœud.

  • False - désactiver l’adresse IP publique du nœud.

  • NotSpecified - activer l’adresse IP publique du nœud.

Valeur par défaut: True

Méthodes

validate_configuration

Vérifie que les valeurs de configuration spécifiées sont valides.

Déclenche un ComputeTargetException si la validation échoue.

validate_configuration

Vérifie que les valeurs de configuration spécifiées sont valides.

Déclenche un ComputeTargetException si la validation échoue.

validate_configuration()

Exceptions

Type Description
ComputeTargetException