infoblox.nios_modules.nios_txt_record module – Configure Infoblox NIOS txt records
Note
This module is part of the infoblox.nios_modules collection (version 1.6.1).
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_txt_record
.
New in infoblox.nios_modules 1.0.0
Synopsis
Adds and/or removes instances of txt record objects from Infoblox NIOS servers. This module manages NIOS
record:txt
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 fully qualified hostname to add or remove from the system. Users can also update the name as it is possible to pass a dict containing new_name, old_name. See examples. |
|
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:
|
|
Text associated with the record. It can contain up to 255 bytes per substring, up to a total of 512 bytes. To enter leading, trailing, or embedded spaces in the text, add quotes around the text to preserve the spaces. |
|
Configures the TTL to be associated with this txt record. |
|
Sets the DNS view to associate this tst record with. The DNS view must already be configured on the system. Default: |
Notes
Note
This module supports
check_mode
.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: Ensure a text Record Exists
infoblox.nios_modules.nios_txt_record:
name: fqdn.txt.record.com
text: mytext
state: present
view: External
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
- name: Update name of TXT record
infoblox.nios_modules.nios_txt_record:
name: {old_name: sample.txtrecord.com, new_name: newsample.txtrecord.com}
text: mytext
state: present
view: External
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin
connection: local
- name: Ensure a text Record does not exist
infoblox.nios_modules.nios_txt_record:
name: fqdn.txt.record.com
text: mytext
state: absent
view: External
provider:
host: "{{ inventory_hostname_short }}"
username: admin
password: admin