Merge pull request #294391 from dlepow/aint

[APIC] UX for integrations

Author: v-regandowner

articles/api-center/includes/delete-api-integration.md

@@ -23,8 +23,8 @@ You can delete an integration using the portal or the Azure CLI.
 #### [Portal](#tab/portal)
 
 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). 
 
 #### [Azure CLI](#tab/cli)
 

articles/api-center/index.yml

@@ -51,8 +51,8 @@ landingContent:
         links:
           - text: Manage inventory - Azure CLI
             url: manage-apis-azure-cli.md
-          - text: Import APIs from API Management
-            url: import-api-management-apis.md
+          - text: Synchronize APIs from API Management
+            url: synchronize-api-management-apis.md
           - text: Build and register APIs - VS Code extension
             url: use-vscode-extension.md
  # Card

articles/api-center/media/synchronize-api-management-apis/link-api-management-service.png

@@ -14,6 +14,9 @@ ms.custom: devx-track-azurecli
 
 This article shows how to integrate an API Management instance so that the instances'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.
+
 ## 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). 
@@ -64,17 +67,18 @@ You can integrate an API Management instance using the portal or the Azure CLI.
 
 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 **Integrations (preview)** > **+ New integration** > **From Azure API Management**.
+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 **Link details**, enter an identifier.
+    1. In **Integration details**, enter an identifier.
+        If you haven't already configured a managed identity with access to the API Management instance, enable **Automatically configure managed identity and assign permissions**. This selection automatically assigns the API center's system-assigned managed identity the necessary permissions to synchronize APIs from the API Management instance.
     1. In **Environment details**, enter an **Environment title** (name), **Environment type**, and optional **Description**.
     1. In **API Details**:
         1. Select a **Lifecycle** for the synchronized APIs. (You can update this value for the APIs after they're added to your API center.)
         1. Optionally, select whether to include API definitions with the synchronized APIs.
 1. Select **Create**.
 
-:::image type="content" source="media/synchronize-api-management-apis/link-api-management-service.png" alt-text="Screenshot of integrating 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 integrating an Azure API Management service in the portal.":::
 
 #### [Azure CLI](#tab/cli)
 

articles/api-center/media/synchronize-aws-gateway-apis/link-aws-gateway-service.png

@@ -4,7 +4,7 @@ description: Integrate an Amazon API Gateway to Azure API Center for automatic s
 author: dlepow
 ms.service: azure-api-center
 ms.topic: how-to
-ms.date: 01/23/2025
+ms.date: 02/10/2025
 ms.author: danlep 
 ms.custom: devx-track-azurecli
 # Customer intent: As an API program manager, I want to integrate my Azure API Management instance with my API center and synchronize API Management APIs to my inventory.
@@ -89,7 +89,26 @@ Take note of the **Secret identifier** of each secret, a URI similar to `https:/
 
 ## Integrate an Amazon API Gateway 
 
- 
+You can integrate an Amazon API Gateway using the portal or the Azure CLI.
+
+#### [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** > **From Amazon API Gateway**.
+1. In the **Integrate your Amazon API Gateway Service** page:
+    1. Enter the Key Vault secret identifiers for the AWS access key and secret access key, and the AWS region where the Amazon API Gateway is deployed.
+    1. In **Integration details**, enter an identifier.
+    1. In **Environment details**, enter an **Environment title** (name), **Environment type**, and optional **Description**.
+    1. In **API Details**:
+        1. Select a **Lifecycle** for the synchronized APIs. (You can update this value for the APIs after they're added to your API center.)
+        1. Optionally, select whether to include API definitions with the synchronized APIs.
+1. Select **Create**.
+
+
+:::image type="content" source="media/synchronize-aws-gateway-apis/link-aws-gateway-service.png" alt-text="Screenshot of integrating an Amazon API Gateway service in the portal.":::
+
+#### [Azure CLI](#tab/cli)
+
 Run the [az apic integration create aws](/cli/azure/apic/integration/create#az-apic-integration-create-aws) (preview) command to integrate an Amazon API Gateway to your API center. 
 
 * Provide the names of the resource group, API center, and integration. 
@@ -109,21 +128,7 @@ az apic integration create aws \
 
 The environment is added in your API center. The Amazon API Gateway APIs are imported to the API center inventory.
 
-## Delete an integration
-
-While an API source 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:
-
-* The synchronized APIs in your API center inventory are deleted
-* The environment and deployments associated with the API source are deleted
-
-To delete an integration using the Azure CLI, run the [az apic integration delete](/cli/azure/apic/integration#az-apic-integration-delete) (preview) command. Provide the names of the resource group, API center, and integration.
-
-```azurecli
-az apic integration delete \
-    --resource-group <resource-group-name> \
-    --service-name <api-center-name> \
-    --integration-name <integration-name> 
-```
+[!INCLUDE [delete-api-integration](includes/delete-api-integration.md)]
 
 ## Related content
 

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

@@ -423,8 +423,8 @@
       href: api-management-howto-configure-notifications.md
   - name: Export APIs
     items:
-    - name: Inventory APIs in API Center
-      href: ../api-center/import-api-management-apis.md?toc=%2Fazure%2Fapi-management%2Ftoc.json&bc=/azure/api-management/breadcrumb/toc.json
+    - name: Synchronize APIs to API Center
+      href: ../api-center/synchronize-api-management-apis.md?toc=%2Fazure%2Fapi-management%2Ftoc.json&bc=/azure/api-management/breadcrumb/toc.json
     - name: Export APIs to Postman for API development
       displayName: collection
       href: export-api-postman.md