Share via


Resource Skus - List

Gets the list of Microsoft.Compute SKUs available for your Subscription.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/skus?api-version=2021-07-01
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/skus?api-version=2021-07-01&$filter={$filter}&includeExtendedLocations={includeExtendedLocations}

URI Parameters

Name In Required Type Description
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.

$filter
query

string

The filter to apply on the operation. Only location filter is supported currently.

includeExtendedLocations
query

string

To Include Extended Locations information or not in the response.

Responses

Name Type Description
200 OK

ResourceSkusResult

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

Lists all available Resource SKUs
Lists all available Resource SKUs for the specified region
Lists all available Resource SKUs with Extended Location information

Lists all available Resource SKUs

Sample request

GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Compute/skus?api-version=2021-07-01

Sample response

{
  "value": [
    {
      "resourceType": "virtualMachines",
      "locations": [
        "westus"
      ],
      "capabilities": [
        {
          "name": "MaxResourceVolumeMB",
          "value": "20480"
        },
        {
          "name": "OSVhdSizeMB",
          "value": "1047552"
        },
        {
          "name": "vCPUs",
          "value": "1"
        },
        {
          "name": "HyperVGenerations",
          "value": "V1"
        },
        {
          "name": "MemoryGB",
          "value": "0.75"
        },
        {
          "name": "MaxDataDiskCount",
          "value": "1"
        },
        {
          "name": "LowPriorityCapable",
          "value": "False"
        },
        {
          "name": "PremiumIO",
          "value": "False"
        },
        {
          "name": "vCPUsAvailable",
          "value": "1"
        },
        {
          "name": "ACUs",
          "value": "50"
        },
        {
          "name": "vCPUsPerCore",
          "value": "1"
        },
        {
          "name": "EphemeralOSDiskSupported",
          "value": "False"
        },
        {
          "name": "AcceleratedNetworkingEnabled",
          "value": "False"
        },
        {
          "name": "RdmaEnabled",
          "value": "False"
        },
        {
          "name": "MaxNetworkInterfaces",
          "value": "2"
        }
      ],
      "locationInfo": [
        {
          "location": "westus",
          "zones": [
            "2",
            "1"
          ],
          "zoneDetails": [
            {
              "name": [
                "2"
              ],
              "capabilities": [
                {
                  "name": "UltraSSDAvailable",
                  "value": "True"
                }
              ]
            }
          ]
        }
      ],
      "name": "Standard_A0",
      "tier": "Standard",
      "size": "A0",
      "family": "standardA0_A7Family"
    },
    {
      "resourceType": "virtualMachines",
      "locations": [
        "westus"
      ],
      "capabilities": [
        {
          "name": "MaxResourceVolumeMB",
          "value": "71680"
        },
        {
          "name": "OSVhdSizeMB",
          "value": "1047552"
        },
        {
          "name": "vCPUs",
          "value": "1"
        },
        {
          "name": "HyperVGenerations",
          "value": "V1"
        },
        {
          "name": "MemoryGB",
          "value": "1.75"
        },
        {
          "name": "MaxDataDiskCount",
          "value": "2"
        },
        {
          "name": "LowPriorityCapable",
          "value": "True"
        },
        {
          "name": "PremiumIO",
          "value": "False"
        },
        {
          "name": "vCPUsAvailable",
          "value": "1"
        },
        {
          "name": "ACUs",
          "value": "100"
        },
        {
          "name": "vCPUsPerCore",
          "value": "1"
        },
        {
          "name": "EphemeralOSDiskSupported",
          "value": "False"
        },
        {
          "name": "AcceleratedNetworkingEnabled",
          "value": "False"
        },
        {
          "name": "RdmaEnabled",
          "value": "False"
        },
        {
          "name": "MaxNetworkInterfaces",
          "value": "2"
        }
      ],
      "locationInfo": [
        {
          "location": "westus",
          "zones": [
            "1",
            "2",
            "3"
          ]
        }
      ],
      "name": "Standard_A1",
      "tier": "Standard",
      "size": "A1",
      "family": "standardA0_A7Family"
    }
  ],
  "nextLink": null
}

