Share via

AmlComputeProvisioningConfiguration 類別

  • 參考

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

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

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

繼承
ComputeTargetProvisioningConfiguration
AmlComputeProvisioningConfiguration

建構函式

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)

參數

vm_size
str
必要

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

vm_priority
str
預設值: dedicated

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

min_nodes
int
預設值: 0

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

max_nodes
int
預設值: None

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

idle_seconds_before_scaledown
int
預設值: 1800

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

admin_username
str
預設值: None

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

admin_user_password
str
預設值: None

管理員使用者帳戶的密碼。

admin_user_ssh_key
str
預設值: None

管理員使用者帳戶的 SSH 公開金鑰。

vnet_resourcegroup_name
str
預設值: None

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

vnet_name
str
預設值: None

虛擬網路的名稱。

subnet_name
str
預設值: None

VNet 內子網的名稱。

tags
dict[str, str]
預設值: None

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

description
str
預設值: None

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

remote_login_port_public_access
str
預設值: NotSpecified

公用 SSH 埠的狀態。 可能的值包括：

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

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

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

identity_type
string
預設值: None

可能的值包括：

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

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

identity_id
list[str]
預設值: None

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

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
dict[str, str]
必要

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

description
str
必要

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

remote_login_port_public_access
str
必要

公用 SSH 埠的狀態。 可能的值包括：

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

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

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

identity_type
string
必要

可能的值包括：

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

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

identity_id
list[str]
必要

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

compute_location
str
預設值: None

布建叢集的位置。

enable_node_public_ip
bool
預設值: True

啟用節點公用 IP。 可能的值包括：

  • True - 啟用節點公用 IP。

  • False - 停用節點公用 IP。

  • NotSpecified - 啟用節點公用 IP。

方法

validate_configuration

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

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

validate_configuration

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

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

validate_configuration()

例外狀況

ComputeTargetException