[APIC] UX for integrations

Author: gitName

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/media/synchronize-api-management-apis/link-api-management-service.png

@@ -64,17 +64,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-api-management-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,25 @@ 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-api-management-apis/link-amazon-api-gateway.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 +127,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