Merge pull request #252452 from simonkurtz-MSFT/patch-1

Use CAF abbreviations in naming

Author: prmerger-automator[bot]

articles/api-management/api-management-howto-integrate-internal-vnet-appgateway.md

@@ -84,13 +84,13 @@ If you use Azure Active Directory or third-party authentication, enable the [coo
 
 ## Setting Variables
 
-Throughout this guide, you will need to define several variables. 
+Throughout this guide, you will need to define several variables. Naming is based on the [Cloud Adoption Framework abbreviation](/azure/cloud-adoption-framework/ready/azure-best-practices/resource-abbreviations) guidance.
 
 ```powershell
 # These variables must be changed.
 $subscriptionId = "00000000-0000-0000-0000-000000000000"      # GUID of your Azure subscription
 $domain = "contoso.net"                                       # The custom domain for your certificate
-$apimServiceName = "ContosoApi"                               # API Management service instance name, must be globally unique    
+$apimServiceName = "apim-contoso"                             # API Management service instance name, must be globally unique    
 $apimDomainNameLabel = $apimServiceName                       # Domain name label for API Management's public IP address, must be globally unique
 $apimAdminEmail = "[email protected]"                         # Administrator's email address - use your email address
 
@@ -110,10 +110,10 @@ $managementCertPfxPassword = "certificatePassword123"         # Password for man
 
 
 # These variables may be changed.
-$resGroupName = "apim-appGw-RG"                               # Resource group name that will hold all assets
+$resGroupName = "rg-apim-agw"                                 # Resource group name that will hold all assets
 $location = "West US"                                         # Azure region that will hold all assets
 $apimOrganization = "Contoso"                                 # Organization name    
-$appgwName = "apim-app-gw"                                    # The name of the Application Gateway
+$appgwName = "agw-contoso"                                    # The name of the Application Gateway
 ```
 
 ## Create a resource group for Resource Manager
@@ -157,7 +157,7 @@ The following example shows how to create a virtual network by using Resource Ma
         Internet -SourcePortRange * -DestinationAddressPrefix * -DestinationPortRange 443
         
     $appGwNsg = New-AzNetworkSecurityGroup -ResourceGroupName $resGroupName -Location $location -Name `
-        "NSG-APPGW" -SecurityRules $appGwRule1, $appGwRule2
+        "nsg-agw" -SecurityRules $appGwRule1, $appGwRule2
     ```
     
 1.  Create a network security group (NSG) and NSG rules for the API Management subnet. [API Management stv2 requires several specific NSG rules](api-management-using-with-internal-vnet.md#enable-vnet-connection).
@@ -177,7 +177,7 @@ The following example shows how to create a virtual network by using Resource Ma
         -SourcePortRange * -DestinationAddressPrefix AzureKeyVault -DestinationPortRange 443
     
     $apimNsg = New-AzNetworkSecurityGroup -ResourceGroupName $resGroupName -Location $location -Name `
-        "NSG-APIM" -SecurityRules $apimRule1, $apimRule2, $apimRule3, $apimRule4
+        "nsg-apim" -SecurityRules $apimRule1, $apimRule2, $apimRule3, $apimRule4
     ```
 
 1. Assign the address range 10.0.0.0/24 to the subnet variable to be used for Application Gateway while you create a virtual network.
@@ -192,10 +192,10 @@ The following example shows how to create a virtual network by using Resource Ma
     $apimSubnet = New-AzVirtualNetworkSubnetConfig -Name "apimSubnet" -NetworkSecurityGroup $apimNsg -AddressPrefix "10.0.1.0/24"
     ```
 
-1. Create a virtual network named **appgwvnet** in resource group **apim-appGw-RG** for the West US region. Use the prefix 10.0.0.0/16 with subnets 10.0.0.0/24 and 10.0.1.0/24.
+1. Create a virtual network named **vnet-contoso**. Use the prefix 10.0.0.0/16 with subnets 10.0.0.0/24 and 10.0.1.0/24.
 
     ```powershell
-    $vnet = New-AzVirtualNetwork -Name "appgwvnet" -ResourceGroupName $resGroupName `
+    $vnet = New-AzVirtualNetwork -Name "vnet-contoso" -ResourceGroupName $resGroupName `
       -Location $location -AddressPrefix "10.0.0.0/16" -Subnet $appGatewaySubnet,$apimSubnet
     ```