Virtual Machine Scale Sets - List Skus
Gets a list of SKUs available for your VM scale set, including the minimum and maximum VM instances allowed for each SKU.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/skus?api-version=2024-03-01
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
resource
|
path | True |
string |
The name of the resource group. |
subscription
|
path | True |
string |
Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. |
vm
|
path | True |
string |
The name of the VM scale set. |
api-version
|
query | True |
string |
Client Api Version. |
Responses
Name | Type | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
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
Virtual |
Virtual |
VirtualMachineScaleSet_ListSkus_MaximumSet_Gen
Sample Request
Sample Response
{
"value": [
{
"resourceType": "aaaaaaaaaaaaaaaaa",
"sku": {
"name": "DSv3-Type1",
"tier": "aaa",
"capacity": 7
},
"capacity": {
"minimum": 22,
"maximum": 27,
"defaultCapacity": 20,
"scaleType": "Automatic"
}
}
],
"nextLink": "aaaaaaaaaaaaaa"
}
VirtualMachineScaleSet_ListSkus_MinimumSet_Gen
Sample Request
Sample Response
{
"value": [
{}
]
}
Definitions
Name | Description |
---|---|
Api |
Api error. |
Api |
Api error base. |
Cloud |
An error response from the Compute service. |
Inner |
Inner error details. |
Sku |
Describes a virtual machine scale set sku. NOTE: If the new VM SKU is not supported on the hardware the scale set is currently on, you need to deallocate the VMs in the scale set before you modify the SKU name. |
Virtual |
The Virtual Machine Scale Set List Skus operation response. |
Virtual |
Describes an available virtual machine scale set sku. |
Virtual |
Describes scaling information of a sku. |
Virtual |
The scale type applicable to the sku. |
ApiError
Api error.
Name | Type | Description |
---|---|---|
code |
string |
The error code. |
details |
The Api error details |
|
innererror |
The Api inner error |
|
message |
string |
The error message. |
target |
string |
The target of the particular error. |
ApiErrorBase
Api error base.
Name | Type | Description |
---|---|---|
code |
string |
The error code. |
message |
string |
The error message. |
target |
string |
The target of the particular error. |
CloudError
An error response from the Compute service.
Name | Type | Description |
---|---|---|
error |
Api error. |
InnerError
Inner error details.
Name | Type | Description |
---|---|---|
errordetail |
string |
The internal error message or exception dump. |
exceptiontype |
string |
The exception type. |
Sku
Describes a virtual machine scale set sku. NOTE: If the new VM SKU is not supported on the hardware the scale set is currently on, you need to deallocate the VMs in the scale set before you modify the SKU name.
Name | Type | Description |
---|---|---|
capacity |
integer |
Specifies the number of virtual machines in the scale set. |
name |
string |
The sku name. |
tier |
string |
Specifies the tier of virtual machines in a scale set. |
VirtualMachineScaleSetListSkusResult
The Virtual Machine Scale Set List Skus operation response.
Name | Type | Description |
---|---|---|
nextLink |
string |
The uri to fetch the next page of Virtual Machine Scale Set Skus. Call ListNext() with this to fetch the next page of VMSS Skus. |
value |
The list of skus available for the virtual machine scale set. |
VirtualMachineScaleSetSku
Describes an available virtual machine scale set sku.
Name | Type | Description |
---|---|---|
capacity |
Specifies the number of virtual machines in the scale set. |
|
resourceType |
string |
The type of resource the sku applies to. |
sku |
The Sku. |
VirtualMachineScaleSetSkuCapacity
Describes scaling information of a sku.
Name | Type | Description |
---|---|---|
defaultCapacity |
integer |
The default capacity. |
maximum |
integer |
The maximum capacity that can be set. |
minimum |
integer |
The minimum capacity. |
scaleType |
The scale type applicable to the sku. |
VirtualMachineScaleSetSkuScaleType
The scale type applicable to the sku.
Name | Type | Description |
---|---|---|
Automatic |
string |
|
None |
string |