New in version 1.5.
- python >= 2.6
- pyrax
parameter | required | default | choices | comments |
---|---|---|---|---|
api_key |
no | Rackspace API key, overrides credentials.
aliases: password | ||
comment |
no | Brief description of the domain. Maximum length of 160 characters | ||
credentials |
no | File to find the Rackspace credentials in. Ignored if api_key and username are provided.
aliases: creds_file | ||
email |
no | Email address of the domain administrator | ||
env (added in 1.5) |
no | Environment as configured in ~/.pyrax.cfg, see https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#pyrax-configuration. | ||
name |
no | Domain name to create | ||
region |
no | DFW | Region to create an instance in. | |
state |
no | present |
|
Indicate desired state of the resource |
ttl |
no | 3600 | Time to live of domain in seconds | |
username |
no | Rackspace username, overrides credentials. | ||
verify_ssl (added in 1.5) |
no | Whether or not to require SSL validation of API endpoints. |
- name: Create domain hosts: all gather_facts: False tasks: - name: Domain create request local_action: module: rax_dns credentials: ~/.raxpub name: example.org email: admin@example.org register: rax_dns
Note
serial: 1
to avoid exceeding the API request limit imposed by the Rackspace CloudDNS APIRAX_USERNAME
, RAX_API_KEY
, RAX_CREDS_FILE
, RAX_CREDENTIALS
, RAX_REGION
.RAX_CREDENTIALS
and RAX_CREDS_FILE
points to a credentials file appropriate for pyrax. See https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#authenticatingRAX_USERNAME
and RAX_API_KEY
obviate the use of a credentials fileRAX_REGION
defines a Rackspace Public Cloud region (DFW, ORD, LON, ...)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.