Merge pull request #223823 from halkazwini/ps-bulk

Peering Service: Freshness: Create Peering Service Connection using the Azure portal

Author: v-dirichards

articles/peering-service/azure-portal.md

@@ -1,112 +1,116 @@
 ---
 title: Create Azure Peering Service Connection - Azure portal
-description: Learn how to create Azure Peering Service by using the Azure portal
+description: Learn how to create, configure, and delete an Azure Peering Service connection using the Azure portal
 services: peering-service
 author: halkazwini
 ms.service: peering-service
 ms.topic: how-to
-ms.tgt_pltfrm: na
 ms.workload: Infrastructure-services
-ms.date: 04/07/2021
+ms.date: 01/12/2023
 ms.author: halkazwini
+ms.custom: template-how-to, engagement-fy23
 ---
 
 # Create Peering Service Connection using the Azure portal
 
+> [!div class="op_single_selector"]
+> * [Portal](azure-portal.md)
+> * [PowerShell](powershell.md)
+> * [Azure CLI](cli.md)
+
 Azure Peering Service is a networking service that enhances customer connectivity to Microsoft public cloud services such as Microsoft 365, Dynamics 365, software as a service (SaaS) services, Azure, or any Microsoft services accessible via the public internet.
 
 In this article, you'll learn how to Create a Peering Service connection by using the Azure portal.
 
-If you don't have an Azure subscription, create an [account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) now.
-
-> 
+If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
 
 ## Prerequisites
 
-You must have the following:
-
-### Azure account
-
-You must have a valid and active Microsoft Azure account. This account is required to set up the Peering Service connection. Peering Service connection is a resource within Azure subscriptions. 
-
-### Connectivity provider
+- An Azure subscription
 
-You can work with any [Azure peering service provider](./location-partners.md) to obtain Peering Service to connect your network optimally with the Microsoft network.
+- A connectivity provider. For more information, see [Azure peering service partners](./location-partners.md).
 
+## Sign in to Azure
 
