The infoblox_ip_allocation resource allows allocation of a new IP address from a network that already exists as a NIOS object. The IP address can be allocated statically by specifying an address or dynamically as the next available IP address from the specified IPv4 and/or IPv6 network blocks.
The allocation is done by creating a host record in NIOS with an IPv4 address, an IPv6 address, or both assigned to the record. The allocated IP address is marked as ‘used’ in the appropriate network block.
Note
As a prerequisite for creation of host records using the infoblox_ip_allocation and infoblox_ip_association resources, you must create the extensible attribute Terraform Internal ID of string type in Infoblox NIOS Grid Manager. For steps, refer to the Infoblox NIOS Documentation.
The following table describes the parameters you can define in the infoblox_ip_allocation resource block:
Parameter | Required/ | Description | Example Value |
|---|---|---|---|
| Required | Specifies the name (in FQDN format) of a host with which an IP address needs to be allocated. | |
| Optional | Specifies the network view from which to get the specified network block. |
|
| Optional | Specifies the DNS view in which to create the DNS resource records that are associated with the IP address.
For more information, see the description of the |
|
| Optional | A flag that specifies whether DNS records associated with the resource must be created. When you update the enable_dns parameter, consider the following points:
|
|
| Required only for dynamic allocation | Specifies the IPv4 network block (in CIDR format) from where to allocate an IP address. |
|
| Required only for dynamic allocation | Specifies the IPv6 network block (in CIDR format) from where to allocate an IP address. |
|
| Required only for static allocation | Specifies an IPv4 address to allocate. |
|
| Required only for static allocation | Specifies an IPv6 address to allocate. |
|
| Optional | Specifies the time to live value for the DNS record. |
|
| Optional | Specifies the human readable description of the resource. |
|
| Optional | Specifies the set of NIOS extensible attributes that are attached to the NIOS resource. An extensible attribute must be a JSON map translated into a string value. |
|
When you use the infoblox_ip_allocation resource block to allocate or deallocate a static IP address from a host record, you must configure appropriate dependencies so that workflows run in the correct order. In the following example, dependencies have been configured for network view and the extensible attribute, Network Name:
resource "infoblox_ip_allocation" "ip_allocation" {
network_view = infoblox_ipv6_network.ipv6_network.network_view ipv4_addr = "10.0.0.32" ipv6_addr = "2001:1890:1959:2710::32"
#Create Host Record with DNS flags dns_view="default" fqdn="testipv4v6" enable_dns = "false"
ext_attrs = jsonencode({ "Tenant ID" = "tf-plugin" "Network Name" = lookup(jsondecode(infoblox_ipv4_network.ipv4_network.ext_attrs), "Network Name") "VM Name" = "tf-vmware-ipv4-ipv61" "Location" = "Test loc." "Site" = "Test site" })}
When you perform a create or an update operation using this allocation resource, the following read-only parameters are computed:
Parameter | Description |
|---|---|
| If you allocated a dynamic IP address, this value is the IP address allocated from the specified IPv4 CIDR.
You can add a reference for the IP address as follows:
|
| If you allocated a dynamic IP address, this value is the IP address allocated from the specified IPv6 CIDR. You can reference this field for the IP address when using other resources. See the previous description for an example. |
Example of the Resource Block
You can use static and dynamic allocation methods independently to assign IPv4 and IPv6 addresses within the same resource.
// minimal set of parameters for IP address allocationresource "infoblox_ip_allocation" "allocation1" { dns_view = "default" // this time the parameter is not optional, because... # enable_dns = true // ... this is 'true', by default fqdn = "example1.org " // this resource type is implemented as a host record at the NIOS side ipv4_addr = "1.2.3.4"}
// Wide set of parametersresource "infoblox_ip_allocation" "allocation2" { dns_view = "nondefault_dnsview1" fqdn = "example2.org " ipv6_addr = "2002:1f93::1234" ttl = 120 comment = "another host record, statically allocated" ext_attrs = jsonencode({ "Tenant ID" = "tenant_3261798" })}
// allocation of IPv4 and IPv6 address simultaneouslyresource "infoblox_ip_allocation" "allocation3" { dns_view = "nondefault_dnsview2" network_view = "nondefault_netview" // you must specify the network view // which the DNS view belongs to fqdn = "host3.example4.org" ipv6_addr = "2002:1f93::12:40" ipv4_addr = "1.2.3.40" ttl = 0 comment = "still statically allocated, but IPv4 and IPv6 together" ext_attrs = jsonencode({ "Tenant ID" = "tenant_3261798" })}
resource "infoblox_ip_allocation" "allocation4" { enable_dns = false # dns_view = "nondefault_dnsview2" // remove or comment out dns_view // when enable_dns = false network_view = "nondefault_netview" // you must mention the network view which the //DNS view belongs to fqdn = "host4" // just one name component because there is no host-to-DNS-zone assignment // either of the IP addresses must belong to an existing network // (not a network container) in the specified network view // because of enable_dns = false ipv6_addr = "2002:1f93::12:40" ipv4_addr = "10.1.0.60" // ensure that the appropriate network exists before creating this resource depends_on = [infoblox_ipv4_network.net1]}
// dynamic allocationresource "infoblox_ip_allocation" "allocation5" { dns_view = "nondefault_dnsview2" network_view = "nondefault_netview" fqdn = "host5.example4.org" ipv6_cidr = infoblox_ipv6_network.net2.cidr ipv4_cidr = infoblox_ipv4_network.net2.cidr}