Virtual Machine Sizes - List

Service:: Machine Learning

API Version:: 2025-09-01

Returns supported VM Sizes in a location

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.MachineLearningServices/locations/{location}/vmSizes?api-version=2025-09-01

URI Parameters

Name	In	Required	Type	Description
location	path	True	string pattern: ^[-\w\._]+$	The location upon which virtual-machine-sizes is queried.
subscriptionId	path	True	string minLength: 1	The ID of the target subscription.
api-version	query	True	string minLength: 1	The API version to use for this operation.

Responses

Name	Type	Description
200 OK	VirtualMachineSizeListResult	OK
Other Status Codes	ErrorResponse	Error response describing why the operation failed.

Security

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	impersonate your user account

Examples

List VM Sizes

Sample request

HTTP

GET https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/providers/Microsoft.MachineLearningServices/locations/eastus/vmSizes?api-version=2025-09-01

Sample response

Status code:: 200

{
  "value": [
    {
      "name": "Standard_DS1_v2",
      "family": "standardDSv2Family",
      "vCPUs": 1,
      "gpus": 0,
      "osVhdSizeMB": 1047552,
      "maxResourceVolumeMB": 7168,
      "memoryGB": 3.5,
      "lowPriorityCapable": true,
      "premiumIO": true,
      "estimatedVMPrices": {
        "billingCurrency": "USD",
        "unitOfMeasure": "OneHour",
        "values": [
          {
            "retailPrice": 0.13,
            "osType": "Windows",
            "vmTier": "Standard"
          },
          {
            "retailPrice": 0.01,
            "osType": "Linux",
            "vmTier": "LowPriority"
          },
          {
            "retailPrice": 0.07,
            "osType": "Linux",
            "vmTier": "Standard"
          },
          {
            "retailPrice": 0.05,
            "osType": "Windows",
            "vmTier": "LowPriority"
          }
        ]
      },
      "supportedComputeTypes": [
        "AmlCompute",
        "ComputeInstance"
      ]
    },
    {
      "name": "Standard_DS2_v2",
      "family": "standardDSv2Family",
      "vCPUs": 2,
      "gpus": 0,
      "osVhdSizeMB": 1047552,
      "maxResourceVolumeMB": 14336,
      "memoryGB": 7,
      "lowPriorityCapable": true,
      "premiumIO": true,
      "estimatedVMPrices": {
        "billingCurrency": "USD",
        "unitOfMeasure": "OneHour",
        "values": [
          {
            "retailPrice": 0.03,
            "osType": "Linux",
            "vmTier": "LowPriority"
          },
          {
            "retailPrice": 0.15,
            "osType": "Linux",
            "vmTier": "Standard"
          },
          {
            "retailPrice": 0.1,
            "osType": "Windows",
            "vmTier": "LowPriority"
          },
          {
            "retailPrice": 0.25,
            "osType": "Windows",
            "vmTier": "Standard"
          }
        ]
      },
      "supportedComputeTypes": [
        "AmlCompute",
        "ComputeInstance",
        "MIR"
      ]
    },
    {
      "name": "Standard_DS3_v2",
      "family": "standardDSv2Family",
      "vCPUs": 4,
      "gpus": 0,
      "osVhdSizeMB": 1047552,
      "maxResourceVolumeMB": 28672,
      "memoryGB": 14,
      "lowPriorityCapable": true,
      "premiumIO": true,
      "estimatedVMPrices": {
        "billingCurrency": "USD",
        "unitOfMeasure": "OneHour",
        "values": [
          {
            "retailPrice": 0.2,
            "osType": "Windows",
            "vmTier": "LowPriority"
          },
          {
            "retailPrice": 0.06,
            "osType": "Linux",
            "vmTier": "LowPriority"
          },
          {
            "retailPrice": 0.5,
            "osType": "Windows",
            "vmTier": "Standard"
          },
          {
            "retailPrice": 0.29,
            "osType": "Linux",
            "vmTier": "Standard"
          }
        ]
      },
      "supportedComputeTypes": [
        "AmlCompute",
        "ComputeInstance",
        "MIR"
      ]
    },
    {
      "name": "Standard_DS4_v2",
      "family": "standardDSv2Family",
      "vCPUs": 8,
      "gpus": 0,
      "osVhdSizeMB": 1047552,
      "maxResourceVolumeMB": 57344,
      "memoryGB": 28,
      "lowPriorityCapable": true,
      "premiumIO": true,
      "estimatedVMPrices": {
        "billingCurrency": "USD",
        "unitOfMeasure": "OneHour",
        "values": [
          {
            "retailPrice": 0.12,
            "osType": "Linux",
            "vmTier": "LowPriority"
          },
          {
            "retailPrice": 0.4,
            "osType": "Windows",
            "vmTier": "LowPriority"
          },
          {
            "retailPrice": 1.01,
            "osType": "Windows",
            "vmTier": "Standard"
          },
          {
            "retailPrice": 0.58,
            "osType": "Linux",
            "vmTier": "Standard"
          }
        ]
      },
      "supportedComputeTypes": [
        "AmlCompute",
        "ComputeInstance",
        "MIR"
      ]
    },
    {
      "name": "Standard_DS5_v2",
      "family": "standardDSv2Family",
      "vCPUs": 16,
      "gpus": 0,
      "osVhdSizeMB": 1047552,
      "maxResourceVolumeMB": 114688,
      "memoryGB": 56,
      "lowPriorityCapable": true,
      "premiumIO": true,
      "estimatedVMPrices": {
        "billingCurrency": "USD",
        "unitOfMeasure": "OneHour",
        "values": [
          {
            "retailPrice": 1.17,
            "osType": "Linux",
            "vmTier": "Standard"
          },
          {
            "retailPrice": 0.81,
            "osType": "Windows",
            "vmTier": "LowPriority"
          },
          {
            "retailPrice": 2.02,
            "osType": "Windows",
            "vmTier": "Standard"
          },
          {
            "retailPrice": 0.23,
            "osType": "Linux",
            "vmTier": "LowPriority"
          }
        ]
      },
      "supportedComputeTypes": [
        "AmlCompute",
        "ComputeInstance",
        "MIR"
      ]
    },
    {
      "name": "Standard_DS11_v2",
      "family": "standardDSv2Family",
      "vCPUs": 2,
      "gpus": 0,
      "osVhdSizeMB": 1047552,
      "maxResourceVolumeMB": 28672,
      "memoryGB": 14,
      "lowPriorityCapable": true,
      "premiumIO": true,
      "estimatedVMPrices": {
        "billingCurrency": "USD",
        "unitOfMeasure": "OneHour",
        "values": [
          {
            "retailPrice": 0.26,
            "osType": "Windows",
            "vmTier": "Standard"
          },
          {
            "retailPrice": 0.18,
            "osType": "Linux",
            "vmTier": "Standard"
          },
          {
            "retailPrice": 0.11,
            "osType": "Windows",
            "vmTier": "LowPriority"
          },
          {
            "retailPrice": 0.04,
            "osType": "Linux",
            "vmTier": "LowPriority"
          }
        ]
      },
      "supportedComputeTypes": [
        "AmlCompute",
        "ComputeInstance"
      ]
    },
    {
      "name": "Standard_DS12_v2",
      "family": "standardDSv2Family",
      "vCPUs": 4,
      "gpus": 0,
      "osVhdSizeMB": 1047552,
      "maxResourceVolumeMB": 57344,
      "memoryGB": 28,
      "lowPriorityCapable": true,
      "premiumIO": true,
      "estimatedVMPrices": {
        "billingCurrency": "USD",
        "unitOfMeasure": "OneHour",
        "values": [
          {
            "retailPrice": 0.37,
            "osType": "Linux",
            "vmTier": "Standard"
          },
          {
            "retailPrice": 0.53,
            "osType": "Windows",
            "vmTier": "Standard"
          },
          {
            "retailPrice": 0.21,
            "osType": "Windows",
            "vmTier": "LowPriority"
          },
          {
            "retailPrice": 0.07,
            "osType": "Linux",
            "vmTier": "LowPriority"
          }
        ]
      },
      "supportedComputeTypes": [
        "AmlCompute",
        "ComputeInstance"
      ]
    },
    {
      "name": "Standard_DS13_v2",
      "family": "standardDSv2Family",
      "vCPUs": 8,
      "gpus": 0,
      "osVhdSizeMB": 1047552,
      "maxResourceVolumeMB": 114688,
      "memoryGB": 56,
      "lowPriorityCapable": true,
      "premiumIO": true,
      "estimatedVMPrices": {
        "billingCurrency": "USD",
        "unitOfMeasure": "OneHour",
        "values": [
          {
            "retailPrice": 0.15,
            "osType": "Linux",
            "vmTier": "LowPriority"
          },
          {
            "retailPrice": 0.42,
            "osType": "Windows",
            "vmTier": "LowPriority"
          },
          {
            "retailPrice": 0.74,
            "osType": "Linux",
            "vmTier": "Standard"
          },
          {
            "retailPrice": 1.06,
            "osType": "Windows",
            "vmTier": "Standard"
          }
        ]
      },
      "supportedComputeTypes": [
        "AmlCompute",
        "ComputeInstance"
      ]
    },
    {
      "name": "Standard_DS14_v2",
      "family": "standardDSv2Family",
      "vCPUs": 16,
      "gpus": 0,
      "osVhdSizeMB": 1047552,
      "maxResourceVolumeMB": 229376,
      "memoryGB": 112,
      "lowPriorityCapable": true,
      "premiumIO": true,
      "estimatedVMPrices": {
        "billingCurrency": "USD",
        "unitOfMeasure": "OneHour",
        "values": [
          {
            "retailPrice": 0.3,
            "osType": "Linux",
            "vmTier": "LowPriority"
          },
          {
            "retailPrice": 1.48,
            "osType": "Linux",
            "vmTier": "Standard"
          },
          {
            "retailPrice": 0.84,
            "osType": "Windows",
            "vmTier": "LowPriority"
          },
          {
            "retailPrice": 2.11,
            "osType": "Windows",
            "vmTier": "Standard"
          }
        ]
      },
      "supportedComputeTypes": [
        "AmlCompute",
        "ComputeInstance"
      ]
    }
  ]
}

