integration

Author: gitName

articles/api-center/includes/api-center-service-limits.md

@@ -24,10 +24,9 @@ ms.custom: Include file
 | Maximum number of child properties in custom metadata property of type "object" | 10 |10 | 
 | Maximum requests per minute (data plane) | 3,000 | 6,000  |
 | Maximum number of API definitions [linted](../enable-managed-api-analysis-linting.md) per 4 hours | 10 | 100  |
-| Maximum number of linked API sources<sup>4</sup> | 1  |  3 |
-| Maximum number of API [synchronizations](../synchronize-api-management-apis.md)<sup>4</sup> per 4 hours | 1 | 10  |
+| Maximum number of integrated API sources<sup>4</sup> | 1  |  3 |
 
 <sup>1</sup> To increase a limit in the Standard plan, contact [support](https://azure.microsoft.com/support/options/).<br/>
 <sup>2</sup> In the Free plan, use of full service features including API analysis and access through the data plane API is limited to 5 APIs.<br/>
 <sup>3</sup> Custom metadata properties assigned to APIs, deployments, and environments.<br/>
-<sup>4</sup> Sources such as linked API Management instances that synchronize APIs.
+<sup>4</sup> Sources such as integrated API Management instances. In the Free plan, synchronization from an integrated API source is limited to 200 APIs and 5 API definitions.

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

@@ -1,35 +1,35 @@
 ---
-title: Synchronize APIs from Azure API Management source
-description: Link an API Management instance to Azure API Center for automatic synchronization of APIs from API Management to the inventory.
+title: Synchronize APIs from Azure API Management instance
+description: Integrate an API Management instance to Azure API Center for automatic synchronization of APIs from API Management to the inventory.
 author: dlepow
 ms.service: azure-api-center
 ms.topic: how-to
 ms.date: 10/22/2024
 ms.author: danlep 
 ms.custom: devx-track-azurecli
-# Customer intent: As an API program manager, I want to link my Azure API Management instance to my API center and synchronize API Management APIs to my inventory.
+# Customer intent: As an API program manager, I want to integrate my Azure API Management instance to my API center and synchronize API Management APIs to my inventory.
 ---
 
-# Link an API Management instance to synchronize APIs to your API center
+# Integrate an API Management instance to synchronize APIs to your API center
 
-This article shows how to create a link (preview) to an API Management instance so that the instances's APIs are synchronized in your [API center](overview.md).
+This article shows how to create an integration (preview) to an API Management instance so that the instances's APIs are synchronized in your [API center](overview.md).
 
-APIs in a linked API Management instance are continuously kept up to date in your API center inventory. This makes all of the API Management APIs easily discoverable and accessible to developers, API program managers, and other stakeholders.
+APIs in an integrated API Management instance are continuously kept up to date in your API center inventory. This synchronization makes all of the API Management APIs available to stakeholders to be discovered, reused, and governed like your other APIs.
 
-## About linking an API Management instance
+## 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, linking an API Management instance enables continuous synchronization so that the API inventory stays up to date.
+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 an API Management instance enables continuous synchronization so that the API inventory stays up to date.
 
-When you create a link to an API Management instance, the following happens:
+When you integrate an API Management instance, the following happens:
 
 * All APIs, and optionally API definitions, from the API Management instance are added to the API center inventory.
 * You configure an [environment](key-concepts.md#environment) of type *Azure API Management* in the API center. An associated [deployment](key-concepts.md#deployment) is created for each synchronized API definition from API Management. 
 
 API Management APIs automatically synchronize to the API center whenever existing APIs' settings change, new versions are added, new APIs are created, or APIs are deleted. This synchronization is one-way from API Management to your Azure API center, meaning API updates in the API center aren't synchronized back to the API Management instance.
 
 > [!NOTE]
-> * Some API updates in API Management can take a few minutes to synchronize to your API center.
-> * Links to API Management instances are subject to [limits](../azure-resource-manager/management/azure-subscription-service-limits.md?toc=/azure/api-center/toc.json&bc=/azure/api-center/breadcrumb/toc.json#api-center-limits) on number of linked API sources and synchronization frequency.
+> * API updates in API Management can take a few minutes to synchronize to your API center.
+> * There are [limits](../azure-resource-manager/management/azure-subscription-service-limits.md?toc=/azure/api-center/toc.json&bc=/azure/api-center/breadcrumb/toc.json#api-center-limits) for the number of integrate API Management instances.
 
 
 ### Entities synchronized from API Management
@@ -42,9 +42,8 @@ Certain properties of synchronized APIs and other entities are configured automa
 |--------------|--------------------------------------------------------|
 | API          | • title<br/>• description<br/>• kind                   |
 | API version  | • title                                                |
-| API definition   | N/A                                                    |
-| Deployment   | • server.runtimeUri<br/>• environmentId<br/>• definitionId |
 | Environment  | • server.type
+| Deployment   | • server.runtimeUri<br/>• environmentId<br/>• definitionId |
 
 For property details, see the [API Center REST API reference](/rest/api/apicenter).
 
@@ -53,9 +52,7 @@ For property details, see the [API Center REST API reference](/rest/api/apicente
 
 * An API center in your Azure subscription. If you haven't created one, see [Quickstart: Create your API center](set-up-api-center.md).
 
-* One or more instances of Azure API Management, in the same or a different subscription. The resources must be in the same directory. 
-
-* One or more APIs managed in your API Management instance that you want to synchronize to your API center. 
+* An Azure API Management instance, in the same or a different subscription. The instance must be in the same directory. 
 
 * For Azure CLI:
     [!INCLUDE [include](~/reusable-content/azure-cli/azure-cli-prepare-your-environment-no-header.md)]
@@ -74,41 +71,41 @@ Select
 
 [!INCLUDE [configure-managed-identity-apim-reader](includes/configure-managed-identity-apim-reader.md)]
 
-## Link an API Management instance 
+## Integrate an API Management instance 
 
-You can create a link to an API Management instance using the portal.
+You can create an integration to an API Management instance using the portal.
 
 #### [Portal](#tab/portal)
 
 1. In the [portal](https://portal.azure.com), navigate to your API center.
 1. Under **Assets**, select **Environments**.
-1. Select **Links (preview)** > **+ Create a link**.
-1. In the **Link your Azure API Management Service** page:
-    1. Select the **Subscription**, **Resource group**, and **Azure API Management service** that you want to link.
-    1. In **Link details**, enter a link identifier.
+1. Select **Integrations (preview)** > **+ New integration**.
+1. In the **Integrate your Azure API Management Service** page:
+    1. Select the **Subscription**, **Resource group**, and **Azure API Management service** that you want to integrate.
+    1. In **Integration details**, enter an identifier.
     1. In **Environment details**, enter an **Environment title** (name), **Environment type**, and optional **Environment description**.
-    1. In **API details**, select a **Lifecycle** stage for all the synchronized APIs. (You can change this value for some or all APIs after they're added to your API center.) Also, select whether to synchronize API definitions.
+    1. In **API details**, select a **Lifecycle stage** for the synchronized APIs. (You can update this value for your APIs after they're added to your API center.) Also, select whether to synchronize API definitions.
 1. Select **Create**.
 
-:::image type="content" source="media/synchronize-api-management-apis/link-api-management-service.png" alt-text="Screenshot of the Link your API Management service page.":::
+:::image type="content" source="media/synchronize-api-management-apis/link-api-management-service.png" alt-text="Screenshot of integrated an Azure API Management Service in the portal.":::
 
-A linked environment is added in your API center. The API Management APIs are imported to the API center inventory.
+The environment is added in your API center. The API Management APIs are imported to the API center inventory.
 
-:::image type="content" source="media/synchronize-api-management-apis/environment-link-list.png" alt-text="Screenshot of link to API Management in the portal.":::
+:::image type="content" source="media/synchronize-api-management-apis/environment-link-list.png" alt-text="Screenshot of environment list in the portal.":::
 ---
 
-## Unlink an API Management instance
+## Delete an integration
 
-While an API Management instance is linked, you can't deleted synchronized APIs from your API center. If you need to, you can unlink an API Management instance. When you unlink an API Management instance from your API center:
+While an API Management instance is integrated, you can't delete synchronized APIs from your API center. If you need to, you can delete the integration. When you delete an integration:
 
-* All the API Management APIs in your API center inventory are deleted
-* The environment associated with the API Management instance is deleted
+* All the synchronized API Management APIs in your API center inventory are deleted
+* The environment and deployments associated with the API Management instance are deleted
 
-To unlink an API Management instance:
+To delete an API Management integration:
 
 1. In the [portal](https://portal.azure.com), navigate to your API center.
-1. Under **Assets**, select **Environments** > **Links (preview)**.
-1. Select the link, and then select **Delete** (trash can icon). 
+1. Under **Assets**, select **Environments** > **Integrations (preview)**.
+1. Select the integration, and then select **Delete** (trash can icon). 
 
 ## Related content