Skip to content

Commit f92eaed

Browse files
committed
review comments
1 parent 2da9b3f commit f92eaed

File tree

3 files changed

+10
-10
lines changed

3 files changed

+10
-10
lines changed

articles/api-management/api-management-policies.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -86,7 +86,7 @@ More information about policies:
8686
- [Convert XML to JSON](xml-to-json-policy.md) - Converts request or response body from XML to JSON.
8787
- [Find and replace string in body](find-and-replace-policy.md) - Finds a request or response substring and replaces it with a different substring.
8888
- [Mask URLs in content](redirect-content-urls-policy.md) - Rewrites (masks) links in the response body so that they point to the equivalent link via the gateway.
89-
- [Set backend service](set-backend-service-policy.md) - Changes the backend service base URL of an incoming request to a URL or a [backend](backends.md). Referencing a backend resource allows you to manage the backend service base URL and other settings in a single place. Also apply backend properties such as [distributing traffic to a pool of URLs](backends.md#load-balanced-pool-preview) and [circuit breaker rules](backends.md#circuit-breaker-preview) to protect the backend from too many requests.
89+
- [Set backend service](set-backend-service-policy.md) - Changes the backend service base URL of an incoming request to a URL or a [backend](backends.md). Referencing a backend resource allows you to manage the backend service base URL and other settings in a single place. Also implement [load balancing of traffic across a pool of backend services](backends.md#load-balanced-pool-preview) and [circuit breaker rules](backends.md#circuit-breaker-preview) to protect the backend from too many requests.
9090
- [Set body](set-body-policy.md) - Sets the message body for a request or response.
9191
- [Set HTTP header](set-header-policy.md) - Assigns a value to an existing response and/or request header or adds a new response and/or request header.
9292
- [Set query string parameter](set-query-parameter-policy.md) - Adds, replaces value of, or deletes request query string parameter.

articles/api-management/backends.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
22
title: Azure API Management backends | Microsoft Docs
3-
description: Learn about custom backends in Azure API Management
3+
description: Learn about backends in Azure API Management. A backend entity encapsulates information about the backend service, promoting reusability across APIs and improved governance.
44
services: api-management
55
author: dlepow
66
ms.service: api-management
77
ms.topic: article
8-
ms.date: 03/08/2024
8+
ms.date: 03/14/2024
99
ms.author: danlep
1010
ms.custom:
1111
---
@@ -25,20 +25,20 @@ API Management also supports using other Azure resources as an API backend, such
2525

2626
## Benefits of backends
2727

28-
API Management supports custom backends so you can manage the backend services of your API. A backend resource abstracts information about the backend service, promoting reusability across APIs and improved governance.
28+
API Management supports backend entities so you can manage the backend services of your API. A backend entity encapsulates information about the backend service, promoting reusability across APIs and improved governance.
2929

30-
Use custom backends for one or more of the following:
30+
Use backends for one or more of the following:
3131

3232
* Authorize the credentials of requests to the backend service
3333
* Take advantage of API Management functionality to maintain secrets in Azure Key Vault if [named values](api-management-howto-properties.md) are configured for header or query parameter authentication.
34-
* Protect your backend from too many requests
34+
* Define circuit breaker rules to protect your backend from too many requests
3535
* Route or load-balance requests to multiple backends
3636

37-
Configure and manage custom backends in the Azure portal, or using Azure APIs or tools.
37+
Configure and manage backend entities in the Azure portal, or using Azure APIs or tools.
3838

3939
## Reference backend using set-backend-service policy
4040

41-
After creating a backend, you can reference the backend in your APIs. Use the [`set-backend-service`](set-backend-service-policy.md) policy to direct an incoming API request to the custom backend. If you already configured a backend web service for an API, you can use the `set-backend-service` policy to redirect the request to a custom backend instead of the default backend web service configured for that API. For example:
41+
After creating a backend, you can reference the backend in your APIs. Use the [`set-backend-service`](set-backend-service-policy.md) policy to direct an incoming API request to the backend. If you already configured a backend web service for an API, you can use the `set-backend-service` policy to redirect the request to a backend entity instead. For example:
4242

4343
```xml
4444
<policies>

articles/api-management/set-backend-service-policy.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,14 +6,14 @@ author: dlepow
66

77
ms.service: api-management
88
ms.topic: article
9-
ms.date: 03/08/2024
9+
ms.date: 03/14/2024
1010
ms.author: danlep
1111
---
1212

1313
# Set backend service
1414
Use the `set-backend-service` policy to redirect an incoming request to a different backend than the one specified in the API settings for that operation. This policy changes the backend service base URL of the incoming request to a URL or [backend](backends.md) specified in the policy.
1515

16-
Referencing a backend entity allows you to manage the backend service base URL and other settings in a single place and reuse them across multiple APIs and operations. Also apply backend properties such as [distributing traffic to a pool of URLs](backends.md#load-balanced-pool-preview) and [circuit breaker rules](backends.md#circuit-breaker-preview) to protect the backend from too many requests.
16+
Referencing a backend entity allows you to manage the backend service base URL and other settings in a single place and reuse them across multiple APIs and operations. Also implement [load balancing of traffic across a pool of backend services](backends.md#load-balanced-pool-preview) and [circuit breaker rules](backends.md#circuit-breaker-preview) to protect the backend from too many requests.
1717

1818
> [!NOTE]
1919
> Backend entities can be managed via [Azure portal](how-to-configure-service-fabric-backend.md), management [API](/rest/api/apimanagement), and [PowerShell](https://www.powershellgallery.com/packages?q=apimanagement).

0 commit comments

Comments
 (0)