W3cubDocs

/Ansible

udm_dns_zone - Manage dns zones on a univention corporate server

New in version 2.2.

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']

This is an Extras Module

For more information on what this means please read Extras Modules

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

© 2012–2016 Michael DeHaan
© 2016 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/udm_dns_zone_module.html