salt.states.ddns¶

Dynamic DNS updates¶

Ensure a DNS record is present or absent utilizing RFC 2136 type dynamic updates. Requires dnspython module.

webserver:
  ddns.present:
    - zone: example.com
    - ttl: 60
    - data: 111.222.333.444
    - nameserver: 123.234.345.456
    - keyfile: /srv/salt/tsig_key.txt

salt.states.ddns.absent(name, zone, data=None, rdtype=None, **kwargs)¶

Ensures that the named DNS record is absent.

name: The host portion of the DNS record, e.g., 'webserver'
zone: The zone to check
data: Data for the DNS record. E.g., the IP address for an A record. If omitted, all records matching name (and rdtype, if provided) will be purged.
rdtype: DNS resource type. If omitted, all types will be purged.
**kwargs: Additional arguments the ddns.delete function may need (e.g. nameserver, keyfile, keyname).

salt.states.ddns.present(name, zone, ttl, data, rdtype='A', **kwargs)¶

Ensures that the named DNS record is present with the given ttl.

name: The host portion of the DNS record, e.g., 'webserver'
zone: The zone to check/update
ttl: TTL for the record
data: Data for the DNS record. E.g., the IP address for an A record.
rdtype: DNS resource type. Default 'A'.
**kwargs: Additional arguments the ddns.update function may need (e.g. nameserver, keyfile, keyname).