AmlComputeProvisioningConfiguration Klasse

  • Referenz

Stellt Konfigurationsparameter für die Bereitstellung von AmlCompute-Zielen dar.

Verwenden Sie die provisioning_configuration-Methode der AmlCompute-Klasse, um Konfigurationsparameter anzugeben.

Erstellen Sie ein Konfigurationsobjekt für die Bereitstellung eines AmlCompute-Ziels.

Vererbung
ComputeTargetProvisioningConfiguration
AmlComputeProvisioningConfiguration

Konstruktor

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)

Parameter

Name Beschreibung
vm_size
Erforderlich
str

Die Größe von Agent-VMs. Weitere Informationen finden Sie hier: https://aka.ms/azureml-vm-details. Beachten Sie, dass nicht alle Größen in allen Regionen verfügbar sind, wie im zuvor verlinkten Artikel beschrieben. Wenn keine Angabe erfolgt, wird standardmäßig Standard_NC6 verwendet.
vm_priority
str

Die VM-Priorität; entweder „dedicated“ oder „lowpriority“ VMs. Wenn keine Angabe erfolgt, wird der Standardwert „dedicated“ verwendet.

Standardwert: dedicated
min_nodes
int

Die Mindestanzahl von Knoten, die im Cluster verwendet werden. Ohne Angabe wird standardmäßig „0“ verwendet.

Standardwert: 0
max_nodes
int

Die maximale Anzahl von Knoten, die im Cluster verwendet werden. Der Standardwert ist 4.

Standardwert: None
idle_seconds_before_scaledown
int

Die Leerlaufzeit des Knotens, nach der der Cluster herunterskaliert wird (in Sekunden). Ohne Angabe wird standardmäßig „1800“ verwendet.

Standardwert: 1800
admin_username
str

Der Name des Administratorbenutzerkontos, das für die SSH-Verbindung mit Knoten verwendet werden kann.

Standardwert: None
admin_user_password
str

Das Kennwort des Administratorbenutzerkontos.

Standardwert: None
admin_user_ssh_key
str

Der öffentliche SSH-Schlüssel des Administrator-Benutzerkontos.

Standardwert: None
vnet_resourcegroup_name
str

Der Name der Ressourcengruppe, in der sich das virtuelle Netzwerk befindet.

Standardwert: None
vnet_name
str

Den Namen des virtuellen Netzwerks.

Standardwert: None
subnet_name
str

Der Name des Subnetzes innerhalb des VNet.

Standardwert: None
tags
dict[str, str]

Ein Wörterbuch mit Schlüsselwerttags, die für das Computeobjekt bereitgestellt werden sollen.

Standardwert: None
description
str

Eine Beschreibung für das Computeobjekt.

Standardwert: None
remote_login_port_public_access
str

Der Status des öffentlichen SSH-Ports. Mögliche Werte:

  • Disabled: Gibt an, dass der öffentliche SSH-Port auf allen Knoten im Cluster geschlossen ist.

  • Enabled: Gibt an, dass der öffentliche SSH-Port auf allen Knoten im Cluster geöffnet ist.

  • NotSpecified: Gibt an, dass der öffentliche SSH-Port auf allen Knoten im Cluster geschlossen ist, wenn das VNet definiert ist. Andernfalls sind alle öffentlichen Knoten geöffnet. Dieser Standardwert kann nur während der Clustererstellung vorhanden sein. Nach der Erstellung lautet er entweder „enabled“ oder „disabled“.

Standardwert: NotSpecified
identity_type
string

Mögliche Werte:

  • SystemAssigned: Systemseitig zugewiesene Identität

  • UserAssigned: Benutzerseitig zugewiesene Identität. Erfordert das Festlegen der Identitäts-ID.

Standardwert: None
identity_id
list[str]

Liste der Ressourcen-IDs für die benutzerseitig zugewiesene Identität. Beispiel: ['/subscriptions//resourceGroups//providers/Microsoft.ManagedIdentity /userAssignedIdentities/']

Standardwert: None
vm_size
Erforderlich
str

