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)

參數

名稱	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	dict[str, str] 要提供給計算物件的索引鍵值標記字典。 預設值: None
description	str 要提供給計算物件的描述。 預設值: None
remote_login_port_public_access	str 公用 SSH 埠的狀態。 可能的值包括： 已停用 - 指出叢集的所有節點上已關閉公用 SSH 埠。 已啟用 - 指出叢集的所有節點上都已開啟公用 SSH 埠。 NotSpecified - 指出如果已定義 VNet，則叢集的所有節點上都會關閉公用 SSH 埠，否則會開啟所有公用節點。 它只能在叢集建立期間使用這個預設值。 建立之後，將會啟用或停用。 預設值: NotSpecified
identity_type	string 可能的值包括： SystemAssigned - 系統指派的身分識別 UserAssigned - 使用者指派的身分識別。 需要設定身分識別識別碼。 預設值: None
identity_id	list[str] 使用者指派身分識別的資源識別碼清單。 例如 ['/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 必要	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 啟用節點公用 IP。 可能的值包括： True - 啟用節點公用 IP。 False - 停用節點公用 IP。 NotSpecified - 啟用節點公用 IP。 預設值: True

方法

validate_configuration

檢查指定的組態值是否有效。 如果驗證失敗， ComputeTargetException 則引發 。

validate_configuration

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

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

validate_configuration()

例外狀況

類型	Description
ComputeTargetException