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/api-management/api-management-howto-deploy-multi-region.md
+8-8Lines changed: 8 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -58,11 +58,11 @@ When adding a region, you configure:
58
58
1. For the location you would like to remove, select the context menu using the **...** button at the right end of the table. Select **Delete**.
59
59
1. Confirm the deletion and select **Save** to apply the changes.
60
60
61
-
## Route API calls to regional back-end services
61
+
## Route API calls to regional backend services
62
62
63
-
By default, each API routes requests to a single back-end service URL. Even if you configure API Management gateways in various regions, the API gateway still forwards requests to the same back-end service, which is deployed in only one region. In this case, improved performance comes only from responses cached within API Management in a region specific to the request. Contacting the back end across the globe might still cause high latency.
63
+
By default, each API routes requests to a single backend service URL. Even if you configure API Management gateways in various regions, the API gateway still forwards requests to the same backend service, which is deployed in only one region. In this case, improved performance comes only from responses cached within API Management in a region specific to the request. Contacting the backend across the globe might still cause high latency.
64
64
65
-
To take advantage of geographical distribution of your system, you should deploy back-end services in the same regions as API Management instances. Then, by using policies and the `@(context.Deployment.Region)` property, you can route the traffic to local instances of your back end.
65
+
To take advantage of geographical distribution of your system, you should deploy backend services in the same regions as API Management instances. Then, by using policies and the `@(context.Deployment.Region)` property, you can route the traffic to local instances of your backend.
66
66
67
67
1. Go to your API Management instance and select **APIs** from the left menu.
68
68
2. Select your desired API.
@@ -102,11 +102,11 @@ To take advantage of geographical distribution of your system, you should deploy
102
102
</policies>
103
103
```
104
104
105
-
### Use Traffic Manager for routing to regional back ends
105
+
### Use Traffic Manager for routing to regional backends
106
106
107
-
You can also front your back-end services with [Azure Traffic Manager](https://azure.microsoft.com/services/traffic-manager/), direct the API calls to the Traffic Manager, and let it resolve the routing automatically.
107
+
You can also front your backend services with [Azure Traffic Manager](https://azure.microsoft.com/services/traffic-manager/), direct the API calls to the Traffic Manager, and let it resolve the routing automatically.
108
108
109
-
* For traffic distribution and failover, we recommend using Traffic Manager with the [**Geographic**](../traffic-manager/traffic-manager-routing-methods.md#geographic-traffic-routing-method) routing method. We don't recommend using Traffic Manager with the Weighted routing method with API Management back ends.
109
+
* For traffic distribution and failover, we recommend using Traffic Manager with the [**Geographic**](../traffic-manager/traffic-manager-routing-methods.md#geographic-traffic-routing-method) routing method. We don't recommend using Traffic Manager with the Weighted routing method with API Management backends.
110
110
111
111
* For traffic control during maintenance operations, we recommend using the Priority routing method.
112
112
@@ -124,8 +124,8 @@ API Management routes the requests to a regional gateway based on [the lowest la
124
124
125
125
Under some conditions, you might need to temporarily disable routing to one of the regional gateways. For example:
126
126
127
-
* After you add a new region, to keep it disabled while you configure and test the regional back-end service
128
-
* During regular back-end maintenance in a region
127
+
* After you add a new region, to keep it disabled while you configure and test the regional backend service
128
+
* During regular backend maintenance in a region
129
129
* To redirect traffic to other regions during a planned disaster recovery drill that simulates an unavailable region, or during a regional failure
130
130
131
131
To disable routing to a regional gateway in your API Management instance, update the gateway's `disableGateway` property value to `true`. You can set the value by using the [Create or update service](/rest/api/apimanagement/current-ga/api-management-service/create-or-update) REST API, the [az apim update](/cli/azure/apim#az-apim-update) command in the Azure CLI, the [set-azapimanagement](/powershell/module/az.apimanagement/set-azapimanagement) Azure PowerShell cmdlet, or other Azure tools.
Copy file name to clipboardExpand all lines: articles/reliability/reliability-api-management.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,7 +11,7 @@ ms.date: 07/17/2025
11
11
12
12
# Reliability in Azure API Management
13
13
14
-
Azure API Management is a fully managed service that helps organizations publish, secure, transform, maintain, and monitor APIs. The service acts as a gateway that sits between API consumers and back-end services. It provides essential capabilities like authentication, rate limiting, response caching, and request and response transformations. Organizations can use API Management to create a consistent and secure API experience while abstracting the complexity of the underlying back-end services.
14
+
Azure API Management is a fully managed service that helps organizations publish, secure, transform, maintain, and monitor APIs. The service acts as a gateway that sits between API consumers and backend services. It provides essential capabilities like authentication, rate limiting, response caching, and request and response transformations. Organizations can use API Management to create a consistent and secure API experience while abstracting the complexity of the underlying backend services.
15
15
16
16
API Management provides several reliability features designed to ensure high availability and fault tolerance for your API infrastructure. The service provides built-in redundancy through multiple deployment units, automatic failover capabilities between availability zones, and multi-region deployment options for global API distribution. API Management includes intelligent traffic routing, health monitoring, and automatic retry mechanisms that help maintain service continuity even during infrastructure failures or high-traffic scenarios.
17
17
@@ -50,7 +50,7 @@ To learn about how to deploy API Management to support your solution's reliabili
50
50
51
51
[!INCLUDE[introduction to transient faults](./includes/reliability-transient-fault-description-include.md)]
52
52
53
-
When you use API Management in front of an API, you might need to retry requests that fail because of transient faults. To protect your back-end API from being overwhelmed by too many requests, API Management provides retry, rate-limit, and quota policies. You can also configure load balancing and circuit breaker capabilities by using [back-end resources](../api-management/backends.md).
53
+
When you use API Management in front of an API, you might need to retry requests that fail because of transient faults. To protect your backend API from being overwhelmed by too many requests, API Management provides retry, rate-limit, and quota policies. You can also configure load balancing and circuit breaker capabilities by using [backend resources](../api-management/backends.md).
54
54
55
55
## Availability zone support
56
56
@@ -89,7 +89,7 @@ API Management supports availability zones for the Premium (classic) tier in all
89
89
90
90
### Requirements
91
91
92
-
You must use the Premium (classic) tier to configure availability zone support. API Management doesn't support availability zones in the classic Consumption, Developer, Basic, and Standard tiers or in the Basic v2, Standard v2, and Premium v2 tiers. To upgrade your instance to the Premium (classic) tier, see [Upgrade to the Premium tier](../api-management/upgrade-and-scale.md#change-your-api-management-service-tier).
92
+
You must use the Premium (classic) tier to configure availability zone support. API Management doesn't currently support availability zones in the classic Consumption, Developer, Basic, and Standard tiers or in the Basic v2, Standard v2, and Premium v2 tiers. To upgrade your instance to the Premium (classic) tier, see [Upgrade to the Premium tier](../api-management/upgrade-and-scale.md#change-your-api-management-service-tier).
93
93
94
94
> [!NOTE]
95
95
> The Premium v2 tier with enterprise capabilities is in preview. To determine whether your design should rely on early access features or generally available capabilities, evaluate your design and implementation timelines in relation to the available information about Premium v2's release and migration paths.
@@ -260,7 +260,7 @@ This section describes what to expect when API Management instances are configur
260
260
261
261
-**Traffic routing between regions:** API Management automatically routes incoming requests to a regional gateway. A request is routed to the regional gateway with the lowest latency from the client. If you need to use a different routing approach, you can configure your own Traffic Manager with custom routing rules. For more information, see [Use custom routing to API Management regional gateways](../api-management/api-management-howto-deploy-multi-region.md#use-custom-routing-to-api-management-regional-gateways).
262
262
263
-
When a request reaches an API Management regional gateway, it's routed to the back-end API unless a policy returns a response directly from the gateway, such as a cached response or an error code. In a multi-region solution, you need to take care to route to an instance of the back-end API that meets your performance requirements. For more information, see [Route API calls to regional back-end services](../api-management/api-management-howto-deploy-multi-region.md#route-api-calls-to-regional-back-end-services).
263
+
When a request reaches an API Management regional gateway, it's routed to the backend API unless a policy returns a response directly from the gateway, such as a cached response or an error code. In a multi-region solution, you need to take care to route to an instance of the backend API that meets your performance requirements. For more information, see [Route API calls to regional backend services](../api-management/api-management-howto-deploy-multi-region.md#route-api-calls-to-regional-back-end-services).
264
264
265
265
-**Data replication between regions:** Gateway configuration, such as APIs and policy definitions, are regularly synchronized between the primary and secondary regions you add. Propagation of updates to the regional gateways normally takes less than 10 seconds.
266
266
@@ -321,7 +321,7 @@ The SLA for API Management describes the expected availability of the service. I
321
321
322
322
When you deploy an API Management instance in multiple availability zones or regions, the uptime percentage defined in the SLA increases.
323
323
324
-
The service provides its own SLA, but you also need to account for the anticipated reliability of other workload components, such as the API back ends.
324
+
The service provides its own SLA, but you also need to account for the anticipated reliability of other workload components, such as the API backends.
0 commit comments