community.dns.lookup lookup – Просмотр записей DNS

Примечание

Этот плагин поиска является частью коллекции community.dns (версия 3.0.5).

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

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

Для использования в книге задач укажите: community.dns.lookup.

Новое в community.dns 2.6.0

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

Описание

Просмотр записей DNS.

Требования

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

dnspython >= 1.15.0 (возможно, также работают более старые версии)
ipaddress (в Python 2.7 при использовании server)

Термины

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

Параметры ключевых слов

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

Параметр	Комментарии
nxdomain_handling строка	Как обрабатывать ошибки NXDOMAIN. Они появляются, если запрос выполняется для неизвестного имени домена. `empty` (по умолчанию) возвращает пустой результат для этого имени домена. Это означает, что для соответствующего имени домена ничего не добавляется в `_result`. `fail` приводит к ошибке поиска. `message` добавляет строку `NXDOMAIN` в `_result`. Варианты: `"empty"` ← (по умолчанию) `"fail"` `"message"`
query_retry целое число	Количество попыток повторного запроса DNS при тайм-аутах запроса. По умолчанию: `3`
query_timeout вещественное число	Тайм-аут для каждого запроса DNS в секундах. По умолчанию: `10.0`
search булево добавлен в community.dns 3.0.0	Если `false`, входное значение предполагается абсолютным именем домена. Если `true`, входное значение предполагается относительным именем домена, если оно не заканчивается на `.`, используется список поиска, настроенный в конфигурации решателя системы, для относительных имён, и может быть добавлено имя домена решателя к относительным именам. Обратите внимание, что это поведение изменилось в версии community.dns 3.0.0. В community.dns 2.x.y был только вариант `search=false`. Варианты: `false` `true` ← (по умолчанию)
server список / элементы=строка	Сервер(ы) DNS, которые нужно использовать для поиска результата. Должен быть список из одного или нескольких IP-адресов. По умолчанию используется стандартный решатель системы.
servfail_retries целое число	Сколько раз нужно повторить попытку при ошибках SERVFAIL. По умолчанию: `0`
type строка	Тип записи, который нужно получить. Варианты: `"A"` ← (по умолчанию) `"ALL"` `"AAAA"` `"CAA"` `"CNAME"` `"DNAME"` `"DNSKEY"` `"DS"` `"HINFO"` `"LOC"` `"MX"` `"NAPTR"` `"NS"` `"NSEC"` `"NSEC3"` `"NSEC3PARAM"` `"PTR"` `"RP"` `"RRSIG"` `"SOA"` `"SPF"` `"SRV"` `"SSHFP"` `"TLSA"` `"TXT"`

Примечания

Примечание

Когда параметры ключевых слов и позиционные параметры используются вместе, позиционные параметры должны быть перечислены перед параметрами ключевых слов: lookup('community.dns.lookup', term1, term2, key1=value1, key2=value2) и query('community.dns.lookup', term1, term2, key1=value1, key2=value2)
Обратите внимание, что при использовании этого плагина поиска с lookup(), и результат является списком из одного элемента, Ansible просто возвращает один элемент, а не список. Поскольку это поведение неожиданно и может вызвать проблемы, лучше использовать query() вместо lookup() . Смотрите примеры, а также Принудительное возвращение списков в результатах поиска в документации Ansible.

Примеры

- name: Look up A (IPv4) records for example.org
  ansible.builtin.debug:
    msg: "{{ query('community.dns.lookup', 'example.org.') }}"

- name: Look up AAAA (IPv6) records for example.org
  ansible.builtin.debug:
    msg: "{{ query('community.dns.lookup', 'example.org.', type='AAAA' ) }}"

Значение возврата

Ключ	Описание
Значение возврата список / элементы=строка	Записи типа `type` для всех запрошенных имен DNS. Если в `_terms` запрошено несколько имён DNS, результирующие списки были объединены. Возвращено: успех Пример: `["127.0.0.1"]`

Авторы

Felix Fontein (@felixfontein)

Подсказка

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

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

© 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/dns/lookup_lookup.html