Definitions

Name	Description
BillingCurrency	Billing currency
ErrorAdditionalInfo	The resource management error additional info.
ErrorDetail	The error detail.
ErrorResponse	Error response
EstimatedVMPrice	The estimated price info for using a VM of a particular OS type, tier, etc.
EstimatedVMPrices	The estimated price info for using a VM.
UnitOfMeasure	Unit of time measure
VirtualMachineSize	Describes the properties of a VM size.
VirtualMachineSizeListResult	The List Virtual Machine size operation response.
VMPriceOSType	OS type
VMTier	VM tier

BillingCurrency

Enumeration

Billing currency

Value	Description
USD

ErrorAdditionalInfo

Object

The resource management error additional info.

Name	Type	Description
info	object	The additional info.
type	string	The additional info type.

ErrorDetail

Object

The error detail.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	The error additional info.
code	string	The error code.
details	ErrorDetail[]	The error details.
message	string	The error message.
target	string	The error target.

ErrorResponse

Object

Error response

Name	Type	Description
error	ErrorDetail	The error object.

EstimatedVMPrice

Object

The estimated price info for using a VM of a particular OS type, tier, etc.

Name	Type	Description
osType	VMPriceOSType	OS type Operating system type used by the VM.
retailPrice	number (double)	Retail price The price charged for using the VM.
vmTier	VMTier	VM tier The type of the VM.

