Share via

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

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

vm_priority
str
valeur par défaut: dedicated

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
int
valeur par défaut: 0

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
int
valeur par défaut: None

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

idle_seconds_before_scaledown
int
valeur par défaut: 1800

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
str
valeur par défaut: None

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

admin_user_password
str
valeur par défaut: None

Mot de passe du compte d’utilisateur administrateur.

admin_user_ssh_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 des étiquettes de valeur de clé à fournir à l’objet de calcul.

description
str
valeur par défaut: None

Description de l’objet de calcul.

remote_login_port_public_access
str
valeur par défaut: NotSpecified

É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é).

identity_type
string
valeur par défaut: None

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
list[str]
valeur par défaut: None

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

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

vm_priority
str
Obligatoire

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
int
Obligatoire

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
int
Obligatoire

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

idle_seconds_before_scaledown
int
Obligatoire

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
str
Obligatoire

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

admin_user_password
str
Obligatoire

Mot de passe du compte d’utilisateur administrateur.

admin_user_ssh_key
str
Obligatoire

Clé publique SSH du compte d’utilisateur administrateur.

vnet_resourcegroup_name
str
Obligatoire

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

vnet_name
str
Obligatoire

nom du réseau virtuel.

subnet_name
str
Obligatoire

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

tags
dict[str, str]
Obligatoire

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

description
str
Obligatoire

Description de l’objet de calcul.

remote_login_port_public_access
str
Obligatoire

É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
string
Obligatoire

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
list[str]
Obligatoire

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

compute_location
str
valeur par défaut: None

Emplacement dans lequel approvisionner le cluster.

enable_node_public_ip
bool
valeur par défaut: True

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.

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

ComputeTargetException