Skip to content

Commit 7bd93b2

Browse files
committed
Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into collab-migration-marketing-hub
2 parents db0e2b0 + 500fd00 commit 7bd93b2

File tree

1,233 files changed

+12352
-7523
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

1,233 files changed

+12352
-7523
lines changed

.openpublishing.publish.config.json

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -626,6 +626,12 @@
626626
"branch": "main",
627627
"branch_mapping": {}
628628
},
629+
{
630+
"path_to_root": "app-service-agentic-langgraph-foundry-node",
631+
"url": "https://github.com/Azure-Samples/app-service-agentic-langgraph-foundry-node",
632+
"branch": "main",
633+
"branch_mapping": {}
634+
},
629635
{
630636
"path_to_root": "app-service-agentic-semantic-kernel-java",
631637
"url": "https://github.com/Azure-Samples/app-service-agentic-semantic-kernel-java",

.openpublishing.redirection.json

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,40 @@
11
{
22
"redirections": [
3+
{
4+
"source_path": "articles/expressroute/expressroute-troubleshooting-arp-classic.md",
5+
"redirect_url": "/previous-versions/azure/expressroute/expressroute-troubleshooting-arp-classic",
6+
"redirect_document_id": false
7+
},
8+
{
9+
"source_path": "articles/expressroute/expressroute-howto-circuit-classic.md",
10+
"redirect_url": "/previous-versions/azure/expressroute/expressroute-howto-circuit-classic",
11+
"redirect_document_id": false
12+
},
13+
{
14+
"source_path": "articles/expressroute/expressroute-howto-routing-classic.md",
15+
"redirect_url": "/previous-versions/azure/expressroute/expressroute-howto-routing-classic",
16+
"redirect_document_id": false
17+
},
18+
{
19+
"source_path": "articles/expressroute/expressroute-howto-linkvnet-classic.md",
20+
"redirect_url": "/previous-versions/azure/expressroute/expressroute-howto-linkvnet-classic",
21+
"redirect_document_id": false
22+
},
23+
{
24+
"source_path": "articles/expressroute/expressroute-howto-move-arm.md",
25+
"redirect_url": "/previous-versions/azure/expressroute/expressroute-howto-move-arm",
26+
"redirect_document_id": false
27+
},
28+
{
29+
"source_path": "articles/expressroute/expressroute-move.md",
30+
"redirect_url": "/previous-versions/azure/expressroute/expressroute-move",
31+
"redirect_document_id": false
32+
},
33+
{
34+
"source_path": "articles/expressroute/expressroute-migration-classic-resource-manager.md",
35+
"redirect_url": "/previous-versions/azure/expressroute/expressroute-migration-classic-resource-manager",
36+
"redirect_document_id": false
37+
},
338
{
439
"source_path": "articles/api-center/discover-shadow-apis-dev-proxy.md",
540
"redirect_url": "/previous-versions/azure/api-center/discover-shadow-apis-dev-proxy",
@@ -4004,6 +4039,21 @@
40044039
"redirect_url": "/azure/expressroute/work-remotely-support",
40054040
"redirect_document_id": false
40064041
},
4042+
{
4043+
"source_path_from_root": "/articles/expressroute/expressroute-howto-add-ipv6-powershell.md",
4044+
"redirect_url": "/azure/expressroute/expressroute-howto-add-ipv6",
4045+
"redirect_document_id": false
4046+
},
4047+
{
4048+
"source_path_from_root": "/articles/expressroute/expressroute-howto-add-ipv6-cli.md",
4049+
"redirect_url": "/azure/expressroute/expressroute-howto-add-ipv6",
4050+
"redirect_document_id": false
4051+
},
4052+
{
4053+
"source_path_from_root": "/articles/expressroute/expressroute-howto-add-ipv6-portal.md",
4054+
"redirect_url": "/azure/expressroute/expressroute-howto-add-ipv6",
4055+
"redirect_document_id": false
4056+
},
40074057
{
40084058
"source_path_from_root": "/articles/external-attack-surface-management/data-connections-overview.md",
40094059
"redirect_url": "/azure/external-attack-surface-management/index",

articles/api-center/register-discover-mcp-server.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn about how Azure API Center can be a centralized registry for
44
author: dlepow
55
ms.service: azure-api-center
66
ms.topic: concept-article
7-
ms.date: 04/28/2025
7+
ms.date: 07/22/2025
88
ms.author: danlep
99
# Customer intent: As an API program manager, I want to register and discover MCP servers as APIs in my API Center inventory.
1010
ms.custom:
@@ -27,6 +27,9 @@ To register an MCP server in your API center inventory, specify the API type as
2727

2828
As described in the following sections, when you register an MCP server, you can specify an environment, deployment, and definition.
2929

30+
> [!TIP]
31+
> If you manage MCP servers in Azure API Management, you can enable automatic synchronization to keep your API center up to date with MCP servers and other APIs from your API Management instance. To learn more, see [Synchronize APIs from Azure API Management instance](synchronize-api-management-apis.md).
32+
3033

3134
### Environment and deployment for MCP server
3235

articles/api-center/synchronize-api-management-apis.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Integrate an API Management instance to Azure API Center for automa
44
author: dlepow
55
ms.service: azure-api-center
66
ms.topic: how-to
7-
ms.date: 06/25/2025
7+
ms.date: 07/22/2025
88
ms.author: danlep
99
ms.custom: devx-track-azurecli
1010
# Customer intent: As an API program manager, I want to integrate my Azure API Management instance with my API center and synchronize API Management APIs to my inventory.
@@ -23,7 +23,7 @@ Although you can use the Azure CLI to [import](import-api-management-apis.md) AP
2323

2424
When you integrate an API Management instance as an API source, the following happens:
2525

26-
1. All APIs, and optionally API definitions (specs), from the API Management instance are added to the API center inventory.
26+
1. All APIs, and optionally API definitions (specs), from the API Management instance are added to the API center inventory. MCP servers in API Management are included in the APIs added to the inventory.
2727
1. You configure an [environment](key-concepts.md#environment) of type *Azure API Management* in the API center.
2828
1. An associated [deployment](key-concepts.md#deployment) is created for each synchronized API definition from API Management.
2929

@@ -106,4 +106,5 @@ The API Management instance is integrated as an environment in your API center.
106106

107107
* [Manage API inventory with Azure CLI commands](manage-apis-azure-cli.md)
108108
* [Import APIs from API Management to your Azure API center](import-api-management-apis.md)
109+
* [Register and discover MCP servers in your API center](register-discover-mcp-server.md)
109110
* [Azure API Management documentation](../api-management/index.yml)

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ Each API Management [pricing tier](api-management-key-concepts.md#api-management
3939
| Autoscaling | No | No | Yes | No | Yes | No |Yes | No |
4040
| API analytics | No | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
4141
| [Self-hosted gateway](self-hosted-gateway-overview.md)<sup>3</sup> | No | Yes | No | No | No | No | Yes | No |
42-
| [Workspaces](workspaces-overview.md) | No | No | No | No | No | No | Yes | No |
42+
| [Workspaces](workspaces-overview.md) | No | No | No | No | No | No | Yes | Yes |
4343
| [TLS settings](api-management-howto-manage-protocols-ciphers.md) | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
4444
| [Client certificate authentication](api-management-howto-mutual-certificates-for-clients.md) | Yes | Yes | Yes | Yes | Yes | Yes |Yes | Yes |
4545
| [Policies](api-management-howto-policies.md)<sup>4</sup> | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |

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

Lines changed: 8 additions & 8 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: 07/11/2024
11+
ms.date: 07/22/2025
1212
ms.author: danlep
1313
---
1414

@@ -79,20 +79,20 @@ The following tables compare features available in the following API Management
7979
| [Virtual network injection](virtual-network-concepts.md) | Developer, Premium | Premium v2 || ✔️<sup>1,2</sup> | ✔️ |
8080
| [Inbound private endpoints](private-endpoint.md) | Developer, Basic, Standard, Premium | Standard v2 ||||
8181
| [Outbound virtual network integration](integrate-vnet-outbound.md) || Standard v2, Premium v2 ||| ✔️ |
82-
| [Availability zones](zone-redundancy.md) | Premium | ✔️<sup>3</sup> || ✔️<sup>1</sup> | ✔️<sup>3</sup> |
82+
| [Availability zones](zone-redundancy.md) | Premium | || ✔️<sup>1</sup> | |
8383
| [Multi-region deployment](api-management-howto-deploy-multi-region.md) | Premium ||| ✔️<sup>1</sup> ||
84-
| [CA root certificates](api-management-howto-ca-certificates.md) for certificate validation | ✔️ ||| ✔️<sup>4</sup> ||
84+
| [CA root certificates](api-management-howto-ca-certificates.md) for certificate validation | ✔️ ||| ✔️<sup>3</sup> ||
8585
| [Managed domain certificates](configure-custom-domain.md?tabs=managed#domain-certificate-options) | Developer, Basic, Standard, Premium || ✔️ |||
8686
| [TLS settings](api-management-howto-manage-protocols-ciphers.md) | ✔️ | ✔️ | ✔️ | ✔️ ||
87-
| **HTTP/2** (Client-to-gateway) | ✔️<sup>5</sup> | ✔️<sup>5</sup> || ✔️ ||
88-
| **HTTP/2** (Gateway-to-backend) || || ✔️ ||
87+
| **HTTP/2** (Client-to-gateway) | ✔️<sup>4</sup> | ✔️<sup>4</sup> || ✔️ ||
88+
| **HTTP/2** (Gateway-to-backend) || ✔️<sup>5</sup> || ✔️<sup>5</sup> ||
8989
| API threat detection with [Defender for APIs](protect-with-defender-for-apis.md) | ✔️ | ✔️ ||||
9090

9191
<sup>1</sup> Depends on how the gateway is deployed, but is the responsibility of the customer.<br/>
9292
<sup>2</sup> Connectivity to the self-hosted gateway v2 [configuration endpoint](self-hosted-gateway-overview.md#fqdn-dependencies) requires DNS resolution of the endpoint hostname.<br/>
93-
<sup>3</sup> Two zones are enabled by default; not configurable.<br/>
94-
<sup>4</sup> CA root certificates for self-hosted gateway are managed separately per gateway<br/>
95-
<sup>5</sup> Client protocol needs to be enabled.
93+
<sup>3</sup> CA root certificates for self-hosted gateway are managed separately per gateway<br/>
94+
<sup>4</sup> Client protocol needs to be enabled.<br/>
95+
<sup>5</sup> Configure using the [forward-request](forward-request-policy.md) policy.
9696

9797
### Backend APIs
9898

articles/api-management/azure-openai-emit-token-metric-policy.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -59,7 +59,7 @@ The `azure-openai-emit-token-metric` policy sends custom metrics to Application
5959
| ----------- | --------------------------------------------------------------------------------- | -------- |
6060
| dimension | Add one or more of these elements for each dimension included in the metric. | Yes |
6161

62-
### dimension attributes
62+
### Dimension attributes
6363

6464
| Attribute | Description | Required | Default value |
6565
| --------- | -------------------------- | ------------------ | -------------- |
@@ -77,7 +77,7 @@ The `azure-openai-emit-token-metric` policy sends custom metrics to Application
7777
### Usage notes
7878

7979
* This policy can be used multiple times per policy definition.
80-
* You can configure at most 10 custom dimensions for this policy.
80+
* You can configure at most 5 custom dimensions for this policy.
8181
* This policy can optionally be configured when adding an API from the Azure OpenAI Service using the portal.
8282
* Where available, values in the usage section of the response from the Azure OpenAI Service API are used to determine token metrics.
8383
* Certain Azure OpenAI endpoints support streaming of responses. When `stream` is set to `true` in the API request to enable streaming, token metrics are estimated.

articles/api-management/breaking-changes/managed-certificates-suspension-august-2025.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: Azure API Management - Managed certificates suspension for new custom domains (August 2025)
3-
description: Azure API Management is temporarily suspending managed certificates for new custom domains from August 15, 2025 to March 15, 2026 due to industry-wide changes in domain validation.
2+
title: Azure API Management - Managed certificates suspension for custom domains (August 2025)
3+
description: Azure API Management is temporarily suspending creation of managed certificates for custom domains from August 15, 2025 to March 15, 2026 due to industry-wide changes in domain validation.
44
services: api-management
55
author: dlepow
66
ms.service: azure-api-management
@@ -10,21 +10,21 @@ ms.date: 07/18/2025
1010
ms.author: danlep
1111
---
1212

13-
# Managed certificates suspension for new custom domains (August 2025)
13+
# Creation of managed certificates temporarily suspended for custom domains (August 2025)
1414

1515
[!INCLUDE [premium-dev-standard-basic.md](../../../includes/api-management-availability-premium-dev-standard-basic.md)]
1616

17-
Azure managed certificates for new custom domains in API Management will be temporarily turned off from August 15, 2025 to March 15, 2026. Existing managed certificates will be autorenewed and remain unaffected.
17+
Creation of Azure-managed certificates for custom domains in API Management will be temporarily turned off from August 15, 2025 to March 15, 2026. Existing managed certificates will be autorenewed and remain unaffected.
1818

19-
In the classic service tiers, Azure API Management offers [free, managed TLS certificates for custom domains](../configure-custom-domain.md#domain-certificate-options), allowing customers to secure their endpoints without purchasing and managing their own certificates. Because of an industry-wide deprecation of CNAME-based Domain Control Validation (DCV), our Certificate Authority (CA), DigiCert, will migrate to a new validation platform to meet Multi-Perspective Issuance Corroboration (MPIC) requirements. This migration requires a temporary suspension of managed certificates for new custom domains.
19+
In the classic service tiers, Azure API Management offers [free, managed TLS certificates for custom domains](../configure-custom-domain.md#domain-certificate-options) (preview), allowing customers to secure their endpoints without purchasing and managing their own certificates. Because of an industry-wide deprecation of CNAME-based Domain Control Validation (DCV), our Certificate Authority (CA), DigiCert, will migrate to a new validation platform to meet Multi-Perspective Issuance Corroboration (MPIC) requirements for issuing certificates. This migration requires us to temporarily suspend the creation of managed certificates for custom domains.
2020

2121
## Is my service affected by this?
2222

23-
You're affected if you plan to create new managed certificates for new custom domains in Azure API Management between August 15, 2025 and March 15, 2026. Existing managed certificates will be autorenewed before August 15, 2025 and will continue to function normally. There's no impact to existing managed certificates or custom domains already using them.
23+
You're affected if you plan to create new managed certificates for custom domains in Azure API Management between August 15, 2025 and March 15, 2026. Existing managed certificates will be autorenewed before August 15, 2025 and will continue to function normally. There's no impact to existing managed certificates or custom domains already using them.
2424

2525
## What is the deadline for the change?
2626

27-
The suspension of managed certificates for new custom domains will be enforced from August 15, 2025 to March 15, 2026. The capability to create managed certificates will resume after the migration to the new validation platform is complete.
27+
The suspension of managed certificates for custom domains will be enforced from August 15, 2025 to March 15, 2026. The capability to create managed certificates will resume after the migration to the new validation platform is complete.
2828

2929
## What do I need to do?
3030

articles/api-management/configure-custom-domain.md

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ author: dlepow
77

88
ms.service: azure-api-management
99
ms.topic: how-to
10-
ms.date: 05/30/2025
10+
ms.date: 07/25/2025
1111
ms.author: danlep
1212
ms.custom:
1313
- engagement-fy23
@@ -104,12 +104,20 @@ For more information, see [Use managed identities in Azure API Management](api-m
104104

105105
API Management offers a free, managed TLS certificate for your domain, if you don't wish to purchase and manage your own certificate. The certificate is autorenewed automatically.
106106

107+
> [!IMPORTANT]
108+
> **Creation of managed certificates for custom domains in API Management will be temporarily unavailable from August 15, 2025 to March 15, 2026.** Our Certificate Authority (CA), DigiCert, will migrate to a new validation platform to meet Multi-Perspective Issuance Corroboration (MPIC) requirements for issuing certificates. This migration requires us to temporarily suspend the creation of managed certificates for custom domains. [Learn more](breaking-changes/managed-certificates-suspension-august-2025.md)
109+
>
110+
> Existing managed certificates will be autorenewed and remain unaffected.
111+
>
112+
> While creation of managed certificates is suspended, use other certificate options for configuring custom domains.
113+
107114
> [!NOTE]
108-
> The free, managed TLS certificate is in preview. Currently, it's unavailable in the v2 service tiers.
115+
> The free, managed TLS certificate is in preview.
109116
110117
#### Limitations
111118

112119
* Currently can be used only with the Gateway endpoint of your API Management service
120+
* Not supported in the v2 tiers
113121
* Not supported with the self-hosted gateway
114122
* Not supported in the following Azure regions: France South and South Africa West
115123
* Currently available only in the Azure cloud

articles/api-management/emit-metric-policy.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ The `emit-metric` policy sends custom metrics in the specified format to Applica
5252
| ----------- | --------------------------------------------------------------------------------- | -------- |
5353
| dimension | Add one or more of these elements for each dimension included in the custom metric. | Yes |
5454

55-
### dimension attributes
55+
### Dimension attributes
5656

5757
| Attribute | Description | Required | Default value |
5858
| --------- | -------------------------- | ------------------ | -------------- |
@@ -69,7 +69,7 @@ The `emit-metric` policy sends custom metrics in the specified format to Applica
6969

7070
### Usage notes
7171

72-
* You can configure at most 10 custom dimensions for this policy.
72+
* You can configure at most 5 custom dimensions for this policy.
7373

7474
## Example
7575

0 commit comments

Comments
 (0)