» azurerm_public_ip

Manages a Public IP Address.

» Example Usage

resource "azurerm_resource_group" "test" {
  name     = "resourceGroup1"
  location = "West US"

resource "azurerm_public_ip" "test" {
  name                = "acceptanceTestPublicIp1"
  location            = "West US"
  resource_group_name = "${azurerm_resource_group.test.name}"
  allocation_method   = "Static"

  tags = {
    environment = "Production"

» Argument Reference

The following arguments are supported:

  • name - (Required) Specifies the name of the Public IP resource . Changing this forces a new resource to be created.

  • resource_group_name - (Required) The name of the resource group in which to create the public ip.

  • location - (Required) Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created.

  • sku - (Optional) The SKU of the Public IP. Accepted values are Basic and Standard. Defaults to Basic.

  • allocation_method - (Required) Defines the allocation method for this IP address. Possible values are Static or Dynamic.
  • ip_version - (Optional) The IP Version to use, IPv6 or IPv4.
  • idle_timeout_in_minutes - (Optional) Specifies the timeout for the TCP idle connection. The value can be set between 4 and 30 minutes.

  • domain_name_label - (Optional) Label for the Domain Name. Will be used to make up the FQDN. If a domain name label is specified, an A DNS record is created for the public IP in the Microsoft Azure DNS system.

  • reverse_fqdn - (Optional) A fully qualified domain name that resolves to this public IP address. If the reverseFqdn is specified, then a PTR DNS record is created pointing from the IP address in the in-addr.arpa domain to the reverse FQDN.

  • public_ip_prefix_id - (Optional) If specified then public IP address allocated will be provided from the public IP prefix resource.

  • tags - (Optional) A mapping of tags to assign to the resource.

  • zones - (Optional) A collection containing the availability zone to allocate the Public IP in.

» Attributes Reference

The following attributes are exported:

  • id - The Public IP ID.
  • ip_address - The IP address value that was allocated.
  • fqdn - Fully qualified domain name of the A DNS record associated with the public IP. domain_name_label must be specified to get the fqdn. This is the concatenation of the domain_name_label and the regionalized DNS zone

» Import

Public IPs can be imported using the resource id, e.g.

terraform import azurerm_public_ip.myPublicIp /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mygroup1/providers/Microsoft.Network/publicIPAddresses/myPublicIpAddress1