Merge pull request #114495 from KumudD/release-build-virtual-network

Routing Preference - registration updates

Author: v-shmck

articles/virtual-network/configure-routing-preference-virtual-machine-cli.md

@@ -1,5 +1,5 @@
 ---
-title: Create a VM with a public IP address with routing preference choice - Azure CLI
+title: Configure routing preference for a VM - Azure CLI
 description: Learn how to create a VM with a public IP address with routing preference choice using the Azure command-line interface (CLI).
 services: virtual-network
 documentationcenter: na
@@ -14,9 +14,9 @@ ms.date: 05/18/2020
 ms.author: mnayak
 
 ---
-# Configure a virtual machine to route traffic with the routing preference type Internet using Azure CLI
+# Configure routing preference for a VM using Azure CLI
 
-You can create a virtual machine with a public IP address with a routing preference choice. Internet bound traffic from the VM will be routed to and from internet via respective network based on the routing preference selection. The default routing is via Microsoft global network.
+This article shows you how to configure routing preference for a virtual machine. Internet bound traffic from the VM will be routed via the ISP network when you choose **Internet** as your routing preference option . The default routing is via the Microsoft global network.
 
 This article shows you how to create a virtual machine with a public IP that is set to route traffic via the public internet using Azure CLI.
 
@@ -25,6 +25,11 @@ This article shows you how to create a virtual machine with a public IP that is
 > This preview version is provided without a service level agreement, and it's not recommended for production workloads. Certain features might not be supported or might have constrained capabilities. 
 > For more information, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
 
