Merge pull request #175533 from mimckitt/release-spot-try-restore-ga

Azure Spot Try & restore GA 10/25

Author: PMEds28

articles/virtual-machine-scale-sets/media/virtual-machine-scale-sets-use-spot/vmss-spot-portal-1.png

@@ -1,12 +1,12 @@
 ---
 title: Create a scale set that uses Azure Spot Virtual Machines 
 description: Learn how to create Azure virtual machine scale sets that use Azure Spot Virtual Machines to save on costs.
-author: JagVeerappan
-ms.author: jagaveer
+author: mimckitt
+ms.author: mimckitt
 ms.topic: how-to
 ms.service: virtual-machine-scale-sets
 ms.subservice: spot
-ms.date: 02/26/2021
+ms.date: 10/22/2021
 ms.reviewer: cynthn
 ms.custom: devx-track-azurecli, devx-track-azurepowershell
 
@@ -20,15 +20,6 @@ Using Azure Spot Virtual Machines on scale sets allows you to take advantage of
 
 The amount of available capacity can vary based on size, region, time of day, and more. When deploying Azure Spot Virtual Machine instances on scale sets, Azure will allocate the instance only if there is capacity available, but there is no SLA for these instances. An Azure Spot Virtual machine scale set is deployed in a single fault domain and offers no high availability guarantees.
 
