Skip to content

Commit 669d803

Browse files
brittanyrowebrittanyrowe
committed
REST API + troubleshooting update
1 parent 461432b commit 669d803

File tree

1 file changed

+49
-1
lines changed

1 file changed

+49
-1
lines changed

‎articles/virtual-machine-scale-sets/virtual-machine-scale-sets-instance-flexibility.md

Lines changed: 49 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -76,8 +76,44 @@ Following the scale set cost model, usage of Instance Flexibility is free. You'l
7676
## Deploy a scale set using Instance Flexibility
7777
The following example can be used to deploy a scale set using Instance Flexibility:
7878

79+
### [REST API](#tab/arm-1)
80+
To deploy an Instance Flexible scale set through REST API, use a `PUT` call to and include the following sections in your request body:
81+
```json
82+
PUT https://management.azure.com/subscriptions/{YourSubscriptionId}/resourceGroups/{YourResourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{youScaleSetName}?api-version=2023-09-01
83+
```
84+
85+
In the request body, ensure `sku.name` is set to Mix:
86+
```json
87+
"sku": {
88+
"name": "Mix",
89+
"capacity": {TotalNumberVms}
90+
},
91+
```
92+
Ensure you reference your existing subnet:
93+
```json
94+
"subnet": {
95+
"id": "/subscriptions/{YourSubscriptionId}/resourceGroups/{YourResourceGroupName}/providers/Microsoft.Network/virtualNetworks/{YourVnetName}/subnets/default"
96+
},
97+
```
98+
Lastly, be sure to specify the `skuProfile` with **up to 5** VM sizes:
99+
```json
100+
"skuProfile": {
101+
"vmSizes": [
102+
{
103+
"name": "Standard_D8s_v5"
104+
},
105+
{
106+
"name": "Standard_E16s_v5"
107+
},
108+
{
109+
"name": "Standard_D2s_v5"
110+
}
111+
],
112+
"allocationStrategy": "lowestPrice"
113+
},
114+
```
79115

80-
### [Azure portal](#tab/portal-2)
116+
### [Azure portal](#tab/portal-1)
81117
1. Go to **Virtual machine scale sets**.
82118
2. Select the **Create** button to go to the **Create a virtual machine scale set** view.
83119
3. In the **Basics** tab, fill out the required fields. If the field isn't called out below, you can set fields to what works best for your scale set.
@@ -89,6 +125,18 @@ The following example can be used to deploy a scale set using Instance Flexibili
89125
9. You can specify other properties in subsequent tabs, or you can go to **Review + create** and select the **Create** button at the bottom of the page to start your Instance Flexible scale set deployment.
90126

91127
## Troubleshooting
128+
| Error Code | Error Message | Troubleshooting options |
129+
|--------------------------------------------|-------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
130+
| SkuProfileAllocationStrategyInvalid | Sku Profile’s Allocation Strategy is invalid. | Ensure that you are using either `CapacityOptimized` or `LowestPrice` as the `allocationStrategy` |
131+
| SkuProfileVMSizesCannotBeNullOrEmpty | Sku Profile VM Sizes cannot be null or empty. Please provide a valid list of VM Sizes and retry. | Please provide at least one VM size in the `skuProfile`. |
132+
| SkuProfileHasTooManyVMSizesInRequest | Too many VM Sizes were specified in the request. Please provide no more than 5 VM Sizes. | At this time, you can specify up to 5 VM sizes with Instance Flexibility. |
133+
| SkuProfileVMSizesCannotHaveDuplicates | Sku Profile contains duplicate VM Size : {0}. Please remove any duplicates and retry. | Check the VM SKUs listed in the `skuProfile` and remove the duplicate VM size(s). |
134+
| SkuProfileUpdateNotAllowed | Virtual Machine Scale Sets with Sku Profile property cannot be updated. | At this time, you cannot update the `skuProfile` of a scale set using Instance Flexibility. |
135+
| SkuProfileScenarioNotSupported | ‘{0}’ is not supported on Virtual Machine Scale Sets with Sku Profile | Instance Flexibility doesn’t support certain scenarios today, like Azure Dedicated Host (`properties.hostGroup`), Capacity Reservations (`properties.virtualMachineProfile.capacityReservation`), and StandbyPools (`properties.standbyPoolProfile`). Please adjust the template to ensure you’re not using any of the above. |
136+
| SkuNameMustBeMixIfSkuProfileIsSpecified | Sku name is ‘{0}’. Virtual Machine Scale Sets with Sku Profile must have the Sku name property set to ‘Mix’ | Ensure that the `sku.name property` is set to `‘Mix’`. |
137+
| SkuTierMustNotBeSetIfSkuProfileIsSpecified | Sku tier is ‘{0}’. Virtual Machine Scale Sets with Sku Profile must not have the Sku tier property set. | `sku.tier` is an optional property for VMSS. With VMSS Flex Mix, `sku.tier` must be set to `null` or not specified. |
138+
| InvalidParameter | The value of parameter skuProfile is invalid. | Your subscription isn't registered for the Instance Flexibility feature. Follow the enrollment instructions to register for the Preview. |
139+
| FleetRPInternalError | An unexpected error occurred while computing the desired sku split. | Instance Flexibility isn't supported in this region yet. Deploy only in supported regions. |
92140

93141
## FAQs
94142
### Can I use Spot and Standard VMs with Instance Flexibility?

0 commit comments

Comments
 (0)