community.dns.adguardhome_rewrite_info module – Retrieve DNS rewrite rules from AdGuardHome
Note
This module is part of the community.dns collection (version 3.3.0).
It is not included in ansible-core
.
To check whether it is installed, run ansible-galaxy collection list
.
To install it, use: ansible-galaxy collection install community.dns
.
To use it in a playbook, specify: community.dns.adguardhome_rewrite_info
.
New in community.dns 3.3.0
Synopsis
Retrieves DNS rewrite rules from AdGuardHome.
Parameters
Parameter |
Comments |
---|---|
URL of AdGuardHome host. For example, |
|
Related password for the AdGuardHome user. |
|
AdGuardHome user. |
|
Ability to disable TLS certificate validation. This should only set to Choices:
|
Attributes
Attribute |
Support |
Description |
---|---|---|
Support: full This action does not modify state. |
Can run in |
|
Support: N/A This action does not modify state. |
Will return details on what has changed (or possibly needs changing in |
|
Support: full This action does not modify state. |
When run twice in a row outside check mode, with the same arguments, the second invocation indicates no change. This assumes that the system controlled/queried by the module has not changed in a relevant way. |
Examples
- 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
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
---|---|
The list of fetched rewrite rules. Returned: success |
|
Value of the rewrite. Returned: success Sample: |
|
Domain of the rewrite. Returned: success Sample: |