поиск community.general.dnstxt — запрос TXT-полей DNS домена или доменов

Примечание

Этот плагин поиска входит в коллекцию community.general (версия 12.6.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.general. Для использования этого плагина поиска могут потребоваться дополнительные компоненты. Подробнее см. раздел Требования.

Чтобы использовать его в плейбуке, укажите: community.general.dnstxt.

Краткое описание
Требования
Аргументы
Именованные параметры
Примечания
Примеры
Возвращаемое значение

Краткое описание

Использует библиотеку Python для получения DNS TXT-записи домена.

Требования

Следующие компоненты должны быть установлены на локальном узле-контроллере, выполняющем этот поиск.

dns/dns.resolver (библиотека Python)

Аргументы

Параметр	Комментарии
Аргументы list / elements=string / обязательный	Домен или список доменов, для которых нужно запросить TXT-записи.

Именованные параметры

Здесь описаны именованные параметры поиска. Это значения key1=value1, key2=value2 и так далее в следующих примерах: lookup('community.general.dnstxt', key1=value1, key2=value2, ...) и query('community.general.dnstxt', key1=value1, key2=value2, ...)

Параметр	Комментарии
real_empty boolean добавлено в community.general 6.0.0	Возвращать пустой результат без пустых строк и возвращать пустой список вместо `NXDOMAIN`. В будущем значение этого параметра по умолчанию, вероятно, изменится на `true`. Варианты: `false` ← (по умолчанию) `true`

Примечания

Примечание

При совместном использовании позиционных и именованных параметров позиционные параметры необходимо указывать перед именованными: lookup('community.general.dnstxt', term1, term2, key1=value1, key2=value2) и query('community.general.dnstxt', term1, term2, key1=value1, key2=value2)

Примеры

- name: show txt entry
  ansible.builtin.debug:
    msg: "{{lookup('community.general.dnstxt', ['test.example.com'])}}"

- name: iterate over txt entries
  ansible.builtin.debug:
    msg: "{{item}}"
  with_community.general.dnstxt:
    - 'test.example.com'
    - 'other.example.com'
    - 'last.example.com'

- name: iterate of a comma delimited DNS TXT entry
  ansible.builtin.debug:
    msg: "{{item}}"
  with_community.general.dnstxt: "{{lookup('community.general.dnstxt', ['test.example.com']).split(',')}}"

Возвращаемое значение

Ключ	Описание
Возвращаемое значение list / elements=string	Значения, возвращаемые DNS TXT-записью. Возвращается: при успешном выполнении

Авторы

Jan-Piet Mens (@jpmens) <jpmens(at)gmail.com>

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/dnstxt_lookup.html