Skip to content

Commit d5f4219

Browse files
Stacyrch140Stacyrch140
authored
Merge pull request #302474 from anaharris-ms/asux-anaharris
[Suggested Edits] Reliability - App Service: Add Azure portal guidance
2 parents 8e80b5d + 44b948b commit d5f4219

30 files changed

+819
-365
lines changed

‎articles/app-service/configure-zone-redundancy.md

Lines changed: 203 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,203 @@
1+
---
2+
title: Configure App Service plans for zone redundancy
3+
description: Learn how to configure your App Service plan for zone redundancy. Understand how your App Service plan instances are distributed across availability zones and how to check for zone redundancy support.
4+
ms.topic: conceptual
5+
ms.service: azure-app-service
6+
ms.date: 07/15/2025
7+
author: anaharris
8+
ms.author: anaharris
9+
10+
---
11+
# Configure App Service plans for zone redundancy
12+
13+
Azure App Service provides built-in reliability features to help ensure your applications are available and resilient. This article describes how to create your App Service plan with zone redundancy. It also covers how to disable and enable zone redundancy on existing plans, and how to check for zone redundancy support. To learn more about how App Service supports zone redundancy, see [Reliability in Azure App Service](../reliability/reliability-app-service.md).
14+
15+
## Create a new App Service plan with zone redundancy
16+
17+
To create a new App Service plan with zone redundancy:
18+
19+
# [Azure portal](#tab/portal)
20+
21+
Follow the guidance in [Create an App Service plan](../app-service/app-service-plan-manage.md#create-an-app-service-plan). Make sure to select *Enabled* for **Zone redundancy**.
22+
23+
:::image type="content" source="./media/configure-zone-redundancy/app-service-create-zr-plan.png" alt-text="Screenshot of zone redundancy enablement during App Service plan creation in the Azure portal.":::
24+
25+
# [Azure CLI](#tab/azurecli)
26+
27+
Set the `--zone-redundant` argument. You must also specify the `--number-of-workers` argument, which is the number of instances, and set a value greater than or equal to 2.
28+
29+
```azurecli
30+
az appservice plan create \
31+
-n <app-service-plan-name> \
32+
-g <resource-group-name> \
33+
--zone-redundant \
34+
--number-of-workers 2 \
35+
--sku P1V3
36+
```
37+
38+
# [Bicep](#tab/bicep)
39+
40+
Set the `zoneRedundant` property to `true`. You must also define the `sku.capacity` property to a value of 2 or greater. If you don't define the `sku.capacity` property, the value defaults to 1.
41+
42+
```bicep
43+
resource appServicePlan 'Microsoft.Web/serverfarms@2024-11-01' = {
44+
name: appServicePlanName
45+
location: location
46+
sku: {
47+
name: sku
48+
capacity: 2
49+
}
50+
kind: 'linux'
51+
properties: {
52+
reserved: true
53+
zoneRedundant: true
54+
}
55+
}
56+
```
57+
58+
---
59+
60+
## Set zone redundancy for an existing App Service plan
61+
62+
1. If you want to enable zone redundancy on an existing App Service plan, [check for zone redundancy support for your App Service plan](#check-for-zone-redundancy-support-on-an-app-service-plan).
63+
1. If your App Service plan supports zone redundancy, you can enable or disable it by using the Azure portal, Azure CLI, or Bicep/Resource Manager.
64+
65+
# [Azure portal](#tab/portal)
66+
67+
1. In the [Azure portal](https://portal.azure.com), navigate to your App Service plan.
68+
1. Select **Settings > Scale out (App Service plan)** in the left navigation pane.
69+
1. Select **Zone redundancy** if you wish to enable zone redundancy. Deselect if you wish to disable it.
70+
71+
Changing the zone redundancy status of an App Service plan is almost instantaneous. You don't experience downtime or performance problems during the process.
72+
73+
:::image type="content" source="./media/configure-zone-redundancy/app-service-plan-zone-redundancy-portal.png" alt-text="Screenshot of zone redundancy property for an App Service plan in the Azure portal.":::
74+
75+
> [!IMPORTANT]
76+
> If you have *Rules Based* scaling enabled, you can't use the Azure portal to enable zone redundancy. You must use the Azure CLI or Bicep/Resource Manager instead.
77+
78+
# [Azure CLI](#tab/azurecli)
79+
80+
- To *enable zone redundancy*, set the `zoneRedundant` property to `true`. You must also specify the `sku.capacity` argument, which is the number of instances, and set a value greater than or equal to 2.
81+
82+
```azurecli
83+
az appservice plan update \
84+
-n <app-service-plan-name> \
85+
-g <resource-group-name> \
86+
--set zoneRedundant=true sku.capacity=2
87+
```
88+
89+
- To *disable zone redundancy*, set the `zoneRedundant` property to `false`.
90+
91+
```azurecli
92+
az appservice plan update \
93+
-n <app-service-plan-name> \
94+
-g <resource-group-name> \
95+
--set zoneRedundant=false
96+
```
97+
98+
# [Bicep](#tab/bicep)
99+
100+
- To *enable zone redundancy*, set the `zoneRedundant` property to `true`. You must also define the `sku.capacity` property to a value of 2 or greater. If you don't define the `sku.capacity` property, the value defaults to 1.
101+
102+
```bicep
103+
resource appServicePlan 'Microsoft.Web/serverfarms@2024-11-01' = {
104+
name: appServicePlanName
105+
location: location
106+
sku: {
107+
name: sku
108+
capacity: 2
109+
}
110+
kind: 'linux'
111+
properties: {
112+
reserved: true
113+
zoneRedundant: true
114+
}
115+
}
116+
```
117+
118+
- To *disable zone redundancy*, set the `zoneRedundant` property to `false`.
119+
120+
---
121+
122+
## Check for zone redundancy support on an App Service plan
123+
124+
To see whether an existing App Service plan supports zone redundancy:
125+
126+
1. Get the maximum number of availability zones that the App Service plan can use by using the Azure portal, Azure CLI, or Bicep/Resource Manager:
127+
128+
# [Azure portal](#tab/portal)
129+
130+
1. In the [Azure portal](https://portal.azure.com), navigate to your App Service plan.
131+
132+
1. Select **Scale out (App Service plan)**.
133+
134+
The maximum number of zones that your App Service plan can use is shown in **Maximum available zones**.
135+
136+
:::image type="content" source="./media/configure-zone-redundancy/app-service-plan-max-zones-portal.png" alt-text="Screenshot of maximum available zones property in the Scale out blade in the Azure portal for an App Service plan.":::
137+
138+
# [Azure CLI](#tab/azurecli)
139+
140+
Query the plan's `maximumNumberOfZones` property:
141+
142+
```azurecli
143+
az appservice plan show \
144+
-n <app-service-plan-name> \
145+
-g <resource-group-name> \
146+
--query properties.maximumNumberOfZones
147+
```
148+
149+
# [Bicep](#tab/bicep)
150+
151+
Query the plan's `maximumNumberOfZones` property:
152+
153+
```bicep
154+
resource appServicePlan 'Microsoft.Web/serverfarms@2024-11-01' existing = {
155+
name: '<app-service-plan-name>'
156+
}
157+
158+
#disable-next-line BCP083
159+
output maximumNumberOfZones int = appServicePlan.properties.maximumNumberOfZones
160+
```
161+
162+
---
163+
164+
1. Compare the number with the following table to determine whether your plan supports zone redundancy:
165+
166+
| Maximum Number of Zones | Zone redundancy support |
167+
| ------------------------ | ----------------------- |
168+
| Greater than 1 | Supported |
169+
| Equal to 1 | Not supported* |
170+
171+
\* If you're on a plan or a stamp that doesn't support availability zones, you must create a new App Service plan in a new resource group so that you land on the App Service footprint that supports zones.
172+
173+
## View physical zones for an App Service plan
174+
175+
When you have a zone-redundant App Service plan, the platform automatically places the instances across [physical availability zone](../reliability/availability-zones-overview.md#physical-and-logical-availability-zones). If you want to verify that your instances are spread across zones, you can check which physical availability zones your plan's instances use by using the Azure portal or Azure CLI:
176+
177+
# [Azure portal](#tab/portal)
178+
179+
1. In the [Azure portal](https://portal.azure.com), go to your App Service app. If you have multiple apps in a plan, you can select any app.
180+
181+
1. Select the **Health check** blade.
182+
183+
1. Select the **Instances** tab to view the physical zone placement for each of your instances.
184+
185+
:::image type="content" source="./media/configure-zone-redundancy/app-service-physical-zones.png" alt-text="Screenshot of the Instances tab in the Health Check blade with the physical zone information in the Azure portal for an App Service app.":::
186+
187+
# [Azure CLI](#tab/azurecli)
188+
189+
Use the [REST API](/rest/api/appservice/web-apps/get-instance-info), which returns the `physicalZone` value for each instance in the App Service plan:
190+
191+
```azurecli
192+
az rest --method get --url https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Web/sites/{appName}/instances?api-version=2024-04-01
193+
```
194+
195+
# [Bicep](#tab/bicep)
196+
197+
This operation is not supported in Bicep. Use the Azure CLI or Azure portal instead.
198+
199+
---
200+
201+
## Related content
202+
- [Reliability in Azure App Service](../reliability/reliability-app-service.md)
203+
- [Configure App Service Environment for zone redundancy](../app-service/environment/configure-zone-redundancy-environment.md)

‎articles/app-service/environment/configure-zone-redundancy-environment.md

Lines changed: 187 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,187 @@
1+
---
2+
title: Configure App Service Environment and Isolated v2 App Service plans for zone redundancy
3+
description: Learn how to configure your App Service Environment and Isolated v2 App Service plan for zone redundancy
4+
ms.topic: conceptual
5+
ms.service: azure-app-service
6+
ms.date: 07/16/2025
7+
author: anaharris
8+
ms.author: anaharris
9+
10+
---
11+
# Configure App Service Environment and Isolated v2 App Service plans for zone redundancy
12+
13+
[App Service Environment](./overview.md) is a single-tenant deployment of Azure App Service that integrates with an Azure virtual network. Each App Service Environment deployment requires a dedicated subnet, which you can't use for other resources.
14+
15+
This article shows you how to create and modify your App Service Environment zone redundancy settings. It also shows you how to set up and modifiy zone redundancy settings for your plan.
16+
17+
To learn more details about how App Service Environment supports zone redundancy, see [Reliability in Azure App Service Environment](../../reliability/reliability-app-service-environment.md).
18+
19+
## Configure zone redundancy for an App Service Environment
20+
21+
- **To create a new App Service Environment with zone redundancy,** follow the steps in [Create an App Service Environment](creation.md). Make sure to select *Enabled* for **Zone redundancy**.
22+
23+
- **To enable or disable zone redundancy** for an existing App Service Environment, you can use Azure CLI or Bicep:
24+
25+
# [Azure portal](#tab/portal)
26+
27+
This operation is not yet supported in the Azure portal. Use the Azure CLI or Bicep instead.
28+
29+
# [Azure CLI](#tab/azurecli)
30+
31+
- To *enable zone redundancy*, set the `zoneRedundant` property to `true`.
32+
33+
```azurecli
34+
az resource update \
35+
--ids /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Web/hostingEnvironments/{aseName} \
36+
--set properties.zoneRedundant=true
37+
```
38+
39+
- To *disable zone redundancy*, set the `zoneRedundant` property to `false`.
40+
41+
```azurecli
42+
az resource update \
43+
--ids /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Web/hostingEnvironments/{aseName} \
44+
--set properties.zoneRedundant=false
45+
```
46+
47+
# [Bicep](#tab/bicep)
48+
49+
- To *enable zone redundancy*, set the `zoneRedundant` property to `true`.
50+
51+
```bicep
52+
resource appServiceEnvironment 'Microsoft.Web/hostingEnvironment@2024-11-01' = {
53+
name: appServiceEnvironmentName
54+
location: location
55+
properties: {
56+
zoneRedundant: true
57+
}
58+
}
59+
```
60+
61+
- To *disable zone redundancy*, set the `zoneRedundant` property to `false`.
62+
63+
---
64+
65+
> [!NOTE]
66+
> When you change the zone redundancy status of the App Service Environment, you initiate an upgrade that takes 12-24 hours to complete. During the upgrade process, you don't experience any downtime or performance problems.
67+
68+
## Configure Isolated v2 App Service plans with zone redundancy
69+
70+
All App Service plans created in an App Service Environment must be in an Isolated v2 pricing tier.
71+
72+
If you've enabled your App Service Environment to be zone redundant, the Isolated v2 App Service plans can also be set as zone redundant. However, because each plan has its own independent zone redundancy setting, you can manually enable or disable zone-redundancy on specific plans in an App Service Environment, as long as the App Service Environment is configured to be zone redundant.
73+
74+
- **To create a new Isolated v2 App Service plan with zone redundancy**, you can use the Azure portal, Azure CLI, or Bicep:
75+
76+
# [Azure portal](#tab/portal)
77+
78+
Follow the guidance in [Create an App Service plan](../app-service-plan-manage.md#create-an-app-service-plan). Make sure to:
79+
80+
- For **Region**, select your App Service Environment.
81+
- For **Pricing plan**, select *Isolated v2*.
82+
- For **Zone redundancy**, select **Enabled**.
83+
84+
# [Azure CLI](#tab/azurecli)
85+
86+
Set the `--zone-redundant` argument. You must also specify the `--number-of-workers` argument, which is the number of instances, and set a value greater than or equal to 2.
87+
88+
```azurecli
89+
az appservice plan create \
90+
-n <app-service-plan-name> \
91+
-g <resource-group-name> \
92+
--app-service-environment MyAse \
93+
--zone-redundant \
94+
--number-of-workers 2 \
95+
--sku I1V2
96+
```
97+
98+
# [Bicep](#tab/bicep)
99+
100+
Set the `zoneRedundant` property to `true`. You must also define the `sku.capacity` property to a value of 2 or greater. If you don't define the `sku.capacity` property, the value defaults to 1.
101+
102+
```bicep
103+
resource appServicePlan 'Microsoft.Web/serverfarms@2024-11-01' = {
104+
name: appServicePlanName
105+
location: location
106+
hostingEnvironmentProfile: {
107+
id: '...'
108+
}
109+
sku: {
110+
name: sku
111+
capacity: 2
112+
}
113+
kind: 'linux'
114+
properties: {
115+
reserved: true
116+
zoneRedundant: true
117+
}
118+
}
119+
```
120+
121+
---
122+
123+
- **To enable or disable zone redundancy** on an existing Isolated v2 App Service plan, you can use the Azure portal, Azure CLI, or Bicep:
124+
125+
# [Azure portal](#tab/portal)
126+
127+
1. In the [Azure portal](https://portal.azure.com), go to your App Service plan.
128+
1. Select **Settings > Scale out (App Service plan)** in the left navigation pane.
129+
1. Select **Zone redundancy** if you wish to enable zone redundancy. Deselect if you wish to disable it.
130+
131+
:::image type="content" source="./media/configure-zone-redundancy/app-service-plan-zone-redundancy-portal-isolated.png" alt-text="Screenshot of zone redundancy property for an App Service plan in the Azure portal.":::
132+
133+
>[!IMPORTANT]
134+
>If you have *Rules Based* scaling enabled, you can't use the Azure portal to enable zone redundancy for your App Service plan. You must use the Azure CLI or Bicep/Resource Manager instead.
135+
136+
# [Azure CLI](#tab/azurecli)
137+
138+
- To *enable zone redundancy*, set the `zoneRedundant` property to `true`. You must also specify the `sku.capacity` argument, which is the number of instances, and set a value greater than or equal to 2.
139+
140+
```azurecli
141+
az appservice plan update \
142+
-n <app-service-plan-name> \
143+
-g <resource-group-name> \
144+
--set zoneRedundant=true sku.capacity=2
145+
```
146+
147+
- To *disable zone redundancy*, set the `zoneRedundant` property to `false`.
148+
149+
```azurecli
150+
az appservice plan update \
151+
-n <app-service-plan-name> \
152+
-g <resource-group-name> \
153+
--set zoneRedundant=false
154+
```
155+
156+
# [Bicep](#tab/bicep)
157+
158+
- To *enable zone redundancy*, set the `zoneRedundant` property to `true`. You must also define the `sku.capacity` property to a value of 2 or greater. If you don't define the `sku.capacity` property, the value defaults to 1.
159+
160+
```bicep
161+
resource appServicePlan 'Microsoft.Web/serverfarms@2024-11-01' = {
162+
name: appServicePlanName
163+
location: location
164+
hostingEnvironmentProfile: {
165+
id: '...'
166+
}
167+
sku: {
168+
name: sku
169+
capacity: 2
170+
}
171+
kind: 'linux'
172+
properties: {
173+
reserved: true
174+
zoneRedundant: true
175+
}
176+
}
177+
```
178+
179+
- To *disable zone redundancy*, set the `zoneRedundant` property to `false`.
180+
181+
---
182+
183+
184+
## Related content
185+
186+
- [Configure App Service plans for reliability](../configure-zone-redundancy.md)
187+
- [Reliability in Azure App Service Environments](../../reliability/reliability-app-service-environment.md)

0 commit comments

Comments
 (0)