more work

Author: TomArcherMsft

articles/virtual-network/ip-services/create-public-ip-terraform.md

@@ -33,6 +33,11 @@ In this article, you learn how to:
 > * Create a standard static public IPv4 address named **myRoutingPreferenceStandardPublicIP** that supports the Routing Preference feature
 > * Create a standard static public IPv4 address named **myGlobalTierStandardPublicIP** that supports the Global Tier feature
 
+> [!NOTE]
+> The sample code for this article is located in the [Azure Terraform GitHub repo](https://github.com/Azure/terraform/tree/master/quickstart/101-virtual-network-public-ip). You can view the log file containing the [test results from current and previous versions of Terraform](https://github.com/Azure/terraform/tree/master/quickstart/101-virtual-network-public-ip/TestRecord.md).
+> 
+> See more [articles and sample code showing how to use Terraform to manage Azure resources](/azure/terraform)
+
 ## Create a resource group
 
 An Azure resource group is a logical container into which Azure resources are deployed and managed.
@@ -46,20 +51,10 @@ An Azure resource group is a logical container into which Azure resources are de
 >[!NOTE]
 >Standard SKU public IP is recommended for production workloads. For more information about SKUs, see **[Public IP addresses](public-ip-addresses.md)**.
 >
->The following command works for API version **2020-08-01** or **later**. For more information about the API version currently being used, see [Resource Providers and Types](../../azure-resource-manager/management/resource-providers-and-types.md).
-
-Use [az network public-ip create](/cli/azure/network/public-ip#az-network-public-ip-create) to create a standard zone-redundant public IPv4 address named **myStandardPublicIP** in **QuickStartCreateIP-rg**. 
+>The following command snippet works for API version **2020-08-01** or **later**. For more information about the API version currently being used, see [Resource Providers and Types](../../azure-resource-manager/management/resource-providers-and-types.md).
 
-To create an IPv6 address, modify the `--version` parameter to **IPv6**.
+:::code language="terraform" source="~/terraform_samples/quickstart/101-virtual-network-public-ip/main.tf" range="10-18":::
 
-```azurecli-interactive
-  az network public-ip create \
-    --resource-group QuickStartCreateIP-rg \
-    --name myStandardPublicIP \
-    --version IPv4 \
-    --sku Standard \
-    --zone 1 2 3
-```
 > [!IMPORTANT]
 > For versions of the API older than 2020-08-01, execute the command without specifying a `--zone` parameter to create a zone-redundant IP address. 
 >
@@ -68,19 +63,11 @@ To create an IPv6 address, modify the `--version` parameter to **IPv6**.
 
 In this section, you create a basic IP. Basic public IPs don't support availability zones.
 
-Use [az network public-ip create](/cli/azure/network/public-ip#az-network-public-ip-create) to create a basic static public IPv4 address named **myBasicPublicIP** in **QuickStartCreateIP-rg**.
+The followingcode snippet creates an IPv6 address, modify the `--version` parameter to **IPv6**. 
 
-To create an IPv6 address, modify the `--version` parameter to **IPv6**. 
+:::code language="terraform" source="~/terraform_samples/quickstart/101-virtual-network-public-ip/main.tf" range="20-27":::
 
-```azurecli-interactive
-  az network public-ip create \
-    --resource-group QuickStartCreateIP-rg \
-    --name myBasicPublicIP \
-    --version IPv4 \
-    --sku Basic \
-    --allocation-method Static
-```
-If it's acceptable for the IP address to change over time, **Dynamic** IP assignment can be selected by changing the **`--allocation-method`** to **Dynamic**. 
+If it's acceptable for the IP address to change over time, **Dynamic** IP assignment can be selected by changing the `allocation_method` value to **Dynamic**. 
 
 >[!NOTE]
 > A basic IPv6 address must always be `Dynamic`.
@@ -93,18 +80,11 @@ In this section, you learn how to create a zonal or no-zone public IP address.
 
 # [**Zonal**](#tab/create-public-ip-zonal)
 
-To create a standard zonal public IPv4 address in Zone 2 named **myStandardPublicIP** in **QuickStartCreateIP-rg**, use the following command.
+The following code snippet creates a standard zonal public IPv4 address in Zone 2 named **myZonalStandardPublicIP**.
 
-To create an IPv6 address, modify the `--version` parameter to **IPv6**.
+To create an IPv6 address, set the `version` value to **IPv6**.
 
-```azurecli-interactive
-  az network public-ip create \
-    --resource-group QuickStartCreateIP-rg \
-    --name myStandardPublicIP-zonal \
-    --version IPv4 \
-    --sku Standard \
-    --zone 2
-```
+:::code language="terraform" source="~/terraform_samples/quickstart/101-virtual-network-public-ip/main.tf" range="29-37":::
 
 >[!NOTE]
 >The above options for zones are only valid selections in regions with [Availability Zones](../../reliability/availability-zones-overview.md?toc=%2fazure%2fvirtual-network%2ftoc.json).
@@ -116,20 +96,15 @@ In this section, you create a non-zonal IP address.
 >[!NOTE]
 >The following command works for API version 2020-08-01 or later. For more information about the API version currently being used, see [Resource Providers and Types](../../azure-resource-manager/management/resource-providers-and-types.md).
 
-Use [az network public-ip create](/cli/azure/network/public-ip#az-network-public-ip-create) to create a standard public IPv4 address as a non-zonal resource named **myStandardPublicIP-nozone** in **QuickStartCreateIP-rg**. 
+The following code snippet creates a standard public IPv4 address as a non-zonal resource named **myNonZonalStandardPublicIP**. 
 
-To create an IPv6 address, modify the `--version` parameter to **IPv6**.
+To create an IPv6 address, set the `version` value to **IPv6**.
 
-```azurecli-interactive
-  az network public-ip create \
-    --resource-group QuickStartCreateIP-rg \
-    --name myStandardPublicIP-nozone \
-    --version IPv4 \
-    --sku Standard
-```
-The removal of the `--zone` parameter in the command is valid in all regions. 
+:::code language="terraform" source="~/terraform_samples/quickstart/101-virtual-network-public-ip/main.tf" range="39-46":::
 
-The removal of the `--zone` parameter is the default selection for standard public IP addresses in regions without [Availability Zones](../../reliability/availability-zones-overview.md?toc=%2fazure%2fvirtual-network%2ftoc.json).
+The removal of the `zone` field is valid in all regions. 
+
+The removal of the `zone` field is the default selection for standard public IP addresses in regions without [Availability Zones](../../reliability/availability-zones-overview.md?toc=%2fazure%2fvirtual-network%2ftoc.json).
 
 ---
 
@@ -145,55 +120,34 @@ The selection of **Internet** minimizes travel on Microsoft's network, instead u
 
 For more information on routing preference, see [What is routing preference (preview)?](routing-preference-overview.md).
 
-The command creates a new standard zone-redundant public IPv4 address with a routing preference of type **Internet**:
+The following code snippet creates a new standard zone-redundant public IPv4 address with a routing preference of type **Internet**:
 
-```azurecli-interactive
-  az network public-ip create \
-    --resource-group QuickStartCreateIP-rg \
-    --name myStandardPublicIP-RP \
-    --version IPv4 \
-    --ip-tags 'RoutingPreference=Internet' \
-    --sku Standard \
-    --zone 1 2 3
-```
+:::code language="terraform" source="~/terraform_samples/quickstart/101-virtual-network-public-ip/main.tf" range="48-61":::
 
 # [**Tier**](#tab/tier)
 
 Public IP addresses are associated with a single region. The **Global** tier spans an IP address across multiple regions. **Global** tier is required for the frontends of cross-region load balancers. 
 
 For more information, see [Cross-region load balancer](../../load-balancer/cross-region-overview.md).
 
-The following command creates a global IPv4 address. This address can be associated with the frontend of a cross-region load balancer.
+The following code snippet creates a global IPv4 address. This address can be associated with the frontend of a cross-region load balancer.
+
+:::code language="terraform" source="~/terraform_samples/quickstart/101-virtual-network-public-ip/main.tf" range="63-71":::
 
-```azurecli-interactive
-  az network public-ip create \
-    --resource-group QuickStartCreateIP-rg \
-    --name myStandardPublicIP-Global \
-    --version IPv4 \
-    --tier global \
-    --sku Standard
-```
 >[!NOTE]
 >Global tier addresses don't support Availability Zones.
 
 ---
 
 ## Clean up resources
 
-If you're not going to continue to use this application, delete the public IP address with the following steps:
-
-1. In the search box at the top of the portal, enter **Resource group**.
-
-2. In the search results, select **Resource groups**.
-
-3. Select **QuickStartCreateIP-rg**.
+[!INCLUDE [terraform-plan-destroy.md](~/azure-dev-docs-pr/articles/terraform/includes/terraform-plan-destroy.md)]
 
-4. Select **Delete resource group**.
+## Troubleshoot Terraform on Azure
 
-5. Enter **QuickStartCreateIP-rg** for **TYPE THE RESOURCE GROUP NAME** and select **Delete**.
+[Troubleshoot common problems when using Terraform on Azure](/azure/developer/terraform/troubleshoot)
 
 ## Next steps
 
-Advance to the next article to learn how to create a public IP prefix:
 > [!div class="nextstepaction"]
 > [Create public IP prefix using the Azure CLI](create-public-ip-prefix-cli.md)