yadro.tatlin_uni.tatlin_sp_dns module – Configure SP DNS settings

Note

This module is part of the yadro.tatlin_uni collection (version 1.0.0).

You might already have this collection installed if you are using the ansible package. 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 yadro.tatlin_uni.

To use it in a playbook, specify: yadro.tatlin_uni.tatlin_sp_dns.

New in version 1.0.0: of yadro.tatlin_uni

Synopsis

  • This module is intended to configure DNS servers and DNS search list

  • This module supports check mode

Parameters

Parameter

Comments

connection

dictionary / required

connection describes Tatlin Storage Processor (SP) connection configuration.

Only session connection supported.

Authorization is executed automatically with corresponding endpoint. ‘auth/login’ by default.

Client receives x-auth-token and uses it for following requests.

base_url

string / required

Tatlin REST API entrypoint.

password

string

Tatlin user password.

timeout

integer

Tatlin REST API request timeout.

Default: 60

username

string

Tatlin username to login.

validate_certs

boolean

Responsible for SSL certificates validation.

If set to False certificates won’t validated.

Choices:

  • no

  • yes ← (default)

search_list

list / elements=string

List of DNS suffixes

servers

list / elements=string

List of DNS servers` addresses in format x.x.x.x

state

string

present sets listed DNS servers or DNS search list or both

absent deletes listed DNS servers or DNS search list or both

If no servers and no DNS suffixes listed with absent all servers addresses and DNS search list will be removed

Choices:

  • present ← (default)

  • absent

Examples

---
- name: Set DNS config
  yadro.tatlin_uni.tatlin_sp_dns:
    connection: "{{ connection }}"
    servers:
      - 127.0.0.1
      - 1.1.1.1
    search_list:
      - example.com
      - test.com

- name: Remove server
  yadro.tatlin_uni.tatlin_sp_dns:
    connection: "{{ connection }}"
    servers:
      - 1.1.1.1
    state: absent

- name: Remove suffix
  yadro.tatlin_uni.tatlin_sp_dns:
    connection: "{{ connection }}"
    search_list:
      - test.com
    state: absent

- name: Clear config
  yadro.tatlin_uni.tatlin_sp_dns:
    connection: "{{ connection }}"
    state: absent

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key

Description

error

string

Error details if raised

Returned: on error

msg

string

Operation status message

Returned: always

Authors

  • Sergey Kovalev (@kvlvs)