You are reading an unmaintained version of the Ansible documentation. Unmaintained Ansible versions can contain unfixed security vulnerabilities (CVE). Please upgrade to a maintained version. See the latest Ansible documentation.

community.general.ipwcli_dns module – Manage DNS Records for Ericsson IPWorks via ipwcli

Note

This module is part of the community.general collection (version 4.8.3).

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 community.general.

To use it in a playbook, specify: community.general.ipwcli_dns.

New in version 0.2.0: of community.general

Synopsis

• Manage DNS records for the Ericsson IPWorks DNS server. The module will use the ipwcli to deploy the DNS records.

Requirements

The below requirements are needed on the host that executes this module.

• ipwcli (installed on Ericsson IPWorks)

Parameters

Parameter	Comments
address string	The IP address for the A or AAAA record. Required for type=A or type=AAAA
container string / required	Sets the container zone for the record.
dnsname string / required	Name of the record.
flags string	Sets one of the possible flags of NAPTR record. Required for type=NAPTR Choices: S A U P
order integer	Sets the order of the NAPTR record. Required for type=NAPTR
password string / required	Password to login on ipwcli.
port integer	Sets the port of the SRV record. Required for type=SRV
preference integer	Sets the preference of the NAPTR record. Required for type=NAPTR
priority integer	Sets the priority of the SRV record. Default: 10
replacement string	Sets the replacement of the NAPTR record. Required for type=NAPTR
service string	Sets the service of the NAPTR record. Required for type=NAPTR
state string	Whether the record should exist or not. Choices: absent present ← (default)
target string	Sets the target of the SRV record. Required for type=SRV
ttl integer	Sets the TTL of the record. Default: 3600
type string / required	Type of the record. Choices: NAPTR SRV A AAAA
username string / required	Username to login on ipwcli.
weight integer	Sets the weight of the SRV record. Default: 10

Notes

Note

• To make the DNS record changes effective, you need to run update dnsserver on the ipwcli.

Examples

- name: Create A record
  community.general.ipwcli_dns:
    dnsname: example.com
    type: A
    container: ZoneOne
    address: 127.0.0.1

- name: Remove SRV record if exists
  community.general.ipwcli_dns:
    dnsname: _sip._tcp.test.example.com
    type: SRV
    container: ZoneOne
    ttl: 100
    state: absent
    target: example.com
    port: 5060

- name: Create NAPTR record
  community.general.ipwcli_dns:
    dnsname: test.example.com
    type: NAPTR
    preference: 10
    container: ZoneOne
    ttl: 100
    order: 10
    service: 'SIP+D2T'
    replacement: '_sip._tcp.test.example.com.'
    flags: S

Return Values

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

Key	Description
record string	The created record from the input params Returned: always

Authors

• Christian Wollinger (@cwollinger)

Collection links

Issue Tracker Repository (Sources) Submit a bug report Request a feature Communication