Skip to content

Commit 9a4ea67

Browse files
committed
Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into afd-wildcard
2 parents efe45b3 + 6619555 commit 9a4ea67

69 files changed

Lines changed: 1564 additions & 1893 deletions

File tree

Some content is hidden

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

.openpublishing.redirection.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,10 @@
11
{
22
"redirections": [
3+
{
4+
"source_path": "articles/backup/backup-azure-enhanced-soft-delete-about.md",
5+
"redirect_url": "/azure/backup/secure-by-default",
6+
"redirect_document_id": false
7+
},
38
{
49
"source_path": "articles/migrate/best-practices-assessment.md",
510
"redirect_url": "/previous-versions/azure/migrate/best-practices-assessment",

articles/api-management/azure-ai-foundry-api.md

Lines changed: 20 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ ms.service: azure-api-management
55
author: dlepow
66
ms.author: danlep
77
ms.topic: how-to
8-
ms.date: 10/07/2025
8+
ms.date: 03/24/2026
99
ms.update-cycle: 180-days
1010
ms.collection: ce-skilling-ai-copilot
1111
ms.custom: template-how-to, build-2024
@@ -21,32 +21,31 @@ Learn more about managing AI APIs in API Management:
2121

2222
* [AI gateway capabilities in Azure API Management](genai-gateway-capabilities.md)
2323

24-
2524
## Client compatibility options
2625

2726
API Management supports two client compatibility options for AI APIs from Microsoft Foundry. When you import the API using the wizard, choose the option suitable for your model deployment. The option determines how clients call the API and how the API Management instance routes requests to the Foundry tool.
2827

29-
* **Azure OpenAI** - Manage Azure OpenAI in Microsoft Foundry model deployments.
28+
* **Azure OpenAI**: Manage Azure OpenAI in Microsoft Foundry model deployments.
3029

31-
Clients call the deployment at an `/openai` endpoint such as `/openai/deployments/my-deployment/chat/completions`. Deployment name is passed in the request path. Use this option if your Foundry tool only includes Azure OpenAI model deployments.
30+
Clients call the deployment at an `/openai` endpoint such as `/openai/deployments/my-deployment/chat/completions`. Deployment name is passed in the request path. Use this option if your Foundry tool only includes Azure OpenAI model deployments.
3231

33-
* **Azure AI** - Manage model endpoints in Microsoft Foundry that are exposed through the [Azure AI Model Inference API](/azure/ai-studio/reference/reference-model-inference-api).
32+
* **Azure AI**: Manage model endpoints in Microsoft Foundry that are exposed through the [Azure AI Model Inference API](/rest/api/aifoundry/modelinference/).
3433

3534
Clients call the deployment at a `/models` endpoint such as `/my-model/models/chat/completions`. Deployment name is passed in the request body. Use this option if you want flexibility to switch between models exposed through the Azure AI Model Inference API and those deployed in Azure OpenAI in Foundry Models.
3635

3736
## Prerequisites
3837

39-
- An existing API Management instance. [Create one if you haven't already](get-started-create-service-instance.md).
38+
* An existing API Management instance. [Create one if you haven't already](get-started-create-service-instance.md).
4039

41-
- A Foundry tool in your subscription with one or more models deployed. Examples include models deployed in Microsoft Foundry or Azure OpenAI.
40+
* A Foundry tool in your subscription with one or more models deployed. Examples include models deployed in Microsoft Foundry or Azure OpenAI.
4241

4342
## Import Microsoft Foundry API using the portal
4443

45-
Use the following steps to import an AI API to API Management.
44+
Use the following steps to import an AI API to API Management.
4645

4746
When you import the API, API Management automatically configures:
4847

49-
* Operations for each of the API's REST API endpoints
48+
* Operations for each of the API's REST API endpoints.
5049
* A system-assigned identity with the necessary permissions to access the Foundry tool deployment.
5150
* A [backend](backends.md) resource and a [set-backend-service](set-backend-service-policy.md) policy that direct API requests to the Azure AI Services endpoint.
5251
* Authentication to the backend using the instance's system-assigned managed identity.
@@ -62,37 +61,38 @@ To import a Microsoft Foundry API to API Management:
6261
1. On the **Select AI Service** tab:
6362
1. Select the **Subscription** in which to search for Foundry Tools. To get information about the model deployments in a service, select the **deployments** link next to the service name.
6463
:::image type="content" source="media/azure-ai-foundry-api/deployments.png" alt-text="Screenshot of deployments for an AI service in the portal.":::
65-
1. Select a Foundry tool.
64+
1. Select a Foundry tool.
6665
1. Select **Next**.
6766
1. On the **Configure API** tab:
6867
1. Enter a **Display name** and optional **Description** for the API.
6968
1. In **Base path**, enter a path that your API Management instance uses to access the deployment endpoint.
70-
1. Optionally select one or more **Products** to associate with the API.
69+
1. Optionally, select one or more **Products** to associate with the API.
7170
1. In **Client compatibility**, select either of the following based on the types of client you intend to support. See [Client compatibility options](#client-compatibility-options) for more information.
72-
* **Azure OpenAI** - Select this option if your clients only need to access Azure OpenAI in Microsoft Foundry model deployments.
73-
* **Azure AI** - Select this option if your clients need to access other models in Microsoft Foundry.
71+
* **Azure OpenAI**: Select this option if your clients only need to access Azure OpenAI in Microsoft Foundry model deployments.
72+
* **Azure AI**: Select this option if your clients need to access other models in Microsoft Foundry.
7473
1. Select **Next**.
7574

7675
:::image type="content" source="media/azure-ai-foundry-api/client-compatibility.png" alt-text="Screenshot of Microsoft Foundry API configuration in the portal.":::
7776

78-
1. On the **Manage token consumption** tab, optionally enter settings or accept defaults that define the following policies to help monitor and manage the API:
77+
1. On the **Manage token consumption** tab, optionally enter settings, or accept defaults that define the following policies to help monitor and manage the API:
7978
* [Manage token consumption](llm-token-limit-policy.md)
80-
* [Track token usage](llm-emit-token-metric-policy.md)
81-
1. On the **Apply semantic caching** tab, optionally enter settings or accept defaults that define the policies to help optimize performance and reduce latency for the API:
79+
* [Track token usage](llm-emit-token-metric-policy.md)
80+
1. On the **Apply semantic caching** tab, optionally enter settings, or accept defaults that define the policies to help optimize performance and reduce latency for the API:
8281
* [Enable semantic caching of responses](azure-openai-enable-semantic-caching.md)
83-
1. On the **AI content safety**, optionally enter settings or accept defaults to configure the Azure AI Content Safety service to block prompts with unsafe content:
82+
1. On the **AI content safety**, optionally enter settings, or accept defaults to configure the Azure AI Content Safety service to block prompts with unsafe content:
8483
* [Enforce content safety checks on LLM requests](llm-content-safety-policy.md)
8584
1. Select **Review**.
86-
1. After settings are validated, select **Create**.
85+
1. After settings are validated, select **Create**.
8786

8887
## Test the AI API
8988

90-
To ensure that your AI API is working as expected, test it in the API Management test console.
89+
To ensure that your AI API is working as expected, test it in the API Management test console.
90+
9191
1. Select the API you created in the previous step.
9292
1. Select the **Test** tab.
9393
1. Select an operation that's compatible with the model deployment.
9494
The page displays fields for parameters and headers.
95-
1. Enter parameters and headers as needed. Depending on the operation, you might need to configure or update a **Request body**. Here's a very basic example request body for a chat completions operation:
95+
1. Enter parameters and headers as needed. Depending on the operation, you might need to configure or update a **Request body**. Here's a basic example request body for a chat completions operation:
9696

9797
```json
9898
{
@@ -113,5 +113,4 @@ To ensure that your AI API is working as expected, test it in the API Management
113113

114114
When the test is successful, the backend responds with a successful HTTP response code and some data. Appended to the response is token usage data to help you monitor and manage your language model token consumption.
115115

116-
117116
[!INCLUDE [api-management-define-api-topics.md](../../includes/api-management-define-api-topics.md)]

articles/app-service/tutorial-java-tomcat-connect-managed-identity-postgresql-database.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: 'Tutorial: Access data with managed identity in Java'
33
description: Secure Azure Database for PostgreSQL connectivity with managed identity from a sample Java Tomcat app, and apply it to other Azure services.
44
ms.devlang: java
55
ms.topic: tutorial
6-
ms.date: 06/04/2024
6+
ms.date: 03/26/2026
77
author: KarlErickson
88
ms.author: karler
99
ms.reviewer: edburns

articles/app-testing/load-testing/troubleshoot-private-endpoint-tests.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ Azure Load Testing service requires outbound connectivity from the virtual netwo
1919
| Destination | Need for connectivity |
2020
| ------------|-------|
2121
| *.azure.com | Access to this destination is required for the Azure Load Testing service to interact with Azure Batch service. |
22-
| *.windows.net | Access to this destination is required for the Azure Load Testing service to interact with Azure Service Bus, Azure Event Grids, and Azure Storage. To learn more about firewall configuration in these services, see <li> [Azure Service Bus frequently asked questions](/azure/service-bus-messaging/service-bus-faq#what-ports-do-i-need-to-open-on-the-firewall--) </li> <li> [Azure Event Hubs Firewall Rules](/azure/event-hubs/event-hubs-ip-filtering) </li> <li> [Configure Azure Storage firewalls and virtual networks ](/azure/storage/common/storage-network-security?tabs=azure-portal) </li> |
22+
| *.windows.net, *.blob.storage.azure.net | Access to this destination is required for the Azure Load Testing service to interact with Azure Service Bus, Azure Event Grids, and Azure Storage. To learn more about firewall configuration in these services, see <li> [Azure Service Bus frequently asked questions](/azure/service-bus-messaging/service-bus-faq#what-ports-do-i-need-to-open-on-the-firewall--) </li> <li> [Azure Event Hubs Firewall Rules](/azure/event-hubs/event-hubs-ip-filtering) </li> <li> [Configure Azure Storage firewalls and virtual networks ](/azure/storage/common/storage-network-security?tabs=azure-portal) </li> |
2323
| *.azurecr.io | Access to this destination is required for the Azure Load Testing service to interact with Azure Container Registry. To learn more about firewall configuration in Azure Container Registry, see <li> [Firewall access rules - Azure Container Registry ](/azure/container-registry/container-registry-firewall-access-rules) </li> |
2424

2525
Optionally, outbound connectivity is needed to *.maven.org and *.github.com to download any plugins that are included in your test configuration.

articles/azure-maps/private-endpoints.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -3,15 +3,15 @@ title: Use private endpoints with Azure Maps
33
description: Learn how to use private endpoints with Azure Maps.
44
author: pbrasil
55
ms.author: peterbr
6-
ms.date: 02/27/2026
7-
ms.topic: how-to
6+
ms.date: 03/26/2026
7+
ms.topic: article
88
ms.service: azure-maps
99
ms.subservice: authentication
1010
---
1111

12-
# Use private endpoints with Azure Maps
12+
# Use private endpoints with Azure Maps (preview)
1313

14-
Azure Maps supports [Azure Private Link](/../private-link/private-link-overview.md), enabling secure access to Azure Maps services through a private endpoint in your virtual network. A private endpoint assigns a private IP address from your virtual network to the Azure Maps service, so traffic between your applications and Azure Maps stays on the Microsoft backbone network instead of the public internet. This provides improved security and network isolation. You can create a private endpoint when you create an Azure Maps account or add one to an existing account.
14+
Azure Maps supports [Azure Private Link](../private-link/private-link-overview.md), enabling secure access to Azure Maps services through a private endpoint in your virtual network. A private endpoint assigns a private IP address from your virtual network to the Azure Maps service, so traffic between your applications and Azure Maps stays on the Microsoft backbone network instead of the public internet. This provides improved security and network isolation. You can create a private endpoint when you create an Azure Maps account or add one to an existing account.
1515

1616
## Benefits of private endpoints for Azure Maps
1717

@@ -82,7 +82,7 @@ Within this zone, a DNS record maps your Azure Maps account's unique ID and regi
8282
Clients inside the virtual network resolve the hostname to a private IP address for private connectivity, while clients outside the network resolve the same hostname to the Azure Maps public endpoint. This split‑horizon DNS approach lets you use a single endpoint URL both inside and outside the virtual network.
8383

8484
If you don't use automatic DNS integration, configure DNS manually so the Azure Maps account hostname
85-
(`<maps-account-client-id>.<location>.privatelink.account.maps.azure.com`) resolves to the private endpoint IP address within your network. For more information, see [Azure Private Endpoint DNS documentation](/../private-link/private-endpoint-dns.md).
85+
(`<maps-account-client-id>.<location>.account.maps.azure.com`) resolves to the private endpoint IP address within your network. For more information, see [Azure Private Endpoint DNS documentation](../private-link/private-endpoint-dns.md).
8686

8787
### 3. Use the private endpoint in your applications
8888

@@ -92,7 +92,7 @@ To use the private endpoint, configure your applications to call the **Azure Map
9292

9393
The access pattern is:
9494

95-
`https://{maps-account-client-id}.{location}.privatelink.account.maps.azure.com`
95+
`https://{maps-account-client-id}.{location}.account.maps.azure.com`
9696

9797
> [!Important]
9898
> If your application continues to use the default Azure Maps endpoint (such as `atlas.microsoft.com`), requests won't be routed through the private endpoint. Azure Maps SDKs support overriding the default endpoint, so configure your SDK or connection code to use your Azure Maps account–specific hostname. When configured, requests from within your network are automatically routed through Private Link.
@@ -118,5 +118,5 @@ Ask Copilot
118118

119119
## Related content
120120

121-
- [Azure Private Endpoint private DNS zone values](/../private-link/private-endpoint-dns.md)
122-
- [Azure Private Link availability](/../private-link/availability.md)
121+
- [Azure Private Endpoint private DNS zone values](../private-link/private-endpoint-dns.md)
122+
- [Azure Private Link availability](../private-link/availability.md)

articles/azure-resource-manager/management/async-operations.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ After getting the 201 or 202 response code, you're ready to monitor the status o
2929

3030
## URL to monitor status
3131

32-
There are two different ways to monitor the status the asynchronous operation. You determine the correct approach by examining the header values that are returned from your original request. First, look for:
32+
There are two different ways to monitor the status of the asynchronous operation. You determine the correct approach by examining the header values that are returned from your original request. First, look for:
3333

3434
* `Azure-AsyncOperation` - URL for checking the ongoing status of the operation. If your operation returns this value, use it to track the status of the operation.
3535
* `Retry-After` - The number of seconds to wait before checking the status of the asynchronous operation.
@@ -213,7 +213,7 @@ GET
213213
https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Storage/operations/{operation-id}?monitor=true&api-version=2019-06-01
214214
```
215215

216-
If the request is still running, you receive a status code 202. If the request is completed, your receive a status code 200. The body of the response contains the properties of the storage account that was created.
216+
If the request is still running, you receive a status code 202. If the request is completed, you receive a status code 200. The body of the response contains the properties of the storage account that was created.
217217

218218
## Next steps
219219

0 commit comments

Comments
 (0)