Skip to content

Commit a4257b8

Browse files
Merge pull request #312482 from apwestgarth/asyncscaling_asp_docs
Updates to asynchronous scaling section
2 parents 2c84894 + 56a77bf commit a4257b8

1 file changed

Lines changed: 14 additions & 2 deletions

File tree

articles/app-service/app-service-plan-manage.md

Lines changed: 14 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ ms.assetid: 4859d0d5-3e3c-40cc-96eb-f318b2c51a3d
66
ms.topic: how-to
77
ms.author: msangapu
88
author: msangapu-msft
9-
ms.date: 11/17/2025
9+
ms.date: 03/19/2026
1010
ms.update-cycle: 1095-days
1111
ms.custom: "UpdateFrequency3"
1212

@@ -102,6 +102,19 @@ When creating or manually scaling out an App Service Plan you may experience sit
102102

103103
The preview of App Service Plan Asynchronous enables you to request your target number of instances and the platform scales out to the target number, without you having to modify your original request and retrying. The platform scales to the number of available instances and then triggers the underlying platform to make more instances available. You can make use of this functionality during scale-out operations or at plan creation time. This functionality is supported for all Basic, Standard, and Premium pricing plans.
104104

105+
> [!NOTE]
106+
> This behavior is NOT configurable for App Service Plans created in App Service Environments. App Service Environments create and scale App Service Plans asynchronously by default.
107+
108+
### Scaling up or down App Service Plan SKUs
109+
110+
When using asynchronous scaling, it's possible to scale up or down to a larger or smaller SKU. During this type of operation, no other properties of the App Service Plan can be changed. Scaling up or down to a new SKU may fail if there aren't enough App Service Plan instances available to fully satisfy the request, this is to prevent your App Service Plan having fewer workers than requested.
111+
112+
If a scale up or down operation fails, you can either scale in or out within the current SKU or perform the operation with the minim number of acceptable workers and then scale out asynchronously to the desired target.
113+
114+
### Cancelling an asynchronous scaling operation
115+
116+
An in-progress asynchronous scale operation is canceled only when you explicitly change the TargetWorkerCount property. Changes to other App Service Plan properties don't cancel the operation, including changes to the SKU, or App Service Plan instance count. App Service Plan instance count changes that can't be completed synchronously are ignored unless the TargetWorkerCount is also changed. To explicitly cancel the scale operation, set the TargetWorkerCount to 0.
117+
105118
### [Scale-out (CLI)](#tab/asyncscaleout)
106119
```azurecli-interactive
107120
az appservice plan update -g <resourceGroupName> -n <App Service Plan Name> --async-scaling-enabled true --number-of-workers <number of workers to scale out to>
@@ -111,7 +124,6 @@ az appservice plan update -g <resourceGroupName> -n <App Service Plan Name> --as
111124
```azurecli-interactive
112125
az appservice plan create -g asyncasp -n asyncasplinuxexample --number-of-workers 25 --sku p1v3 --async-scaling-enabled true --location northeurope
113126
```
114-
115127
---
116128

117129
<a name="delete"></a>

0 commit comments

Comments
 (0)