rax_dns - Manage domains on Rackspace Cloud DNS

Author:Matt Martz

Synopsis

New in version 1.5.

Manage domains on Rackspace Cloud DNS

Options

parameter required default choices comments
api_key no
    Rackspace API key (overrides credentials)
    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)
        email no
          env no
            Environment as configured in ~/.pyrax.cfg, see https://github.com/rackspace/pyrax/blob/master/docs/getting_started.md#pyrax-configuration (added in Ansible 1.5)
            name no
              Domain name to create
              region no DFW
                Region to create an instance in
                state no present
                • present
                • absent
                Indicate desired state of the resource
                ttl no 3600
                  Time to live of domain in seconds
                  username no
                    Rackspace username (overrides credentials)
                    verify_ssl no
                      Whether or not to require SSL validation of API endpoints (added in Ansible 1.5)

                      Note

                      Requires pyrax

                      Examples


                      - 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

                      It is recommended that plays utilizing this module be run with serial: 1 to avoid exceeding the API request limit imposed by the Rackspace CloudDNS API

                      Note

                      The following environment variables can be used, RAX_USERNAME, RAX_API_KEY, RAX_CREDS_FILE, RAX_CREDENTIALS, RAX_REGION.

                      Note

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

                      Note

                      RAX_USERNAME and RAX_API_KEY obviate the use of a credentials file

                      Note

                      RAX_REGION defines a Rackspace Public Cloud region (DFW, ORD, LON, ...)