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

Примечание

Этот модуль является частью коллекции community.dns (версия 3.0.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 boolean	При установке в `true` (по умолчанию), будет использовать стандартный резолвер для поиска авторитетных серверов имен подзоны. См. `server` для настройки стандартного резолвера. При установке в `false`, будет использовать авторитетные серверы родительской зоны для поиска авторитетных серверов имен подзоны. Это имеет смысл только в случае, если серверы имен недавно изменились и еще не были распространены. Варианты: `false` `true` ← (по умолчанию)
name list / elements=string / required	Список имен DNS, для которых необходимо получить серверы имен.
query_retry integer	Количество попыток повторного запроса при временных ограничениях DNS-запроса. По умолчанию: `3`
query_timeout float	Время ожидания каждого DNS-запроса в секундах. По умолчанию: `10.0`
resolve_addresses boolean	Выполнять ли преобразование имён серверов имен в IP-адреса. Варианты: `false` ← (по умолчанию) `true`
server list / elements=string добавлен в community.dns 2.7.0	Сервер(ы) DNS, которые использовать для поиска результатов. Должен быть списком из одного или более IP-адресов. По умолчанию используется стандартный резолвер системы.
servfail_retries integer	Сколько раз пытаться повторить запрос при ошибках SERVFAIL. По умолчанию: `0`

Атрибуты

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

Примеры

- 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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/dns/nameserver_info_module.html