community.general.udm_dns_record (2.5.9) — module

Install collection

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

Add to requirements.yml

  collections:
    - name: community.general
      version: 2.5.9

Description

This module allows to manage dns records on a univention corporate server (UCS). It uses the python API of the UCS to create a new object or edit it.

Requirements

• Python >= 2.6
• Univention
• ipaddress (for I(type=ptr_record))

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Create a DNS record on a UCS
  community.general.udm_dns_record:
    name: www
    zone: example.com
    type: host_record
    data:
      a:
         - 192.0.2.1
         - 2001:0db8::42

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Create a DNS v4 PTR record on a UCS
  community.general.udm_dns_record:
    name: 192.0.2.1
    zone: 2.0.192.in-addr.arpa
    type: ptr_record
    data:
      ptr_record: "www.example.com."

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Create a DNS v6 PTR record on a UCS
  community.general.udm_dns_record:
    name: 2001:db8:0:0:0:ff00:42:8329
    zone: 2.4.0.0.0.0.f.f.0.0.0.0.0.0.0.0.0.0.0.0.8.b.d.0.1.0.0.2.ip6.arpa
    type: ptr_record
    data:
      ptr_record: "www.example.com."

Inputs

    
data:
    default: []
    description:
    - 'Additional data for this record, e.g. [''a'': ''192.0.2.1'']. Required if C(state=present).'
    required: false

name:
    description:
    - Name of the record, this is also the DNS record. E.g. www for www.example.com.
    - For PTR records this has to be the IP address.
    required: true

type:
    description:
    - Define the record type. C(host_record) is a A or AAAA record, C(alias) is a CNAME,
      C(ptr_record) is a PTR record, C(srv_record) is a SRV record and C(txt_record) is
      a TXT record.
    - 'The available choices are: C(host_record), C(alias), C(ptr_record), C(srv_record),
      C(txt_record).'
    required: true

zone:
    description:
    - Corresponding DNS zone for this record, e.g. example.com.
    - For PTR records this has to be the full reverse zone (for example C(1.1.192.in-addr.arpa)).
    required: true

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