community.dns.reverse_lookup lookup – Обратный поиск IP-адресов

Примечание

Этот lookup-плагин входит в коллекцию community.dns (версия 3.5.5).

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

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

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

Добавлено в community.dns 3.1.0

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

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

Выполняет обратный поиск DNS для определения имён хостов по IP-адресам.

Требования

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

dnspython >= 1.15.0 (возможно, также подойдут более старые версии)

Аргументы

Параметр	Комментарии
Аргументы список / элементы=строка / обязательный	IP-адрес или адреса для поиска.

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

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

Параметр	Комментарии
query_retry целое число	Количество повторных попыток при тайм-ауте DNS-запроса. По умолчанию: `3`
query_timeout число с плавающей запятой	Тайм-аут каждого DNS-запроса в секундах. По умолчанию: `10.0`
server список / элементы=строка	DNS-сервер или серверы, используемые для поиска результата. Должен быть указан список из одного или нескольких IP-адресов. По умолчанию используется стандартный системный резолвер.
servfail_retries целое число	Количество повторных попыток при ошибках SERVFAIL. По умолчанию: `0`

Примечания

Примечание

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

Примеры

- name: Look up hostname of IPv4 address
  ansible.builtin.debug:
    msg: "{{ query('community.dns.reverse_lookup', '192.168.1.1') }}"

- name: Look up hostname of IPv6 address
  ansible.builtin.debug:
    msg: "{{ query('community.dns.reverse_lookup', '1:2:3::4') }}"

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

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

Авторы

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/reverse_lookup_lookup.html