ansible.builtin.udm_dns_zone (v2.9.27) — module

Manage dns zones on a univention corporate server

| "added in version" 2.2 of ansible.builtin"

Authors: Tobias Rüetschi (@keachi)

preview | supported by community

Install Ansible via pip

Install with pip install ansible==2.9.27

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.
# 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

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:
    choices:
    - forward_zone
    - reverse_zone
    description:
    - Define if the zone is a forward or reverse DNS 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