+## Register the feature for your subscription
+The Routing Preference feature is currently in preview. Register the feature for your subscription as follows:
+```azurecli
+az feature register --namespace Microsoft.Network --name AllowRoutingPreferenceFeature
+```
 ## Create a resource group
 1. If using the Cloud Shell, skip to step 2. Open a command session and sign into Azure with `az login`.
 2. Create a resource group with the [az group create](/cli/azure/group#az-group-create) command. The following example creates a resource group in the East US Azure region:
@@ -122,7 +127,6 @@ az group delete --name myResourceGroup --yes
 
 ## Next steps
 
-- Learn more about [Public IP with routing preference](routing-preference-overview.md).
 - Learn more about [routing preference in public IP addresses](routing-preference-overview.md).
 - Learn more about [public IP addresses](virtual-network-ip-addresses-overview-arm.md#public-ip-addresses) in Azure.
 - Learn more about [public IP address settings](virtual-network-public-ip-address.md#create-a-public-ip-address).

articles/virtual-network/configure-routing-preference-virtual-machine-powershell.md

@@ -1,5 +1,5 @@
 ---
-title: Create a VM with a public IP address with routing preference choice - Azure PowerShell
+title: Configure routing preference for a VM - Azure PowerShell
 description: Learn how to create a VM with a public IP address with routing preference choice using the Azure PowerShell.
 services: virtual-network
 documentationcenter: na
@@ -14,17 +14,23 @@ ms.date: 05/18/2020
 ms.author: mnayak
 
 ---
-# Configure a virtual machine to route traffic via the internet using Azure PowerShell
+# Configure routing preference for a VM using Azure PowerShell
 
-You can create a virtual machine with a public IP address with a routing preference choice. Internet bound traffic from the VM will be routed to and from internet via respective network based on the routing preference selection. The default routing is via Microsoft global network.
+This article shows you how to configure routing preference for a virtual machine. Internet bound traffic from the VM will be routed via the ISP network when you choose **Internet** as your routing preference option . The default routing is via the Microsoft global network.
 
-This article shows you how to create a virtual machine with a public IP that is set to route traffic via the Internet using Azure PowerShell.
+This article shows you how to create a virtual machine with a public IP that is set to route traffic via the ISP network using Azure PowerShell.
 
 > [!IMPORTANT]
 > Routing preference is currently in public preview.
 > This preview version is provided without a service level agreement, and it's not recommended for production workloads. Certain features might not be supported or might have constrained capabilities. 
 > For more information, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
 
+## Register the feature for your subscription
+The Routing Preference feature is currently in preview. Register the feature for your subscription as follows:
+```azurepowershell
+Register-AzProviderFeature -FeatureName AllowRoutingPreferenceFeature ProviderNamespace Microsoft.Network
+```
+
 ## Create a resource group
 1. If using the Cloud Shell, skip to step 2. Open a command session and sign into Azure with `Connect-AzAccount`.
 2. Create a resource group with the [New-AzResourceGroup](/powershell/module/az.resources/new-azresourcegroup) command. The following example creates a resource group in the East US Azure region:

articles/virtual-network/routing-preference-cli.md

@@ -1,5 +1,5 @@
 ---
-title: Create a public IP address with Internet traffic routing preference using Azure CLI
+title: Configure routing preference for a public IP address using Azure CLI
 titlesuffix: Azure Virtual Network
 description: Learn how to create a public IP with an Internet traffic routing preference
 services: virtual-network
@@ -15,9 +15,9 @@ ms.date: 05/18/2020
 ms.author: mnayak
 
 ---
-# Create a public IP address with Internet traffic routing preference using Azure CLI
+# Configure routing preference for a public IP address using Azure CLI
 
-This article shows you how to create a public IP address with an Internet routing preference using Azure CLI. After creating the public IP address, you can associate it with the following Azure resources for inbound and outbound traffic to the internet:
+This article shows you how to configure routing preference via ISP network (**Internet** option) for a public IP address using Azure CLI. After creating the public IP address, you can associate it with the following Azure resources for inbound and outbound traffic to the internet:
 
 * Virtual machine
 * Virtual machine scale set
@@ -26,6 +26,8 @@ This article shows you how to create a public IP address with an Internet routin
 * Application Gateway
 * Azure Firewall
 
+By default, traffic is routed via the Microsoft global network for all Azure services and can be associated with any Azure services.
+
 > [!IMPORTANT]
 > Routing preference is currently in public preview.
 > This preview version is provided without a service level agreement, and it's not recommended for production workloads. Certain features might not be supported or might have constrained capabilities. 
@@ -36,6 +38,12 @@ If you don't have an Azure subscription, create a [free account](https://azure.m
 [!INCLUDE [cloud-shell-try-it.md](../../includes/cloud-shell-try-it.md)]
 If you decide to install and use Azure CLI locally instead, this quickstart requires you to use Azure CLI version 2.0.49 or later. To find your installed version, run `az --version`. See [Install Azure CLI](/cli/azure/install-azure-cli) for install or upgrade info.
 
+## Register the feature for your subscription
+The Routing Preference feature is currently in preview. Register the feature for your subscription as follows:
+```azurecli
+az feature register --namespace Microsoft.Network --name AllowRoutingPreferenceFeature
+```
+
 ## Create a resource group
 Create a resource group with the [az group create](/cli/azure/group#az-group-create) command. The following example creates a resource group in the **East US** Azure region:
 
@@ -65,7 +73,7 @@ az network public-ip create \
 You can associate the above created public IP address with a [Windows](../virtual-machines/windows/overview.md?toc=%2fazure%2fvirtual-network%2ftoc.json) or [Linux](../virtual-machines/linux/overview.md?toc=%2fazure%2fvirtual-network%2ftoc.json) virtual machine. Use the CLI section on the tutorial page: [Associate a public IP address to a virtual machine](associate-public-ip-address-vm.md#azure-cli) to associate the Public IP to your VM. You can also associate the public IP address created above with with an [Azure Load Balancer](../load-balancer/load-balancer-overview.md), by assigning it to the load balancer **frontend** configuration. The public IP address serves as a load-balanced virtual IP address (VIP).
 
 ## Next steps
-- Learn more about [Public IP with routing preference](routing-preference-overview.md).
+
 - Learn more about [routing preference in public IP addresses](routing-preference-overview.md). 
-- [Deploy a VM and associate a public ip with routing preference choice using the Azure CLI](configure-routing-preference-virtual-machine-cli.md).
+- [Configure routing preference for a VM using the Azure CLI](configure-routing-preference-virtual-machine-cli.md).
 

articles/virtual-network/routing-preference-overview.md

@@ -26,13 +26,13 @@ Azure routing preference enables you to choose how your traffic routes between A
 
 ## Routing via Microsoft global network
 
-When you route your traffic via the *Microsoft global network*, traffic is delivered over one of the largest networks on the globe spanning over 130,000 miles of fiber with over 165 edge POPs. The network is well provisioned with multiple redundant fiber paths to ensure exceptionally high reliability and availability. The traffic engineering is managed by a software defined WAN control that ensures low latency path selection for your traffic and offers the premium network performance.
+When you route your traffic via the *Microsoft global network*, traffic is delivered over one of the largest networks on the globe spanning over 160,000 miles of fiber with over 165 edge Point of Presence (POP). The network is well provisioned with multiple redundant fiber paths to ensure exceptionally high reliability and availability. The traffic engineering is managed by a software defined WAN controller that ensures low latency path selection for your traffic and offers the premium network performance.
 
 ![Routing via Microsoft global network](media/routing-preference-overview/route-via-microsoft-global-network.png)
 
-**Ingress traffic:** The global BGP Anycast announcement ensures ingress traffic enters Microsoft network closest to the user. For example, if a user from Singapore accesses Azure resources hosted in Chicago, USA then traffic is entered into Microsoft global network in Singapore Edge Point Of Presence (PoP) and travels on Microsoft network to the service hosted in Chicago.
+**Ingress traffic:** The global BGP Anycast announcement ensures ingress traffic enters Microsoft network closest to the user. For example, if a user from Singapore accesses Azure resources hosted in Chicago, USA then traffic is entered into Microsoft global network in Singapore Edge POP and travels on Microsoft network to the service hosted in Chicago.
 
-**Egress traffic:** The egress traffic follows the same principle. Traffic travels majority of its journey on Microsoft global network and exits closest to the user. For example, if traffic from Azure Chicago is destined to a user from Singapore, then traffic travels on Microsoft network from Chicago to Singapore, and exits the Microsoft network in Singapore Edge Point Of Presence (PoP).
+**Egress traffic:** The egress traffic follows the same principle. Traffic travels majority of its journey on Microsoft global network and exits closest to the user. For example, if traffic from Azure Chicago is destined to a user from Singapore, then traffic travels on Microsoft network from Chicago to Singapore, and exits the Microsoft network in Singapore Edge POP.
 
 Both ingress and egress traffic stays bulk of the travel on the Microsoft global network. This is also known as *cold potato routing*.
 
@@ -49,7 +49,7 @@ The new routing choice *Internet routing* minimizes travel on the Microsoft glob
 
 ## Supported services
 
-Routing preference choice is enabled on a public IP address, which can be assigned to an Azure resource for inbound and outbound traffic to internet. Some of the resources you can associate a public IP address with routing preference type are:
+Public IP with Routing preference choice “Microsoft Global Network” can be associated with any Azure services. However, Public IP with Routing preference choice **Internet** can be associated with the following Azure resources:
 
 * Virtual machine
 * Virtual machine scale set
@@ -82,16 +82,17 @@ The price difference between both options is reflected in the internet egress da
 
 ## Availability
 
-Routing Preference support is available in the following regions for services such as virtual machine and internet-facing load balancer that use a public IP for internet egress - North Europe, West Europe, France Central, UK South, Central US, East US, East US 2, North Central US, South Central US, West US, West US 2, West Central US, Southeast Asia, and Australia East.
+Routing Preference support is available in the following regions for services such as virtual machine and internet-facing load balancer that use a public IP for internet egress - North Europe, West Europe, France South, UK South, East US, North Central US, South Central US, West US,  West Central US, Southeast Asia, Germany West Central, Switzerland West, Japan East, and Japan West.
 
 Routing Preference support for storage account is available in the following Azure regions - France South, North Central US, and West Central US.
 ## Limitations
 
 * Routing preference is only compatible with standard SKU of public IP address. Basic SKU of public IP address is not supported.
 * Routing preference currently supports only IPv4 public IP addresses. IPv6 public IP addresses are not supported.
+* Virtual machines with multiple NICs can have only one type of routing preference.
 
 
 ## Next steps
 
-* [Create a VM with Internet routing preference using the Azure PowerShell](configure-routing-preference-virtual-machine-powershell.md)
-* [Create a VM with Internet routing preference using the Azure CLI](configure-routing-preference-virtual-machine-cli.md)
+* [Configure routing preference for a VM using the Azure PowerShell](configure-routing-preference-virtual-machine-powershell.md)
+* [Configure routing preference for a VM using the Azure CLI](configure-routing-preference-virtual-machine-cli.md)

articles/virtual-network/routing-preference-portal.md

@@ -1,5 +1,5 @@
 ---
-title: Create a public IP address with Internet traffic routing preference - Azure portal
+title: Configure routing preference for a public IP address - Azure portal
 description: Learn how to create a public IP with an Internet traffic routing preference
 services: virtual-network
 documentationcenter: na
@@ -14,16 +14,17 @@ ms.date: 05/18/2020
 ms.author: mnayak
 
 ---
-# Create a public IP address with the routing preference type Internet using the Azure portal
+# Configure routing preference for a public IP address using the Azure portal
 
-This article shows you how to create a public IP address with the routing preference type Internet using the Azure portal. After creating the public IP address, you can associate it with the following Azure resources for inbound and outbound traffic to the internet:
+This article shows you how to configure routing preference via ISP network (**Internet** option) for a public IP address. After creating the public IP address, you can associate it with the following Azure resources for inbound and outbound traffic to the internet:
 
 * Virtual machine
 * Virtual machine scale set
 * Azure Kubernetes Service (AKS)
 * Internet-facing load balancer
 * Application Gateway
 * Azure Firewall
+By default, traffic is routed via the Microsoft global network for all Azure services and can be associated with any Azure services.
 
 > [!IMPORTANT]
 > Routing preference is currently in public preview.
@@ -32,6 +33,12 @@ This article shows you how to create a public IP address with the routing prefer
 
 If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) now.
 
+## Register the feature for your subscription
+The Routing Preference feature is currently in preview. Register the feature for your subscription using Azure PowerShell as follows:
+```azurepowershell
+Register-AzProviderFeature -FeatureName AllowRoutingPreferenceFeature -ProviderNamespace Microsoft.Network
+```
+
 ## Create a public IP address with a routing preference
 1. Sign in to the [Azure portal](https://preview.portal.azure.com/).
 2. Select **Create a resource**. 
@@ -47,8 +54,8 @@ If you don't have an Azure subscription, create a [free account](https://azure.m
 You can associate the above created public IP address with a [Windows](../virtual-machines/windows/overview.md?toc=%2fazure%2fvirtual-network%2ftoc.json) or [Linux](../virtual-machines/linux/overview.md?toc=%2fazure%2fvirtual-network%2ftoc.json) virtual machine. Use the CLI section on the tutorial page: [Associate a public IP address to a virtual machine](associate-public-ip-address-vm.md#azure-cli) to associate the public IP to your VM. You can also associate the public IP address created above with an [Azure Load Balancer](../load-balancer/load-balancer-overview.md), by assigning it to the load balancer **frontend** configuration. The public IP address serves as a load-balanced virtual IP address (VIP).
 
 ## Next steps
-- Learn more about [Public IP with routing preference](routing-preference-overview.md).
-- [Deploy a VM and assign a public IP with routing preference choice using the Azure portal](tutorial-routing-preference-virtual-machine-portal.md).
-- [Create a public IP with routing preference choice using the PowerShell](routing-preference-powershell.md).
+- Learn more about [public IP with routing preference](routing-preference-overview.md).
+- [Configure routing preference for a VM](tutorial-routing-preference-virtual-machine-portal.md).
+- [Configure routing preference for a public IP address using the PowerShell](routing-preference-powershell.md).
 - Learn more about [public IP addresses](virtual-network-ip-addresses-overview-arm.md#public-ip-addresses) in Azure.
 - Learn more about all [public IP address settings](virtual-network-public-ip-address.md#create-a-public-ip-address).