Skip to content

Commit 04a0ab0

Browse files
committed
Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into azure-communication-services-10dlc-articles
2 parents d51d40b + b32b1bd commit 04a0ab0

File tree

253 files changed

+2452
-1362
lines changed

Some content is hidden

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

253 files changed

+2452
-1362
lines changed

.openpublishing.publish.config.json

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -757,6 +757,12 @@
757757
"url": "https://github.com/AzureADQuickStarts/WebApp-OpenIdConnect-DotNet",
758758
"branch": "GuidedSetup",
759759
"branch_mapping": {}
760+
},
761+
{
762+
"path_to_root": "azure-policy-autogen-docs",
763+
"url": "https://github.com/MicrosoftDocs/azure-policy-autogen-docs",
764+
"branch": "main",
765+
"branch_mapping": {}
760766
}
761767
],
762768
"branch_target_mapping": {

articles/active-directory-b2c/add-password-reset-policy.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -157,7 +157,7 @@ A claims transformation technical profile accesses the `isForgotPassword` claim.
157157

158158
The **SelfAsserted-LocalAccountSignin-Email** technical profile **setting.forgotPasswordLinkOverride** defines the password reset claims exchange that executes in your user journey.
159159

160-
The **LocalAccountWritePasswordUsingObjectId** technical profile **UseTechnicalProfileForSessionManagement** `SM-AAD` session manager is required for the user to preform subsequent logins successfully under [SSO](./custom-policy-reference-sso.md) conditions.
160+
The **LocalAccountWritePasswordUsingObjectId** technical profile **UseTechnicalProfileForSessionManagement** `SM-AAD` session manager is required for the user to perform subsequent logins successfully under [SSO](./custom-policy-reference-sso.md) conditions.
161161

162162
### Add the password reset sub journey
163163

articles/active-directory-b2c/best-practices.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -84,7 +84,7 @@ Manage your Azure AD B2C environment.
8484
| Use the Microsoft Graph API to automate the management of your B2C tenants | Microsoft Graph APIs:<br/>Manage [Identity Experience Framework](/graph/api/resources/trustframeworkpolicy?preserve-view=true&view=graph-rest-beta) (custom policies)<br/>[Keys](/graph/api/resources/trustframeworkkeyset?preserve-view=true&view=graph-rest-beta)<br/>[User Flows](/graph/api/resources/identityuserflow?preserve-view=true&view=graph-rest-beta) |
8585
| Integrate with Azure DevOps | A [CI/CD pipeline](deploy-custom-policies-devops.md) makes moving code between different environments easy and ensures production readiness always. |
8686
| Deploy custom policy | Azure AD B2C relies on caching to deliver performance to your end users. When you deploy a custom policy using whatever method, expect a delay of up to **30 minutes** for your users to see the changes. As a result of this behavior, consider the following practices when you deploy your custom policies: <br> - If you're deploying to a development environment, set the `DeploymentMode` attribute in your custom policy file's `<TrustFrameworkPolicy>` element to `Production`. <br> - Deploy your updated policy files to a production environment when traffic in your app is low. <br> - When you deploy to a production environment to update existing policy files, upload the updated files with new names, which act as new versions of the policies. Then, update your app references to the new names/versions. You can remove the old policy files afterward or keep them as your last known good configuration for easy rollback.<br> - If you need to deploy to a production environment to update existing policy files without versioning, make the new policy backward compatible with the old policy by following some simple rules. If you need to change a technical profile, claim, or [SubJourney](subjourneys.md), create a new version of it, publish the policy, and wait for 30 minutes for Azure AD B2C caches to pick up the new version. Then, in a subsequent update, make changes to use the new version and perform another policy update. Wait for another 30 minutes, then you can delete the old version of the elements if needed. Ensure all of your business logic is inside SubJourneys.<br> - You can set the `DeploymentMode` to `Development` in a production environment to bypass the caching behavior. However, we don't recommend this practice. If you [Collect Azure AD B2C logs with Application Insights](troubleshoot-with-application-insights.md), all claims sent to and from identity providers are collected, which is a security and performance risk. |
87-
| Deploy app registration updates | When you modify your application registration in your Azure AD B2C tenant, such as updating the application's redirect URI, expect a delay of up to **2 hours (3600s)** for the changes to take effect in the production environment. We recommend that you modify your application registration in your production environment when traffic in your app is low.|
87+
| Deploy app registration updates | When you modify your application registration in your Azure AD B2C tenant, such as updating the application's redirect URI, expect a delay of up to **2 hours (7200s)** for the changes to take effect in the production environment. We recommend that you modify your application registration in your production environment when traffic in your app is low.|
8888
| Integrate with Azure Monitor | [Audit log events](view-audit-logs.md) are only retained for seven days. [Integrate with Azure Monitor](azure-monitor.md) to retain the logs for long-term use, or integrate with third-party security information and event management (SIEM) tools to gain insights into your environment. |
8989
| Setup active alerting and monitoring | [Track user behavior](./analytics-with-application-insights.md) in Azure AD B2C using Application Insights. |
9090

articles/api-management/api-management-gateways-overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -81,7 +81,7 @@ The following tables compare features available in the following API Management
8181
| [Outbound virtual network integration](integrate-vnet-outbound.md) || Standard v2, Premium v2 ||| ✔️ |
8282
| [Availability zones](zone-redundancy.md) | Premium | ✔️<sup>3</sup> || ✔️<sup>1</sup> | ✔️<sup>3</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>4</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) | ✔️ | ✔️ | ✔️ | ✔️ ||
8787
| **HTTP/2** (Client-to-gateway) | ✔️<sup>5</sup> | ✔️<sup>5</sup> || ✔️ ||

