freeipa / freeipa.ansible_freeipa / 1.8.4 / module / ipadnsrecord Manage FreeIPA DNS records Authors: Rafael Guterres Jeffman preview | supported by communityfreeipa.ansible_freeipa.ipadnsrecord (1.8.4) — module
Install with ansible-galaxy collection install freeipa.ansible_freeipa:==1.8.4
collections: - name: freeipa.ansible_freeipa version: 1.8.4
Manage FreeIPA DNS records
# Ensure dns record is present - freeipa.ansible_freeipa.ipadnsrecord: ipaadmin_password: SomeADMINpassword name: vm-001 zone_name: example.com record_type: 'AAAA' record_value: '::1'
# Ensure that dns record exists with a TTL - freeipa.ansible_freeipa.ipadnsrecord: ipaadmin_password: SomeADMINpassword name: host01 zone_name: example.com record_type: 'AAAA' record_value: '::1' record_ttl: 300
# Ensure that dns record exists with a reverse record - freeipa.ansible_freeipa.ipadnsrecord: ipaadmin_password: SomeADMINpassword name: host02 zone_name: example.com record_type: 'AAAA' record_value: 'fd00::0002' create_reverse: yes
# Ensure a PTR record is present - freeipa.ansible_freeipa.ipadnsrecord: ipaadmin_password: SomeADMINpassword name: 5 zone_name: 2.168.192.in-addr.arpa record_type: 'PTR' record_value: 'internal.ipa.example.com'
# Ensure a TXT record is present - freeipa.ansible_freeipa.ipadnsrecord: ipaadmin_password: SomeADMINpassword name: _kerberos zone_name: example.com record_type: 'TXT' record_value: 'EXAMPLE.COM'
# Ensure a SRV record is present - freeipa.ansible_freeipa.ipadnsrecord: ipaadmin_password: SomeADMINpassword name: _kerberos._udp.example.com zone_name: example.com record_type: 'SRV' record_value: '10 50 88 ipa.example.com'
# Ensure an MX record is present - freeipa.ansible_freeipa.ipadnsrecord: ipaadmin_password: SomeADMINpassword name: '@' zone_name: example.com record_type: 'MX' record_value: '1 mailserver.example.com'
# Ensure that dns record is absent - freeipa.ansible_freeipa.ipadnsrecord: ipaadmin_password: SomeADMINpassword name: host01 zone_name: example.com record_type: 'AAAA' record_value: '::1' state: absent
name: aliases: - record_name description: The DNS record name to manage. required: true a_rec: aliases: - a_record description: Raw A record. required: false state: choices: - present - absent default: present description: State to ensure a6_rec: aliases: - a6_record description: Raw A6 record. required: false ds_rec: aliases: - ds_record description: Raw DS record. required: false kx_rec: aliases: - kx_record description: Raw KX record. required: false mx_rec: aliases: - mx_record description: Raw MX record. required: false ns_rec: aliases: - ns_record description: Raw NS record. required: false del_all: description: Delete all associated records. required: false type: bool dlv_rec: aliases: - dlv_record description: Raw DLV record. required: false loc_rec: aliases: - loc_record description: Raw LOC record. required: false ptr_rec: aliases: - ptr_record description: Raw PTR record. required: false records: description: The list of user dns records dicts required: false suboptions: a6_data: description: A6 record data. required: false a6_rec: aliases: - a6_record description: Raw A6 record. required: false a_create_reverse: description: 'Create reverse record for A records. There is no equivalent to remove reverse records. ' required: false type: bool a_ip_address: description: IP adresses for A records. required: false type: string a_rec: aliases: - a_record description: Raw A record. required: false aaaa_create_reverse: description: 'Create reverse record for AAAA records. There is no equivalent to remove reverse records. ' required: false type: bool aaaa_ip_address: description: IP adresses for AAAA records. required: false type: string aaaa_rec: aliases: - aaaa_record description: Raw AAAA record. required: false afsdb_hostname: description: AFSDB Hostname required: false type: string afsdb_rec: aliases: - afsdb_record description: Raw AFSDB record. required: false afsdb_subtype: description: AFSDB Subtype required: false type: int cert_algorithm: description: CERT Algorithm required: false type: int cert_certificate_or_crl: description: CERT Certificate or Certificate Revocation List (CRL). required: false type: string cert_key_tag: description: CERT Key Tag required: false type: int cert_rec: aliases: - cert_record description: Raw CERT record. required: false cert_type: description: CERT Certificate Type required: false type: int cname_hostname: description: A hostname which this alias hostname points to. required: false type: string cname_rec: aliases: - cname_record description: Raw CNAME record. required: false create_reverse: aliases: - reverse description: 'Create reverse record for A or AAAA record types. There is no equivalent to remove reverse records. ' required: false type: bool del_all: description: Delete all associated records. required: false type: bool dlv_algorithm: description: DLV Algorithm required: false type: int dlv_digest: description: DLV Digest required: false type: string dlv_digest_type: description: DLV Digest Type required: false type: int dlv_key_tag: description: DS Key Tag required: false type: int dlv_rec: aliases: - dlv_record description: Raw DLV record. required: false dname_rec: aliases: - dname_record description: Raw DNAM record. required: false dname_target: description: DNAME Target required: false type: string ds_algorithm: description: DS Algorithm required: false type: int ds_digest: description: DS Digest required: false type: string ds_digest_type: description: DS Digest Type required: false type: int ds_key_tag: description: DS Key Tag required: false type: int ds_rec: aliases: - ds_record description: Raw DS record. required: false ip_address: description: IP adresses for A or AAAA records. required: false type: string kx_exchanger: description: A host willing to act as a key exchanger. required: false type: string kx_preference: description: 'Preference given to this exchanger. Lower values are more preferred. ' required: false type: int kx_rec: aliases: - kx_record description: Raw KX record. required: false loc_altitude: description: LOC Altitude required: false type: float loc_h_precision: description: LOC Horizontal Precision required: false type: float loc_lat_deg: description: LOC Degrees Latitude required: false type: int loc_lat_dir: choices: - N - S description: LOC Direction Latitude required: false loc_lat_min: description: LOC Minutes Latitude required: false type: int loc_lat_sec: description: LOC Seconds Latitude required: false type: float loc_lon_deg: description: LOC Degrees Longitude required: false type: int loc_lon_dir: choices: - E - W description: LOC Direction Longitude required: false loc_lon_min: description: LOC Minutes Longitude required: false type: int loc_lon_sec: description: LOC Seconds Longitude required: false type: float loc_rec: aliases: - loc_record description: Raw LOC record. required: false loc_size: description: LOC Size required: false type: float loc_v_precision: description: LOC Vertical Precision required: false type: float mx_exchanger: description: A host willing to act as a mail exchanger. required: false type: string mx_preference: description: 'Preference given to this exchanger. Lower values are more preferred. ' required: false type: int mx_rec: aliases: - mx_record description: Raw MX record. required: false name: aliases: - record_name description: The DNS record name to manage. required: true naptr_flags: description: NAPTR Flags required: false type: string naptr_order: description: NAPTR Order required: false type: int naptr_preference: description: NAPTR Preference required: false type: int naptr_rec: aliases: - naptr_record description: Raw NAPTR record. required: false naptr_regexp: description: NAPTR Regular Expression required: false type: string naptr_replacement: description: NAPTR Replacement required: false type: string naptr_service: description: NAPTR Service required: false type: string ns_hostname: description: NS Hostname required: false type: string ns_rec: aliases: - ns_record description: Raw NS record. required: false ptr_hostname: description: The hostname this reverse record points to. required: false type: string ptr_rec: aliases: - ptr_record description: Raw PTR record. required: false record_ttl: description: Set the TTL for the record. required: false type: int record_type: choices: - A - AAAA - A6 - AFSDB - CERT - CNAME - DLV - DNAME - DS - KX - LOC - MX - NAPTR - NS - PTR - SRV - SSHFP - TLSA - TXT - URI default: A description: The type of DNS record. record_value: description: Manage DNS record name with these values. required: false type: list srv_port: description: SRV Port required: false type: int srv_priority: description: 'Lower number means higher priority. Clients will attempt to contact the server with the lowest-numbered priority they can reach. ' required: false type: int srv_rec: aliases: - srv_record description: Raw SRV record. required: false srv_target: description: 'The domain name of the target host or ''.'' if the service is decidedly not available at this domain. ' required: false type: string srv_weight: description: Relative weight for entries with the same priority. required: false type: int sshfp_algorithm: description: SSHFP Algorithm required: false type: int sshfp_fingerprint: description: SSHFP Fingerprint required: false type: string sshfp_fp_type: description: SSHFP Fingerprint Type required: false type: int sshfp_rec: aliases: - sshfp_record description: Raw SSHFP record. required: false tlsa_cert_association_data: description: TLSA Certificate Association Data required: false type: string tlsa_cert_usage: description: TLSA Certificate Usage required: false type: int tlsa_matching_type: description: TLSA Matching Type required: false type: int tlsa_rec: aliases: - tlsa_record description: Raw TLSA record. required: false tlsa_selector: description: TLSA Selector required: false type: int txt_data: description: TXT Text Data required: false type: string txt_rec: aliases: - txt_record description: Raw TXT record. required: false uri_priority: description: 'Lower number means higher priority. Clients will attempt to contact the URI with the lowest-numbered priority they can reach. ' required: false type: int uri_rec: aliases: - uri_record description: Raw URI record. required: false uri_target: description: Target Uniform Resource Identifier according to RFC 3986. required: false type: string uri_weight: description: Relative weight for entries with the same priority. required: false type: int zone_name: aliases: - dnszone description: 'The DNS zone name to which DNS record needs to be managed. Required if not provided globally. ' required: false srv_rec: aliases: - srv_record description: Raw SRV record. required: false txt_rec: aliases: - txt_record description: Raw TXT record. required: false uri_rec: aliases: - uri_record description: Raw URI record. required: false aaaa_rec: aliases: - aaaa_record description: Raw AAAA record. required: false cert_rec: aliases: - cert_record description: Raw CERT record. required: false loc_size: description: LOC Size required: false type: float srv_port: description: SRV Port required: false type: int tlsa_rec: aliases: - tlsa_record description: Raw TLSA record. required: false txt_data: description: TXT Text Data required: false type: string afsdb_rec: aliases: - afsdb_record description: Raw AFSDB record. required: false cert_type: description: CERT Certificate Type required: false type: int cname_rec: aliases: - cname_record description: Raw CNAME record. required: false dname_rec: aliases: - dname_record description: Raw DNAM record. required: false ds_digest: description: DS Digest required: false type: string naptr_rec: aliases: - naptr_record description: Raw NAPTR record. required: false sshfp_rec: aliases: - sshfp_record description: Raw SSHFP record. required: false zone_name: aliases: - dnszone description: 'The DNS zone name to which DNS record needs to be managed. Required if not provided globally. ' required: false dlv_digest: description: DLV Digest required: false type: string ds_key_tag: description: DS Key Tag required: false type: int ip_address: description: IP adresses for A ar AAAA. required: false type: string record_ttl: description: Set the TTL for the record. required: false type: int srv_target: description: 'The domain name of the target host or ''.'' if the service is decidedly not available at this domain. ' required: false type: string srv_weight: description: Relative weight for entries with the same priority. required: false type: int uri_target: description: Target Uniform Resource Identifier according to RFC 3986. required: false type: string uri_weight: description: Relative weight for entries with the same priority. required: false type: int dlv_key_tag: description: DS Key Tag required: false type: int loc_lat_deg: description: LOC Degrees Latitude required: false type: int loc_lat_dir: choices: - N - S description: LOC Direction Latitude required: false loc_lat_min: description: LOC Minutes Latitude required: false type: int loc_lat_sec: description: LOC Seconds Latitude required: false type: float loc_lon_deg: description: LOC Degrees Longitude required: false type: int loc_lon_dir: choices: - E - W description: LOC Direction Longitude required: false loc_lon_min: description: LOC Minutes Longitude required: false type: int loc_lon_sec: description: LOC Seconds Longitude required: false type: float naptr_flags: description: NAPTR Flags required: false type: string naptr_order: description: NAPTR Order required: false type: int ns_hostname: description: NS Hostname required: false type: string record_type: choices: - A - AAAA - A6 - AFSDB - CERT - CNAME - DLV - DNAME - DS - KX - LOC - MX - NAPTR - NS - PTR - SRV - SSHFP - TLSA - TXT - URI default: A description: The type of DNS record. required: false a_ip_address: description: IP adresses for A records. required: false type: string cert_key_tag: description: CERT Key Tag required: false type: int dname_target: description: DNAME Target required: false type: string ds_algorithm: description: DS Algorithm required: false type: int kx_exchanger: description: A host willing to act as a key exchanger. required: false type: string loc_altitude: description: LOC Altitude required: false type: float mx_exchanger: description: A host willing to act as a mail exchanger. required: false type: string naptr_regexp: description: NAPTR Regular Expression required: false type: string ptr_hostname: description: The hostname this reverse record points to. required: false type: string record_value: description: Manage DNS record name with this values. required: false type: list srv_priority: description: 'Lower number means higher priority. Clients will attempt to contact the server with the lowest-numbered priority they can reach. ' required: false type: int uri_priority: description: 'Lower number means higher priority. Clients will attempt to contact the URI with the lowest-numbered priority they can reach. ' required: false type: int afsdb_subtype: description: AFSDB Subtype required: false type: int dlv_algorithm: description: DLV Algorithm required: false type: int kx_preference: description: 'Preference given to this exchanger. Lower values are more preferred. ' required: false type: int mx_preference: description: 'Preference given to this exchanger. Lower values are more preferred. ' required: false type: int naptr_service: description: NAPTR Service required: false type: string sshfp_fp_type: description: SSHFP Fingerprint Type required: false type: int tlsa_selector: description: TLSA Selector required: false type: int afsdb_hostname: description: AFSDB Hostname required: false type: string cert_algorithm: description: CERT Algorithm required: false type: int cname_hostname: description: A hostname which this alias hostname points to. required: false type: string create_reverse: aliases: - reverse description: 'Create reverse record for A or AAAA record types. There is no equivalent to remove reverse records. ' required: false type: bool ds_digest_type: description: DS Digest Type required: false type: int ipaapi_context: choices: - server - client description: 'The context in which the module will execute. Executing in a server context is preferred. If not provided context will be determined by the execution environment. ' required: false aaaa_ip_address: description: IP adresses for AAAA records. required: false type: string dlv_digest_type: description: DLV Digest Type required: false type: int loc_h_precision: description: LOC Horizontal Precision required: false type: float loc_v_precision: description: LOC Vertical Precision required: false type: float sshfp_algorithm: description: SSHFP Algorithm required: false type: int tlsa_cert_usage: description: TLSA Certificate Usage required: false type: int a_create_reverse: description: 'Create reverse record for A records. There is no equivalent to remove reverse records. ' required: false type: bool naptr_preference: description: NAPTR Preference required: false type: int ipaadmin_password: description: The admin password. required: false ipaapi_ldap_cache: default: true description: Use LDAP cache for IPA connection. type: bool naptr_replacement: description: NAPTR Replacement required: false type: string sshfp_fingerprint: description: SSHFP Fingerprint required: false type: string ipaadmin_principal: default: admin description: The admin principal. tlsa_matching_type: description: TLSA Matching Type required: false type: int aaaa_create_reverse: description: 'Create reverse record for AAAA records. There is no equivalent to remove reverse records. ' required: false type: bool cert_certificate_or_crl: description: CERT Certificate/CRL required: false type: string tlsa_cert_association_data: description: TLSA Certificate Association Data required: false type: string