community.general.udm_dns_record – Manage dns entries on a univention corporate server

Note

This plugin is part of the community.general collection.

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

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

Synopsis

  • 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

The below requirements are needed on the host that executes this module.

  • Python >= 2.6

  • Univention

Parameters

Parameter Choices/Defaults Comments
data
string
Default:
[]
Additional data for this record, e.g. ['a': '192.0.2.1']. Required if state=present.
name
string / required
Name of the record, this is also the DNS record. E.g. www for www.example.com.
state
string
    Choices:
  • present ←
  • absent
Whether the dns record is present or not.
type
string / required
    Choices:
  • host_record
  • alias
  • ptr_record
  • srv_record
  • txt_record
Define the record type. host_record is a A or AAAA record, alias is a CNAME, ptr_record is a PTR record, srv_record is a SRV record and txt_record is a TXT record.
zone
string / required
Corresponding DNS zone for this record, e.g. example.com.

Examples

- 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

Authors

  • Tobias Rüetschi (@keachi)