» azurerm_public_ip
Manage 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 areBasic
andStandard
. Defaults toBasic
.
Note Public IP Standard SKUs require allocation_method
to be set to Static
.
Note: The Standard
SKU is currently in Public Preview on an opt-in basis. More information, including how you can register for the Preview, and which regions Standard
SKU's are available in are available here
-
allocation_method
- (Required) Defines the allocation method for this IP address. Possible values areStatic
orDynamic
.
Note Dynamic
Public IP Addresses aren't allocated until they're assigned to a resource (such as a Virtual Machine or a Load Balancer) by design within Azure - more information is available below.
-
ip_version
- (Optional) The IP Version to use, IPv6 or IPv4.
Note Only dynamic
IP address allocation is supported for IPv6.
-
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.
Please Note: Public IP Prefix are currently in Public Preview. You can find more information about Public IP Preifx Preview here.
-
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.
Please Note: Availability Zones are only supported in several regions at this time.
» Attributes Reference
The following attributes are exported:
-
id
- The Public IP ID. -
ip_address
- The IP address value that was allocated.
Note Dynamic
Public IP Addresses aren't allocated until they're attached to a device (e.g. a Virtual Machine/Load Balancer). Instead you can obtain the IP Address once the the Public IP has been assigned via the azurerm_public_ip
Data Source.
-
fqdn
- Fully qualified domain name of the A DNS record associated with the public IP.domain_name_label
must be specified to get thefqdn
. This is the concatenation of thedomain_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