AmlComputeProvisioningConfiguration Klasse

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

vm_size
str
Erforderlich

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
Standardwert: dedicated

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

min_nodes
int
Standardwert: 0

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

max_nodes
int
Standardwert: None

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

idle_seconds_before_scaledown
int
Standardwert: 1800

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

admin_username
str
Standardwert: None

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

admin_user_password
str
Standardwert: None

Das Kennwort des Administratorbenutzerkontos.

admin_user_ssh_key
str
Standardwert: None

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

vnet_resourcegroup_name
str
Standardwert: None

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

vnet_name
str
Standardwert: None

Den Namen des virtuellen Netzwerks.

subnet_name
str
Standardwert: None

Der Name des Subnetzes innerhalb des VNet.

tags
dict[str, str]
Standardwert: None

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

description
str
Standardwert: None

Eine Beschreibung für das Computeobjekt.

remote_login_port_public_access
str
Standardwert: NotSpecified

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“.

identity_type
string
Standardwert: None

Mögliche Werte:

  • SystemAssigned: Systemseitig zugewiesene Identität

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

identity_id
list[str]
Standardwert: None

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

vm_size
str
Erforderlich

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
Erforderlich

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

min_nodes
int
Erforderlich

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

max_nodes
int
Erforderlich

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

idle_seconds_before_scaledown
int
Erforderlich

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

admin_username
str
Erforderlich

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

admin_user_password
str
Erforderlich

Das Kennwort des Administratorbenutzerkontos.

admin_user_ssh_key
str
Erforderlich

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

vnet_resourcegroup_name
str
Erforderlich

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

vnet_name
str
Erforderlich

Den Namen des virtuellen Netzwerks.

subnet_name
str
Erforderlich

Der Name des Subnetzes innerhalb des VNet.

tags
dict[str, str]
Erforderlich

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

description
str
Erforderlich

Eine Beschreibung für das Computeobjekt.

remote_login_port_public_access
str
Erforderlich

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
string
Erforderlich

Mögliche Werte:

  • SystemAssigned: Systemseitig zugewiesene Identität

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

identity_id
list[str]
Erforderlich

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

compute_location
str
Standardwert: None

Der Speicherort, an dem der Cluster bereitgestellt werden soll.

enable_node_public_ip
bool
Standardwert: True

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.

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