Skip to content

Commit fee0848

Browse files
authored
Merge branch 'MicrosoftDocs:main' into main
2 parents 992aebe + 5aa912a commit fee0848

File tree

89 files changed

+2155
-236
lines changed

Some content is hidden

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

89 files changed

+2155
-236
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/backup/backup-azure-sql-restore-cli.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Restore SQL server databases in Azure VMs using Azure Backup via CLI
33
description: Learn how to use CLI to restore SQL server databases in Azure VMs in the Recovery Services vault.
44
ms.topic: how-to
5-
ms.date: 06/03/2025
5+
ms.date: 07/28/2025
66
ms.service: azure-backup
77
ms.custom: devx-track-azurecli, engagement-fy24
88
author: AbhishekMallick-MS
@@ -58,8 +58,8 @@ The list above contains three recovery points: each for full, differential, and
5858

5959
Ensure that the following prerequisites are met before restoring a database:
6060

61-
* You can restore the database only to an SQL instance in the same region.
62-
* The target instance must be registered with the same vault as the source.
61+
* You can restore the database only to an SQL instance in the same region or to a different region if Cross Region Restore is enabled on the vault.
62+
* The target instance must be registered with the same vault as the source, except during Cross Region Restore and Cross Subscription Restore. .
6363

6464
## Restore a database
6565

articles/backup/backup-azure-vms-agentless-multi-disk-crash-consistent-overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: About agentless multi-disk crash-consistent backup for Azure Virtual Machines by using Azure Backup
33
description: Learn about agentless multi-disk crash-consistent backup for Azure VMs by using Azure Backup via Azure portal.
44
ms.topic: overview
5-
ms.date: 07/30/2025
5+
ms.date: 07/25/2025
66
author: AbhishekMallick-MS
77
ms.author: v-mallicka
88
# Customer intent: As an IT administrator managing Azure VMs, I want to implement agentless multi-disk crash-consistent backups, so that I can optimize backup performance without the need for additional agents or scripts when my virtual machine can tolerate crash-consistent recovery.

articles/backup/backup-azure-vms-agentless-multi-disk-crash-consistent.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Back up Azure VM with agentless multi-disk crash-consistent backup by using Azure Backup
33
description: Learn how to configure backup for Azure VMs with agentless multi-disk crash-consistent backup via Azure portal.
44
ms.topic: how-to
5-
ms.date: 07/30/2025
5+
ms.date: 07/25/2025
66
author: AbhishekMallick-MS
77
ms.author: v-mallicka
88
# Customer intent: As an IT administrator managing Azure VMs, I want to configure agentless multi-disk crash-consistent backups, so that I can ensure robust data protection with minimal impact on performance.

articles/backup/backup-azure-vms-introduction.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: About Azure VM backup
33
description: In this article, learn how the Azure Backup service backs up Azure Virtual machines, and how to follow best practices.
44
ms.topic: overview
5-
ms.date: 07/30/2025
5+
ms.date: 07/25/2025
66
author: AbhishekMallick-MS
77
ms.author: v-mallicka
88
# Customer intent: "As an IT admin managing Azure VMs, I want to implement effective backup strategies using Azure Backup, so that I can ensure data protection and quick recovery for my virtual machines while minimizing downtime and costs."

articles/backup/backup-support-matrix-iaas.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Support matrix for Azure VM backups
33
description: Get a summary of support settings and limitations for backing up Azure VMs by using the Azure Backup service.
44
ms.topic: reference
5-
ms.date: 07/30/2025
5+
ms.date: 07/25/2025
66
ms.custom:
77
- references_regions
88
- linux-related-content

articles/backup/sql-support-matrix.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Azure Backup support matrix for SQL Server Backup in Azure VMs
33
description: Provides a summary of support settings and limitations when backing up SQL Server in Azure VMs with the Azure Backup service.
44
ms.topic: reference
5-
ms.date: 07/24/2025
5+
ms.date: 07/28/2025
66
ms.custom: references_regions
77
ms.service: azure-backup
88
author: AbhishekMallick-MS
@@ -38,6 +38,7 @@ You can use Azure Backup to back up SQL Server databases in Azure VMs hosted on
3838
|Number of full backups supported per day | One scheduled backup. <br><br> Three on-demand backups. <br><br> We recommend not to trigger more than three backups per day. However, to allow user retries in case of failed attempts, hard limit for on-demand backups is set to nine attempts. |
3939
| Log shipping | When you enable [log shipping](/sql/database-engine/log-shipping/about-log-shipping-sql-server?view=sql-server-ver15&preserve-view=true) on the SQL server database that you are backing up, we recommend you to disable log backups in the backup policy. This is because, the log shipping (which automatically sends transaction logs from the primary to secondary database) will interfere with the log backups enabled through Azure Backup. <br><br> Therefore, if you enable log shipping, ensure that your policy only has full and/or differential backups enabled. |
4040
| Retention period for on-demand backups | For Full/ Differential/ Incremental backups, the out-of-box retention is 45 days. <br><br> For Copy-only full backup, you can define a custom retention period. |
41+
| Restore limit for SQL in Azure VM | 20 |
4142

4243
_*The database size limit depends on the data transfer rate that we support and the backup time limit configuration. It’s not the hard limit. [Learn more](#backup-throughput-performance) on backup throughput performance._
4344

articles/backup/whats-new.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: What's new in the Azure Backup service
33
description: Learn about the new features in the Azure Backup service.
44
ms.topic: release-notes
5-
ms.date: 07/30/2025
5+
ms.date: 07/25/2025
66
ms.service: azure-backup
77
ms.custom:
88
- ignite-2023

0 commit comments

Comments
 (0)