Lists all available Resource SKUs for the specified region

Sample request

GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Compute/skus?api-version=2021-07-01&$filter=location eq 'westus'

Sample response

{
  "value": [
    {
      "resourceType": "virtualMachines",
      "locations": [
        "westus"
      ],
      "capabilities": [
        {
          "name": "MaxResourceVolumeMB",
          "value": "20480"
        },
        {
          "name": "OSVhdSizeMB",
          "value": "1047552"
        },
        {
          "name": "vCPUs",
          "value": "1"
        },
        {
          "name": "HyperVGenerations",
          "value": "V1"
        },
        {
          "name": "MemoryGB",
          "value": "0.75"
        },
        {
          "name": "MaxDataDiskCount",
          "value": "1"
        },
        {
          "name": "LowPriorityCapable",
          "value": "False"
        },
        {
          "name": "PremiumIO",
          "value": "False"
        },
        {
          "name": "vCPUsAvailable",
          "value": "1"
        },
        {
          "name": "ACUs",
          "value": "50"
        },
        {
          "name": "vCPUsPerCore",
          "value": "1"
        },
        {
          "name": "EphemeralOSDiskSupported",
          "value": "False"
        },
        {
          "name": "AcceleratedNetworkingEnabled",
          "value": "False"
        },
        {
          "name": "RdmaEnabled",
          "value": "False"
        },
        {
          "name": "MaxNetworkInterfaces",
          "value": "2"
        }
      ],
      "locationInfo": [
        {
          "location": "westus",
          "zones": [
            "2",
            "1"
          ],
          "zoneDetails": [
            {
              "name": [
                "2"
              ],
              "capabilities": [
                {
                  "name": "UltraSSDAvailable",
                  "value": "True"
                }
              ]
            }
          ]
        }
      ],
      "name": "Standard_A0",
      "tier": "Standard",
      "size": "A0",
      "family": "standardA0_A7Family"
    },
    {
      "resourceType": "virtualMachines",
      "locations": [
        "westus"
      ],
      "capabilities": [
        {
          "name": "MaxResourceVolumeMB",
          "value": "71680"
        },
        {
          "name": "OSVhdSizeMB",
          "value": "1047552"
        },
        {
          "name": "vCPUs",
          "value": "1"
        },
        {
          "name": "HyperVGenerations",
          "value": "V1"
        },
        {
          "name": "MemoryGB",
          "value": "1.75"
        },
        {
          "name": "MaxDataDiskCount",
          "value": "2"
        },
        {
          "name": "LowPriorityCapable",
          "value": "True"
        },
        {
          "name": "PremiumIO",
          "value": "False"
        },
        {
          "name": "vCPUsAvailable",
          "value": "1"
        },
        {
          "name": "ACUs",
          "value": "100"
        },
        {
          "name": "vCPUsPerCore",
          "value": "1"
        },
        {
          "name": "EphemeralOSDiskSupported",
          "value": "False"
        },
        {
          "name": "AcceleratedNetworkingEnabled",
          "value": "False"
        },
        {
          "name": "RdmaEnabled",
          "value": "False"
        },
        {
          "name": "MaxNetworkInterfaces",
          "value": "2"
        }
      ],
      "locationInfo": [
        {
          "location": "westus",
          "zones": [
            "1",
            "2",
            "3"
          ]
        }
      ],
      "name": "Standard_A1",
      "tier": "Standard",
      "size": "A1",
      "family": "standardA0_A7Family"
    }
  ],
  "nextLink": null
}

Lists all available Resource SKUs with Extended Location information

Sample request

GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Compute/skus?api-version=2021-07-01&includeExtendedLocations=true

Sample response

