Merge branch 'MicrosoftDocs:main' into master

Author: madhurinms

articles/api-center/includes/free-standard-plan-linked-api-management.md

@@ -0,0 +1,15 @@
+---
+title: Include file
+description: Include file
+services: api-center
+author: dlepow
+ms.author: danlep
+ms.service: azure-api-center
+ms.topic: include
+ms.date: 03/04/2026
+
+ms.custom: Include file
+---
+
+> [!NOTE]
+> API Center Standard can now be used at no additional cost when you link it to an API Management instance in the Standard, Standard v2, Premium, or Premium v2 tier. For more information, see [API Center plans and features](/azure/api-center/overview#api-center-plans-and-features).

articles/api-center/overview.md

@@ -14,9 +14,6 @@ ms.custom: references_regions
 
 Azure API Center enables you to track all your APIs in a centralized location for discovery, reuse, and governance. Use an API center to develop and maintain a structured and organized inventory of your organization's APIs - regardless of their type, lifecycle stage, or deployment location - along with related information such as version details, API definition files, and common metadata. 
 
-> [!TIP]
-> You can get started quickly with Azure API Center by taking advantage of the Free plan, which has no time constraints. Compare the [Free plan and Standard plan limits](/azure/azure-resource-manager/management/azure-subscription-service-limits?toc=/azure/api-center/toc.json&bc=/azure/api-center/breadcrumb/toc.json#azure-api-center-limits).
-
 By using an API center, stakeholders throughout your organization, including API program managers, IT administrators, application developers, and API developers can design, discover, reuse, and govern APIs.  
 
 > [!NOTE]
@@ -54,12 +51,24 @@ Create and use an API center for the following capabilities:
 
 For more information about the entities you can manage and the capabilities in Azure API Center, see [Key concepts](key-concepts.md).
 
-## Tiers and SKUs
+## API Center plans and features
 
-Azure API Center is offered in a [Free plan and Standard plan](../azure-resource-manager/management/azure-subscription-service-limits.md?toc=/azure/api-center/toc.json&bc=/azure/api-center/breadcrumb/toc.json#azure-api-center-limits).
+Azure API Center is offered in a Free plan and Standard plan, which are designed to meet different needs as summarized in the following table. For feature availability and limits, see [Azure API Center limits](/azure/azure-resource-manager/management/azure-subscription-service-limits?toc=/azure/api-center/toc.json&bc=/azure/api-center/breadcrumb/toc.json#azure-api-center-limits).
 
-> [!NOTE]
-> Azure API Center is also included free with Azure API Management Premium and Standard tiers.
+| Capability | Free plan | Standard plan |
+|---------|-----------|---------------|
+| **Use cases** | Evaluation and small-scale use | Enterprise and production workloads |
+| **Inventory and governance features** | Limited<sup>1</sup> | Expanded for enterprise use cases |
+| **Upgrade path** | Upgradable to Standard | N/A |
+| **Time constraints** | None | None |
+
+<sup>1</sup> For details, see [Azure API Center limits](/azure/azure-resource-manager/management/azure-subscription-service-limits?toc=/azure/api-center/toc.json&bc=/azure/api-center/breadcrumb/toc.json#azure-api-center-limits).
+
+### Standard plan benefit when API Center linked to API Management
+
+Customers who [link](synchronize-api-management-apis.md) an API Management Standard, Standard v2, Premium, or Premium v2 tier instance to their API center can use or upgrade to the API Center Standard plan at no additional cost. This benefit continues as long as at least one eligible API Management instance remains linked. 
+
+For more information, see [Azure API Management pricing](https://azure.microsoft.com/pricing/details/api-management/).
 
 ## Available regions
 

articles/api-center/synchronize-api-management-apis.md

@@ -12,11 +12,13 @@ ms.custom: devx-track-azurecli
 
 # Synchronize APIs from an API Management instance
 
-This article shows how to integrate an API Management instance so that the instance's APIs are continuously kept up to date in your [API center](overview.md) inventory. 
+This article shows how to integrate (link) an API Management instance so that the instance's APIs are continuously kept up to date in your [API center](overview.md) inventory. 
 
 > [!TIP]
 > This article explains how to integrate an API Management instance from your API center. Alternatively, quickly set up integration directly from an API Management instance. In the left menu of your instance, under **APIs**, select **API Center**, and select a target API center in your subscription to synchronize APIs to.
 
+[!INCLUDE [free-standard-plan-linked-api-management](includes/free-standard-plan-linked-api-management.md)]
+
 ## About integrating an API Management instance
 
 Although you can use the Azure CLI to [import](import-api-management-apis.md) APIs on demand from Azure API Management to Azure API Center, integrating (linking) an API Management instance enables continuous synchronization so that the API inventory stays up to date. Azure API Center can also synchronize APIs from sources including [Amazon API Gateway](synchronize-aws-gateway-apis.md). 

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

@@ -1,12 +1,12 @@
 ---
-title: Tutorial - Publish versions of an API using Azure API Management 
+title: "Tutorial: Publish Multiple Versions of your API" 
 description: Learn how to publish multiple API versions in API Management.
 author: dlepow
 
 ms.service: azure-api-management
 ms.custom: mvc, devx-track-azurecli
 ms.topic: tutorial
-ms.date: 03/26/2025
+ms.date: 03/04/2026
 ms.author: danlep
 
 #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.
@@ -18,7 +18,7 @@ ms.author: danlep
 
 There are situations where it's impractical for all API consumers to use the same version. When consumers are ready to upgrade to a newer version, they prefer a simple and understandable approach. As demonstrated in this tutorial, Azure API Management supports exposing multiple API versions to meet this need.
 
-For background, see [Versions](api-management-versions.md) and [Revisions](api-management-revisions.md).
+For background information, see [Versions](api-management-versions.md) and [Revisions](api-management-revisions.md).
 
 [!INCLUDE [api-management-workspace-try-it](../../includes/api-management-workspace-try-it.md)]
 
@@ -34,17 +34,19 @@ In this tutorial, you learn how to:
 
 ## Prerequisites
 
-+ Learn  [Azure API Management terminology](api-management-terminology.md).
++ Learn [Azure API Management terminology](api-management-terminology.md).
 + Complete the quickstart [Create an Azure API Management instance](get-started-create-service-instance.md).
 + Complete the tutorial [Import and publish your first API](import-and-publish.md).
 
 ## Add a new version
 
 1. In the [Azure portal](https://portal.azure.com), navigate to your API Management instance.
-1. In the left menu, in the **APIs** section, select **APIs**.
+
+1. Under **APIs** in the sidebar menu, select **APIs**.
+
 1. Locate **Swagger Petstore - OpenAPI 3.0** in the API list. Select the ellipsis (**...**) next to **Swagger Petstore - OpenAPI 3.0** and then select **Add version**. You'll add values to the resulting window in the next section.
 
-:::image type="content" source="media/api-management-get-started-publish-versions/add-version-menu.png" alt-text="Screenshot showing the steps for adding a version." lightbox="media/api-management-get-started-publish-versions/add-version-menu.png":::
+    :::image type="content" source="media/api-management-get-started-publish-versions/add-version-menu.png" alt-text="Screenshot showing the steps to add a version." lightbox="media/api-management-get-started-publish-versions/add-version-menu.png":::
 
 > [!TIP]
 > You can also enable versions when you create a new API. On the **Add API** screen, select **Version this API?**.
@@ -82,13 +84,18 @@ For callers to see the new version, it must be added to a *product*. If you didn
 To add the version to a product:
 
 1. In the Azure portal, navigate to your API Management instance.
-1. Under **APIs** in the left pane, select **Products**. 
-1. Select the product, and then select **APIs** in the left pane. 
+
+1. Under **APIs** in the sidebar menu, select **Products**. 
+
+1. Select the product, and then select **APIs**. 
+
 1. Select **+ Add**. 
+
 1. Select the API.
-1. Click **Select**. 
 
-:::image type="content" source="media/api-management-get-started-publish-versions/08-add-multiple-versions-03-add-version-product.png" alt-text="Screenshot that shows the APIs - Product window." lightbox="media/api-management-get-started-publish-versions/08-add-multiple-versions-03-add-version-product.png":::
+1. Choose **Select**. 
+
+    :::image type="content" source="media/api-management-get-started-publish-versions/08-add-multiple-versions-03-add-version-product.png" alt-text="Screenshot that shows the APIs Product window." lightbox="media/api-management-get-started-publish-versions/08-add-multiple-versions-03-add-version-product.png":::
 
 ## Use version sets
 
@@ -102,7 +109,7 @@ To see all your version sets, run the [az apim api versionset list](/cli/azure/a
 
 ```azurecli
 az apim api versionset list --resource-group <resource-group-name> \
-    --service-name <API-Management-service-name> --output table
+    --service-name <API-management-service-name> --output table
 ```
 
 When the Azure portal creates a version set for you, it assigns an alphanumeric name, which appears in the **Name** column of the list. Use this name in other Azure CLI commands.
@@ -111,7 +118,7 @@ To see details about a version set, run the [az apim api versionset show](/cli/a
 
 ```azurecli
 az apim api versionset show --resource-group <resource-group-name> \
-    --service-name <API-Management-service-name> --version-set-id <ID from the Name column>
+    --service-name <API-management-service-name> --version-set-id <ID-from-the-name-column>
 ```
 
 For more information about version sets, see [Versions in Azure API Management](api-management-versions.md#how-versions-are-represented).
@@ -121,14 +128,16 @@ For more information about version sets, see [Versions in Azure API Management](
 If you use the [developer portal](api-management-howto-developer-portal-customize.md), you can see API versions there.
 
 1. Select **Developer portal** at the top of the window.
+
 1. Select **APIs**, and then select **Swagger Petstore**.
+
 1. You should see a dropdown that lists multiple versions next to the API name.
+
 1. Select **v1**.
+
 1. Notice the **Request URL** of the first operation in the list. It shows that the API URL path includes **v1**.
 
 ## Next step
 
-Go to the next tutorial:
-
 > [!div class="nextstepaction"]
-> [Customize the style of the Developer portal pages](api-management-howto-developer-portal-customize.md)
+> [Access and customize the developer portal](api-management-howto-developer-portal-customize.md)