Модуль community.dns.nameserver_info — поиск серверов имён для имени DNS

Примечание

Этот модуль входит в коллекцию community.dns (версия 3.5.5).

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

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

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

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

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

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

Получение всех серверов имён, отвечающих за имя DNS.

Требования

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

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

Параметры

Параметр	Комментарии
always_ask_default_resolver логический	Если задано значение `true` (по умолчанию), для поиска авторитетных серверов имён подзоны будет использоваться резолвер по умолчанию. Сведения о настройке резолвера по умолчанию см. в `server`. Если задано значение `false`, для поиска авторитетных серверов имён подзоны будут использоваться авторитетные серверы имён родительской зоны. Это имеет смысл только в том случае, если серверы имён были недавно изменены, и изменения ещё не распространились. Варианты: `false` `true` ← (по умолчанию)
name список / элементы=строка / обязательный	Список имён DNS, для которых нужно получить серверы имён.
query_retry целое число	Количество повторных попыток при тайм-ауте DNS-запроса. По умолчанию: `3`
query_timeout число с плавающей точкой	Тайм-аут для каждого DNS-запроса в секундах. По умолчанию: `10.0`
resolve_addresses логический	Нужно ли разрешать имена серверов имён в IP-адреса. Варианты: `false` ← (по умолчанию) `true`
server список / элементы=строка добавлено в community.dns 2.7.0	DNS-сервер или серверы, используемые для поиска результата. Должен быть указан список из одного или нескольких IP-адресов. По умолчанию используется стандартный системный резолвер.
servfail_retries целое число	Количество повторных попыток при ошибках SERVFAIL. По умолчанию: `0`

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная Это действие не изменяет состояние.	Может выполняться в `check_mode` и возвращать прогноз статуса изменений без изменения целевого объекта.
diff_mode	Поддержка: Н/Д Это действие не изменяет состояние.	В режиме различий будут возвращены сведения об изменениях (или о том, что, возможно, нужно изменить в `check_mode`).
idempotent	Поддержка: полная Это действие не изменяет состояние.	При повторном запуске с теми же аргументами вне режима проверки второй вызов не сообщает об изменениях. Предполагается, что система, которой управляет модуль или к которой он обращается, не изменилась существенным образом.

Примеры

- name: Retrieve name servers of two DNS names
  community.dns.nameserver_info:
    name:
      - www.example.com
      - example.org
  register: result

- name: Show nameservers for www.example.com
  ansible.builtin.debug:
    msg: '{{ result.results[0].nameserver }}'

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

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

Ключ	Описание
results список / элементы=словарь	Сведения о серверах имён для каждого имени DNS, указанного в `name`. Возвращается: всегда Пример: `[{"name": "www.example.com", "nameservers": ["ns1.example.com", "ns2.example.com"]}, {"name": "example.org", "nameservers": ["ns1.example.org", "ns2.example.org", "ns3.example.org"]}]`
name строка	Имя DNS, к которому относится эта запись. Возвращается: всегда Пример: `"www.example.com"`
nameservers список / элементы=строка	Список серверов имён для этого имени DNS. Возвращается: при успешном выполнении Пример: `["ns1.example.com", "ns2.example.com"]`

Авторы

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