edits/review

Author: gitName

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

@@ -24,9 +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 integrated API sources<sup>4</sup> | 1  |  3 |
+| Maximum number of linked 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 integrated API Management instances. In the Free plan, synchronization from an integrated API source is limited to 200 APIs and 5 API definitions.
+<sup>4</sup> Sources such as linked API Management instances. In the Free plan, synchronization from a linked API source is limited to 200 APIs and 5 API definitions.

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

@@ -1,26 +1,24 @@
 ---
 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.
+description: Link an API Management instance to Azure API Center for automatic synchronization of APIs to the inventory.
 author: dlepow
 ms.service: azure-api-center
 ms.topic: how-to
-ms.date: 10/22/2024
+ms.date: 10/29/2024
 ms.author: danlep 
 ms.custom: devx-track-azurecli
 # 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.
 ---
 
-# Integrate an API Management instance to synchronize APIs to your API center
+# Synchronize APIs from an API Management instance
 
-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).
+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).APIs in a linked API Management instance are continuously kept up to date in your API center inventory. 
 
-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 API Management 
 
-## 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 integrate an API Management instance, the following happens:
+When you link 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. 
@@ -29,23 +27,23 @@ API Management APIs automatically synchronize to the API center whenever existin
 
 > [!NOTE]
 > * 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.
+> * 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 linked API Management instances.
 
 
 ### Entities synchronized from API Management
 
-You can add or update API metadata and documentation in your API center to help stakeholders discover, understand, and consume the synchronized APIs. Learn more about Azure API Center's [built-in and custom metadata properties](add-metadata-properties.md).
+You can add or update metadata properties and documentation in your API center to help stakeholders discover, understand, and consume the synchronized APIs. Learn more about Azure API Center's [built-in and custom metadata properties](add-metadata-properties.md).
 
-Certain properties of synchronized APIs and other entities are configured automatically in the API center and are read-only, as shown in the following table:
+The following table shows entity properties that can be modified in Azure API Center and those that are determined based on their values in a linked Azure API Management instance. Also, entities' resource or system identifiers in Azure API Center are generated automatically and can't be modified.
 
-| Entity       | Read-only properties in API center                     |
-|--------------|--------------------------------------------------------|
-| API          | • title<br/>• description<br/>• kind                   |
-| API version  | • title                                                |
-| Environment  | • server.type
-| Deployment   | • server.runtimeUri<br/>• environmentId<br/>• definitionId |
+| Entity       | API Center                     | API Management                                           |
+|--------------|-----------------------------------------|-----------------|
+| API          | summary<br/>lifecycleStage<br/>termsOfService<br/>license<br/>externalDocumentation<br/>customProperties    | title<br/>description<br/>kind                   |
+| API version  | lifecycleStage      | title                                                |
+| Environment  | title<br/>description<br/>kind</br>server.managementPortalUri<br/>onboarding<br/>customProperties      | server.type
+| Deployment   |  title<br/>description<br/>server<br/>state<br/>customProperties    |      server.runtimeUri<br/>environmentId<br/>definitionId |
 
-For property details, see the [API Center REST API reference](/rest/api/apicenter).
+For property details, see the [Azure API Center REST API reference](/rest/api/apicenter).
 
 
 ## Prerequisites
@@ -71,41 +69,41 @@ Select
 
 [!INCLUDE [configure-managed-identity-apim-reader](includes/configure-managed-identity-apim-reader.md)]
 
-## Integrate an API Management instance 
+## Link an API Management instance 
 
-You can create an integration to an API Management instance using the portal.
+You can link 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 **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. Select **Links (preview)** > **+ New 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 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 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 integrated an Azure API Management Service in the portal.":::
+:::image type="content" source="media/synchronize-api-management-apis/link-api-management-service.png" alt-text="Screenshot of linking an Azure API Management Service in the portal.":::
 
 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 environment list in the portal.":::
 ---
 
-## Delete an integration
+## Delete a link
 
-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:
+While an API Management instance is linked, you can't delete synchronized APIs from your API center. If you need to, you can delete the link. When you delete a link:
 
-* All the synchronized API Management APIs in your API center inventory are deleted
+* 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 delete an API Management integration:
+To delete an API Management link:
 
 1. In the [portal](https://portal.azure.com), navigate to your API center.
-1. Under **Assets**, select **Environments** > **Integrations (preview)**.
-1. Select the integration, and then select **Delete** (trash can icon). 
+1. Under **Assets**, select **Environments** > **Link (preview)**.
+1. Select the link, and then select **Delete** (trash can icon). 
 
 ## Related content