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