W3cubDocs

/Ansible

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.

Requirements (on host that executes module)

  • Python >= 2.6
  • Univention

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.

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

© 2012–2017 Michael DeHaan
© 2017 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/udm_dns_record_module.html