-
-## Pricing
-
-Pricing for Azure Spot Virtual Machine instances is variable, based on region and SKU. For more information, see pricing for [Linux](https://azure.microsoft.com/pricing/details/virtual-machine-scale-sets/linux/) and [Windows](https://azure.microsoft.com/pricing/details/virtual-machine-scale-sets/windows/). 
-
-
-With variable pricing, you have option to set a max price, in US dollars (USD), using up to five decimal places. For example, the value `0.98765`would be a max price of $0.98765 USD per hour. If you set the max price to be `-1`, the instance won't be evicted based on price. The price for the instance will be the current price for Azure Spot Virtual Machine or the price for a standard instance, which ever is less, as long as there is capacity and quota available.
-
-
 ## Limitations
 
 The following sizes are not supported for Azure Spot Virtual Machines:
@@ -37,15 +28,22 @@ The following sizes are not supported for Azure Spot Virtual Machines:
 
 Azure Spot Virtual Machine can be deployed to any region, except Microsoft Azure China 21Vianet.
 
-<a name="channel"></a>
-
 The following [offer types](https://azure.microsoft.com/support/legal/offer-details/) are currently supported:
 
 -	Enterprise Agreement
 -	Pay-as-you-go offer code (003P)
 -	Sponsored (0036P and 0136P)
 - For Cloud Service Provider (CSP), see the [Partner Center](/partner-center/azure-plan-get-started) or contact your partner directly.
 
+## Pricing
+
+Pricing for Azure Spot Virtual Machine instances is variable, based on region and SKU. For more information, see pricing for [Linux](https://azure.microsoft.com/pricing/details/virtual-machine-scale-sets/linux/) and [Windows](https://azure.microsoft.com/pricing/details/virtual-machine-scale-sets/windows/). 
+
+
+With variable pricing, you have option to set a max price, in US dollars (USD), using up to five decimal places. For example, the value `0.98765`would be a max price of $0.98765 USD per hour. If you set the max price to be `-1`, the instance won't be evicted based on price. The price for the instance will be the current price for Azure Spot Virtual Machine or the price for a standard instance, which ever is less, as long as there is capacity and quota available.
+
+
+
 ## Eviction policy
 
 When creating a scale set using Azure Spot Virtual Machines, you can set the eviction policy to *Deallocate* (default) or *Delete*. 
@@ -56,15 +54,20 @@ If you would like your instances to be deleted when they are evicted, you can se
 
 Users can opt in to receive in-VM notifications through [Azure Scheduled Events](../virtual-machines/linux/scheduled-events.md). This will notify you if your VMs are being evicted and you will have 30 seconds to finish any jobs and perform shutdown tasks prior to the eviction. 
 
-<a name="bkmk_try"></a>
-## Try & restore (preview)
+## Eviction history
+You can see historical pricing and eviction rates per size in a region in the portal. Select **View pricing history and compare prices in nearby regions** to see a table or graph of pricing for a specific size.  The pricing and eviction rates in the following images are only examples. 
 
-This new platform-level feature will use AI to automatically try to restore evicted Azure Spot Virtual Machine instances inside a scale set to maintain the target instance count. 
+**Chart**:
 
-> [!IMPORTANT]
-> Try & restore is currently in public preview.
-> This preview version is provided without a service level agreement, and it's not recommended for production workloads. Certain features might not be supported or might have constrained capabilities. 
-> For more information, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
+:::image type="content" source="../virtual-machines/media/spot-chart.png" alt-text="Screenshot of the region options with the difference in pricing and eviction rates as a chart.":::
+
+**Table**:
+
+:::image type="content" source="../virtual-machines/media/spot-table.png" alt-text="Screenshot of the region options with the difference in pricing and eviction rates as a table.":::
+
+## Try & restore 
+
+This platform-level feature will use AI to automatically try to restore evicted Azure Spot Virtual Machine instances inside a scale set to maintain the target instance count. 
 
 Try & restore benefits:
 - Attempts to restore Azure Spot Virtual Machines evicted due to capacity.
@@ -74,49 +77,6 @@ Try & restore benefits:
 
 Try & restore is disabled in scale sets that use [Autoscale](virtual-machine-scale-sets-autoscale-overview.md). The number of VMs in the scale set is driven by the autoscale rules.
 
-### Register for try & restore
-
-Before you can use the try & restore feature, you must register your subscription for the preview. The registration may take several minutes to complete. You can use the Azure CLI or PowerShell to complete the feature registration.
-
-
-**Use CLI**
-
-Use [az feature register](/cli/azure/feature#az_feature_register) to enable the preview for your subscription. 
-
-```azurecli-interactive
-az feature register --namespace Microsoft.Compute --name SpotTryRestore 
-```
-
-Feature registration can take up to 15 minutes. To check the registration status: 
-
-```azurecli-interactive
-az feature show --namespace Microsoft.Compute --name SpotTryRestore 
-```
-
-Once the feature has been registered for your subscription, complete the opt-in process by propagating the change into the Compute resource provider. 
-
-```azurecli-interactive
-az provider register --namespace Microsoft.Compute 
-```
-**Use PowerShell** 
-
-Use the [Register-AzProviderFeature](/powershell/module/az.resources/register-azproviderfeature) cmdlet to enable the preview for your subscription. 
-
-```azurepowershell-interactive
-Register-AzProviderFeature -FeatureName SpotTryRestore -ProviderNamespace Microsoft.Compute 
-```
-
-Feature registration can take up to 15 minutes. To check the registration status: 
-
-```azurepowershell-interactive
-Get-AzProviderFeature -FeatureName SpotTryRestore -ProviderNamespace Microsoft.Compute 
-```
-
-Once the feature has been registered for your subscription, complete the opt-in process by propagating the change into the Compute resource provider. 
-
-```azurepowershell-interactive
-Register-AzResourceProvider -ProviderNamespace Microsoft.Compute 
-```
 
 ## Placement Groups
 
@@ -135,8 +95,8 @@ To deploy Azure Spot Virtual Machines on scale sets, you can set the new *Priori
 
 ## Portal
 
-The process to create a scale set that uses Azure Spot Virtual Machines is the same as detailed in the [getting started article](quick-create-portal.md). When you are deploying a scale set, you can choose to set the Spot flag, and the eviction policy:
-![Create a scale set with Azure Spot Virtual Machines](media/virtual-machine-scale-sets-use-spot/vmss-spot-portal-max-price.png)
+The process to create a scale set that uses Azure Spot Virtual Machines is the same as detailed in the [getting started article](quick-create-portal.md). When you are deploying a scale set, you can choose to set the Spot flag, eviction type, eviction policy and if you want to enable try to restore instances:
+![Create a scale set with Azure Spot Virtual Machines](media/virtual-machine-scale-sets-use-spot/vmss-spot-portal-1.png)
 
 
 ## Azure CLI
@@ -153,7 +113,10 @@ az vmss create \
     --admin-username azureuser \
     --generate-ssh-keys \
     --priority Spot \
-    --max-price -1 
+    --eviction-policy Deallocate \
+    --max-price -1 \
+    --enable-spot-restore True \
+    --spot-restore-timeout PT1H
 ```
 
 ## PowerShell
@@ -168,7 +131,10 @@ $vmssConfig = New-AzVmssConfig `
     -SkuName "Standard_DS2" `
     -UpgradePolicyMode Automatic `
     -Priority "Spot" `
-    -max-price -1
+    -max-price -1 `
+    -EnableSpotRestore `
+    -SpotRestoreTimeout 60 `
+    -EvictionPolicy delete
 ```
 
 ## Resource Manager templates
@@ -177,7 +143,7 @@ The process to create a scale set that uses Azure Spot Virtual Machines is the s
 
 For Azure Spot Virtual Machine template deployments, use`"apiVersion": "2019-03-01"` or later. 
 
-Add the `priority`, `evictionPolicy` and `billingProfile` properties to the `"virtualMachineProfile":`section and the `"singlePlacementGroup": false,` property to the `"Microsoft.Compute/virtualMachineScaleSets"` section in your template:
+Add the `priority`, `evictionPolicy`, `billingProfile` and `spotRestoryPolicy` properties to the `"virtualMachineProfile":`section and the `"singlePlacementGroup": false,` property to the `"Microsoft.Compute/virtualMachineScaleSets"` section in your template:
 
 ```json
 
@@ -193,7 +159,11 @@ Add the `priority`, `evictionPolicy` and `billingProfile` properties to the `"vi
                 "evictionPolicy": "Deallocate",
                 "billingProfile": {
                     "maxPrice": -1
-                }
+                },
+                "spotRestorePolicy": {
+                  "enabled": "bool",
+                  "restoreTimeout": "string"
+    },
             },
 ```
 

articles/virtual-machine-scale-sets/use-spot.md

@@ -35,7 +35,9 @@ Here are some possible error codes you could receive when using Azure Spot Virtu
 | MoveResourcesWithAzureSpotVMNotSupported  |  The Move resources request contains an Azure Spot Virtual Machine. Not supported. Check the error details for virtual machine Ids. | You cannot move Azure Spot Virtual Machines. |
 | MoveResourcesWithAzureSpotVmssNotSupported  |  The Move resources request contains an Azure Spot virtual machine scale set. Not supported. Check the error details for virtual machine scale set Ids. | You cannot move Azure Spot virtual machine scale set instances. |
 | AzureSpotVMNotSupportedInVmssWithVMOrchestrationMode | Azure Spot Virtual Machine is not supported in Virtual machine scale set with VM Orchestration mode. | Set the orchestration mode to virtual machine scale set in order to use Azure Spot Virtual Machine instances. |
+| SpotRestorationIsNotSupportedForThisAPIVersion | Spot restoration feature is not supported for this API version. |  For an existing scaleset, perform a PATCH using using API version 2021-07-01 or later. <br><br> For new scale set deployments, add the following property to the Azure Resource Manager template using API version 2021-07-01 or later: <br><br> :::image type="content" source="media/spot/spot-try-restore-error-codes-1.png" alt-text="Error code sample to use the correct API version.":::| 
+| SpotRestorationIsSupportedOnlyForAzureSpotScaleSets | Spot restoration feature is supported only for Azure Spot Virtual Machine scale sets. | Spot restoration feature is only supported for Azure Spot Virtual Machine scale sets. To use this feature, deploy Azure Spot using Virtual Machine scale sets. | 
 
 
 **Next steps**
-For more information, see [spot Virtual Machines](./spot-vms.md).
+For more information, see [spot Virtual Machines](./spot-vms.md).