{
  "value": [
    {
      "resourceType": "virtualMachines",
      "locations": [
        "westus"
      ],
      "capabilities": [
        {
          "name": "MaxResourceVolumeMB",
          "value": "20480"
        },
        {
          "name": "OSVhdSizeMB",
          "value": "1047552"
        },
        {
          "name": "vCPUs",
          "value": "1"
        },
        {
          "name": "HyperVGenerations",
          "value": "V1"
        },
        {
          "name": "MemoryGB",
          "value": "0.75"
        },
        {
          "name": "MaxDataDiskCount",
          "value": "1"
        },
        {
          "name": "LowPriorityCapable",
          "value": "False"
        },
        {
          "name": "PremiumIO",
          "value": "False"
        },
        {
          "name": "vCPUsAvailable",
          "value": "1"
        },
        {
          "name": "ACUs",
          "value": "50"
        },
        {
          "name": "vCPUsPerCore",
          "value": "1"
        },
        {
          "name": "EphemeralOSDiskSupported",
          "value": "False"
        },
        {
          "name": "AcceleratedNetworkingEnabled",
          "value": "False"
        },
        {
          "name": "RdmaEnabled",
          "value": "False"
        },
        {
          "name": "MaxNetworkInterfaces",
          "value": "2"
        }
      ],
      "locationInfo": [
        {
          "location": "westus",
          "zones": [
            "2",
            "1"
          ],
          "zoneDetails": [
            {
              "name": [
                "2"
              ],
              "capabilities": [
                {
                  "name": "UltraSSDAvailable",
                  "value": "True"
                }
              ]
            }
          ]
        }
      ],
      "name": "Standard_A0",
      "tier": "Standard",
      "size": "A0",
      "family": "standardA0_A7Family"
    },
    {
      "resourceType": "virtualMachines",
      "locations": [
        "westus"
      ],
      "capabilities": [
        {
          "name": "MaxResourceVolumeMB",
          "value": "71680"
        },
        {
          "name": "OSVhdSizeMB",
          "value": "1047552"
        },
        {
          "name": "vCPUs",
          "value": "1"
        },
        {
          "name": "HyperVGenerations",
          "value": "V1"
        },
        {
          "name": "MemoryGB",
          "value": "1.75"
        },
        {
          "name": "MaxDataDiskCount",
          "value": "2"
        },
        {
          "name": "LowPriorityCapable",
          "value": "True"
        },
        {
          "name": "PremiumIO",
          "value": "False"
        },
        {
          "name": "vCPUsAvailable",
          "value": "1"
        },
        {
          "name": "ACUs",
          "value": "100"
        },
        {
          "name": "vCPUsPerCore",
          "value": "1"
        },
        {
          "name": "EphemeralOSDiskSupported",
          "value": "False"
        },
        {
          "name": "AcceleratedNetworkingEnabled",
          "value": "False"
        },
        {
          "name": "RdmaEnabled",
          "value": "False"
        },
        {
          "name": "MaxNetworkInterfaces",
          "value": "2"
        }
      ],
      "locationInfo": [
        {
          "location": "westus",
          "zones": [
            "1",
            "2",
            "3"
          ]
        },
        {
          "location": "westus",
          "extendedLocations": [
            "Las Vegas",
            "Seattle",
            "Portland"
          ],
          "type": "EdgeZone"
        }
      ],
      "name": "Standard_A1",
      "tier": "Standard",
      "size": "A1",
      "family": "standardA0_A7Family"
    }
  ],
  "nextLink": null
}

Definitions

Name Description
ErrorAdditionalInfo

The resource management error additional info.

ErrorDetail

The error detail.

ErrorResponse

Error response

ExtendedLocationType

The type of the extended location.

ResourceSku

Describes an available Compute SKU.

ResourceSkuCapabilities

Describes The SKU capabilities object.

ResourceSkuCapacity

Describes scaling information of a SKU.

ResourceSkuCapacityScaleType

The scale type applicable to the sku.

ResourceSkuCosts

Describes metadata for retrieving price info.

ResourceSkuLocationInfo

Describes an available Compute SKU Location Information.

ResourceSkuRestrictionInfo

Describes an available Compute SKU Restriction Information.

ResourceSkuRestrictions

