Nóta
Aðgangur að þessari síðu krefst heimildar. Þú getur prófað aðskrá þig inn eða breyta skráasöfnum.
Aðgangur að þessari síðu krefst heimildar. Þú getur prófað að breyta skráasöfnum.
APPLIES TO: Premium | Premium v2
This article describes how to enable and configure availability zones on an Azure API Management instance.
For more detailed information about reliability features of API Management, such as availability zones and multiregion deployments, see Reliability in API Management.
Availability zone support
While instances in both the Premium and Premium v2 tiers benefit from availability zone support, the implementation differs between the two tiers.
| Premium | Premium v2 |
|---|---|
| - Automatically enable zone redundancy when you create a new instance or add a new location to an existing instance in a supported region. - Zonal or zone-redundant settings can also be manually configured in a new or existing instance. |
- Optionally enable zone redundancy when creating an instance in a supported region. - Configuring zone redundancy in an existing instance isn't supported. |
When you create a new API Management instance in the Premium tier in a region that supports availability zones, or you deploy API Management to multiple regions, API Management provides two types of availability zone support:
Automatic: API Management provides automatic availability zone support when you don't specify which availability zones to use.
Manual: API Management provides manual availability zone support when you explicitly specify which availability zones to use.
Important
To ensure the reliability of your API Management instance, use the automatic availability zone support. To achieve maximum zone redundancy, deploy a minimum of two units in each region where you deploy API Management to ensure that an availability zone outage doesn't affect your instance. For more information, see Reliability in API Management.
Manual availability zone support
We recommend automatic availability zone configuration, but you can manually configure or update availability zones for an existing location of your API Management instance. The following sections provide steps for manually configuring zone redundancy on an existing location of your API Management instance, depending on whether the instance is injected in a virtual network.
Note
You can optionally enable a zonal configuration, where the API Management instance or location is deployed in a single availability zone. Because it doesn't provide resiliency to an outage in that zone, this configuration generally isn't recommended except for specific scenarios. For more information, see Reliability in API Management.
Caution
If you manually configure availability zones on an API Management instance that's configured with autoscaling, you might need to adjust your autoscale settings after configuration. In this case, the number of API Management units in autoscale rules and limits must be a multiple of the number of zones. If you use the automatic availability zone support, you don't need to adjust your autoscale settings.
Prerequisites
Your instance must be in one of the Azure regions that support availability zones.
If you don't have an API Management instance, create one by following the create a new API Management instance by using the Azure portal quickstart. Select the Premium service tier.
If you have an existing API Management instance, make sure that it's in the Premium (classic) tier. If it isn't, upgrade to the Premium tier.
Configure availability zones
Follow these steps to enable availability zone support on your API Management instance.
Enable availability zones when creating an instance
In the Premium tier, availability zone support is automatically enabled when you create a new API Management instance in a supported region. You can optionally specify which availability zones to use.
Existing instance not injected in a virtual network
To manually configure availability zone support on an existing location of an API Management instance, follow these steps:
Thoroughly understand all requirements and considerations for availability zones in API Management.
In the Azure portal, go to your API Management instance.
On the Deployment + infrastructure menu, select Locations.
Select the location that you want to enable. The location must support availability zones, as mentioned earlier in the prerequisites.
Under Units, select the number of scale units that you want in the location.
Under Availability zones, leave the Automatic setting (recommended), or optionally select one or more zones. If you select specific zones, the number of units that you select must distribute evenly across the availability zones. For example, if you select three units, you must select three zones so that each zone hosts one unit.
Select Apply, then select Save.
Existing instance injected in a virtual network
To manually configure availability zone support on an existing location of an API Management instance that's injected in a virtual network, follow these steps:
Review all requirements and considerations for enabling zone redundancy in API Management.
Create a public IP address in the location to enable availability zones. For detailed requirements, see the virtual networking guidance.
In the Azure portal, go to your API Management instance.
On the Deployment + infrastructure menu, select Locations.
Select the location that you want to enable. The location must support availability zones, as mentioned earlier in the prerequisites.
Under Units, select the number of scale units that you want in the location.
Under Availability zones, leave the Automatic setting (recommended), or optionally select one or more zones. If you select specific zones, the number of units that you select must distribute evenly across the availability zones. For example, if you select three units, you must select three zones so that each zone hosts one unit.
Under Public IP Address, select a public IP address in the location.
Select Apply, then select Save.
New gateway location
To add a new location to your API Management instance and to configure availability zones in that location, follow these steps:
Thoroughly understand all requirements and considerations for enabling availability zones in API Management.
If your API Management instance is deployed in a virtual network in the primary location, set up a virtual network, subnet, and optional public IP address in the new location where you plan to enable availability zones.
In the Azure portal, go to your API Management instance.
On the Deployment + infrastructure menu, select Locations.
Select + Add to add a new location. The location must support availability zones, as mentioned earlier in the prerequisites.
Under Units, select the number of scale units that you want in the location.
Under Availability zones, leave the Automatic setting (recommended), or optionally select one or more zones. If you select specific zones, the number of units that you select must distribute evenly across the availability zones. For example, if you select three units, you must select three zones so that each zone hosts one unit.
If your API Management instance is deployed in a virtual network, under Network, select the virtual network, subnet, and public IP address that are available in the location.
Select Add, and then select Save.