-
-
-## Sign in to the Azure portal
-
-From a browser, go to the Azure portal and sign in with your Azure account.
+Sign in to the [Azure portal](https://portal.azure.com)
 
 ## Create a Peering Service connection
 
-1. To create a Peering Service connection, select **Create a resource** > **Peering Service**.
+1. In the search box at the top of the portal, enter *Peering Service*. Select **Peering Services** in the search results.
 
-    ![Create Peering Service](./media/peering-service-portal/peering-servicecreate.png)
+1. Select **+ Create**.
 
-1. Enter the following details on the **Basics** tab on the **Create a peering service connection** page.
+1. In **Create a peering service connection**, enter or select the following information in the **Basics** tab:
 
- 
-1. Select the subscription and the resource group associated with the subscription.
+    | Setting | Value |
+    | ------- | ----- |
+    | **Project Details**  |  |
+    | Subscription | Select your Azure subscription. |
+    | Resource Group | Select **Create new**. </br> Enter *myResourceGroup*. </br> Select **OK**. |
+    | **Instance details** |  |
+    | Name | Enter *myPeeringService*. |
 
-   ![Create Peering basic tab](./media/peering-service-portal/peering-servicebasics.png)
+    :::image type="content" source="./media/azure-portal/peering-service-basics.png" alt-text="Screenshot of the Basics tab of Create a peering service connection in Azure portal.":::
 
-1. Enter a **Name** to which the Peering Service instance should be registered.
+    > [!NOTE]
+    > Once a Peering Service resource is created under a certain subscription and resource group, it cannot be moved to another resource group or subscription.
  
-1. Now, select the **Next: Configuration** button at the bottom of the page. The **Configuration** page appears.
+1. Select **Next: Configuration**.
 
 ## Configure the Peering Service connection
 
-1. On the **Configuration** page, select the customer network location to which the Peering Service must be enabled by selecting the same from the **Peering service location** drop-down list. 
+1. On the **Configuration** page, select your **Country** and **State/Province** where the Peering Service must be enabled. 
 
-1. Select the service provider from whom the Peering Service must be obtained by selecting a provider name from the **Peering service provider** drop-down list.
+1. Select the **Provider** that you're using to enable the Peering Service.
 
-1. Select the **provider's primary peering location** closest to the customer network location. This is the peering service location between Microsoft and Partner.
+1. Select the **provider primary peering location** closest to your network location. This is the peering service location between Microsoft and the Partner.
 
-1. Select the **provider's backup peering location** as the next closest to the customer network location. peering services will be active via backup location only in the event of failure of primary peering service location for disaster recovery. If "None" is selected, internet will be the default failover route in the event of primary peering service location failure.
+1. Select the **provider backup peering location** as the next closest to your network location. A peering service will be active via the backup peering location only in the event of failure of primary peering service location for disaster recovery. If **None** is selected, internet will be the default failover route in the event of primary peering service location failure.
 
- 
-1. Select **Create new prefix** at the bottom of the **Prefixes** section, and text boxes appear. Now, enter the name of the prefix resource and the prefixes that are associated with the service provider.
+1. Under the **Prefixes** section, select **Create new prefix**. In **Name**, enter a name for the prefix resource. Enter the prefixes that are associated with the service provider in **Prefix**. In **Prefix key**, enter the prefix key that was given to you by your provider (ISP or IXP). This key allows Microsoft to validate the prefix and provider who have allocated your IP prefix.
 
-1. Select **Prefix Key** and add the Prefix Key that has been given to you by your provider (ISP or IXP). This key allows MS to validate the prefix and provider who have allocated your IP prefix.
-   > ![Screenshot shows the Configuration tab of the Create a peering service connection page where you can enter the Prefix key.](./media/peering-service-portal/peering-serviceconfiguration.png)
+    :::image type="content" source="./media/azure-portal/peering-service-configuration.png" alt-text="Screenshot of the Configuration tab of Create a peering service connection in Azure portal."::: 
 
-1. Select the **Review + create** button at the lower left of the page. The **Review + create** page appears, and Azure validates your configuration.
+1. Select **Review + create**.
 
 
-1. When you see the **Validation passed** message as shown, select **Create**.
-
-   > ![Screenshot shows the Review + create tab of the Create a peering service connection page.](./media/peering-service-portal/peering-service-prefix.png)
+1. Review the settings, and then select **Create**.
 
+    :::image type="content" source="./media/azure-portal/peering-service-create.png" alt-text="Screenshot of the Review + create tab of Create a peering service connection in Azure portal.":::
 
-1. After you create a Peering Service connection, additional validation is performed on the included prefixes. You can review the validation status under the **Prefixes** section of the resource name. If the validation fails, one of the following error messages is displayed:
+1. After you create a Peering Service connection, additional validation is performed on the included prefixes. You can review the validation status under the **Prefixes** section of your Peering Service. If the validation fails, one of the following error messages is displayed:
 
    - Invalid Peering Service prefix, the prefix should be valid format, only IPv4 prefix is supported currently.
-   - Prefix was not received from Peering Service provider, contact Peering Service provider.
-   - Prefix announcement does not have a valid BGP community,  contact Peering Service provider.
+   - Prefix wasn't received from Peering Service provider, contact Peering Service provider.
+   - Prefix announcement doesn't have a valid BGP community,  contact Peering Service provider.
    - Prefix received with longer AS path(>3), contact Peering Service provider.
    - Prefix received with private AS in the path, contact Peering Service provider.
 
 ### Add or remove a prefix
 
-Select **Add prefixes** on the **Prefixes** page to add prefixes.
+1. In the search box at the top of the portal, enter *Peering Service*. Select **Peering Services** in the search results.
 
-Select the ellipsis (...) next to the listed prefix, and select the **Delete** option.
+1. Select your Peering Service that you want to add or remove a prefix to or from it.
 
-### Delete a Peering Service connection
+1. Select **Prefixes**, and then select **Add prefix** to add prefixes.
 
-On the **All Resources** page, select the check box on the Peering Service and select the **Delete** option at the top of the page.
+1. Select the ellipsis (**...**) next to the listed prefix, and select **Delete**.
 
 > [!NOTE]
 > You can't modify an existing prefix.
->
+
+### Delete a Peering Service connection
+
+1. In the search box at the top of the portal, enter *Peering Service*. Select **Peering Services** in the search results.
+
+1. Select the checkbox next to the Peering Service that you want to delete, and then select **Delete** at the top of the page.
+
+1. Enter *yes* in **Confirm delete**, and then select **Delete**.
+
+    :::image type="content" source="./media/azure-portal/peering-service-delete.png" alt-text="Screenshot of deleting a Peering Service in Azure portal.":::
 
 ## Next steps
 
-- To learn about Peering Service connection, see [Peering Service connection](connection.md).
-- To learn about Peering Service connection telemetry, see [Peering Service connection telemetry](connection-telemetry.md).
-- To measure telemetry, see [Measure connection telemetry](measure-connection-telemetry.md).
-- To create the peering service connection by using Azure PowerShell, see [Create a Peering Service connection - Azure PowerShell](powershell.md).
-- To create the connection by using the Azure CLI, see [Create a Peering Service connection - Azure CLI](cli.md).
+- To learn more about Peering Service connection, see [Peering Service connection](connection.md).
+- To learn more about Peering Service connection telemetry, see [Peering Service connection telemetry](connection-telemetry.md).
+- To measure Peering Service connection telemetry, see [Measure connection telemetry](measure-connection-telemetry.md).