/
Forwarding Member Name Server Group
Document toolboxDocument toolbox

Forwarding Member Name Server Group

Owned by Jyothi KP
Oct 04, 2024
2 min read

Use the nios_nsgroup_forwardingmember module to create, update, or remove a name server group object of type ‘Forwarding Member’ from NIOS. A forwarding member name server group is a collection of one or more forwarding name servers. For more information about forwarding member name server groups, see the Using Name Server Groups topic in the Infoblox NIOS Documentation.

The following table describes the parameters you can define in the nios_nsgroup_forwardingmember module:

Parameter

Required/Optional

Description

Parameter

Required/Optional

Description

name

Required

Specifies the name of the NIOS name server group consisting of forwarding name servers that needs to be managed.

forwarding_servers

Required

Specifies the list of forwarding member servers to be used.
Configure the following subparameters for each name server in the list:

  • name (required): Specifies the name of the name server in FQDN format.

  • forwarders_only: Determines whether the appliance sends queries only to forwarding server, and not to other internal or external root servers.
    To send queries only to forwarders, set it true. The default value is false.

  • use_override_forwarders: Determines whether only custom forwarders must be used in the group. To use custom forwarders set use_override_forwarders to true and configure the forward_to parameter.
    The default value is false.

  • forward_to: Specifies the details of the remote name server to which you want the Infoblox appliance to forward queries for a specified domain name.

    • name (required): Specifies the name of the remote name server.

    • address (required): Specifies the IP address of the remote name server.

extattrs

Optional

Specifies extensible attributes for the DNS name server group object.

state

Optional

Specifies the state of the DNS name server group instance on the NIOS server.
Set one of the following values:

  • present (default): Creates or updates the group.

  • absent: Removes the group.

comment

Optional

Describes the DNS name server group 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_nsgroup_forwardingmember module must be run locally.

Examples

name: create infoblox nameserver forwarding member group
infoblox.nios_modules.nios_nsgroup_forwardingmember:
name: my-forwardingmember-group
comment: "this is a forwarding member nameserver group"
forwarding_servers:
- name: member.localdomain
state: present
provider:
host: <nios_hostname_or_hostip>
    username: <nios_username>
    password: <nios_password>
connection: local

name: create infoblox nameserver forwarding member group with external forwarders
infoblox.nios_modules.nios_nsgroup_forwardingmember:
name: my-forwardingmember-group
comment: "this is a forwarding member nameserver group with external forwarders"
forwarding_servers:
- name: member.localdomain
use_override_forwarders: true
forward_to:
- name: ns1
address: 192.168.10.1
state: present
provider:
host: <nios_hostname_or_hostip>
  username: <nios_username>
  password: <nios_password>
connection: local

Related content