f5os_dns – Manage DNS on F5OS Devices¶
New in version 1.8.0.
Parameters¶
| Parameter | Choices/Defaults | Configuration | Comments |
|---|---|---|---|
|
dns_domains
list
/ elements=string
|
An ordered list of domains to search when resolving a host name.
|
||
|
dns_servers
list
/ elements=string / required
|
Specifies List of the DNS servers that the resolver should query.
This parameter is required when creating a resource.
|
||
|
state
string
|
|
The sytem controller DNS config state.
If
present, creates the specified DNS Servers and Domains if it does not exist.If
absent, deletes the VLAN if it exists. |
Notes¶
Note
- This Modules will only make patch calls to add the DNS servers and domains.
- It does not support the deletion of difference DNS servers and domains from the existing list while updating,it just adds new entries.
- When state is
absentit will delete the DNS servers and domains from the user provided list.
Examples¶
- name: Create DNS Resolver config on controller
f5os_dns:
dns_servers:
- "10.10.10.10"
- "10.10.10.11"
- "10.10.10.12"
dns_domains:
- "test-domain1.com"
- "test-domain2.com"
- "test-domain3.com"
- name: Delete DNS Resolver config on controller
f5os_dns:
dns_servers:
- "10.10.10.10"
- "10.10.10.11"
- "10.10.10.12"
dns_domains:
- "test-domain1.com"
- "test-domain2.com"
- "test-domain3.com"
state: absent
Return Values¶
The following are the fields unique to this module:
| Key | Returned | Description |
|---|---|---|
|
dns_domains
list
|
changed |
The ID of the VLAN.
Sample:
['test-domain2.com']
|
|
dns_servers
list
|
changed |
List of the DNS servers that the resolver should query.
Sample:
['10.10.10.13', '10.10.10.14']
|