vultr_dns_domain – Manages DNS domains on Vultr¶
New in version 2.5.
Requirements¶
The below requirements are needed on the host that executes this module.
- python >= 2.6
Parameters¶
| Parameter | Choices/Defaults | Comments | 
|---|---|---|
| api_account 
                    string
                                                                 | Default: "default" | Name of the ini section in the  vultr.inifile.The ENV variable  VULTR_API_ACCOUNTis used as default, when defined. | 
| api_endpoint 
                    string
                                                                 | URL to API endpint (without trailing slash). The ENV variable  VULTR_API_ENDPOINTis used as default, when defined.Fallback value is https://api.vultr.com if not specified. | |
| api_key 
                    string
                                                                 | API key of the Vultr API. The ENV variable  VULTR_API_KEYis used as default, when defined. | |
| api_retries 
                    integer
                                                                 | Amount of retries in case of the Vultr API retuns an HTTP 503 code. The ENV variable  VULTR_API_RETRIESis used as default, when defined.Fallback value is 5 retries if not specified. | |
| api_retry_max_delay 
                    integer
                                                                 added in 2.9 | Retry backoff delay in seconds is exponential up to this max. value, in seconds. The ENV variable  VULTR_API_RETRY_MAX_DELAYis used as default, when defined.Fallback value is 12 seconds. | |
| api_timeout 
                    integer
                                                                 | HTTP timeout to Vultr API. The ENV variable  VULTR_API_TIMEOUTis used as default, when defined.Fallback value is 60 seconds if not specified. | |
| name 
                    -
                                             / required                     | The domain name. aliases: domain | |
| server_ip 
                    -
                                                                 | The default server IP. Use vultr_dns_record to change it once the domain is created. Required if  state=present. | |
| state 
                    -
                                                                 | 
 | State of the DNS domain. | 
| validate_certs 
                    boolean
                                                                 | 
 | Validate SSL certs of the Vultr API. | 
Notes¶
Note
- Also see the API documentation on https://www.vultr.com/api/.
Examples¶
- name: Ensure a domain exists
  local_action:
    module: vultr_dns_domain
    name: example.com
    server_ip: 10.10.10.10
- name: Ensure a domain is absent
  local_action:
    module: vultr_dns_domain
    name: example.com
    state: absent
Return Values¶
Common return values are documented here, the following are the fields unique to this module:
Status¶
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors¶
- René Moser (@resmo)
Hint
If you notice any issues in this documentation, you can edit this document to improve it.
