TXT Record

name

Required

Specifies the fully qualified host name of the TXT record to add, update, or remove from NIOS.

To update the name of a TXT record object, define a dictionary object that contains the following parameters:

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

• new_name: Specifies the new name.

view

Optional

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

text

Optional

Specifies the text associated with the record. It can contain up to 255 bytes per substring and a total of up to 512 bytes.
To enter leading, trailing, or embedded spaces in the text, add quotation marks around the text to preserve the spaces.

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 TXT record object.

state

Optional

Specifies the state of the TXT 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 TXT 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_txt_record module must be run locally.