Skip to content

Commit 4465e21

Browse files
Merge branch 'main' into patch-11
2 parents 0dc445b + fb2ec70 commit 4465e21

1,391 files changed

Lines changed: 23575 additions & 22440 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.publish.config.json

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -500,6 +500,12 @@
500500
"branch": "v1.x",
501501
"branch_mapping": {}
502502
},
503+
{
504+
"path_to_root": "functions-scenarios-quickstart-sql",
505+
"url": "https://github.com/Azure-Samples/functions-quickstart-dotnet-azd-sql",
506+
"branch": "main",
507+
"branch_mapping": {}
508+
},
503509
{
504510
"path_to_root": "functions-sql-todo-sample",
505511
"url": "https://github.com/Azure-Samples/azure-sql-binding-func-dotnet-todo",

.openpublishing.redirection.json

Lines changed: 1957 additions & 3856 deletions
Large diffs are not rendered by default.

articles/api-center/TOC.yml

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,8 @@
3333
href: ./tutorials/register-apis.md
3434
- name: 3 - Add environments and deployments
3535
href: ./tutorials/configure-environments-deployments.md
36+
- name: 4 - Link an API Management instance
37+
href: ../api-management/tutorials/link-api-center.md
3638
expanded: true
3739
- name: API inventory
3840
items:
@@ -121,4 +123,4 @@
121123
- name: Azure updates
122124
href: https://aka.ms/apic/updates
123125
- name: MCP Center
124-
href: https://mcp.azure.com
126+
href: https://mcp.azure.com

articles/api-management/TOC.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -63,6 +63,8 @@
6363
href: api-management-howto-developer-portal-customize.md
6464
- name: 10 - Manage APIs in Visual Studio Code
6565
href: visual-studio-code-tutorial.md
66+
- name: 11 - Link to an API Center
67+
href: tutorials/link-api-center.md
6668
expanded: true
6769
- name: Deployment and operations
6870
items:

articles/api-management/api-management-authenticate-authorize-azure-openai.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ In this article, you learn about ways to authenticate and authorize to Azure Ope
2323

2424
For background, see:
2525

26-
* [Azure OpenAI Service REST API reference](/azure/ai-services/openai/reference)
26+
* [Azure OpenAI Service REST API reference](/azure/ai-foundry/openai/reference)
2727

2828
* [Authentication and authorization to APIs in API Management](authentication-authorization-overview.md).
2929

@@ -80,13 +80,13 @@ In this example, the named value in API Management is *openai-api-key*.
8080
## Authenticate with managed identity
8181

8282
An alternative and recommended way to authenticate to an Azure OpenAI API is by using a managed identity in Microsoft Entra ID. For background, see
83-
[How to configure Azure OpenAI Service with managed identity](/azure/ai-services/openai/how-to/managed-identity).
83+
[How to configure Azure OpenAI Service with managed identity](/azure/api-management/api-management-authenticate-authorize-azure-openai).
8484

8585
Following are steps to configure your API Management instance to use a managed identity to authenticate requests to an Azure OpenAI API.
8686

8787
1. [Enable](api-management-howto-use-managed-service-identity.md) a system-assigned or user-assigned managed identity for your API Management instance. The following example assumes that you've enabled the instance's system-assigned managed identity.
8888

89-
1. Assign the managed identity the **Cognitive Services OpenAI User** role, scoped to the appropriate resource. For example, assign the system-assigned managed identity the **Cognitive Services OpenAI User** role on the Azure OpenAI resource. For detailed steps, see [Role-based access control for Azure OpenAI service](/azure/ai-services/openai/how-to/role-based-access-control).
89+
1. Assign the managed identity the **Cognitive Services OpenAI User** role, scoped to the appropriate resource. For example, assign the system-assigned managed identity the **Cognitive Services OpenAI User** role on the Azure OpenAI resource. For detailed steps, see [Role-based access control for Azure OpenAI service](/azure/ai-foundry/openai/how-to/role-based-access-control).
9090

9191
1. Add the following policy snippet in the `inbound` policy section to authenticate requests to the Azure OpenAI API using the managed identity.
9292

@@ -163,5 +163,5 @@ Following are high level steps to restrict API access to users or apps that are
163163

164164
## Related content
165165

166-
* Learn more about [Microsoft Entra ID and OAuth2.0](../active-directory/develop/authentication-vs-authorization.md).
166+
* Learn more about [Microsoft Entra ID and OAuth2.0](/entra/architecture/auth-oauth2).
167167
* [Authenticate requests to Azure AI services](/azure/ai-services/authentication)

articles/api-management/api-management-howto-cache-external.md

Lines changed: 9 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: dlepow
66

77
ms.service: azure-api-management
88
ms.topic: how-to
9-
ms.date: 09/11/2025
9+
ms.date: 10/27/2025
1010
ms.author: danlep
1111
ms.custom: sfi-image-nochange
1212

@@ -44,10 +44,10 @@ To complete this tutorial, you need to:
4444

4545
+ [Create an Azure API Management instance](get-started-create-service-instance.md)
4646
+ Understand [caching in Azure API Management](api-management-howto-cache.md)
47-
+ Have an [Azure Managed Redis](../redis/quickstart-create-managed-redis.md), [Azure Cache for Redis](../azure-cache-for-redis/quickstart-create-redis.md), or another Redis-compatible cache available.
47+
+ Have an [Azure Managed Redis](../redis/quickstart-create-managed-redis.md) or another Redis-compatible cache available.
4848

4949
> [!IMPORTANT]
50-
> Azure API Management uses a Redis connection string to connect to the cache. If you use Azure Cache for Redis or Azure Managed Redis, enable access key authentication in your cache to use a connection string. Currently, you can't use Microsoft Entra authentication to connect Azure API Management to Azure Cache for Redis or Azure Managed Redis.
50+
> Azure API Management uses a Redis connection string to connect to the cache. If you use Azure Managed Redis, enable access key authentication in your cache to use a connection string. Currently, you can't use Microsoft Entra authentication to connect Azure API Management to Azure Managed Redis.
5151
5252
### Redis cache for Kubernetes
5353

@@ -57,7 +57,7 @@ For an API Management self-hosted gateway, caching requires an external cache. F
5757

5858
Follow the steps below to add an external Redis-compatible cache in Azure API Management. You can limit the cache to a specific gateway in your API Management instance.
5959

60-
![Screenshot that shows how to add an external Azure Cache for Redis in Azure API Management.](media/api-management-howto-cache-external/add-external-cache.png)
60+
![Screenshot that shows how to add an external Azure Managed Redis cache in Azure API Management.](media/api-management-howto-cache-external/add-external-cache.png)
6161

6262
### Use from setting
6363

@@ -76,7 +76,7 @@ The **Use from** setting in the configuration specifies the location of your API
7676
> [!NOTE]
7777
> You can configure the same external cache for more than one API Management instance. The API Management instances can be in the same or different regions. When sharing the cache for more than one instance, you must select **Default** in the **Use from** setting.
7878
79-
### Add an Azure Cache for Redis or Azure Managed Redis instance from the same subscription
79+
### Add an Azure Managed Redis instance from the same subscription
8080

8181
1. Browse to your API Management instance in the Azure portal.
8282
1. In the left menu, under **Deployment + infrastructure** select **External cache**.
@@ -85,14 +85,17 @@ The **Use from** setting in the configuration specifies the location of your API
8585
1. In the [**Use from**](#use-from-setting) dropdown, select **Default** or specify the desired region. The **Connection string** is automatically populated.
8686
1. Select **Save**.
8787

88+
> [!NOTE]
89+
> The default connection string is in the form `<cache-name>:10000,<cache-access-key>,ssl=True,abortConnect=False`. API Management stores the string as a secret named value. If you need to view or edit the string to rotate the access key or troubleshoot connection issues, go to the **Named values** blade.
90+
8891
### Add a Redis-compatible cache hosted outside of the current Azure subscription or Azure in general
8992

9093
1. Browse to your API Management instance in the Azure portal.
9194
1. In the left menu, under **Deployment + infrastructure** select **External cache**.
9295
1. Select **+ Add**.
9396
1. In the **Cache instance** dropdown, select **Custom**.
9497
1. In the [**Use from**](#use-from-setting) dropdown, select **Default** or specify the desired region.
95-
1. Enter your Azure Cache for Redis, Azure Managed Redis, or Redis-compatible cache connection string in the **Connection string** field.
98+
1. Enter your Azure Managed Redis or Redis-compatible cache connection string in the **Connection string** field.
9699
1. Select **Save**.
97100

98101
### Add a Redis cache to a self-hosted gateway

articles/api-management/api-management-howto-cache.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -82,7 +82,7 @@ With the caching policies shown in this example, the first request to a test ope
8282
1. Select **Save**.
8383

8484
> [!TIP]
85-
> If you're using an external cache, as described in [Use an external Azure Cache for Redis in Azure API Management](api-management-howto-cache-external.md), you might want to specify the `caching-type` attribute of the caching policies. See [API Management caching policies](api-management-policies.md#caching) for more information.
85+
> If you're using an external cache, as described in [Use an external Redis-compatible cache in Azure API Management](api-management-howto-cache-external.md), you might want to specify the `caching-type` attribute of the caching policies. See [API Management caching policies](api-management-policies.md#caching) for more information.
8686
8787
## Call an operation to test the caching
8888

articles/api-management/api-management-howto-entra-external-id.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,7 @@ Create an app registration in your Microsoft Entra ID tenant. The app registrati
5555
* In the **Supported account types** section, select **Accounts in this organizational directory only**.
5656
* In **Redirect URI**, select **Single-page application (SPA)** and enter the following URL: `https://{your-api-management-service-name}.developer.azure-api.net/signin`, where `{your-api-management-service-name}` is the name of your API Management instance.
5757
* Select **Register** to create the application.
58-
1.On the app **Overview** page, find the **Application (client) ID** and **Directory (tenant) ID** and copy theses values to a safe location. You need them later.
58+
1.On the app **Overview** page, find the **Application (client) ID** and **Directory (tenant) ID** and copy these values to a safe location. You need them later.
5959
1. In the sidebar menu, under **Manage**, select **Certificates & secrets**.
6060
1. From the **Certificates & secrets** page, on the **Client secrets** tab, select **+ New client secret**.
6161
* Enter a **Description**.

articles/api-management/api-management-howto-llm-logs.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -97,7 +97,7 @@ ApiManagementGatewayLlmLog
9797
RequestContent = tostring(RequestArray.content),
9898
ResponseContent = tostring(ResponseArray.content)
9999
| summarize
100-
Input = strcat_aray(make_list(RequestContent), " . "),
100+
Input = strcat_array(make_list(RequestContent), " . "),
101101
Output = strcat_array(make_list(ResponseContent), " . ")
102102
by CorrelationId
103103
| where isnotempty(Input) and isnotempty(Output)
@@ -121,4 +121,4 @@ For details to create and run a model evaluation in Azure AI Foundry, see [Evalu
121121

122122
* [Learn more about monitoring API Management](monitor-api-management.md)
123123
* [Azure Monitor reference for API Management](monitor-api-management-reference.md)
124-
* [Tutorial: Monitor published APIs](api-management-howto-use-azure-monitor.md)
124+
* [Tutorial: Monitor published APIs](api-management-howto-use-azure-monitor.md)

0 commit comments

Comments
 (0)