Skip to main content

A simple CLI client for AuroraDNS

Project description


A command line api client for PCextreme's AuroraDNS service based on Apache Libcloud.


usage: [action] [arguments] (--help for more information)

AuroraDNS Command Line Interface

positional arguments:
                        Specify the action to perform.

optional arguments:
  -h, --help            show this help message and exit
  --details             print details
  --extras              print extras
  --force               do not prompt

  --apikey APIKEY, -a APIKEY
                        dns api key
  --secretkey SECRETKEY, -s SECRETKEY
                        dns secret key

record arguments:
  -n NAME, --name NAME  dns name field, defaults to apex
  -d DATA, --data DATA  dns data/content field
  -p PRIO, --prio PRIO  dns record PRIO, mandatory for MX and SRV record types
  -t TYPE, --type TYPE  dns record type, defaults to A/AAAA based on DATA, mandatory otherwise
  --ttl TTL             dns record TTL
  --recordid RECORDID   dns record ID

zone arguments:
  -z ZONE, --zone ZONE  dns ZONE name
  --zoneid ZONEID       dns zone ID


List all records in a zone:

./ get-record
name              type       priority   ttl        data
----------------- ---------- ---------- ---------- ----------------------------------------------------------------------
@                 A                     900
*                 A                     900
@                 AAAA                  900        2001:db8:1337::5054:efff:fe0c:c675
*                 AAAA                  900        2001:db8:1337::5054:efff:fe0c:c675
@                 MX         10         900
@                 MX         20         900
@                 NS                    3600
@                 NS                    3600
@                 NS                    3600
@                 SOA                   4800 2019011401 86400 7200 604800 300

Filter on specific record types and ttl:

./ get-record --type=AAAA --ttl=900
name          type       priority   ttl        data
------------- ---------- ---------- ---------- ----------------------------------
@             AAAA                  900        2001:db8:1337::5054:efff:fe0c:c675
*             AAAA                  900        2001:db8:1337::5054:efff:fe0c:c675

Create a new dns-record, IPv6 and IPv4 records are validated and record type is automatically set to AAAA or A if not specified. TTL defaults to zone default:

./ create-record --name=test123 --data=2001:db8:1337:dbfd:5054:3eff:feba:c1f3
Record created: 3600 IN AAAA 2001:db8:1337:dbfd:5054:3eff:feba:c1f3

Delete a record, multiple records can be removed if the filters return multiple results:

./ delete-record --name=mysubdomain --type=A
name                 type       priority   ttl        data
-------------------- ---------- ---------- ---------- ----------------------------
mysubdomain          AAAA                  3600       2001:db8:1337::5054:15ff:feb8:6a0e

Warning, you are about to delete the records shown above, this cannot be undone.
Type _uppercase_ yes to confirm: YES

Deleted record id 9f020b67-5b77-46e8-832c-0792280e3260: 3600 IN A

Automatically create or update AAAA-/A-records for the host

./ set-hostname
Record created: 3600 IN AAAA 2001:db8:1337::5054:15ff:feb8:6a0e
Record updated: 3600 IN A


You can either pass the --apikey APIKEY and --secretkey SECRETKEY command line argumenrs or set the DNS_API_KEY and DNS_SECRET_KEY environment variables:



pip3 install auroradns-cli


Ubuntu 16+

apt install python3 python3-pip python3-dev

CentOS 7

yum install python3 python3-pip python3-devel


  • MIT License

This is my first python project ever so there's probably a lot of code in here that doesn't even come close to being pythonic and some design choices that may seem very strange but they seemed logical to me at the time. So no guarantees on this whatsoever, use at your own risk. If this works for you, great, enjoy! If not, send me a message and I'll try to fix the issue.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

auroradns-cli-0.3.3.tar.gz (10.0 kB view hashes)

Uploaded source

Built Distribution

auroradns_cli-0.3.3-py3-none-any.whl (11.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page