Die Größe von Agent-VMs. Weitere Informationen finden Sie hier: https://aka.ms/azureml-vm-details. Beachten Sie, dass nicht alle Größen in allen Regionen verfügbar sind, wie im zuvor verlinkten Artikel beschrieben. Wenn keine Angabe erfolgt, wird standardmäßig Standard_NC6 verwendet.
vm_priority
Erforderlich
str

Die VM-Priorität; entweder „dedicated“ oder „lowpriority“ VMs. Wenn keine Angabe erfolgt, wird der Standardwert „dedicated“ verwendet.
min_nodes
Erforderlich
int

Die Mindestanzahl von Knoten, die im Cluster verwendet werden. Ohne Angabe wird standardmäßig „0“ verwendet.
max_nodes
Erforderlich
int

Die maximale Anzahl von Knoten, die im Cluster verwendet werden. Der Standardwert ist 4.
idle_seconds_before_scaledown
Erforderlich
int

Die Leerlaufzeit des Knotens, nach der der Cluster herunterskaliert wird (in Sekunden). Ohne Angabe wird standardmäßig „1800“ verwendet.
admin_username
Erforderlich
str

Der Name des Administratorbenutzerkontos, das für die SSH-Verbindung mit Knoten verwendet werden kann.
admin_user_password
Erforderlich
str

Das Kennwort des Administratorbenutzerkontos.
admin_user_ssh_key
Erforderlich
str

Der öffentliche SSH-Schlüssel des Administrator-Benutzerkontos.
vnet_resourcegroup_name
Erforderlich
str

Der Name der Ressourcengruppe, in der sich das virtuelle Netzwerk befindet.
vnet_name
Erforderlich
str

Den Namen des virtuellen Netzwerks.
subnet_name
Erforderlich
str

Der Name des Subnetzes innerhalb des VNet.
tags
Erforderlich
dict[str, str]

Ein Wörterbuch mit Schlüsselwerttags, die für das Computeobjekt bereitgestellt werden sollen.
description
Erforderlich
str

Eine Beschreibung für das Computeobjekt.
remote_login_port_public_access
Erforderlich
str

Der Status des öffentlichen SSH-Ports. Mögliche Werte:

  • Disabled: Gibt an, dass der öffentliche SSH-Port auf allen Knoten im Cluster geschlossen ist.

  • Enabled: Gibt an, dass der öffentliche SSH-Port auf allen Knoten im Cluster geöffnet ist.

  • NotSpecified: Gibt an, dass der öffentliche SSH-Port auf allen Knoten im Cluster geschlossen ist, wenn das VNet definiert ist. Andernfalls sind alle öffentlichen Knoten geöffnet. Dies ist der Standardwert. Der Zustand kann nur während der Clustererstellungszeit in diesem Standardwert enthalten sein. Nach der Erstellung lautet er entweder „enabled“ oder „disabled“.
identity_type
Erforderlich
string

Mögliche Werte:

  • SystemAssigned: Systemseitig zugewiesene Identität

  • UserAssigned: Benutzerseitig zugewiesene Identität. Erfordert das Festlegen der Identitäts-ID.
identity_id
Erforderlich
list[str]

Liste der Ressourcen-IDs für die benutzerseitig zugewiesene Identität. Beispiel: ['/subscriptions//resourceGroups//providers/Microsoft.ManagedIdentity /userAssignedIdentities/']
compute_location
str

Der Speicherort, an dem der Cluster bereitgestellt werden soll.

Standardwert: None
enable_node_public_ip
bool

Aktivieren der öffentliche IP-Adresse des Knotens. Mögliche Werte:

  • True: Aktiviert die öffentliche IP-Adresse des Knotens.

  • False: Deaktiviert die öffentliche IP-Adresse des Knotens.

  • NotSpecified: Aktiviert die öffentliche IP-Adresse des Knotens.

Standardwert: True

Methoden

validate_configuration

Überprüft, ob die angegebenen Konfigurationswerte gültig sind

Löst eine ComputeTargetException aus, wenn die Überprüfung zu einem Fehler führt

validate_configuration

Überprüft, ob die angegebenen Konfigurationswerte gültig sind

Löst eine ComputeTargetException aus, wenn die Überprüfung zu einem Fehler führt

validate_configuration()

Ausnahmen

Typ Beschreibung
ComputeTargetException