dnstxt - query a domain(s)’s DNS txt fields
Synopsis
- Uses a python library to return the DNS TXT record for a domain.
 
Requirements
The below requirements are needed on the local master node that executes this lookup.
- dns/dns.resolver (python library)
 
Parameters
| Parameter | Choices/Defaults | Configuration | Comments | 
|---|---|---|---|
|  _terms  required   |    domain or list of domains to query TXT records from   |  
Examples
- name: show txt entry
  debug: msg="{{lookup('dnstxt', ['test.example.com'])}}"
- name: iterate over txt entries
  debug: msg="{{item}}"
  with_dnstxt:
    - 'test.example.com'
    - 'other.example.com'
    - 'last.example.com'
- name: iterate of a comma delimited DNS TXT entry
  debug: msg="{{item}}"
  with_dnstxt: "{{lookup('dnstxt', ['test.example.com']).split(',')}}"
   Return Values
Common return values are documented here, the following are the fields unique to this lookup:
| Key | Returned | Description | 
|---|---|---|
|  _list  list   |    values returned by the DNS TXT record.   |  
Status
Author
- Jan-Piet Mens (@jpmens) <jpmens(at)gmail.com>
 
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.5/plugins/lookup/dnstxt.html