Skip to content

Commit b31f750

Browse files
jmart1428jmart1428
committed
edits
1 parent 1fbf9da commit b31f750

File tree

3 files changed

+87
-91
lines changed

3 files changed

+87
-91
lines changed

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

Lines changed: 46 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
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.
2+
title: Configure App Service Plans for Zone Redundancy
3+
description: Learn how to configure an App Service plan for zone redundancy, see how plan instances spread across availability zones, and check for zone redundancy support.
44
ms.topic: conceptual
55
ms.service: azure-app-service
66
ms.date: 07/15/2025
@@ -10,21 +10,21 @@ ms.author: anaharris
1010
---
1111
# Configure App Service plans for zone redundancy
1212

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).
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. For more information about how App Service supports zone redundancy, see [Reliability in App Service](../reliability/reliability-app-service.md).
1414

1515
## Create a new App Service plan with zone redundancy
1616

17-
To create a new App Service plan with zone redundancy:
17+
To create a new App Service plan with zone redundancy, follow the appropriate steps.
1818

1919
# [Azure portal](#tab/portal)
2020

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**.
21+
Follow the guidance to [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**.
2222

2323
:::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.":::
2424

2525
# [Azure CLI](#tab/azurecli)
2626

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.
27+
Set the `--zone-redundant` argument. You must also set the `--number-of-workers` argument, which is the number of instances, to a value of 2 or more.
2828

2929
```azurecli
3030
az appservice plan create \
@@ -37,7 +37,7 @@ az appservice plan create \
3737

3838
# [Bicep](#tab/bicep)
3939

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.
40+
Set the `zoneRedundant` property to `true`. You must also set the `sku.capacity` property to a value of 2 or more. If you don't define the `sku.capacity` property, the value defaults to 1.
4141

4242
```bicep
4343
resource appServicePlan 'Microsoft.Web/serverfarms@2024-11-01' = {
@@ -59,45 +59,45 @@ resource appServicePlan 'Microsoft.Web/serverfarms@2024-11-01' = {
5959

6060
## Set zone redundancy for an existing App Service plan
6161

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.
62+
1. To enable zone redundancy on an existing App Service plan, [check for zone redundancy support](#check-for-zone-redundancy-support-on-an-app-service-plan).
63+
1. If your App Service plan supports zone redundancy, use the Azure portal, Azure CLI, or Bicep and Azure Resource Manager to enable or disable it.
6464

6565
# [Azure portal](#tab/portal)
6666

67-
1. In the [Azure portal](https://portal.azure.com), navigate to your App Service plan.
67+
1. In the [Azure portal](https://portal.azure.com), go to your App Service plan.
6868
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.
69+
1. Select **Zone redundancy** to enable zone redundancy. Deselect it to disable it.
7070

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.
71+
The zone redundancy status of an App Service plan changes almost instantaneously. No downtime or performance problems occur during the process.
7272

7373
:::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.":::
7474

7575
> [!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.
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 and Resource Manager instead.
7777
7878
# [Azure CLI](#tab/azurecli)
7979

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.
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, to a value of 2 or more.
8181

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-
```
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+
```
8888
8989
- To *disable zone redundancy*, set the `zoneRedundant` property to `false`.
9090
91-
```azurecli
92-
az appservice plan update \
93-
-n <app-service-plan-name> \
94-
-g <resource-group-name> \
95-
--set zoneRedundant=false
96-
```
91+
```azurecli
92+
az appservice plan update \
93+
-n <app-service-plan-name> \
94+
-g <resource-group-name> \
95+
--set zoneRedundant=false
96+
```
9797
9898
# [Bicep](#tab/bicep)
9999
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.
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 more. If you don't define the `sku.capacity` property, the value defaults to 1.
101101
102102
```bicep
103103
resource appServicePlan 'Microsoft.Web/serverfarms@2024-11-01' = {
@@ -121,23 +121,23 @@ resource appServicePlan 'Microsoft.Web/serverfarms@2024-11-01' = {
121121
122122
## Check for zone redundancy support on an App Service plan
123123
124-
To see whether an existing App Service plan supports zone redundancy:
124+
To see whether an existing App Service plan supports zone redundancy, do the following steps:
125125
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:
126+
1. Determine the maximum number of availability zones that the App Service plan supports by using the Azure portal, Azure CLI, or Bicep and Resource Manager.
127127
128128
# [Azure portal](#tab/portal)
129129
130-
1. In the [Azure portal](https://portal.azure.com), navigate to your App Service plan.
130+
1. In the [Azure portal](https://portal.azure.com), go to your App Service plan.
131131
132132
1. Select **Scale out (App Service plan)**.
133133
134-
The maximum number of zones that your App Service plan can use is shown in **Maximum available zones**.
134+
Under **Maximum available zones**, see the maximum number of zones that your App Service plan can use.
135135
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.":::
136+
:::image type="content" source="./media/configure-zone-redundancy/app-service-plan-max-zones-portal.png" alt-text="Screenshot of the maximum available zones property in the scale-out section in the Azure portal for an App Service plan.":::
137137
138138
# [Azure CLI](#tab/azurecli)
139139
140-
Query the plan's `maximumNumberOfZones` property:
140+
Query the plan's `maximumNumberOfZones` property.
141141
142142
```azurecli
143143
az appservice plan show \
@@ -148,7 +148,7 @@ To see whether an existing App Service plan supports zone redundancy:
148148
149149
# [Bicep](#tab/bicep)
150150
151-
Query the plan's `maximumNumberOfZones` property:
151+
Query the plan's `maximumNumberOfZones` property.
152152
153153
```bicep
154154
resource appServicePlan 'Microsoft.Web/serverfarms@2024-11-01' existing = {
@@ -161,43 +161,43 @@ To see whether an existing App Service plan supports zone redundancy:
161161
162162
---
163163
164-
1. Compare the number with the following table to determine whether your plan supports zone redundancy:
164+
1. Compare the number with the following table to determine whether your plan supports zone redundancy.
165165
166-
| Maximum Number of Zones | Zone redundancy support |
166+
| Maximum number of zones | Zone redundancy support |
167167
| ------------------------ | ----------------------- |
168-
| Greater than 1 | Supported |
168+
| More than 1 | Supported |
169169
| Equal to 1 | Not supported* |
170170
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.
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. This setup ensures that your deployment lands on App Service infrastructure that supports availability zones.
172172
173173
## View physical zones for an App Service plan
174174
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:
175+
When you have a zone-redundant App Service plan, the platform automatically places the instances across [physical availability zones](../reliability/availability-zones-overview.md#physical-and-logical-availability-zones). To verify that your instances are spread across zones, use the Azure portal or Azure CLI to check which physical availability zones your plan's instances use.
176176
177177
# [Azure portal](#tab/portal)
178178
179179
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.
180180
181-
1. Select the **Health check** blade.
181+
1. Select **Health check**.
182182
183-
1. Select the **Instances** tab to view the physical zone placement for each of your instances.
183+
1. Select **Instances** to view the physical zone placement for each of your instances.
184184
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.":::
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 section with the physical zone information in the Azure portal for an App Service app.":::
186186
187187
# [Azure CLI](#tab/azurecli)
188188
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:
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.
190190
191191
```azurecli
192192
az rest --method get --url https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Web/sites/{appName}/instances?api-version=2024-04-01
193193
```
194194

195195
# [Bicep](#tab/bicep)
196196

197-
This operation is not supported in Bicep. Use the Azure CLI or Azure portal instead.
197+
Bicep doesn't support this operation. Use the Azure CLI or the Azure portal instead.
198198

199199
---
200200

201201
## 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)
202+
- [Reliability in App Service](../reliability/reliability-app-service.md)
203+
- [Configure an App Service Environment for zone redundancy](../app-service/environment/configure-zone-redundancy-environment.md)

0 commit comments

Comments
 (0)