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
          name no
            Domain name to create
            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)

                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

                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, ...)