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

Note

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

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

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

Synopsis
Requirements
Parameters
Examples

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 string	Default: 604800	Specifies the upper limit on the time interval that can elapse before the zone is no longer authoritative.
interfaces string		List of interface IP addresses, on which the server should response this zone. Required if `state=present`.
mx string	Default: []	List of MX servers. (Must declared as A or AAAA records).
nameserver string		List of appropriate name servers. Required if `state=present`.
refresh string	Default: 3600	Interval before the zone should be refreshed.
retry string	Default: 1800	Interval that should elapse before a failed refresh should be retried.
state string	present ← absent	Whether the dns zone is present or not.
ttl string	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`.

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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/udm_dns_zone_module.html