ANSIBLE.DNSMADEEASY(3)          ANSIBLE MODULES         ANSIBLE.DNSMADEEASY(3)



NAME
       dnsmadeeasy - Interface with dnsmadeeasy.com (a DNS hosting service).

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:
       http://www.dnsmadeeasy.com/services/rest-api/

OPTIONS
       account_key
              Accout API Key.(required)

       account_secret
              Accout Secret Key.(required)

       domain 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)

       record_name
              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.

       record_ttl
              record's "Time to live".  Number of seconds the record remains
              cached in DNS servers. (default: 1800)

       record_type
              Record type.  Choices: A,AAAA,CNAME,HTTPRED,MX,NS,PTR,SRV,TXT.

       record_value
              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)

       state  whether the record should exist or not Choices:
              present,absent.(required).

NOTES
       The DNS Made Easy service requires that machines interacting with the
       API have the proper time and timezone set. Be sure you are within a few
       seconds of actual time by using NTP.

       This module returns record(s) in the "result" element when 'state' is
       set to 'present'. This value can be be registered and used in your
       playbooks.

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

       # 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"

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

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

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



AUTHOR
       Brice Burgess

SEE ALSO
       ansible(1), http://ansible.github.com/modules.html#dnsmadeeasy



1.4.5                             2014-02-12            ANSIBLE.DNSMADEEASY(3)
