New in version 2.2.
- python >= 2.6
parameter | required | default | choices | comments |
---|---|---|---|---|
api_key |
no | API key of the Exoscale DNS API. | ||
api_region |
no | cloudstack | Name of the ini section in the cloustack.ini file. | |
api_secret |
no | Secret key of the Exoscale DNS API. | ||
api_timeout |
no | 10 | HTTP timeout to Exoscale DNS API. | |
content |
no | Content of the record. Required if state=present or name="" aliases: value, address | ||
domain |
yes | Domain the record is related to. | ||
multiple |
no | Whether there are more than one records with similar name .Only allowed with record_type=A .content will not be updated as it is used as key to find the record.aliases: priority | ||
name |
no | Name of the record. | ||
prio |
no | Priority of the record. aliases: priority | ||
record_type |
no | A |
|
Type of the record. aliases: rtype, type |
state |
no | present |
|
State of the record. |
ttl |
no | 3600 | TTL of the record in seconds. | |
validate_certs |
no | True | Validate SSL certs of the Exoscale DNS API. |
# Create or update an A record. - local_action: module: exo_dns_record name: web-vm-1 domain: example.com content: 1.2.3.4 # Update an existing A record with a new IP. - local_action: module: exo_dns_record name: web-vm-1 domain: example.com content: 1.2.3.5 # Create another A record with same name. - local_action: module: exo_dns_record name: web-vm-1 domain: example.com content: 1.2.3.6 multiple: yes # Create or update a CNAME record. - local_action: module: exo_dns_record name: www domain: example.com record_type: CNAME content: web-vm-1 # Create or update a MX record. - local_action: module: exo_dns_record domain: example.com record_type: MX content: mx1.example.com prio: 10 # delete a MX record. - local_action: module: exo_dns_record domain: example.com record_type: MX content: mx1.example.com state: absent # Remove a record. - local_action: module: exo_dns_record name: www domain: example.com state: absent
Common return values are documented here Return Values, the following are the fields unique to this module:
name | description | returned | type | sample |
---|---|---|---|---|
exo_dns_record | API record results | success | complex |
Note
CLOUDSTACK_KEY
, CLOUDSTACK_SECRET
environment variables. A CLOUDSTACK_CONFIG
environment variable pointing to an .ini
file, A cloudstack.ini
file in the current working directory. A .cloudstack.ini
file in the users home directory. Optionally multiple credentials and endpoints can be specified using ini sections in cloudstack.ini
. Use the argument api_region
to select the section name, default section is cloudstack
.This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
This module is community maintained without core committer oversight.
For more information on what this means please read Module Support
For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Helping Testing PRs and Developing Modules.