f5os_dns – Manage DNS on F5OS Devices

New in version 1.8.0.

Synopsis

  • Manage DNS Resolver Config Domains and Servers

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
    Choices:
  • present ←
  • absent
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 absent it 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']


Status

Authors

  • Ravinder Reddy (@chinthalapalli)