You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/reliability/reliability-api-management.md
+10-2Lines changed: 10 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -52,7 +52,7 @@ When you use Azure API Management in front of an API, you might need to retry re
52
52
[!INCLUDE[introduction to AZ](includes/reliability-availability-zone-description-include.md)]
53
53
54
54
Azure API Management offers two types of availability zone support when you deploy a Premium (classic) API Management instance in a supported region:
55
-
55
+
56
56
-*Automatic*. Azure API Management offers automatic availability zone support when you don't specify which availability zones to use.
57
57
58
58
-*Manual*. Azure API Management offers manual availability zone support when you explicitly specify which availability zones to use.
@@ -63,18 +63,26 @@ With availability zone support, Azure API Management replicates service componen
63
63
64
64
With automatic availability zone support, you can choose either a single unit or multi-unit instance configuration to achieve zone-redundancy:
65
65
66
-
-*Multi-unit configuration (Recommended)* If your instance has two or more units, Azure API Management makes a best effort attempt to spread your instance's units among the region's availability zones. There's no way to determine which availability zones your units are placed into. For maximum benefit of availability zones, we recommend that you deploy a minimum of three units, which can be distributed across all available zones in a region.
66
+
-*Multi-unit configuration (Recommended)* If your instance has two or more units, Azure API Management makes a best effort attempt to spread your instance's units among the region's availability zones. There's no way to determine which availability zones your units are placed into. For maximum benefit of availability zones, we recommend that you deploy a minimum of three units, which can be distributed across all available zones in a region.
67
+
68
+
:::image type="content" source="./media/reliability-api-management/zone-redundant-automatic-multi-unit.png" alt-text="Diagram that shows an API Management instance using automatic availability zone support, with three units configured." border="false" :::
67
69
68
70
-*Single unit configuration*. If your instance has a single unit, the unit's underlying VMs are distributed to two availability zones. There's no way to determine which availability zones the unit's VMs are placed into.
69
71
72
+
:::image type="content" source="./media/reliability-api-management/automatic-single-unit.png" alt-text="Diagram that shows an API Management instance using automatic availability zone support, with one unit configured." border="false" :::
73
+
70
74
### Manual availability zone support
71
75
72
76
If you want to explicitly select the availability zones to use, you can choose between zone-redundant and zonal configurations:
73
77
74
78
-*Zone-redundant*: Manually configure zone redundancy for an API Management instance in a supported region to provide redundancy for service components. When you select two or more availability zones to use, Azure automatically replicates the service components across the selected zones.
75
79
80
+
:::image type="content" source="./media/reliability-api-management/zone-redundant-automatic-multi-unit.png" alt-text="Diagram that shows an API Management instance using manual availability zone support, configured for zone redundancy, with three units configured." border="false" :::
81
+
76
82
-*Zonal*: The API Management service components are deployed in a single zone that you select within an Azure region. All of the units are placed into the same availability zone.
77
83
84
+
:::image type="content" source="./media/reliability-api-management/zonal.png" alt-text="Diagram that shows an API Management instance using manual availability zone support, configured for a zonal deployment into zone 1, with two units configured." border="false" :::
85
+
78
86
> [!IMPORTANT]
79
87
> Pinning to a single availability zone is only recommended when [cross-zone latency](./availability-zones-overview.md#inter-zone-latency) is too high for your needs, and when you have verified that the latency doesn't meet your requirements. By itself, a zonal instance doesn’t provide resiliency to an availability zone outage. To improve the resiliency of a zonal API Management deployment, you need to explicitly deploy separate instances into multiple availability zones and configure traffic routing and failover.
0 commit comments