EstimatedVMPrices

Object

The estimated price info for using a VM.

Name	Type	Description
billingCurrency	BillingCurrency	Billing currency Three lettered code specifying the currency of the VM price. Example: USD
unitOfMeasure	UnitOfMeasure	Unit of time measure The unit of time measurement for the specified VM price. Example: OneHour
values	EstimatedVMPrice[]	List of estimated VM prices. The list of estimated prices for using a VM of a particular OS type, tier, etc.

UnitOfMeasure

Enumeration

Unit of time measure

Value	Description
OneHour

VirtualMachineSize

Object

Describes the properties of a VM size.

Name	Type	Description
estimatedVMPrices	EstimatedVMPrices	Estimated VM prices The estimated price information for using a VM.
family	string	Virtual Machine family name The family name of the virtual machine size.
gpus	integer (int32)	Number of gPUs The number of gPUs supported by the virtual machine size.
lowPriorityCapable	boolean	Low priority capable Specifies if the virtual machine size supports low priority VMs.
maxResourceVolumeMB	integer (int32)	Resource volume size The resource volume size, in MB, allowed by the virtual machine size.
memoryGB	number (double)	Memory size The amount of memory, in GB, supported by the virtual machine size.
name	string	Virtual Machine size name The name of the virtual machine size.
osVhdSizeMB	integer (int32)	OS VHD Disk size The OS VHD disk size, in MB, allowed by the virtual machine size.
premiumIO	boolean	Premium IO supported Specifies if the virtual machine size supports premium IO.
supportedComputeTypes	string[]	Supported Compute Types Specifies the compute types supported by the virtual machine size.
vCPUs	integer (int32)	Number of vPUs The number of vCPUs supported by the virtual machine size.

VirtualMachineSizeListResult

Object

The List Virtual Machine size operation response.

Name	Type	Description
value	VirtualMachineSize[]	The list of virtual machine sizes supported by AmlCompute.

VMPriceOSType

Enumeration

OS type

Value	Description
Linux
Windows

VMTier

Enumeration

VM tier

Value	Description
Standard
LowPriority
Spot

Share via

Virtual Machine Sizes - List

URI Parameters

Responses

Security

azure_auth

Scopes

Examples

List VM Sizes

Sample request

Sample response

Definitions

BillingCurrency

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

EstimatedVMPrice

EstimatedVMPrices

UnitOfMeasure

VirtualMachineSize

VirtualMachineSizeListResult

VMPriceOSType

VMTier