Virtual Machine Sizes - List

  • Reference
Service:
Machine Learning
API Version:
2024-04-01

Returns supported VM Sizes in a location

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

URI Parameters

Name In Required Type Description
location
 path True

string

The location upon which virtual-machine-sizes is queried.

Regex pattern: ^[-\w\._]+$
subscriptionId
 path True

string

The ID of the target subscription.
api-version
 query True

string

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

GET https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/providers/Microsoft.MachineLearningServices/locations/eastus/vmSizes?api-version=2024-04-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

Billing currency

Name Type Description
USD

string

ErrorAdditionalInfo

The resource management error additional info.

Name Type Description
info

object

The additional info.
type

string

The additional info type.

ErrorDetail

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

Error response

Name Type Description
error

ErrorDetail

The error object.

EstimatedVMPrice

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

Retail price
The price charged for using the VM.
vmTier

VMTier

VM tier
The type of the VM.

EstimatedVMPrices

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

Unit of time measure

Name Type Description
OneHour

string

VirtualMachineSize

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

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

Resource volume size
The resource volume size, in MB, allowed by the virtual machine size.
memoryGB

number

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

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

Number of vPUs
The number of vCPUs supported by the virtual machine size.

VirtualMachineSizeListResult

The List Virtual Machine size operation response.

Name Type Description
value

VirtualMachineSize[]

The list of virtual machine sizes supported by AmlCompute.

VMPriceOSType

OS type

Name Type Description
Linux

string

Windows

string

VMTier

VM tier

Name Type Description
LowPriority

string

Spot

string

Standard

string