Merge pull request #294676 from Harikrishnan-M-B/apim3

Apim3

Author: Stacyrch140

articles/frontdoor/media/private-link/apim-private-endpoint-connections.png

@@ -8,14 +8,65 @@ ms.service: azure-frontdoor
 ms.topic: how-to
 ms.date: 09/26/2024
 ms.author: duau
-zone_pivot_groups: front-door-dev-exp-ps-cli
+zone_pivot_groups: front-door-dev-exp-portal-ps-cli
 ms.custom: ai-usage
 ---
 
 # Connect Azure Front Door Premium to an Azure API Management with Private Link (Preview)
 
 This article guides you through the steps to configure an Azure Front Door Premium to connect privately to your Azure API Management origin using Azure Private Link.
 
+::: zone pivot="front-door-portal"
+
+## Prerequisites
+
+- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
+- Have a functioning Azure Front Door Premium profile and an endpoint. For more information on how to create an Azure Front Door profile, see [Create a Front Door](../create-front-door-portal.md).
+- Have a functioning Azure API Management instance. For more information on how to create an API Management instance, see [Create a new Azure API Management instance](../../api-management/get-started-create-service-instance.md)
+
+## Create an origin group and add the API Management instance as an origin
+
+1. In your Azure Front Door Premium profile, go to *Settings* and select **Origin groups**.
+
+1. Click on **Add**
+2. Enter a name for the origin group
+3. Select **+ Add an origin** 
+4. Use the following table to configure the settings for the origin:
+
+    | Setting | Value |
+    | ------- | ----- |
+    | Name | Enter a name to identify this origin. |
+    | Origin Type | API Management |
+    | Host name | Select the host from the dropdown that you want as an origin. | 
+    | Origin host header | Will be autopopulated with the host of the chosen API Management instance|
+    | HTTP port | 80 (default) |
+    | HTTPS port | 443 (default) |
+    | Priority | Assign different priorities to origins for primary, secondary, and backup purposes. |
+    | Weight | 1000 (default). Use weights to distribute traffic among different origins. |
+    | Region | Select the region that matches or is closest to your origin. |
+    | Target sub resource | Choose 'Gateway' |
+    | Request message | Enter a custom message to display while approving the Private Endpoint.  |
+
+:::image type="content" source="../media/private-link/apim-privatelink.png" alt-text="Screenshot of origin settings for configuring API Management as a private origin.":::
+
+6. Select **Add** to save your origin settings
+7. Select **Add** to save the origin group settings.
+
+## Approve the private endpoint
+
+1. Navigate to the API Management instance you configured with Private Link in the previous section. Under **Deployment + infrastructure**, select **Network**.
+
+1. Select **Inbound private endpoint connections** tab. 
+
+1. Find the *pending* private endpoint request from Azure Front Door Premium and select **Approve**.
+
+1. After approval, the connection status will update. It can take a few minutes for the connection to fully establish. Once established, you can access your API Management through Front Door. 
+
+
+:::image type="content" source="../media/private-link/apim-private-endpoint-connections.png" alt-text="Screenshot of private endpoint connections tab in API Management portal.":::
+
+::: zone-end
+
 ::: zone pivot="front-door-ps"
 
 ## Prerequisites