Documentation

udm_dns_record - Manage dns entries on a univention corporate server

New in version 2.2.

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.

Options

parameter required default choices comments
data
no
Additional data for this record, e.g. ['a': '192.0.2.1']. Required if state=present.
name
yes
Name of the record, this is also the DNS record. E.g. www for www.example.com.
state
no present
  • present
  • absent
Whether the dns record is present or not.
type
yes
  • 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
yes
Corresponding DNS zone for this record, e.g. example.com.

Examples

# Create a DNS record on a UCS
- udm_dns_zone:
    name: www
    zone: example.com
    type: host_record
    data:
      - a: 192.0.2.1

Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

Support

This module is community maintained without core committer oversight.

For more information on what this means please read Module Support

For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Helping Testing PRs and Developing Modules.