You are reading an unmaintained version of the Ansible documentation. Unmaintained Ansible versions can contain unfixed security vulnerabilities (CVE). Please upgrade to a maintained version. See the latest Ansible documentation.

udm_dns_zone - Manage dns zones on a univention corporate server¶

New in version 2.2.

Synopsis
Requirements (on host that executes module)
Options
Examples
- Status

Synopsis ¶

This module allows to manage dns zones on a univention corporate server (UCS). It uses the python API of the UCS to create a new object or edit it.

Requirements (on host that executes module)¶

Python >= 2.6

Options ¶

parameter	required	default	choices	comments
contact	no			Contact person in the SOA record.
expire	no	604800		Specifies the upper limit on the time interval that can elapse before the zone is no longer authoritative.
interfaces	no			List of interface IP addresses, on which the server should response this zone. Required if `state=present`.
mx	no			List of MX servers. (Must declared as A or AAAA records).
nameserver	no			List of appropriate name servers. Required if `state=present`.
refresh	no	3600		Interval before the zone should be refreshed.
retry	no	1800		Interval that should elapse before a failed refresh should be retried.
state	no	present	present absent	Whether the dns zone is present or not.
ttl	no	600		Minimum TTL field that should be exported with any RR from this zone.
type	yes		forward_zone reverse_zone	Define if the zone is a forward or reverse DNS zone.
zone	yes			DNS zone name, e.g. `example.com`.

Examples ¶

# Create a DNS zone on a UCS
- udm_dns_zone:
    zone: example.com
    type: forward_zone
    nameserver:
      - ucs.example.com
    interfaces:
      - 192.0.2.1

Status ¶

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Testing Ansible and Developing Modules.