ComputeInstanceProvisioningConfiguration Class

  • Reference

Represents configuration parameters for provisioning ComputeInstance targets.

Use the provisioning_configuration method of the ComputeInstance class to create a ComputeInstanceProvisioningConfiguration object.

Create a configuration object for provisioning a ComputeInstance target.

Inheritance
ComputeTargetProvisioningConfiguration
ComputeInstanceProvisioningConfiguration

Constructor

ComputeInstanceProvisioningConfiguration(vm_size='', ssh_public_access=False, admin_user_ssh_public_key=None, vnet_resourcegroup_name=None, vnet_name=None, subnet_name=None, tags=None, description=None, assigned_user_object_id=None, assigned_user_tenant_id=None)

Parameters

vm_size
str
Required

The size of agent VMs. More details can be found here: https://aka.ms/azureml-vm-details. Note that not all sizes are available in all regions, as detailed in the previous link. Defaults to Standard_DS3_V2.

ssh_public_access
bool
default value: False

Indicates the state of the public SSH port. Possible values are:

  • False - The public ssh port is closed.
  • True - The public ssh port is open.
admin_user_ssh_public_key
str
default value: None

The SSH public key of the administrator user account.

vnet_resourcegroup_name
str
default value: None

The name of the resource group where the virtual network is located.

vnet_name
str
default value: None

The name of the virtual network.

subnet_name
str
default value: None

The name of the subnet inside the VNet.

tags
dict[str, str]
default value: None

An optional dictionary of key value tags to associate with the ComputeInstance object.

description
str
default value: None

An optional description for the ComputeInstance object.

vm_size
str
Required

The size of agent VMs. More details can be found here: https://aka.ms/azureml-vm-details. Note that not all sizes are available in all regions, as detailed in the previous link. Defaults to Standard_DS3_V2.

ssh_public_access
bool
Required

Indicates the state of the public SSH port. Possible values are:

  • False - The public ssh port is closed.
  • True - The public ssh port is open.
admin_user_ssh_public_key
str
Required

The SSH public key of the administrator user account.

vnet_resourcegroup_name
str
Required

The name of the resource group where the virtual network is located.

vnet_name
str
Required

The name of the virtual network.

subnet_name
str
Required

The name of the subnet inside the vnet.

tags
dict[str, str]
Required

An optional dictionary of key value tags to associate with the ComputeInstance object.

description
str
Required

An optional description for the ComputeInstance object.

assigned_user_object_id
str
default value: None

The AAD Object ID of the assigned user (preview).

assigned_user_tenant_id
str
default value: None

The AAD Tenant ID of the assigned user (preview).

Methods

validate_configuration

Check that the specified configuration values are valid.

Raises a ComputeTargetException if validation fails.

validate_configuration

Check that the specified configuration values are valid.

Raises a ComputeTargetException if validation fails.

validate_configuration()

Exceptions

ComputeTargetException