community.general.udm_dns_zone – Manage dns zones on a univention corporate server
Note
This plugin is part of the community.general collection (version 1.3.2).
To install it use: ansible-galaxy collection install community.general.
To use it in a playbook, specify: community.general.udm_dns_zone.
Synopsis
- This module allows to manage dns zones 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
Parameters
| Parameter | Choices/Defaults | Comments |
|---|---|---|
| contact
string
|
Default:
""
|
Contact person in the SOA record.
|
| expire
string
|
Default:
604800
|
Specifies the upper limit on the time interval that can elapse before the zone is no longer authoritative.
|
| interfaces
string
|
List of interface IP addresses, on which the server should response this zone. Required if state=present.
|
|
| mx
string
|
Default:
[]
|
List of MX servers. (Must declared as A or AAAA records).
|
| nameserver
string
|
List of appropriate name servers. Required if state=present.
|
|
| refresh
string
|
Default:
3600
|
Interval before the zone should be refreshed.
|
| retry
string
|
Default:
1800
|
Interval that should elapse before a failed refresh should be retried.
|
| state
string
|
|
Whether the dns zone is present or not.
|
| ttl
string
|
Default:
600
|
Minimum TTL field that should be exported with any RR from this zone.
|
| type
string / required
|
Define if the zone is a forward or reverse DNS zone.
The available choices are: forward_zone, reverse_zone.
|
|
| zone
string / required
|
DNS zone name, e.g. example.com.
|
Examples
- name: Create a DNS zone on a UCS
community.general.udm_dns_zone:
zone: example.com
type: forward_zone
nameserver:
- ucs.example.com
interfaces:
- 192.0.2.1
Authors
- Tobias Rüetschi (@keachi)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/udm_dns_zone_module.html