Content Comparison

name

Required

Specifies the fully qualified host name to add or remove from NIOS.
To update the name of a host record object, define a dictionary object that contains the following parameters:

• old_name: Specifies the existing host name that must be changed.

• new_name: Specifies the new host name.

view

Optional

Specifies the DNS view to associate the host record with.
If a value is not specified, the default DNS view configured in NIOS is used.

configure_for_dns

Optional

Sets the DNS to a particular parent. The default value is true. If you need to bypass the DNS, set the value to false.

use_dns_ea_inheritance

Optional

Specifies whether the extensible attribute must be inherited from the associated zone. The default value is false. To inherit the extensible attribute, set this value to true.
Note: The use_dns_ea_inheritance parameter is compatible only with WAPI versions 2.12.3, 2.13.4, and later.

ipv4addrs

*Optional

Specifies the IPv4 address for the host record.

You can configure the following subparameters:

• use_for_ea_inheritance: Specifies whether the extensible attribute must be inherited from the host address. The default value is false.
  Note that when creating a host record, due to an known issue, this value is set to true by default. If you do not want the extensible attribute inherited, update this parameter to false in an update operation.

• ipv4addr (required): Specifies the IPv4 address for this host record.
  You can dynamically allocate an IPv4 address to the host record by passing a dictionary that contains nios_next_ip and CIDR network range.
  If you want to add or remove the IPv4 address from an existing record, use the parameters.

• configure_for_dhcp: Sets it to true to configure the host record over DHCP rather than DNS and then define the MAC address.

• mac: Specifies the hardware MAC address for the host record. You must specify this value if configure_for_dhcp is set to true.

• add: Specifies whether the IPv4 address must be added to an existing host record. Set it to true to add the IPv4 address.
  When adding an IPv4 address to the host record, you must set the value of the state parameter to present because the new IP address is allocated to the existing host record.

• use_nextserver: Specifies whether to use the nextserver option. Set it to true to enable the suer of nextserver.
  Note that to configure use_nextserver and nextserver options, the configure_for_dhcp option must be set to true.

• nextserver: Specifies the IPv4 address and/or the name in FQDN format of the next server that the host must boot from.

• remove: Specifies whether the IPv4 address must be removed from an existing host record. Set it to true to remove the IPv4 address.
  Set the state parameter to absent because the IP address is de-allocated from the host record.

ipv6addrs

*Optional

Specifies the IPv6 address for the host record. You can configure the following subparameters:

• ipv6addr (required): Specifies the IPv6 address for the host record.
  If you want to add or remove the IPv6 address from an existing record, use parameters.

• configure_for_dhcp: Determines whether the host record is configured over DHCP. Set it to true to configure the record over DHCP rather than DNS and then define the DUID.

• duid: Specifies the hardware DUID for the host record. You must specify this value if configure_for_dhcp is set to true.

aliases

Optional

Specifies an optional list of additional aliases to add to the host record.
These are equivalent to CNAMEs but held within a host record. The value must be formatted as a list.

ttl

Optional

Specifies the Time To Live (TTL) value for the record.
The duration that the record is valid for, in seconds (cached).

extattrs

Optional

Specifies extensible attributes for the host record object.

state

Optional

Specifies the state of the host record instance on the NIOS server.
Set one of the following values:

• present (default): Configures the record.

• absent: Removes the record.

comment

Optional

Describes the host record object.

provider

Required

Defines the details of the connection:

• host: The DNS host name or IP address to connect to the remote instance of NIOS.

• username: The user name to use for authenticating the connection to the remote instance.

• password: The password to use for authenticating the connection to the remote instance.

For information on additional fields you can define, see the list of subparameters in the NIOS Modules for Ansible Collections topic.

connection

Required

The nios_host_record module must be run locally.