Skip to content

Commit 2b7d57e

Browse files
committed
Merge remote-tracking branch 'upstream/main'
2 parents 4154301 + 1ec41f5 commit 2b7d57e

File tree

280 files changed

+5890
-3324
lines changed

Some content is hidden

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

280 files changed

+5890
-3324
lines changed

.openpublishing.redirection.json

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4039,6 +4039,21 @@
40394039
"redirect_url": "/azure/expressroute/work-remotely-support",
40404040
"redirect_document_id": false
40414041
},
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+
},
40424057
{
40434058
"source_path_from_root": "/articles/external-attack-surface-management/data-connections-overview.md",
40444059
"redirect_url": "/azure/external-attack-surface-management/index",
@@ -6943,6 +6958,11 @@
69436958
"source_path": "articles/signups/startup-programs.md",
69446959
"redirect_url": "/azure/signups/overview",
69456960
"redirect_document_id": false
6961+
},
6962+
{
6963+
"source_path": "articles/reliability/migrate-sql-database.md",
6964+
"redirect_url": "/azure/azure-sql/database/enable-zone-redundancy",
6965+
"redirect_document_id": false
69466966
}
69476967

69486968
]

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/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

articles/api-management/forward-request-policy.md

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ The `forward-request` policy forwards the incoming request to the backend servic
3535
| timeout | The amount of time in seconds to wait for the HTTP response headers to be returned by the backend service before a timeout error is raised. Minimum value is 0 seconds. Values greater than 240 seconds may not be honored, because the underlying network infrastructure can drop idle connections after this time. Policy expressions are allowed. You can specify either `timeout` or `timeout-ms` but not both. | No | 300 |
3636
| timeout-ms | The amount of time in milliseconds to wait for the HTTP response headers to be returned by the backend service before a timeout error is raised. Minimum value is 0 ms. Policy expressions are allowed. You can specify either `timeout` or `timeout-ms` but not both. | No | N/A |
3737
| continue-timeout | The amount of time in seconds to wait for a `100 Continue` status code to be returned by the backend service before a timeout error is raised. Policy expressions are allowed. | No | N/A |
38-
| http-version | The HTTP spec version to use when sending the HTTP response to the backend service. When using `2or1`, the gateway will favor HTTP /2 over /1, but fall back to HTTP /1 if HTTP /2 doesn't work. | No | 1 |
38+
| http-version | The HTTP protocol version to use when sending the HTTP request to the backend service: <br> - `1`: HTTP/1 <br> - `2`: HTTP/2 <br/> - `2or1`: The gateway favors HTTP/2 over HTTP/1, but falls back to HTTP/1 if HTTP/2 doesn't work.<br/><br/> HTTP/2 outbound is supported in select gateways. See [Usage notes](#usage-notes) for details. | No | 1 |
3939
| follow-redirects | Specifies whether redirects from the backend service are followed by the gateway or returned to the caller. Policy expressions are allowed. | No | `false` |
4040
| buffer-request-body | When set to `true`, request is buffered and will be reused on [retry](retry-policy.md). | No | `false` |
4141
| buffer-response | Affects processing of chunked responses. When set to `false`, each chunk received from the backend is immediately returned to the caller. When set to `true`, chunks are buffered (8 KB, unless end of stream is detected) and only then returned to the caller.<br/><br/>Set to `false` with backends such as those implementing [server-sent events (SSE)](how-to-server-sent-events.md) that require content to be returned or streamed immediately to the caller. Policy expressions aren't allowed. | No | `true` |
@@ -48,11 +48,18 @@ The `forward-request` policy forwards the incoming request to the backend servic
4848
- [**Policy scopes:**](./api-management-howto-policies.md#scopes) global, workspace, product, API, operation
4949
- [**Gateways:**](api-management-gateways-overview.md) classic, v2, consumption, self-hosted, workspace
5050

51+
### Usage notes
52+
53+
* Use the `http-version` attribute to enable the HTTP/2 protocol outbound from the gateway to the backend. Set the attribute to `2or1` or `2`. Currently, HTTP/2 outbound is supported in the self-hosted gateway and in preview in the v2 gateway.
54+
55+
> [!IMPORTANT]
56+
> In the v2 gateway, HTTP/2 is supported inbound to the API Management gateway and outbound from the gateway to the backend but not end-to-end. Currently, the v2 gateway downgrades an incoming HTTP/2 connection to HTTP/1 before forwarding the request to the backend.
57+
5158
## Examples
5259

5360
### Send request to HTTP/2 backend
5461

55-
The following API level policy forwards all API requests to an HTTP/2 backend service.
62+
The following API level policy forwards all API requests to an HTTP/2 backend service. For example, use this policy to forward requests from a self-hosted gateway to a gRPC backend.
5663

5764
```xml
5865
<!-- api level -->
@@ -69,8 +76,6 @@ The following API level policy forwards all API requests to an HTTP/2 backend se
6976
</policies>
7077
```
7178

72-
This is required for HTTP /2 or gRPC workloads and currently only supported in self-hosted gateway. Learn more in our [API gateway overview](api-management-gateways-overview.md).
73-
7479
### Forward request with timeout interval
7580

7681
The following API level policy forwards all API requests to the backend service with a timeout interval of 60 seconds.

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

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

61-
### dimension attributes
61+
### Dimension attributes
6262

6363
| Attribute | Description | Required | Default value |
6464
| --------- | -------------------------- | ------------------ | -------------- |
@@ -77,7 +77,7 @@ The `llm-emit-token-metric` policy sends custom metrics to Application Insights
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
* Where available, values in the usage section of the response from the LLM API are used to determine token metrics.
8282
* Certain LLM endpoints support streaming of responses. When `stream` is set to `true` in the API request to enable streaming, token metrics are estimated.
8383

articles/azure-functions/functions-bindings-mcp-trigger.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -421,6 +421,8 @@ In both cases, you must include a call to `builder.EnableMcpToolMetadata()` in y
421421
```csharp
422422
var builder = FunctionsApplication.CreateBuilder(args);
423423

424+
builder.ConfigureFunctionsWebApplication();
425+
424426
builder.EnableMcpToolMetadata();
425427

426428
// other configuration
@@ -449,6 +451,8 @@ You can define one or more tool properties in your entry point (`Program.cs`) fi
449451
```csharp
450452
var builder = FunctionsApplication.CreateBuilder(args);
451453

454+
builder.ConfigureFunctionsWebApplication();
455+
452456
builder.EnableMcpToolMetadata();
453457

454458
builder

articles/azure-functions/functions-bindings-mcp.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -64,6 +64,9 @@ To use this preview bundle in your app, replace the existing `extensionBundle` o
6464

6565
[!INCLUDE [functions-host-json-section-intro](../../includes/functions-host-json-section-intro.md)]
6666

67+
> [!NOTE]
68+
> Until the extension is no longer in preview, the JSON schema for `host.json` isn't updated, and specific properties and behaviors might change. During the preview period, you might see warnings in your editor that say the `mcp` section isn't recognized. You can safely ignore these warnings.
69+
6770
You can use `host.json` to define MCP server information.
6871

6972
```json

articles/azure-maps/tutorial-create-store-locator.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -59,7 +59,7 @@ This section lists the Azure Maps features that are demonstrated in the Contoso
5959
* A store logo on the header
6060
* A map that supports panning and zooming
6161
* A **My Location** button to search over the user's current location.
62-
* A Page layout that adjusts based on the width of the devices screen
62+
* A Page layout that adjusts based on the width of the device's screen
6363
* A search box and a search button
6464

6565
### Functionality features

0 commit comments

Comments
 (0)