Skip to content

Commit adc5705

Browse files
Merge pull request #303377 from MicrosoftDocs/main
Auto Publish – main to live - 2025-07-26 05:00 UTC
2 parents 699361b + 0f1a0cc commit adc5705

File tree

4 files changed

+42
-20
lines changed

4 files changed

+42
-20
lines changed

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/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/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/communication-services/concepts/analytics/logs/voice-and-video-logs.md

Lines changed: 15 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,11 @@
22
title: Azure Communication Services voice and video call logs
33
titleSuffix: An Azure Communication Services concept article
44
description: Learn about logging for Azure Communication Services voice and video calling.
5-
author: amagginetti
5+
author: sloanster
66
services: azure-communication-services
77

8-
ms.author: amagginetti
9-
ms.date: 03/21/2023
8+
ms.author: micahvivion
9+
ms.date: 07/25/2025
1010
ms.topic: conceptual
1111
ms.service: azure-communication-services
1212
ms.subservice: calling
@@ -35,23 +35,32 @@ any quality investigations, and using **[call diagnostics](../../voice-video-cal
3535

3636
## Available logs
3737

38-
Azure Communication Services creates eight call logs:
38+
Azure Communication Services calling generates **eight distinct log types**, each serving a specific purpose:
3939

4040
### **Call summary updates logs**:
41-
These log data arrive in Azure Monitor faster than the call summary logs and we recommend using these logs instead of the call summary log schema. This log contains basic information about the call, including all the relevant IDs, time stamps, endpoints, and SDK information.
41+
Fast-arriving logs with basic call metadata (IDs, timestamps, endpoints, SDK info). These log data arrive in Azure Monitor faster than the call summary logs. This log contains basic information about the call, including all the relevant IDs, time stamps, endpoints, and SDK information.
42+
- Data available within 60 minutes of the call ending.
43+
- May contain multiple rows per call participant.
44+
- Contains the most recent updates for each participant.
45+
- Useful for near-real-time monitoring and analysis of call activities.
4246

4347
To learn more, see: [Call summary updates log schema](call-summary-updates-log-schema.md)
4448

4549
### **Call summary logs**:
4650
This log is a subset of the Call summary updates log schema. It contains basic information about the call, including all the relevant IDs, time stamps, endpoints, and SDK information. For faster log latency, use the call summary updates logs instead.
51+
- Data available within 3-5 hours of the call ending.
52+
- Contains a single row per call participant.
53+
- Represents a snapshot of the call state at the time of finalization.
54+
- Useful for post-call analysis and reporting.
4755

4856
To learn more, see: [Call summary log schema](call-summary-log-schema.md)
4957

5058
### **Call diagnostics updates logs**:
5159
These log data arrive in Azure Monitor faster than the call diagnostics logs and we recommend using these logs instead of the call diagnostics log schema. This log contains information about a participant's call media stream, along with a set of metrics that indicate quality of experience measurements.
5260

5361
To learn more, see: [Call diagnostics updates log schema](call-diagnostics-updates-log-schema.md)
54-
62+
> [!NOTE]
63+
> **Call summary logs** and **Call diagnostics updates logs** tables of contain the same columns, but differ in the time they are updated and the number of rows they contain per call.
5564
5665
### **Call diagnostics logs**:
5766
This log is a subset of the call diagnostics updates log schema. It contains information about the stream, along with a set of metrics that indicate quality of experience measurements. For faster log latency, use the call summary updates logs instead.

0 commit comments

Comments
 (0)