/
infoblox_ipv6_network Resource
Document toolboxDocument toolbox

infoblox_ipv6_network Resource

Owned by Jyothi KP
Last updated: Oct 30, 2024

This resource enables you to perform create, update, and delete operations on IP networks. Network resources support the next available network feature when you use the allocate_prefix_len parameter listed in the below table.

The following table describes the parameters you can define in a network resource block:

Parameter

Required/
Optional

Description

network_viewOptional

Specifies the network view in which to create the network.
If a value is not specified, default will be used as the network view name.

cidrRequired only if parent_cidr is not set

Specifies the network block to use for the network, in CIDR notation.
Do not use the IPv4 CIDR for an IPv6 network and IPv6 CIDR for an IPv4 network.
If you configure both cidr and parent_cidr, the value of parent_cidr will be ignored.

parent_cidrRequired only if cidr is not set

Specifies the network container from which the network must be dynamically allocated.
The network container must exist in the NIOS database, but not necessarily as a Terraform resource.

allocate_prefix_lenRequired only if parent_cidr or filter_params is set

Defines the length of the network part of the address for a network that should be allocated from a network container, which in turn is determined by parent_cidr or filter_params.

gatewayOptional

Defines the IP address of the gateway within the network block.

  • If a value is not set, the first IP address of the allocated network will be assigned.
  • If the value is set to none, no value will be assigned.

For more information, see Limitations.

objectOptional

Specifies the type of object from which to allocate the network.
The values can be network or networkcontainer. The default value is networkcontainer.
Note:

  • The object parameter is applicable only if filter_params is configured.
  • If the object parameter is set to network, after the creation of the network object, the parent network object will be converted to a network container object.
filter_paramsOptional

Specifies the extensible attributes of the parent network or network container that must be used as filters to retrieve the next available network for creating the network object.

commentOptionalDescribes the network.
ext_attrsOptionalSpecifies the set of NIOS extensible attributes that will be attached to the network.

Additionally, define the following parameter for the infoblox_ipv6_network resource:

Parameter

Required/Optional

Description

reserve_ipv6OptionalSpecifies the number of IPv6 addresses that you want to reserve in the IPv6 network. The default value is 0.


Note

  • Either cidr, the combination of parent_cidr and allocate_prefix_len, or the combination of filter_params and allocate_prefix_len is required. The rest of the parameters are optional.
  • When creating an IPv6 network using the reserve_ipv6 flag, the DUIDs assigned to the reserved IPv6 addresses that you choose, may not be in standard format.
  • Tenant ID does not display in the IPv6 network container in NIOS.
  • Once the network object is created, the reserve_ipv6, gateway, and filter_params parameter values cannot be changed by performing an update operation.

  • IPv6 addresses that are reserved by setting the reserve_ipv6 field are used for network maintenance by the cloud providers. Therefore, Infoblox does not recommend using these IP addresses for other purposes.

Examples of the Network Block

// minimal set of parameters for statically allocated IPv6 network
resource "infoblox_ipv6_network" "net1" {
    cidr = 2002:1f93:0:3::/96
}


// full set of parameters for statically allocated IPv6 network
resource "infoblox_ipv6_network" "net2" {
    cidr = 2002:1f93:0:4::/96
    network_view = "nondefault_netview"
    reserve_ipv6 = 10
    gateway = "2002:1f93:0:4::1"
    comment = "let's try IPv6"
    ext_attrs = jsonencode({
      "Site" = "somewhere in Antarctica"
    })
}


// full set of parameters for dynamically allocated IPv6 network
resource "infoblox_ipv6_network" "net3" {
    parent_cidr = infoblox_ipv6_network_container.v6net_c1.cidr // reference to the resource from another example
    allocate_prefix_len = 100 // 96 (existing network container) + 4 (new network), prefix
    network_view = "default" // optional parameter
    reserve_ipv6 = 20
    gateway = "none" // no gateway defined for this network
    comment = "the network for the Test Lab"
    ext_attrs = jsonencode({
      "Site" = "small inner cluster"
    })
}


//full set of parameters for dynamically allocated IPv6 network using next-available network based on extensible attributes tag
resource "infoblox_ipv6_network" "ipv6network1" {
  allocate_prefix_len = 67
  network_view = "nondefault_netview"
  comment = "IPV6 NW within a NW container"
  filter_params = jsonencode({


    "*Site": "Blr"
  })
  ext_attrs = jsonencode({
    "Site" = "UK"
  }) 
  object = "networkcontainer"


  })
}


Related content