C Hutchinson

NAME

WebService::DNSwatch - Perl interface to the DNSwatch API

VERSION

Version 0.02

SYNOPSIS

WebService::DNSwatch provides an interface to the DNSwatch API, allowing for control of domains and records hosted at DNSwatch.

    use WebService::DNSwatch;

    # Create a new instance of WebService::DNSwatch
    my $editdns = WebService::DNSwatch->new(email => 'your@email.address',
                                           apihash => 'your_API_hash');

    # Add a new domain
    $dnswatch->add_domain(domain => 'example.com');

    # Add a type A record
    $dnswatch->add_record(domain => 'example.com',
                         record => 'www.example.com',
                         type => 'A',
                         data => '12.34.56.78');

    # Delete a record
    $dnswatch->delete_record(domain => 'example.com',
                            record => 'www.example.com',
                            type => 'A');

    # Delete a domain
    $dnswatch->delete_domain(domain => 'example.com');

    ...

METHODS

new

Creates a new instance of WebService::DNSwatch.

    my $dnswatch = WebService::DNSwatch->new(email => 'your@email.address',
                                           apihash => 'your_API_hash');

Parameters:

  • email

    (Required) E-mail address registered at DNSwatch.net.

  • apihash

    (Required) API hash generated for the DNSwatch account.

  • domain

    (Optional) Domain name. If specified in the constructor call, it can be ommitted in further calls to "add_record" and "delete_record".

add_domain

Adds a new domain.

    $dnswatch->add_domain(domain => 'example.com');

Parameters:

  • domain

    (Required) Domain name.

  • default_ip

    (Optional) Default IP address that the domain's root and www records will point to.

  • master_ns

    (Optional) The IP address or hostname of a master nameserver (for backup/slave domains).

delete_domain

Deletes a domain.

    $dnswatch->delete_domain(domain => 'example.com');

Parameters:

  • domain

    (Required) Domain name.

add_record

Adds a new record.

    $dnswatch->add_record(domain => 'example.com',
                         record => 'www.example.com',
                         type => 'A',
                         data => '12.34.56.78')

Parameters:

  • domain

    (Required) Domain name. Can be ommitted if set with "new".

  • record

    (Required) Record name.

  • type

    (Required) Record type (e.g., "A", "MX", "CNAME", etc.).

  • data

    (Required) Record data (e.g., IP address for a type A record).

  • ttl

    (Optional) TTL (time to live) value for the record.

  • aux

    (Optional) AUX value for the record (mostly used with MX records).

delete_record

Deletes a record.

    $dnswatch->delete_record(domain => 'example.com',
                            record => 'mail.example.com',
                            type => 'MX');

Parameters:

  • domain

    (Required) Domain name. Can be ommitted if set with "new".

  • record

    (Required) Record name.

  • type

    (Required) Record type.

AUTHOR

C Hutchinson, <taint at cpan.org>

BUGS

Please report any bugs or feature requests to bug-webservice-dnswatch at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=WebService-DNSwatch. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc WebService::DNSwatch

You can also look for information at:

COPYRIGHT & LICENSE

Copyright 1985-2013 C Hutchinson, all rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.