Skip to content

Commit 8cb59a8

Browse files
Merge pull request #308727 from MicrosoftDocs/main
Auto Publish – main to live - 2025-11-24 23:00 UTC
2 parents 63daf67 + 4ac5367 commit 8cb59a8

28 files changed

Lines changed: 328 additions & 152 deletions

articles/api-management/api-management-features.md

Lines changed: 25 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -27,31 +27,31 @@ Each API Management [pricing tier](api-management-key-concepts.md#api-management
2727

2828
| Feature | Consumption | Developer | Basic | Basic v2 |Standard | Standard v2 | Premium | Premium v2 |
2929
| -------------------------------------------------------------------------------------------- | ----------- | --------- | --------- | --------- | ----- | -------- | ------- | ------- |
30-
| Microsoft Entra integration<sup>1</sup> | No | Yes | No | Yes | Yes | Yes | Yes | Yes |
31-
| Virtual network injection support | No | Yes | No | No | No | No | Yes | Yes |
32-
| Private endpoint support for inbound connections | No | Yes | Yes | No | Yes | Yes | Yes | Yes |
33-
| Outbound virtual network integration support | No | No | No | No | No | Yes | No | Yes |
34-
| Multi-region deployment | No | No | No | No | No | No | Yes | No |
35-
| Availability zones | No | No | No | No | No | No | Yes | Yes |
36-
| Multiple custom domain names for gateway | No | Yes | No | No | No | No | Yes | No |
37-
| Developer portal<sup>2</sup> | No | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
38-
| Built-in cache | No | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
39-
| [External cache](./api-management-howto-cache-external.md) | Yes | Yes | Yes | Yes | Yes | Yes |Yes | Yes
40-
| Autoscaling | No | No | Yes | No | Yes | No |Yes | No |
41-
| API analytics | No | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
42-
| [Self-hosted gateway](self-hosted-gateway-overview.md)<sup>3</sup> | No | Yes | No | No | No | No | Yes | No |
43-
| [Workspaces](workspaces-overview.md) | No | No | No | No | No | No | Yes | Yes |
44-
| [TLS settings](api-management-howto-manage-protocols-ciphers.md) | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
45-
| [Client certificate authentication](api-management-howto-mutual-certificates-for-clients.md) | Yes | Yes | Yes | Yes | Yes | Yes |Yes | Yes |
46-
| [Policies](api-management-howto-policies.md)<sup>4</sup> | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
47-
| [Credential manager](credentials-overview.md) | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
48-
| [Backup and restore](api-management-howto-disaster-recovery-backup-restore.md) | No | Yes | Yes | No | Yes | No | Yes | No |
49-
| Azure Monitor metrics | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
50-
| Azure Monitor and Log Analytics request logs | No | Yes | Yes | Yes | Yes | Yes |Yes | Yes |
51-
| Application Insights request logs | Yes | Yes | Yes | Yes | Yes | Yes |Yes | Yes |
52-
| Static IP | No | Yes | Yes | No |Yes | No | Yes | No |
53-
| Export API to Power Platform | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
54-
| Export API to Postman | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
30+
| Microsoft Entra integration<sup>1</sup> | | ✔️ | | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
31+
| Virtual network injection support | | ✔️ | | | | | ✔️ | ✔️ |
32+
| Private endpoint support for inbound connections | | ✔️ | ✔️ | | ✔️ | ✔️ | ✔️ | ✔️ |
33+
| Outbound virtual network integration support | | | | | | ✔️ | | ✔️ |
34+
| Multi-region deployment | | | | | | | ✔️ | |
35+
| Availability zones | | | | | | | ✔️ | ✔️ |
36+
| Multiple custom domain names for gateway | | ✔️ | | | | | ✔️ | |
37+
| Developer portal<sup>2</sup> | | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
38+
| Built-in cache | | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
39+
| [External cache](./api-management-howto-cache-external.md) | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |✔️ | ✔️
40+
| Autoscaling | | | ✔️ | ✔️ | ✔️ | ✔️ |✔️ | ✔️ |
41+
| API analytics | | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
42+
| [Self-hosted gateway](self-hosted-gateway-overview.md)<sup>3</sup> | | ✔️ | | | | | ✔️ | |
43+
| [Workspaces](workspaces-overview.md) | | | | | | | ✔️ | ✔️ |
44+
| [TLS settings](api-management-howto-manage-protocols-ciphers.md) | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
45+
| [Client certificate authentication](api-management-howto-mutual-certificates-for-clients.md) | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |✔️ | ✔️ |
46+
| [Policies](api-management-howto-policies.md)<sup>4</sup> | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
47+
| [Credential manager](credentials-overview.md) | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
48+
| [Backup and restore](api-management-howto-disaster-recovery-backup-restore.md) | | ✔️ | ✔️ | | ✔️ | | ✔️ | |
49+
| Azure Monitor metrics | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
50+
| Azure Monitor and Log Analytics request logs | | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |✔️ | ✔️ |
51+
| Application Insights request logs | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |✔️ | ✔️ |
52+
| Static IP | | ✔️ | ✔️ | |✔️ | | ✔️ | |
53+
| Export API to Power Platform | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
54+
| Export API to Postman | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
5555

5656

5757

articles/api-management/api-management-gateways-overview.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ ms.service: azure-api-management
88
ms.custom:
99
- build-2024
1010
ms.topic: concept-article
11-
ms.date: 09/30/2025
11+
ms.date: 11/21/2025
1212
ms.author: danlep
1313
---
1414

@@ -115,7 +115,7 @@ The following tables compare features available in the following API Management
115115
| [Azure OpenAI in AI Foundry models and LLMs](azure-ai-foundry-api.md) | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
116116
| [Pass-through MCP server](expose-existing-mcp-server.md) | ✔️ | ✔️ || ✔️ ||
117117
| [Export REST API as MCP server](export-rest-mcp-server.md) | ✔️ | ✔️ || ✔️ ||
118-
| A2A agent || ✔️ ||||
118+
| [A2A agent](agent-to-agent-api.md) || ✔️ ||||
119119
| [Circuit breaker in backend](backends.md#circuit-breaker) | ✔️ | ✔️ || ✔️ | ✔️ |
120120
| [Load-balanced backend pool](backends.md#load-balanced-pool) | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
121121

@@ -185,6 +185,7 @@ For estimated maximum gateway throughput in the API Management service tiers, se
185185

186186
* **v2 tiers**
187187
* Scale gateway capacity by adding and removing scale [units](upgrade-and-scale.md), or upgrade the service tier.
188+
* Optionally configure [Azure Monitor autoscale](api-management-howto-autoscale.md).
188189

189190
* **Consumption tier**
190191
* API Management instances in the Consumption tier scale automatically based on the traffic.

articles/api-management/automate-portal-deployments.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ You can automate the migration of content between two API Management services, f
2626
> Using the script to migrate developer portal content between an API Management instance in a classic tier (for example, Standard) and an instance in a v2 tier (for example, Standard v2) isn't currently supported. Migration of portal content between instances in the v2 tiers is also not supported.
2727
2828
> [!NOTE]
29-
> If you're using a self-hosted developer portal with an explicitly defined custom storage account to host media files (that is, you define the `blobStorageUrl` setting in the `config.design.json` configuration file), you need to use the [original `scripts.v2/migrate.js` script](https://github.com/Azure/api-management-developer-portal/blob/master/scripts.v2/migrate.js). The original script doesn't work for managed or self-hosted portals with the media storage account managed by API Management. In that case, use the script from the `/scripts.v3` folder instead.
29+
> If you're using a self-hosted developer portal with an explicitly defined custom storage account to host media files (that is, you define the `blobStorageUrl` setting in the `config.design.json` configuration file), you need to use the [original `scripts.v3/migrate.js` script](https://github.com/Azure/api-management-developer-portal/blob/master/scripts.v3/migrate.js). The original script doesn't work for managed or self-hosted portals with the media storage account managed by API Management. In that case, use the script from the `/scripts.v3` folder instead.
3030
3131
The script performs the following steps:
3232

articles/api-management/backends.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ services: api-management
55
author: dlepow
66
ms.service: azure-api-management
77
ms.topic: concept-article
8-
ms.date: 11/14/2025
8+
ms.date: 11/20/2025
99
ms.author: danlep
1010
ms.custom:
1111
- build-2024
@@ -113,6 +113,8 @@ To add CA certificate details, follow these steps:
113113
1. Select **Add**.
114114
1. Select **Create**.
115115

116+
:::image type="content" source="media/backends/ca-certificate.png" alt-text="Screenshot of configuring CA certificate details for a backend in the portal.":::
117+
116118
> [!NOTE]
117119
> When you configure details of a custom CA certificate in the backend entity, API Management always validates the certificate name and certificate chain, regardless of whether you enable or disable validation settings in the backend's `backendTlsProperties`.
118120
41.6 KB
Loading

articles/api-management/v2-service-tiers-overview.md

Lines changed: 31 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: dlepow
66

77
ms.service: azure-api-management
88
ms.topic: concept-article
9-
ms.date: 11/11/2025
9+
ms.date: 11/21/2025
1010
ms.author: danlep
1111
ms.custom:
1212
- references_regions
@@ -25,7 +25,7 @@ The following v2 tiers are generally available:
2525

2626
* **Standard v2** - Standard v2 is a production-ready tier with support for network-isolated backends.
2727

28-
* **Premium v2** - Premium v2 offers enterprise features including full virtual network isolation, scaling for high volume workloads, availability zones, and workspaces.
28+
* **Premium v2** - Premium v2 offers enterprise features including full virtual network isolation, scaling for high volume workloads, availability zones, and workspaces. [Read the blog post](https://techcommunity.microsoft.com/blog/integrationsonazureblog/announcing-the-general-availability-ga-of-the-premium-v2-tier-of-azure-api-manag/4471499) announcing general availability.
2929

3030
## Key capabilities
3131

@@ -58,26 +58,36 @@ For a current list of regions where the v2 tiers are available, see [Availabilit
5858

5959
### Classic feature availability
6060

61-
Most capabilities of the classic API Management tiers are supported in the v2 tiers. However, the following capabilities aren't supported in the v2 tiers:
61+
Most capabilities of the classic API Management tiers are supported directly in the v2 tiers. However, some features have replacements in the v2 tiers, and some currently aren't available. For detailed comparisons, see
6262

63-
* API Management service configuration using Git
64-
* Back up and restore of API Management instance
65-
* Enabling Azure DDoS Protection
66-
* Direct Management API access
63+
* [Feature-based comparison of the Azure API Management tiers](api-management-features.md)
64+
* [API Management gateways overview](api-management-gateways-overview.md)
65+
66+
#### Features replaced in v2 (with comparable functionality)
67+
68+
| Classic feature | Replacement in v2 |
69+
|---------|-----|
70+
| [Built-in analytics](monitor-api-management.md#legacy-built-in-analytics) | [Azure Monitor-based dashboard](monitor-api-management.md#get-api-analytics-in-azure-api-management)<sup>1</sup> |
71+
| [CA certificates](api-management-howto-ca-certificates.md) managed in the global certificate list | CA certificates referenced in [backend](backends.md#configure-certificates-for-authorization-credentials) entity |
72+
| [Capacity](api-management-capacity.md#available-capacity-metrics) metric | [CPU Percentage of Gateway and Memory Percentage of Gateway](api-management-capacity.md#available-capacity-metrics) metrics<sup>1</sup> |
6773

68-
### Limitations
74+
<sup>1</sup> Also available in the classic tiers.
6975

70-
The following API Management capabilities are currently unavailable in the v2 tiers.
7176

72-
**Infrastructure and networking**
77+
#### Currently unavailable features
78+
79+
The following are currently unavailable in the v2 tiers.
80+
81+
**Infrastructure and configuration**
7382
* Multi-region deployment
7483
* Multiple custom domain names
75-
* Capacity metric - *replaced by CPU Percentage of Gateway and Memory Percentage of Gateway metrics*
76-
* Built-in analytics - *replaced by Azure Monitor-based dashboard*
77-
* CA certificates - *replaced by CA certificates in backend entity*
7884
* Sending events to Event Grid
7985
* Event Hubs event metrics
80-
* Upgrade to v2 tiers from classic tiers
86+
* API Management service configuration using Git
87+
* Enabling Azure DDoS Protection
88+
* Direct Management API access
89+
* Back up and restore of API Management instance
90+
* Upgrade to v2 tiers from classic tiers
8191

8292
**Developer portal**
8393
* Reports
@@ -92,15 +102,11 @@ The following API Management capabilities are currently unavailable in the v2 ti
92102

93103
## Resource limits
94104

95-
The following resource limits apply to the v2 tiers.
96-
97-
[!INCLUDE [api-management-service-limits-v2](../../includes/api-management-service-limits-v2.md)]
98-
99-
## Developer portal limits
105+
The following resource limits apply to the v2 tiers:
100106

101-
The following limits apply to the developer portal in the v2 tiers.
107+
* [Resource limits for v2 tiers](/azure/azure-resource-manager/management/azure-subscription-service-limits?toc=%2Fazure%2Fapi-management%2Ftoc.json&bc=%2Fazure%2Fapi-management%2Fbreadcrumb%2Ftoc.json#limits---api-management-v2-tiers)
108+
* [Developer portal limits for v2 tiers](/azure/azure-resource-manager/management/azure-subscription-service-limits?toc=%2Fazure%2Fapi-management%2Ftoc.json&bc=%2Fazure%2Fapi-management%2Fbreadcrumb%2Ftoc.json#limits---developer-portal-in-api-management-v2-tiers)
102109

103-
[!INCLUDE [api-management-developer-portal-limits-v2](../../includes/api-management-developer-portal-limits-v2.md)]
104110

105111
## Deployment
106112

@@ -112,10 +118,6 @@ Deploy a v2 tier instance using the Azure portal or using tools such as the Azur
112118

113119
A: No. Currently you can't migrate an existing API Management instance (in the Consumption, Developer, Basic, Standard, or Premium tier) to a new v2 tier instance. Currently the v2 tiers are available for newly created service instances only.
114120

115-
### Q: What's the relationship between the stv2 compute platform and the v2 tiers?
116-
117-
A: They're not related. stv2 is a compute platform version of the Developer, Basic, Standard, and Premium tier service instances. stv2 is a successor to the stv1 compute platform that retired in 2024.
118-
119121
### Q: Will I still be able to provision Developer, Basic, Standard, or Premium tier services?
120122

121123
A: Yes, there are no changes to the classic Developer, Basic, Standard, or Premium tiers.
@@ -130,6 +132,10 @@ The Premium tier and Premium v2 tier support full network isolation by deploymen
130132

131133
A: No, such a deployment is only supported in the Premium and Premium v2 tiers.
132134

135+
### Q: What's the relationship between the stv2 compute platform and the v2 tiers?
136+
137+
A: They're not related. stv2 is a compute platform version of the Developer, Basic, Standard, and Premium tier service instances. stv2 is a successor to the stv1 compute platform that retired in 2024.
138+
133139
## Related content
134140

135141
* Compare the API Management [tiers](api-management-features.md).

0 commit comments

Comments
 (0)