Describes scaling information of a SKU.

ResourceSkuRestrictionsReasonCode

The reason for restriction.

ResourceSkuRestrictionsType

The type of restrictions.

ResourceSkusResult

The List Resource Skus operation response.

ResourceSkuZoneDetails

Describes The zonal capabilities of a SKU.

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.

ExtendedLocationType

The type of the extended location.

Value Description
EdgeZone

ResourceSku

Describes an available Compute SKU.

Name Type Description
apiVersions

string[]

The api versions that support this SKU.

capabilities

ResourceSkuCapabilities[]

A name value pair to describe the capability.

capacity

ResourceSkuCapacity

Specifies the number of virtual machines in the scale set.

costs

ResourceSkuCosts[]

Metadata for retrieving price info.

family

string

The Family of this particular SKU.

kind

string

The Kind of resources that are supported in this SKU.

locationInfo

ResourceSkuLocationInfo[]

A list of locations and availability zones in those locations where the SKU is available.

locations

string[]

The set of locations that the SKU is available.

name

string

The name of SKU.

resourceType

string

The type of resource the SKU applies to.

restrictions

ResourceSkuRestrictions[]

The restrictions because of which SKU cannot be used. This is empty if there are no restrictions.

size

string

The Size of the SKU.

tier

string

Specifies the tier of virtual machines in a scale set.

Possible Values:

Standard

Basic

ResourceSkuCapabilities

Describes The SKU capabilities object.

Name Type Description
name

string

An invariant to describe the feature.

value

string

An invariant if the feature is measured by quantity.

ResourceSkuCapacity

Describes scaling information of a SKU.

Name Type Description
default

integer (int64)

The default capacity.

maximum

integer (int64)

The maximum capacity that can be set.

minimum

integer (int64)

The minimum capacity.

scaleType

ResourceSkuCapacityScaleType

The scale type applicable to the sku.

ResourceSkuCapacityScaleType

The scale type applicable to the sku.

Value Description
Automatic
Manual
None

ResourceSkuCosts

Describes metadata for retrieving price info.

Name Type Description
extendedUnit

string

An invariant to show the extended unit.

meterID

string

Used for querying price from commerce.

quantity

integer (int64)

The multiplier is needed to extend the base metered cost.

ResourceSkuLocationInfo

Describes an available Compute SKU Location Information.

Name Type Description
extendedLocations

string[]

The names of extended locations.

location

string

Location of the SKU

type

ExtendedLocationType

The type of the extended location.

zoneDetails

ResourceSkuZoneDetails[]

Details of capabilities available to a SKU in specific zones.

zones

string[]

List of availability zones where the SKU is supported.

ResourceSkuRestrictionInfo

Describes an available Compute SKU Restriction Information.

Name Type Description
locations

string[]

Locations where the SKU is restricted

zones

string[]

List of availability zones where the SKU is restricted.

ResourceSkuRestrictions

Describes scaling information of a SKU.

Name Type Description
reasonCode

ResourceSkuRestrictionsReasonCode

The reason for restriction.

restrictionInfo

ResourceSkuRestrictionInfo

The information about the restriction where the SKU cannot be used.

type

ResourceSkuRestrictionsType

The type of restrictions.

values

string[]

The value of restrictions. If the restriction type is set to location. This would be different locations where the SKU is restricted.

ResourceSkuRestrictionsReasonCode

The reason for restriction.

Value Description
QuotaId
NotAvailableForSubscription

ResourceSkuRestrictionsType

The type of restrictions.

Value Description
Location
Zone

ResourceSkusResult

The List Resource Skus operation response.

Name Type Description
nextLink

string (uri)

The link to the next page of items

value

ResourceSku[]

The ResourceSku items on this page

ResourceSkuZoneDetails

Describes The zonal capabilities of a SKU.

Name Type Description
capabilities

ResourceSkuCapabilities[]

A list of capabilities that are available for the SKU in the specified list of zones.

name

string[]

The set of zones that the SKU is available in with the specified capabilities.