W3cubDocs

/Ansible

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

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

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)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/udm_dns_zone_module.html