Partager via

AmlComputeProvisioningConfiguration Classe

Représente les paramètres de configuration pour l’approvisionnement des cibles AmlCompute.

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

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

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

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

Valeur par défaut: dedicated
min_nodes
int

Nombre minimal de nœuds à utiliser sur le cluster. Si ce n’est pas spécifié, 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

Temps d’inactivité du nœud en secondes avant le scale-down du cluster. S’il n’est pas spécifié, 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 ssh dans 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 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 de balises de valeur clé à fournir à l’objet de calcul.

Valeur par défaut: None
description
str

Description à fournir à 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 :

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

  • Activé : 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 tous les nœuds publics sont ouverts. Il peut s’agir de cette valeur par défaut uniquement pendant le temps de création du cluster. Après la création, elle sera activée ou désactivée.

Valeur par défaut: NotSpecified
identity_type
string

Les valeurs possibles sont les suivantes :

  • SystemAssigned - Identité affectée par le système

  • UserAssigned - Identité affectée par l’utilisateur. Nécessite la définition de l’ID d’identité.

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

Liste des ID de ressource pour l’identité affectée par l’utilisateur. Eg. ['/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. S’il n’est pas spécifié, la valeur par défaut est Standard_NC6.
vm_priority
Obligatoire
str

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

Nombre minimal de nœuds à utiliser sur le cluster. Si ce n’est pas spécifié, 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

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

Nom du compte d’utilisateur administrateur qui peut être utilisé pour ssh dans 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 où se trouve le réseau virtuel.
vnet_name
Obligatoire
str

nom du réseau virtuel.
subnet_name
Obligatoire
str

Nom du sous-réseau à l’intérieur du réseau virtuel.
tags
Obligatoire
dict[str, str]

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

Description à fournir à l’objet de calcul.
remote_login_port_public_access
Obligatoire
str

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

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

  • Activé : 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 tous les nœuds publics sont ouverts. Il s’agit de la valeur par défaut. L’état peut être dans cette valeur par défaut uniquement pendant la durée de création du cluster. Après la création, elle sera activée ou désactivée.
identity_type
Obligatoire
string

Les valeurs possibles sont les suivantes :

  • SystemAssigned - Identité affectée par le système

  • UserAssigned - Identité affectée par l’utilisateur. Nécessite la définition de l’ID d’identité.
identity_id
Obligatoire
list[str]

Liste des ID de ressource pour l’identité affectée par l’utilisateur. Eg. ['/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

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

  • True : activez l’adresse IP publique du nœud.

  • False : désactivez 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érifiez que les valeurs de configuration spécifiées sont valides.

Déclenche une validation en cas d’échec ComputeTargetException .

validate_configuration

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

Déclenche une validation en cas d’échec ComputeTargetException .

validate_configuration()

Exceptions

Type Description
ComputeTargetException