github.com/nathanielks/terraform@v0.6.1-0.20170509030759-13e1a62319dc/website/source/docs/providers/azurerm/r/public_ip.html.markdown (about)

     1  ---
     2  layout: "azurerm"
     3  page_title: "Azure Resource Manager: azurerm_public_ip"
     4  sidebar_current: "docs-azurerm-resource-network-public-ip"
     5  description: |-
     6    Create a Public IP Address.
     7  ---
     8  
     9  # azurerm\_public\_ip
    10  
    11  Create a Public IP Address.
    12  
    13  ## Example Usage
    14  
    15  ```hcl
    16  resource "azurerm_resource_group" "test" {
    17    name     = "resourceGroup1"
    18    location = "West US"
    19  }
    20  
    21  resource "azurerm_public_ip" "test" {
    22    name                         = "acceptanceTestPublicIp1"
    23    location                     = "West US"
    24    resource_group_name          = "${azurerm_resource_group.test.name}"
    25    public_ip_address_allocation = "static"
    26  
    27    tags {
    28      environment = "Production"
    29    }
    30  }
    31  ```
    32  
    33  ## Argument Reference
    34  
    35  The following arguments are supported:
    36  
    37  * `name` - (Required) Specifies the name of the Public IP resource . Changing this forces a
    38      new resource to be created.
    39  
    40  * `resource_group_name` - (Required) The name of the resource group in which to
    41      create the public ip.
    42  
    43  * `location` - (Required) Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created.
    44  
    45  * `public_ip_address_allocation` - (Required) Defines whether the IP address is stable or dynamic. Options are Static or Dynamic.
    46  
    47  * `idle_timeout_in_minutes` - (Optional) Specifies the timeout for the TCP idle connection. The value can be set between 4 and 30 minutes.
    48  
    49  * `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.
    50  
    51  * `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.
    52  
    53  * `tags` - (Optional) A mapping of tags to assign to the resource.
    54  
    55  ## Attributes Reference
    56  
    57  The following attributes are exported:
    58  
    59  * `id` - The Public IP ID.
    60  * `ip_address` - The IP address value that was allocated.
    61  * `fqdn` - Fully qualified domain name of the A DNS record associated with the public IP. This is the concatenation of the domainNameLabel and the regionalized DNS zone
    62  
    63  
    64  ## Import
    65  
    66  Public IPs can be imported using the `resource id`, e.g.
    67  
    68  ```
    69  terraform import azurerm_public_ip.myPublicIp /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mygroup1/providers/Microsoft.Network/publicIPAddresses/myPublicIpAddress1
    70  ```