Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 9 Next »

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 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.

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.

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_ipv4_network resource:

Parameter

Required/
Optional

Description

reserve_ip


Optional

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


Note

  • Once a network object is created, the reserve_ip and gateway fields cannot be edited.
  • IP addresses that are reserved by setting the reserve_ip 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

// statically allocated IPv4 network. Example with minimal set of parameters
resource "infoblox_ipv4_network" "net1" {
    cidr = 10.0.0.0/16
}

//full set of parameters for a statically allocated IPv4 network
resource "infoblox_ipv4_network" "net2" {
    cidr = 10.1.0.0/24
    network_view = "nondefault_netview"
    reserve_ip = 5
    gateway = "10.1.0.254"
    comment = "small network for testing"
    ext_attrs = jsonencode({
      "Site" = "Nevada"
    })
}


//full set of parameters for a dynamically allocated IPv4 network
resource "infoblox_ipv4_network" "net3" {
    parent_cidr = infoblox_ipv4_network_container.v4net_c1.cidr // reference to the resource from another example
    allocate_prefix_len = 26 # 24 (existing network container) + 2 (new network), prefix
    network_view = "default" # optional parameter
    reserve_ip = 2
    gateway = "none" # no gateway defined for this network
    comment = "even smaller network for testing"
    ext_attrs = jsonencode({
      "Site" = "Nevada"
    })
}


  • No labels