CNAME Record

Use the nios_cname_record module to create, update or remove a CNAME record object from a NIOS Grid.

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

Parameter	Required/Optional	Description
`name`	Required	Specifies the fully qualified host name to add or remove from NIOS.
`canonical`	Required	Specifies the canonical name of the CNAME record.
`view`	Optional	Specifies the DNS view to associate the CNAME record with. If a value is not specified, the default view configured in NIOS is used.
`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 the extensible attributes for the CNAME record object.
`state`	Optional	Specifies the state of the CNAME 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 CNAME record object.
`provider`	Required	Defines the details of the connection: `host`: DNS host name or IP address to connect to the remote instance of NIOS. `username`: User name to use for authenticating the connection to the remote instance. `password`: 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_cname_record` module must be run locally.

Examples

name: configure a CNAME record
infoblox.nios_modules.nios_cname_record:
name: cname.ansibletestzone.com
canonical: realhost.ansible.com
state: present
provider:
host: <nios_hostname_or_hostip>
username: <nios_username>
password: <nios_password>
connection: local

name: add a comment to an existing CNAME record
infoblox.nios_modules.nios_cname_record:
name: cname.ansibletestzone.com
canonical: realhost.ansible.com
comment: this is a test comment
state: present
provider:
host: <nios_hostname_or_hostip>
username: <nios_username>
password: <nios_password>
connection: local