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.
`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