rackspace-dns-cli

Command line tool for Rackspace Cloud DNS - not endorsed by Rackspace

The guts of the code has been copied from the python-novaclient project.

You should read the Rackspace DNS documetation at http://docs.rackspace.com/

Quick Install: - Download - Make sure you have python-setuptools (yum install python-setuptools) - python setup.py install - (export variables below, or specify command line options) - rackdns help

Installing this package gets you a shell command, rackdns, that you can use to interact with the Rackspace DNS API.

You'll need to provide your Rackspace username and api key. You can do this with the --os-username, --os-password and --os-tenant-name params, but it's easier to just set them as environment variables::

export OS_USERNAME=user
export OS_PASSWORD=yadayada
export OS_TENANT_NAME=123456

You will also need to define the authentication url with --nova-url.
And explictly state you are using the Rackspace Auth system.
Or set them as an environment variables as well::

export OS_AUTH_URL=http://auth.api.rackspacecloud.com/v2.0/
export NOVA_RAX_AUTH=1

You'll find the complete documentation on the shell by running rackdns help::

usage: rackdns [--version] [--debug] [--os-username <auth-user-name>]
               [--os-password <auth-password>]
               [--os-tenant-name <auth-tenant-name>]
               [--os-auth-url <auth-url>]
               [--no-cache] [--insecure]
              <subcommand> ...

Command-line interface to the Rackspace DNS API.

Positional arguments:
	<subcommand>
		domain-create       Create a new domain.
		domain-delete       Delete a domain by name.
		domain-export       Export details of the specified domain.
		domain-list         Print a list of available domains.
		domain-modify       Modify a domain.
		domain-show         Show details about the given domain
		limits              List all applicable limits.
		rdns-create         Add a reverse DNS record to the specified domain.
		rdns-delete         Remove one or all PTR records associated with a
                    		Rackspace Cloud device. Use the optional ip parameter
                    		to specify a specific record to delete. Omitting this
                    		parameter removes all PTR records associated with the
                    		specified device.
		rdns-list           List all PTR records configured for the specified
                    		Cloud Server.
		rdns-modify         Modify a reverse DNS record to the specified domain.
		record-create       Add new record to the specified domain.
		record-delete       Delete a record of the specified domain.
		record-list         Print a list of records for the given domain.
		record-modify       Modify a record of the specified domain.
		subdomain-list      Print a list of available sub-domains for the given
                    		domain.
		help                Display help about this program or one of its
                        	subcommands.

Optional arguments:
  --version             show program's version number and exit
  --debug               Print debugging output
  --os-username <auth-user-name>
                        Defaults to env[OS_USERNAME].
  --os-password <auth-password>
                        Defaults to env[OS_PASSWORD].
  --os-tenant-name <auth-tenant-name>
                        Defaults to env[OS_TENANT_NAME].
  --os-auth-url <auth-url>
                        Defaults to env[OS_AUTH_URL].
  --no-cache            Don't use the auth token cache.
  --insecure            Explicitly allow dnsclient to perform "insecure" SSL
                        (https) requests. The server's certificate will not be
                        verified against any certificate authorities. This
                        option should be used with caution.

See "rackdns help COMMAND" for help on a specific command.