community.dns.lookup lookup — Поиск DNS-записей

Примечание

Этот плагин поиска входит в коллекцию community.dns (версия 3.5.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 (возможно, подойдут и более ранние версии)

Параметры

Параметр	Комментарии
Terms list / elements=string / обязательный	Имя домена или имена доменов для запроса.

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

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

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

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

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

Авторы

Felix Fontein (@felixfontein)

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

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