Documentation

PLEASE NOTE: This document applies to latest version and not to the latest stable release v2.21

Documentation for other releases can be found by using the version selector in the top right of any doc page.

nsupdate

Manage DNS records using dynamic DNS updates (RFC 2136).

Attributes

check_mode:
  support: full

Parameters

Parameter	Required	Type	Values	Description
server	true	string		The DNS server to send updates to.
zone	true	string		The DNS zone to manage (e.g. example.com).
record		string		The record name (e.g. www). Use “@” for the zone root.
type		string	A AAAA CNAME MX TXT SRV NS PTR CAA SOA	The DNS record type.
value		string		The record value (required for state=present).
ttl		integer		The TTL in seconds.
state		string	present absent	The desired state of the record.
key_name		string		TSIG key name for authentication.
key_secret		string		TSIG key secret (base64 encoded).
key_algorithm		string	hmac-md5 hmac-sha1 hmac-sha224 hmac-sha256 hmac-sha384 hmac-sha512	TSIG key algorithm.
port		integer		DNS server port.
priority		integer		Priority for MX and SRV records.
weight		integer		Weight for SRV records.
srv_port		integer		Port value for SRV records.

Examples

```yaml

name: Add A record nsupdate: server: dns.example.com zone: example.com record: www type: A value: 192.168.1.1 ttl: 300 state: present
name: Add A record with TSIG authentication nsupdate: server: dns.example.com zone: example.com record: www type: A value: 192.168.1.1 ttl: 300 key_name: mykey key_secret: “{{ dns_key }” /// key_algorithm: hmac-sha256 /// state: present /// /// - name: Add AAAA record /// nsupdate: /// server: dns.example.com /// zone: example.com /// record: www /// type: AAAA /// value: “2001:db8::1” /// state: present /// /// - name: Add CNAME record /// nsupdate: /// server: dns.example.com /// zone: example.com /// record: blog /// type: CNAME /// value: www.example.com /// state: present /// /// - name: Add MX record /// nsupdate: /// server: dns.example.com /// zone: example.com /// record: “@” /// type: MX /// value: mail.example.com /// priority: 10 /// state: present /// /// - name: Add TXT record /// nsupdate: /// server: dns.example.com /// zone: example.com /// record: “@” /// type: TXT /// value: “v=spf1 include:_spf.example.com ~all” /// state: present /// /// - name: Add SRV record /// nsupdate: /// server: dns.example.com /// zone: example.com /// record: “_sip._tcp” /// type: SRV /// value: “sip.example.com” /// priority: 10 /// weight: 60 /// port: 5060 /// state: present /// /// - name: Delete a DNS record /// nsupdate: /// server: dns.example.com /// zone: example.com /// record: old /// type: A /// state: absent /// /// - name: Add record using custom port /// nsupdate: /// server: dns.example.com /// port: 5353 /// zone: example.com /// record: test /// type: A /// value: 10.0.0.1 /// state: present /// ```}