- AnsibleFest
- Products
- Community
- Webinars & Training
- Blog

Documentation

# nios_fixed_address – Configure Infoblox NIOS DHCP Fixed Address

New in version 2.8.

- Synopsis

- Requirements

- Parameters

- Notes

- Examples

- Status

## Synopsis

- A fixed address is a specific IP address that a DHCP server always assigns when a lease request comes from a particular MAC address of the client.

- Supports both IPV4 and IPV6 internet protocols

## Requirements

The below requirements are needed on the host that executes this module.

- infoblox-client

## Parameters

Parameter | Choices/Defaults | Comments
--- | --- | ---
comment - |  | Configures a text string comment to be associated with the instance of this object. The provided text string will be configured on the object instance.
extattrs - |  | Allows for the configuration of Extensible Attributes on the instance of the object. This argument accepts a set of key / value pairs for configuration.
ipaddr - / required |  | IPV4/V6 address of the fixed address.
mac - / required |  | The MAC address of the interface.
name - |  | Specifies the hostname with which fixed DHCP ip-address is stored for respective mac.
network - / required |  | Specifies the network range in which ipaddr exists. aliases: network
network_view - | Default: "default" | Configures the name of the network view to associate with this configured instance.
options - |  | Configures the set of DHCP options to be included as part of the configured network instance. This argument accepts a list of values (see suboptions). When configuring suboptions at least one of `name` or `num` must be specified.
| name - |  | The name of the DHCP option to configure
| num - |  | The number of the DHCP option to configure
| use_option boolean | Choices: no yes ← | Only applies to a subset of options (see NIOS API documentation)
| value - / required |  | The value of the DHCP option specified by `name`
| vendor_class - | Default: "DHCP" | The name of the space this DHCP option is associated to
provider dictionary |  | A dict object containing connection details.
| host string / required |  | Specifies the DNS host name or address for connecting to the remote instance of NIOS WAPI over REST Value can also be specified using `INFOBLOX_HOST` environment variable.
| http_request_timeout integer | Default: 10 | The amount of time before to wait before receiving a response Value can also be specified using `INFOBLOX_HTTP_REQUEST_TIMEOUT` environment variable.
| max_results integer | Default: 1000 | Specifies the maximum number of objects to be returned, if set to a negative number the appliance will return an error when the number of returned objects would exceed the setting. Value can also be specified using `INFOBLOX_MAX_RESULTS` environment variable.
| max_retries integer | Default: 3 | Configures the number of attempted retries before the connection is declared usable Value can also be specified using `INFOBLOX_MAX_RETRIES` environment variable.
| password string |  | Specifies the password to use to authenticate the connection to the remote instance of NIOS. Value can also be specified using `INFOBLOX_PASSWORD` environment variable.
| username string |  | Configures the username to use to authenticate the connection to the remote instance of NIOS. Value can also be specified using `INFOBLOX_USERNAME` environment variable.
| validate_certs boolean | Choices: no ← yes | Boolean value to enable or disable verifying SSL certificates Value can also be specified using `INFOBLOX_SSL_VERIFY` environment variable. aliases: ssl_verify
| wapi_version string | Default: "2.1" | Specifies the version of WAPI to use Value can also be specified using `INFOBLOX_WAP_VERSION` environment variable. Until ansible 2.8 the default WAPI was 1.4
state - | Choices: present ← absent | Configures the intended state of the instance of the object on the NIOS server. When this value is set to `present`, the object is configured on the device and when this value is set to `absent` the value is removed (if necessary) from the device.

## Notes

Note

- This module must be run locally, which can be achieved by specifying `connection: local`.

- Please read the Infoblox Guide for more detailed information on how to use Infoblox with Ansible.

## Examples

    - name: configure ipv4 dhcp fixed address
      nios_fixed_address:
        name: ipv4_fixed
        ipaddr: 192.168.10.1
        mac: 08:6d:41:e8:fd:e8
        network: 192.168.10.0/24
        network_view: default
        comment: this is a test comment
        state: present
        provider:
          host: "{{ inventory_hostname_short }}"
          username: admin
          password: admin
      connection: local
    - name: configure a ipv6 dhcp fixed address
      nios_fixed_address:
        name: ipv6_fixed
        ipaddr: fe80::1/10
        mac: 08:6d:41:e8:fd:e8
        network: fe80::/64
        network_view: default
        comment: this is a test comment
        state: present
        provider:
          host: "{{ inventory_hostname_short }}"
          username: admin
          password: admin
      connection: local
    - name: set dhcp options for a ipv4 fixed address
      nios_fixed_address:
        name: ipv4_fixed
        ipaddr: 192.168.10.1
        mac: 08:6d:41:e8:fd:e8
        network: 192.168.10.0/24
        network_view: default
        comment: this is a test comment
        options:
          - name: domain-name
            value: ansible.com
        state: present
        provider:
          host: "{{ inventory_hostname_short }}"
          username: admin
          password: admin
      connection: local
    - name: remove a ipv4 dhcp fixed address
      nios_fixed_address:
        name: ipv4_fixed
        ipaddr: 192.168.10.1
        mac: 08:6d:41:e8:fd:e8
        network: 192.168.10.0/24
        network_view: default
        state: absent
        provider:
          host: "{{ inventory_hostname_short }}"
          username: admin
          password: admin
      connection: local

## Status

- This module is not guaranteed to have a backwards compatible interface. [preview]

- This module is maintained by an Ansible Partner. [certified]

### Authors

- Sumit Jaiswal (@sjaiswal)

Hint

If you notice any issues in this documentation, you can edit this document to improve it.