infoblox.nios_modules.nios_nsgroup_forwardingmember module – Configure Infoblox DNS Nameserver Forwarding Member Groups
Note
This module is part of the infoblox.nios_modules collection (version 1.7.0).
You might already have this collection installed if you are using the ansible
package.
It is not included in ansible-core
.
To check whether it is installed, run ansible-galaxy collection list
.
To install it, use: ansible-galaxy collection install infoblox.nios_modules
.
You need further requirements to be able to use this module,
see Requirements for details.
To use it in a playbook, specify: infoblox.nios_modules.nios_nsgroup_forwardingmember
.
New in infoblox.nios_modules 1.7.0
Synopsis
Adds and/or removes nameserver groups of type “Forwarding Member” from Infoblox NIOS servers. This module manages NIOS
nsgroup:forwardstubserver
objects using the Infoblox. WAPI interface over REST.
Requirements
The below requirements are needed on the host that executes this module.
infoblox_client
Parameters
Parameter |
Comments |
---|---|
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. |
|
Allows for the configuration of Extensible Attributes on the instance of the object. This argument accepts a set of key / value pairs for configuration. |
|
Specifies the list of forwarding member servers to be used |
|
The information for the remote name server to which you want the Infoblox appliance to forward queries for a specified domain name. Default: |
|
Provide the IP address of the server |
|
Provide the name of the server |
|
Determines if the appliance sends queries to forwarders only, and not to other internal or Internet root servers. Choices:
|
|
The name of the forwarding grid member in FQDN format |
|
When using c(forward_to) option, and this is set to Choices:
|
|
Specifies the name of the NIOS nameserver group to be managed. |
|
A dict object containing connection details. |
|
Specifies the client certificate file with digest of x509 config for extra layer secure connection the remote instance of NIOS. Value can also be specified using |
|
Specifies the DNS host name or address for connecting to the remote instance of NIOS WAPI over REST Value can also be specified using |
|
Insert decription here Default: |
|
Insert description here Default: |
|
The amount of time before to wait before receiving a response Value can also be specified using Default: |
|
Specifies private key file for encryption with the certificate in order to connect with remote instance of NIOS. Value can also be specified using |
|
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 Default: |
|
Configures the number of attempted retries before the connection is declared usable Value can also be specified using Default: |
|
Specifies the password to use to authenticate the connection to the remote instance of NIOS. Value can also be specified using |
|
Insert description here Choices:
|
|
Configures the username to use to authenticate the connection to the remote instance of NIOS. Value can also be specified using |
|
Boolean value to enable or disable verifying SSL certificates Value can also be specified using Choices:
|
|
Specifies the version of WAPI to use Value can also be specified using Until ansible 2.8 the default WAPI was 1.4 Default: |
|
Configures the intended state of the instance of the object on the NIOS server. When this value is set to Choices:
|
Notes
Note
This module must be run locally, which can be achieved by specifying
connection: local
.Please read the :ref:`nios_guide` for more detailed information on how to use Infoblox with Ansible.
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: "{{ inventory_hostname_short }}"
username: admin
password: admin
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: "{{ inventory_hostname_short }}"
username: admin
password: admin
connection: local