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¶
The below requirements are needed on the host that executes this module.
- Python >= 2.6
 - Univention
 
Parameters¶
| Parameter | Choices/Defaults | Comments | 
|---|---|---|
| data | 
                                                                                                                                                                Default: [] 
                                 | 
                                                            
                                                                     Additional data for this record, e.g. ['a': '192.0.2.1']. Required if  
                                                                            state=present. | 
        
| 
                name
                                     required                                      | 
                            
                                                                     Name of the record, this is also the DNS record. E.g. www for www.example.com. 
                                                                             | 
        |
| state | 
                                                                                                                        
  | 
                                                            
                                                                     Whether the dns record is present or not. 
                                                                             | 
        
| 
                type
                                     required                                      | 
                            
                                                                                                                        
  | 
                                                            
                                                                     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
                                     required                                      | 
                            
                                                                     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.
Maintenance¶
This module is flagged as community which means that it is maintained by the Ansible Community. See Module Maintenance & Support for more info.
For a list of other modules that are also maintained by the Ansible Community, see here.
Author¶
- Tobias Rueetschi (@2-B)
 
Hint
If you notice any issues in this documentation you can edit this document to improve it.