community.general.udm_dns_zone (1.3.14) — module

Manage dns zones on a univention corporate server

Authors: Tobias Rüetschi (@keachi)

Install collection

Install with ansible-galaxy collection install community.general:==1.3.14


Add to requirements.yml

  collections:
    - name: community.general
      version: 1.3.14

Description

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

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- 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

Inputs

    
mx:
    default: []
    description:
    - List of MX servers. (Must declared as A or AAAA records).
    required: false

ttl:
    default: 600
    description:
    - Minimum TTL field that should be exported with any RR from this zone.
    required: false

type:
    description:
    - Define if the zone is a forward or reverse DNS zone.
    - 'The available choices are: C(forward_zone), C(reverse_zone).'
    required: true

zone:
    description:
    - DNS zone name, e.g. C(example.com).
    required: true

retry:
    default: 1800
    description:
    - Interval that should elapse before a failed refresh should be retried.
    required: false

state:
    choices:
    - present
    - absent
    default: present
    description:
    - Whether the dns zone is present or not.
    required: false

expire:
    default: 604800
    description:
    - Specifies the upper limit on the time interval that can elapse before the zone is
      no longer authoritative.
    required: false

contact:
    default: ''
    description:
    - Contact person in the SOA record.
    required: false

refresh:
    default: 3600
    description:
    - Interval before the zone should be refreshed.
    required: false

interfaces:
    description:
    - List of interface IP addresses, on which the server should response this zone. Required
      if C(state=present).
    required: false

nameserver:
    description:
    - List of appropriate name servers. Required if C(state=present).
    required: false