community.general.udm_dns_record (1.3.14) — module

Manage dns entries on a univention corporate server

Authors: Tobias Rüetschi (@keachi)

Install collection

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


Add to requirements.yml

  collections:
    - name: community.general
      version: 1.3.14

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

Usage examples

  • 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

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.
    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.
    required: true

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