articles/api-management/api-management-get-started-publish-versions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ ms.topic: tutorial
99
ms.date: 03/26/2025
1010
ms.author: danlep
1111

12-
#customer intent: As a developer, I want to publish mutliple versions of an API so that all callers to the API don't need to use the same version.
12+
#customer intent: As a developer, I want to publish multiple versions of an API so that all callers to the API don't need to use the same version.
1313
---
1414

1515
# Tutorial: Publish multiple versions of your API

articles/api-management/api-management-region-availability.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,7 @@ Information in the following table is updated regularly. Capacity availability i
3737
| East US 2 |||||
3838
| France Central ||| ||
3939
| Germany West Central |||||
40+
| Italy North ||| | |
4041
| Japan East ||| ||
4142
| Korea Central |||| |
4243
| North Central US ||| ||
@@ -45,7 +46,8 @@ Information in the following table is updated regularly. Capacity availability i
4546
| South Africa North ||| | |
4647
| South Central US ||| | |
4748
| South India ||| | |
48-
| Southeast Asia ||| ||
49+
| Sweden Central ||| | |
50+
| South India ||| | |
4951
| Switzerland North ||| | |
5052
| UK South |||||
5153
| UK West ||| | |

articles/api-management/azure-openai-api-from-specification.md

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Import an Azure OpenAI API as REST API - Azure API Management
3-
description: How to import an Azure OpenAI API as a REST API from the Azure OpenAI in Foundry Models or from an OpenAPI specification.
3+
description: How to import an Azure OpenAI API as a REST API from Azure OpenAI in Foundry Models or from an OpenAPI specification.
44
ms.service: azure-api-management
55
author: dlepow
66
ms.author: danlep
@@ -20,7 +20,8 @@ You can import AI model endpoints deployed in [Azure OpenAI in Foundry Models](/
2020

2121
This article shows two options to import an Azure OpenAI API into an Azure API Management instance as a REST API:
2222

23-
- [Import an Azure OpenAI API directly from Azure OpenAI in Foundry Models](#option-1-import-api-from-azure-openai) (recommended)
23+
- [Import an Azure OpenAI API directly from Azure OpenAI](#option-1-import-api-from-azure-openai) (recommended)
24+
2425
- [Download and add the OpenAPI specification](#option-2-add-an-openapi-specification-to-api-management) for Azure OpenAI and add it to API Management as an OpenAPI API.
2526

2627
Learn more about managing AI APIs in API Management:
@@ -35,12 +36,12 @@ Learn more about managing AI APIs in API Management:
3536
Make a note of the ID (name) of the deployment. You'll need it when you test the imported API in API Management.
3637

3738
> [!NOTE]
38-
> API Management policies such as [azure-openai-token-limit](azure-openai-token-limit-policy.md) and [azure-openai-emit-token-metric](azure-openai-emit-token-metric-policy.md) are supported for certain API endpoints exposed through specific Azure OpenAI models. For more information, see [Supported Azure OpenAI in Foundry Models](azure-openai-token-limit-policy.md).
39+
> API Management policies such as [azure-openai-token-limit](azure-openai-token-limit-policy.md) and [azure-openai-emit-token-metric](azure-openai-emit-token-metric-policy.md) are supported for certain API endpoints exposed through specific Azure OpenAI models. For more information, see [Supported Azure OpenAI models](azure-openai-token-limit-policy.md#supported-azure-openai-in-foundry-models-models).
3940
4041
- Permissions to grant access to the Azure OpenAI resource from the API Management instance.
4142

42-
## Option 1. Import API from Azure OpenAI
43-
43+
## Option 1. Import API from Azure OpenAI
44+
4445
You can import an Azure OpenAI API directly from Azure OpenAI to API Management.
4546

4647
[!INCLUDE [api-management-workspace-availability](../../includes/api-management-workspace-availability.md)]
@@ -135,8 +136,8 @@ To ensure that your Azure OpenAI API is working as expected, test it in the API
135136
1. Select an operation that's compatible with the model you deployed in the Azure OpenAI resource.
136137
The page displays fields for parameters and headers.
137138
1. In **Template parameters**, enter the following values:
138-
* `deployment-id` - the ID of a deployment in the Azure OpenAI
139-
* `api-version` - a valid Azure OpenAI API version, such as the API version you selected when you imported the API.
139+
* `deployment-id` - the ID of a deployment in Azure OpenAI
140+
* `api-version` - a valid Azure OpenAI API version, such as the API version you selected when you imported the API.
140141
:::image type="content" source="media/azure-openai-api-from-specification/test-azure-openai-api.png" alt-text="Screenshot of testing an Azure OpenAI API in the portal." lightbox="media/azure-openai-api-from-specification/test-azure-openai-api.png" :::
141142
1. Enter other parameters and headers as needed. Depending on the operation, you might need to configure or update a **Request body**.
142143
> [!NOTE]

articles/api-management/mock-api-responses.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ The steps in this section show how to create an HTTP API with no backend.
6060
1. In the **Create an HTTP API** window, select **Full**.
6161
1. In **Display name**, enter *Test API*.
6262
1. In **Products**, select *Unlimited*, if that value is available. This value is available only in some tiers. You can leave the value blank for this tutorial, but you need to associate the API with a product to publish it. For more information, see [Import and publish your first API](import-and-publish.md#import-and-publish-a-backend-api).
63-
1. In **Gateways**, select **Managed** if this option is available. (This option is avaiable only in certain service tiers.)
63+
1. In **Gateways**, select **Managed** if this option is available. (This option is available only in certain service tiers.)
6464
1. Select **Create**.
6565

6666
:::image type="content" source="media/mock-api-responses/create-http-api.png" alt-text="Screenshot that shows the Create an HTTP API window." lightbox="media/mock-api-responses/create-http-api.png":::

articles/api-management/policy-reference.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ the link in the **Version** column to view the source on the
2222

2323
## Azure API Management
2424

25-
[!INCLUDE [azure-policy-reference-rp-apimanagement](../../includes/policy/reference/byrp/microsoft.apimanagement.md)]
25+
[!INCLUDE [azure-policy-reference-rp-apimanagement](~/azure-policy-autogen-docs/includes/policy/reference/byrp/microsoft.apimanagement.md)]
2626

2727
## Related content
2828

articles/api-management/security-controls-policy.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ compliant with the specific standard.
2121

2222
[!INCLUDE [azure-policy-compliancecontrols-introwarning](../../includes/policy/standards/intro-warning.md)]
2323

24-
[!INCLUDE [azure-policy-compliancecontrols-apim](../../includes/policy/standards/byrp/microsoft.apimanagement.md)]
24+
[!INCLUDE [azure-policy-compliancecontrols-apim](~/azure-policy-autogen-docs/includes/policy/standards/byrp/microsoft.apimanagement.md)]
2525

2626
## Related content
2727

0 commit comments

Comments
 (0)