Skip to content
RimuHosting Python DNS tools
Python
Find file
Latest commit c6a8e94 Jun 25, 2013 @abdallah Merge pull request #1 from abestic9/master
cleaned README

README.md

RimuDNS

RimuHosting Python DNS tools

Documentation for the API can be found here and here for RimuHosting and Zonomi respectively.

The RimuDNS class is a wrapper around the REST API calls.

Installation

easy_install rimudns

or

pip install rimudns

Usage

The API key can be generated and replaced in the RimuHosting control panel from https://rimuhosting.com/cp/apikeys.jsp

Get started:

#!/usr/bin/env python
from rimudns import RimuDNS
api_key = 'GETYOURAPIKEYFROMTHECONTROLPANEL'
dns = RimuDNS(api_key)
dns.use_rimuhosting()

List all domains:

for domain in dns.list_zones():
    print domain['name']

Create a new domain:

dns.create_zone('example.com')

Delete a domain:

dns.delete_zone('example.com')

Import a domain from a BIND zone file or string:

  • IMPORT_AXFR = 1
  • IMPORT_FILE = 2
  • IMPORT_TEXT = 3
  • IMPORT_DICT = 4
  • IMPORT_GUESS = 5

for more information about IMPORT_GUESS see [Guessing Feature] below.

from rimudns import ZoneHandle
dns.import_zone('example.com', ZoneHandle.IMPORT_FILE, '/tmp/example.com.zone')

Export a domain to file:

dnsdns.to_file('/tmp/example.com.zone')

Delete a domain:

dns.delete_zone('example.com')

List all records for a domain:

records = dns.list_records('example.com')
for record_type in records:
    print 'Type: ', record_type
    for record in records[record_type]
        print 'name: %s -> %s' % (record['name'], record['content')

Add/Update a record::

dns.set_record('example.com', '127.0.0.1', record_type='A', ttl=600)

Delete a record::

dns.delete_record('example.com', '127.0.0.1', 'A')

Change an IP across all zones::

old_ip = '127.0.0.1'
new_ip = '127.0.0.2'
dns.change_ip(old_ip, new_ip)

Convert a zone to slave/back to regular::

dns.convert_to_regular('example.com')
dns.convert_to_slave('example.com')

Web Interface

You can always use the RimuHosting/Zonomi tools to edit your DNS zones.

Guessing Feature

Most of the time you don't have access to AXFR or the Zone File to import the DNS zone directly. The import_zone offers a guessing feature that tries to build the zone information from DNS queries.

You can also provide extra guesses.

extra_guesses = ['mail2', 'test', 'test1']
records = dns.import_zone('funinc.org', ZoneHandle.IMPORT_GUESS, param=extra_guesses, dryrun=True)
for record_type in records:
    print 'Type: ', record_type
    for record in records[record_type]
        print 'name: %s -> %s' % (record['name'], record['content')
Something went wrong with that request. Please try again.