udm_dns_zone – Manage dns zones on a univention corporate server
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
-
|
Default:
""
|
Contact person in the SOA record.
|
| expire
-
|
Default:
604800
|
Specifies the upper limit on the time interval that can elapse before the zone is no longer authoritative.
|
| interfaces
-
|
List of interface IP addresses, on which the server should response this zone. Required if state=present.
|
|
| mx
-
|
Default:
[]
|
List of MX servers. (Must declared as A or AAAA records).
|
| nameserver
-
|
List of appropriate name servers. Required if state=present.
|
|
| refresh
-
|
Default:
3600
|
Interval before the zone should be refreshed.
|
| retry
-
|
Default:
1800
|
Interval that should elapse before a failed refresh should be retried.
|
| state
-
|
|
Whether the dns zone is present or not.
|
| ttl
-
|
Default:
600
|
Minimum TTL field that should be exported with any RR from this zone.
|
| type
- / required
|
|
Define if the zone is a forward or reverse DNS zone.
|
| zone
- / required
|
DNS zone name, e.g. example.com.
|
Examples
# Create a DNS zone on a UCS
- udm_dns_zone:
zone: example.com
type: forward_zone
nameserver:
- ucs.example.com
interfaces:
- 192.0.2.1
Status
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors
- Tobias Rüetschi (@keachi)
Hint
If you notice any issues in this documentation, you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/udm_dns_zone_module.html