Модуль community.dns.adguardhome_rewrite_info – получение правил перезаписи DNS из AdGuardHome

Примечание

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

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

Чтобы установить ее, используйте: ansible-galaxy collection install community.dns.

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

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

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

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

Получает правила перезаписи DNS из AdGuardHome.

Параметры

Параметр	Комментарии
host строка / обязательный	URL-адрес узла AdGuardHome. Например, `https://my-adguard.my-domain` или `http://192.168.1.2`.
password строка / обязательный	Пароль пользователя AdGuardHome.
username строка / обязательный	Пользователь AdGuardHome.
validate_certs логическое значение	Возможность отключить проверку сертификата TLS. Устанавливайте значение `false` только в том случае, если сетевой путь между узлом, на котором выполняется модуль, и узлом AdGuard полностью находится под вашим контролем и является доверенным. Варианты: `false` `true` ← (по умолчанию)

Атрибуты

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

Примеры

- name: Get DNS rewrites from AdGuardHome
  register: rewrite
  community.dns.adguardhome_rewrite_info:
    username: admin
    password: admin
    host: https://dns.osuv.de

- name: Display the rewrite rules
  debug:
    var: rewrite

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

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

Ключ	Описание
rules список / элементы=словарь	Список полученных правил перезаписи. Возвращается: при успешном выполнении
answer строка	Значение правила перезаписи. Возвращается: при успешном выполнении Пример: `"192.168.178.71"`
domain строка	Домен правила перезаписи. Возвращается: при успешном выполнении Пример: `"dns.osuv.de"`

Авторы

Markus Bergholz (@markuman)

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

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