New in version 1.3.
- hashlib
- hmac
parameter | required | default | choices | comments |
---|---|---|---|---|
account_key |
yes |
Account API Key.
|
||
account_secret |
yes |
Account Secret Key.
|
||
autoFailover (added in 2.4) |
yes | no |
|
If true, fallback to the primary IP address is manual after a failover.
If false, fallback to the primary IP address is automatic after a failover.
|
contactList (added in 2.4) |
yes |
Name or id of the contact list that the monitor will notify.
The default
'' means the Account Owner. |
||
domain |
yes |
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
|
||
failover (added in 2.4) |
yes | no |
|
If
yes , add or change the failover. This is applicable only for A records. |
httpFile (added in 2.4) |
no |
The file at the Fqdn that the monitor queries for HTTP or HTTPS.
|
||
httpFqdn (added in 2.4) |
no |
The fully qualified domain name used by the monitor.
|
||
httpQueryString (added in 2.4) |
no |
The string in the httpFile that the monitor queries for HTTP or HTTPS.
|
||
ip1 (added in 2.4) |
no |
Primary IP address for the failover.
Required if adding or changing the monitor or failover.
|
||
ip2 (added in 2.4) |
no |
Secondary IP address for the failover.
Required if adding or changing the failover.
|
||
ip3 (added in 2.4) |
no |
Tertiary IP address for the failover.
|
||
ip4 (added in 2.4) |
no |
Quaternary IP address for the failover.
|
||
ip5 (added in 2.4) |
no |
Quinary IP address for the failover.
|
||
maxEmails (added in 2.4) |
yes | 1 |
Number of emails sent to the contact list by the monitor.
|
|
monitor (added in 2.4) |
yes | no |
|
If
yes , add or change the monitor. This is applicable only for A records. |
port (added in 2.4) |
yes | 80 |
Port used by the monitor.
|
|
protocol (added in 2.4) |
yes | HTTP |
|
Protocol used by the monitor.
|
record_name |
no |
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 |
no | 1800 |
record's "Time to live". Number of seconds the record remains cached in DNS servers.
|
|
record_type |
no |
|
Record type.
|
|
record_value |
no |
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)
|
||
sensitivity (added in 2.4) |
yes | Medium |
|
Number of checks the monitor performs before a failover occurs where Low = 8, Medium = 5,and High = 3.
|
state |
yes |
|
whether the record should exist or not
|
|
systemDescription (added in 2.4) |
yes |
Description used by the monitor.
|
||
validate_certs (added in 1.5.1) |
no | yes |
|
If
no , SSL certificates will not be validated. This should only be used on personally controlled sites using self-signed certificates. |
# 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.0.2.23 # 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 # Add a failover - dnsmadeeasy: account_key: key account_secret: secret domain: my.com state: present record_name: test record_type: A record_value: 127.0.0.1 failover: True ip1: 127.0.0.2 ip2: 127.0.0.3 - dnsmadeeasy: account_key: key account_secret: secret domain: my.com state: present record_name: test record_type: A record_value: 127.0.0.1 failover: True ip1: 127.0.0.2 ip2: 127.0.0.3 ip3: 127.0.0.4 ip4: 127.0.0.5 ip5: 127.0.0.6 # Add a monitor - dnsmadeeasy: account_key: key account_secret: secret domain: my.com state: present record_name: test record_type: A record_value: 127.0.0.1 monitor: yes ip1: 127.0.0.2 protocol: HTTP # default port: 80 # default maxEmails: 1 systemDescription: Monitor Test A record contactList: my contact list # Add a monitor with http options - dnsmadeeasy: account_key: key account_secret: secret domain: my.com state: present record_name: test record_type: A record_value: 127.0.0.1 monitor: yes ip1: 127.0.0.2 protocol: HTTP # default port: 80 # default maxEmails: 1 systemDescription: Monitor Test A record contactList: 1174 # contact list id httpFqdn: http://my.com httpFile: example httpQueryString: some string # Add a monitor and a failover - dnsmadeeasy: account_key: key account_secret: secret domain: my.com state: present record_name: test record_type: A record_value: 127.0.0.1 failover: True ip1: 127.0.0.2 ip2: 127.0.0.3 monitor: yes protocol: HTTPS port: 443 maxEmails: 1 systemDescription: monitoring my.com status contactList: emergencycontacts # Remove a failover - dnsmadeeasy: account_key: key account_secret: secret domain: my.com state: present record_name: test record_type: A record_value: 127.0.0.1 failover: no # Remove a monitor - dnsmadeeasy: account_key: key account_secret: secret domain: my.com state: present record_name: test record_type: A record_value: 127.0.0.1 monitor: no
Note
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Testing Ansible and Developing Modules.