Модуль community.dns.adguardhome_rewrite — добавление, обновление или удаление правил переписывания DNS в AdGuardHome

Примечание

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

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

Для установки используйте: ansible-galaxy collection install community.dns.

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

Новое в community.dns 3.3.0

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

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

Добавление, обновление или удаление правил переписывания DNS в AdGuardHome.

Параметры

Параметр	Комментарии
answer string	Значение для переписывания домена. Обязательно, если `state=present`. Значением может быть запись CNAME, A или AAAA.
domain string / обязательный	Домен или домен с подстановочными знаками, который требуется переписывать с помощью AdGuardHome.
host string / обязательный	URL-адрес узла AdGuardHome. Например, `https://my-adguard.my-domain` или `http://192.168.1.2`.
password string / обязательный	Пароль пользователя AdGuardHome.
state string	Следует ли добавить или обновить правило переписывания (`state=present`) либо удалить его (`state=absent`). Варианты: `"present"` ← (по умолчанию) `"absent"`
username string / обязательный	Пользователь AdGuardHome.
validate_certs boolean	Возможность отключить проверку сертификата TLS. Устанавливайте значение `false` только в том случае, если сетевой путь между узлом, на котором выполняется модуль, и узлом AdGuard полностью контролируется вами и является доверенным. Варианты: `false` `true` ← (по умолчанию)

Атрибуты

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

Примеры

- name: Add DNS rewrite rule in AdGuardHome
  community.dns.adguardhome_rewrite:
    state: present
    answer: 127.0.0.1
    domain: example.org

# When removing a rewrite, the current answer value must also match.
# Therefore you can just leave it out and the existing value
# will be used.
- name: Remove rewrite for example.org
  community.dns.adguardhome_rewrite:
    state: absent
    domain: example.org

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

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

Ключ	Описание
rules list / elements=dictionary	Изменённый список правил переписывания после применения правила. Возвращается: при успехе
answer string	Значение переписывания. Возвращается: при успехе Пример: `"192.168.178.71"`
domain string	Домен для переписывания. Возвращается: при успехе Пример: `"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_module.html