community.general.udm_dns_zone – Manage dns zones on a univention corporate server

Note

This plugin is part of the community.general collection (version 3.7.0).

To install it use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.udm_dns_zone.

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

The below requirements are needed on the host that executes this module.

  • Python >= 2.6

Parameters

Parameter Choices/Defaults Comments
contact
string
Default:
""
Contact person in the SOA record.
expire
integer
Default:
604800
Specifies the upper limit on the time interval that can elapse before the zone is no longer authoritative.
interfaces
list / elements=string
List of interface IP addresses, on which the server should response this zone. Required if state=present.
mx
list / elements=string
Default:
[]
List of MX servers. (Must declared as A or AAAA records).
nameserver
list / elements=string
List of appropriate name servers. Required if state=present.
refresh
integer
Default:
3600
Interval before the zone should be refreshed.
retry
integer
Default:
1800
Interval that should elapse before a failed refresh should be retried.
state
string
    Choices:
  • present ←
  • absent
Whether the dns zone is present or not.
ttl
integer
Default:
600
Minimum TTL field that should be exported with any RR from this zone.
type
string / required
Define if the zone is a forward or reverse DNS zone.
The available choices are: forward_zone, reverse_zone.
zone
string / required
DNS zone name, e.g. example.com.

aliases: name

Examples

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

Authors

  • Tobias Rüetschi (@keachi)