Share via

Virtual Machine Sizes - List

Service:
Machine Learning
API Version:
2025-12-01

Returns supported VM Sizes in a location

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

URI Parameters

Name In Required Type Description
location
 path True

string

pattern: ^[-\w\._]+$

The location name.
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

The request has succeeded.
Other Status Codes

ErrorResponse

An unexpected error response.

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

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

Sample response

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

Definitions

Name Description
BillingCurrency

Three lettered code specifying the currency of the VM price. Example: USD
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

The unit of time measurement for the specified VM price. Example: OneHour
VirtualMachineSize

Describes the properties of a VM size.
VirtualMachineSizeListResult

The List Virtual Machine size operation response.
VMPriceOSType

Operating system type used by the VM.
VMTier

The type of the VM.

BillingCurrency

Enumeration

Three lettered code specifying the currency of the VM price. Example: USD

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

The unit of time measurement for the specified VM price. Example: OneHour

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

Operating system type used by the VM.

Value Description
Linux
Windows

VMTier

Enumeration

The type of the VM.

Value Description
Standard
LowPriority
Spot