共用方式為


AmlComputeProvisioningConfiguration 類別

表示布建 AmlCompute 目標的組態參數。

provisioning_configuration使用類別的 AmlCompute 方法來指定組態參數。

建立組態物件來布建 AmlCompute 目標。

建構函式

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)

參數

名稱 Description
vm_size
必要
str

代理程式 VM 的大小。 如需詳細資訊,請參閱這裡:https://aka.ms/azureml-vm-details。 請注意,並非所有大小都可在所有區域中使用,如上一個連結中所述。 如果未指定,則預設為 Standard_NC6。

vm_priority
str

VM 優先順序,可以是「專用」或「低優先順序」VM。 如果未指定,則預設為 「專用」。

預設值: dedicated
min_nodes
int

叢集上使用的節點數目下限。 如果未指定,則預設為 0。

預設值: 0
max_nodes
int

叢集上要使用的節點數目上限。 預設值為 4。

預設值: None
idle_seconds_before_scaledown
int

在相應減少叢集之前,以秒為單位的節點空閒時間。 如果未指定,則預設為1800。

預設值: 1800
admin_username
str

可用來透過 SSH 連線到節點的系統管理員用戶帳戶名稱。

預設值: None
admin_user_password
str

系統管理員用戶帳戶的密碼。

預設值: None
admin_user_ssh_key
str

系統管理員用戶帳戶的 SSH 公鑰。

預設值: None
vnet_resourcegroup_name
str

虛擬網路所在的資源組名。

預設值: None
vnet_name
str

虛擬網路的名稱。

預設值: None
subnet_name
str

VNet 內的子網名稱。

預設值: None
tags

要提供給計算物件的索引鍵值標記字典。

預設值: None
description
str

要提供給計算物件的描述。

預設值: None
remote_login_port_public_access
str

公用 SSH 埠的狀態。 可能的值為:

  • 已停用 - 指出叢集的所有節點上已關閉公用 SSH 埠。

  • 已啟用 - 指出叢集的所有節點上已開啟公用 SSH 埠。

  • NotSpecified - 指出如果已定義 VNet,則叢集的所有節點上都會關閉公用 SSH 埠,否則會開啟所有公用節點。 它只能在叢集建立期間使用此預設值。 建立之後,將會啟用或停用。

預設值: NotSpecified
identity_type

可能的值為:

  • SystemAssigned - 系統指派的身分識別

  • UserAssigned - 使用者指派的身分識別。 需要設定身分識別標識碼。

預設值: None
identity_id

使用者指派身分識別的資源標識符清單。 例如 ['/subscriptions//resourceGroups//providers/Microsoft.ManagedIdentity /userAssignedIdentities/']

預設值: None
vm_size
必要
str

代理程式 VM 的大小。 如需詳細資訊,請參閱這裡:https://aka.ms/azureml-vm-details。 請注意,並非所有大小都可在所有區域中使用,如上一個連結中所述。 如果未指定,則預設為 Standard_NC6。

vm_priority
必要
str

VM 優先順序,可以是「專用」或「低優先順序」VM。 如果未指定,則預設為 「專用」。

min_nodes
必要
int

叢集上使用的節點數目下限。 如果未指定,則預設為 0。

max_nodes
必要
int

叢集上要使用的節點數目上限。 預設值為 4。

idle_seconds_before_scaledown
必要
int

在相應減少叢集之前,以秒為單位的節點空閒時間。 如果未指定,則預設為1800。

admin_username
必要
str

可用來透過 SSH 連線到節點的系統管理員用戶帳戶名稱。

admin_user_password
必要
str

系統管理員用戶帳戶的密碼。

admin_user_ssh_key
必要
str

系統管理員用戶帳戶的 SSH 公鑰。

vnet_resourcegroup_name
必要
str

虛擬網路所在的資源組名。

vnet_name
必要
str

虛擬網路的名稱。

subnet_name
必要
str

VNet 內的子網名稱。

tags
必要

要提供給計算物件的索引鍵值標記字典。

description
必要
str

要提供給計算物件的描述。

remote_login_port_public_access
必要
str

公用 SSH 埠的狀態。 可能的值為:

  • 已停用 - 指出叢集的所有節點上已關閉公用 SSH 埠。

  • 已啟用 - 指出叢集的所有節點上已開啟公用 SSH 埠。

  • NotSpecified - 指出如果已定義 VNet,則叢集的所有節點上都會關閉公用 SSH 埠,否則會開啟所有公用節點。 這是預設值。 狀態只能在叢集建立期間在此預設值中。 建立之後,將會啟用或停用。

identity_type
必要

可能的值為:

  • SystemAssigned - 系統指派的身分識別

  • UserAssigned - 使用者指派的身分識別。 需要設定身分識別標識碼。

identity_id
必要

使用者指派身分識別的資源標識符清單。 例如 ['/subscriptions//resourceGroups//providers/Microsoft.ManagedIdentity /userAssignedIdentities/']

compute_location
str

要布建叢集的位置。

預設值: None
enable_node_public_ip

啟用節點公用IP。 可能的值為:

  • True - 啟用節點公用 IP。

  • False - 停用節點公用 IP。

  • NotSpecified - 啟用節點公用IP。

預設值: True

方法

validate_configuration

檢查指定的組態值是否有效。

如果驗證失敗,則 ComputeTargetException 引發 。

validate_configuration

檢查指定的組態值是否有效。

如果驗證失敗,則 ComputeTargetException 引發 。

validate_configuration()

例外狀況

類型 Description