Edit

Quickstart: Create a public IP address using a Resource Manager template

  • Article

This article shows how to create a public IP address resource within a Resource Manager template.

Diagram of an example use of a public IP address. A public IP address is assigned to a load balancer.

For more information on resources this public IP can be associated to and the difference between the basic and standard SKUs, see Public IP addresses.

Prerequisites

  • If you don't have an Azure subscription, create a free account before you begin.
  • A resource group in your Azure subscription.
  • An Azure Resource Manager template for the public IP sections.

Create standard SKU public IP with zones

In this section, you create a public IP with zones. Public IP addresses can be zone-redundant or zonal.

Zone redundant

The code in this section creates a standard zone-redundant public IPv4 address named myStandardPublicIP.

To create an IPv6 address, modify the publicIPAddressVersion parameter to IPv6.

Template section to add:

{
  "apiVersion": "2020-08-01",
  "type": "Microsoft.Network/publicIPAddresses",
  "name": "myStandardPublicIP",
  "location": "[resourceGroup().location]",
  "sku": {
    "name": "Standard"
  },
  "zones": [
    "1",
    "2",
    "3"
  ],
  "properties": {
    "publicIPAllocationMethod": "Static",
    "publicIPAddressVersion": "IPv4"
  }

Important

For API versions older than 2020-08-01, use the code above without specifying a zone parameter for a Standard SKU to create a zone-redundant IP address.

Note

The above options for zones are only valid selections in regions with Availability Zones.

Zonal

The code in this section creates a standard zonal public IPv4 address named myStandardPublicIP-zonal.

To create a standard zonal public IP address in Zone 2, the "zones" property contains a '2'.

Template section to add:

{
  "apiVersion": "2020-08-01",
  "type": "Microsoft.Network/publicIPAddresses",
  "name": "myStandardPublicIP-zonal",
  "location": "[resourceGroup().location]",
  "sku": {
    "name": "Standard"
  },
  "zones": [
    "2"
  ],
  "properties": {
    "publicIPAllocationMethod": "Static",
    "publicIPAddressVersion": "IPv4"
  }

Note

The above options for zones are only valid selections in regions with Availability Zones.

Create standard public IP without zones

In this section, you create a non-zonal IP address.

The code in this section creates a standard no-zone public IPv4 address named myStandardPublicIP. The code section is valid for all regions with or without Availability Zones.

To create an IPv6 address, modify the publicIPAddressVersion parameter to IPv6.

Template section to add:

{
  "apiVersion": "2020-08-01",
  "type": "Microsoft.Network/publicIPAddresses",
  "name": "myStandardPublicIP-nozone",
  "location": "[resourceGroup().location]",
  "sku": {
    "name": "Standard"
  },
  "properties": {
    "publicIPAllocationMethod": "Static",
    "publicIPAddressVersion": "IPv4"
  }

Important

For API versions older than 2020-08-01, not specifying a zone parameter for a Standard SKU will create a zone-redundant IP address.

Create a basic public IP

In this section, you create a basic IP. Basic public IPs don't support availability zones.

The code in this section creates a basic public IPv4 address named myBasicPublicIP.

To create an IPv6 address, modify the publicIPAddressVersion parameter to IPv6.

Template section to add:

{
  "apiVersion": "2020-08-01",
  "type": "Microsoft.Network/publicIPAddresses",
  "name": "myBasicPublicIP",
  "location": "[resourceGroup().location]",
  "sku": {
    "name": "Basic"
  },
  "properties": {
    "publicIPAllocationMethod": "Static",
    "publicIPAddressVersion": "IPv4"
  }

If it's acceptable for the IP address to change over time, publicIPAllocationMethod IP assignment can be selected by changing the AllocationMethod to Dynamic.

Note

A basic IPv6 address must always be 'Dynamic'.

Routing preference and tier

Standard SKU static public IPv4 addresses support Routing Preference or the Global Tier feature.

Routing preference

By default, the routing preference for public IP addresses is set to Microsoft network, which delivers traffic over Microsoft's global wide area network to the user.

The selection of Internet minimizes travel on Microsoft's network, instead using the transit ISP network to deliver traffic at a cost-optimized rate.

For more information on routing preference, see What is routing preference (preview)?.

To use Internet Routing preference for a standard zone-redundant public IPv4 address, the template section should look similar to:

{
  "apiVersion": "2020-08-01",
  "type": "Microsoft.Network/publicIPAddresses",
  "name": "myStandardZRPublicIP-RP",
  "location": "[resourceGroup().location]",
  "sku": {
    "name": "Standard"
  },
  "zones": [
    "1",
    "2",
    "3"
  ],
  "properties": {
    "publicIPAllocationMethod": "Static",
    "publicIPAddressVersion": "IPv4",
    "ipTags": [
      {
        "ipTagType": "RoutingPreference",
        "tag": "Internet"
      }
    ]
  }
}

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.

To use a standard global public IPv4 address, the template section should look similar to:

{
  "apiVersion": "2020-08-01",
  "type": "Microsoft.Network/publicIPAddresses",
  "name": "myStandardPublicIP-Global",
  "location": "[resourceGroup().location]",
  "sku": {
    "name": "Standard",
    "tier": "Global"
  },
  "properties": {
    "publicIPAllocationMethod": "Static",
    "publicIPAddressVersion": "IPv4"
  }

Additional information

For more information on the public IP properties listed in this article, see Manage public IP addresses.

Next steps