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

Note

This module is part of the community.general collection (version 5.8.3).

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. You need further requirements to be able to use this module, see Requirements for details.

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

Comments

contact

string

Contact person in the SOA record.

Default: ""

expire

integer

Specifies the upper limit on the time interval that can elapse before the zone is no longer authoritative.

Default: 604800

interfaces

list / elements=string

List of interface IP addresses, on which the server should response this zone. Required if state=present.

Default: []

mx

list / elements=string

List of MX servers. (Must declared as A or AAAA records).

Default: []

nameserver

list / elements=string

List of appropriate name servers. Required if state=present.

Default: []

refresh

integer

Interval before the zone should be refreshed.

Default: 3600

retry

integer

Interval that should elapse before a failed refresh should be retried.

Default: 1800

state

string

Whether the dns zone is present or not.

Choices:

  • "present" ← (default)

  • "absent"

ttl

integer

Minimum TTL field that should be exported with any RR from this zone.

Default: 600

type

string / required

Define if the zone is a forward or reverse DNS zone.

The available choices are: forward_zone, reverse_zone.

zone

aliases: name

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)