ansible.builtin.dnsmadeeasy (v2.3.3.0-1) — module

Install Ansible via pip

Install with pip install ansible==2.3.3.0.post1

Description

Manages DNS records via the v2 REST API of the DNS Made Easy service. It handles records only; there is no manipulation of domains or monitor/account support yet. See: U(https://www.dnsmadeeasy.com/integration/restapi/)

Requirements

• hashlib
• hmac

Usage examples

Scanned by Steampunk Spotter

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

# fetch my.com domain records
- dnsmadeeasy:
    account_key: key
    account_secret: secret
    domain: my.com
    state: present
  register: response

Scanned by Steampunk Spotter

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

# create / ensure the presence of a record
- dnsmadeeasy:
    account_key: key
    account_secret: secret
    domain: my.com
    state: present
    record_name: test
    record_type: A
    record_value: 127.0.0.1

Scanned by Steampunk Spotter

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

# update the previously created record
- dnsmadeeasy:
    account_key: key
    account_secret: secret
    domain: my.com
    state: present
    record_name: test
    record_value: 192.0.2.23

Scanned by Steampunk Spotter

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

# fetch a specific record
- dnsmadeeasy:
    account_key: key
    account_secret: secret
    domain: my.com
    state: present
    record_name: test
  register: response

Scanned by Steampunk Spotter

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

# delete a record / ensure it is absent
- dnsmadeeasy:
    account_key: key
    account_secret: secret
    domain: my.com
    state: absent
    record_name: test

Inputs

    
state:
    choices:
    - present
    - absent
    default: null
    description:
    - whether the record should exist or not
    required: true

domain:
    default: null
    description:
    - Domain to work with. Can be the domain name (e.g. "mydomain.com") or the numeric
      ID of the domain in DNS Made Easy (e.g. "839989") for faster resolution.
    required: true

record_ttl:
    default: 1800
    description:
    - record's "Time to live".  Number of seconds the record remains cached in DNS servers.
    required: false

account_key:
    default: null
    description:
    - Account API Key.
    required: true

record_name:
    default: null
    description:
    - Record name to get/create/delete/update. If record_name is not specified; all records
      for the domain will be returned in "result" regardless of the state argument.
    required: false

record_type:
    choices:
    - A
    - AAAA
    - CNAME
    - HTTPRED
    - MX
    - NS
    - PTR
    - SRV
    - TXT
    default: null
    description:
    - Record type.
    required: false

record_value:
    default: null
    description:
    - 'Record value. HTTPRED: <redirection URL>, MX: <priority> <target name>, NS: <name
      server>, PTR: <target name>, SRV: <priority> <weight> <port> <target name>, TXT:
      <text value>'
    - If record_value is not specified; no changes will be made and the record will be
      returned in 'result' (in other words, this module can be used to fetch a record's
      current id, type, and ttl)
    required: false

account_secret:
    default: null
    description:
    - Account Secret Key.
    required: true

validate_certs:
    choices:
    - 'yes'
    - 'no'
    default: 'yes'
    description:
    - If C(no), SSL certificates will not be validated. This should only be used on personally
      controlled sites using self-signed certificates.
    required: false
    version_added: 1.5.1
    version_added_collection: ansible.builtin