Skip to content

Commit ec8582b

Browse files
committed
edits to address feedback from dlepow
1 parent 0a86d70 commit ec8582b

File tree

2 files changed

+13
-13
lines changed

2 files changed

+13
-13
lines changed

articles/api-management/api-management-howto-deploy-multi-region.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -58,11 +58,11 @@ When adding a region, you configure:
5858
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**.
5959
1. Confirm the deletion and select **Save** to apply the changes.
6060

61-
## Route API calls to regional back-end services
61+
## Route API calls to regional backend services
6262

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.
6464

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.
6666

6767
1. Go to your API Management instance and select **APIs** from the left menu.
6868
2. Select your desired API.
@@ -102,11 +102,11 @@ To take advantage of geographical distribution of your system, you should deploy
102102
</policies>
103103
```
104104

105-
### Use Traffic Manager for routing to regional back ends
105+
### Use Traffic Manager for routing to regional backends
106106

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.
108108

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.
110110

111111
* For traffic control during maintenance operations, we recommend using the Priority routing method.
112112

@@ -124,8 +124,8 @@ API Management routes the requests to a regional gateway based on [the lowest la
124124

125125
Under some conditions, you might need to temporarily disable routing to one of the regional gateways. For example:
126126

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
129129
* To redirect traffic to other regions during a planned disaster recovery drill that simulates an unavailable region, or during a regional failure
130130

131131
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.

articles/reliability/reliability-api-management.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ ms.date: 07/17/2025
1111

1212
# Reliability in Azure API Management
1313

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.
1515

1616
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.
1717

@@ -50,7 +50,7 @@ To learn about how to deploy API Management to support your solution's reliabili
5050

5151
[!INCLUDE[introduction to transient faults](./includes/reliability-transient-fault-description-include.md)]
5252

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).
5454

5555
## Availability zone support
5656

@@ -89,7 +89,7 @@ API Management supports availability zones for the Premium (classic) tier in all
8989

9090
### Requirements
9191

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).
9393

9494
> [!NOTE]
9595
> 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
260260

261261
- **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).
262262

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).
264264

265265
- **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.
266266

@@ -321,7 +321,7 @@ The SLA for API Management describes the expected availability of the service. I
321321

322322
When you deploy an API Management instance in multiple availability zones or regions, the uptime percentage defined in the SLA increases.
323323

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.
325325

326326
## Related content
327327

0 commit comments

Comments
 (0)