community.general.ipwcli_dns (8.5.0) — module

Install collection

Install with ansible-galaxy collection install community.general:==8.5.0

Add to requirements.yml

  collections:
    - name: community.general
      version: 8.5.0

Description

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

Requirements

• ipwcli (installed on Ericsson IPWorks)

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

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

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- 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

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- 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

Inputs

    
ttl:
    default: 3600
    description:
    - Sets the TTL of the record.
    type: int

port:
    description:
    - Sets the port of the SRV record.
    - Required for O(type=SRV).
    type: int

type:
    choices:
    - NAPTR
    - SRV
    - A
    - AAAA
    description:
    - Type of the record.
    required: true
    type: str

flags:
    choices:
    - S
    - A
    - U
    - P
    description:
    - Sets one of the possible flags of NAPTR record.
    - Required for O(type=NAPTR).
    type: str

order:
    description:
    - Sets the order of the NAPTR record.
    - Required for O(type=NAPTR).
    type: int

state:
    choices:
    - absent
    - present
    default: present
    description:
    - Whether the record should exist or not.
    type: str

target:
    description:
    - Sets the target of the SRV record.
    - Required for O(type=SRV).
    type: str

weight:
    default: 10
    description:
    - Sets the weight of the SRV record.
    type: int

address:
    description:
    - The IP address for the A or AAAA record.
    - Required for O(type=A) or O(type=AAAA).
    type: str

dnsname:
    description:
    - Name of the record.
    required: true
    type: str

service:
    description:
    - Sets the service of the NAPTR record.
    - Required for O(type=NAPTR).
    type: str

password:
    description:
    - Password to login on ipwcli.
    required: true
    type: str

priority:
    default: 10
    description:
    - Sets the priority of the SRV record.
    type: int

username:
    description:
    - Username to login on ipwcli.
    required: true
    type: str

container:
    description:
    - Sets the container zone for the record.
    required: true
    type: str

preference:
    description:
    - Sets the preference of the NAPTR record.
    - Required for O(type=NAPTR).
    type: int

replacement:
    description:
    - Sets the replacement of the NAPTR record.
    - Required for O(type=NAPTR).
    type: str

Outputs

record:
  description: The created record from the input params
  returned: always
  type: str