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

Примечание

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

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

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

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

Описание
Требования
Термины
Ключевые параметры
Примечания
Примеры
Возвращаемое значение

Описание

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

Требования

Ниже перечислены требования, необходимые на локальном узле контроллера, на котором выполняется этот поиск.

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

Термины

Параметр	Комментарии
Термины список / элементы=строка / обязательно	домен или список доменов для запроса записей TXT

Ключевые параметры

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

Параметр	Комментарии
real_empty логический тип добавлено в 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(',')}}"

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

Ключ	Описание
Возвращаемое значение список / элементы=строка	значения, возвращаемые записью DNS TXT. Возвращено: успех

Авторы

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

Подсказка

Параметры конфигурации для каждого типа записи имеют порядок приоритета от низкого к высокому. Например, переменная, расположенная ниже в списке, переопределит переменную, расположенную выше.

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

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