WebService::DNSwatch - Perl interface to the DNSwatch API
Version 0.02
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'); ...
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".
Adds a new domain.
$dnswatch->add_domain(domain => 'example.com');
(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).
Deletes a domain.
$dnswatch->delete_domain(domain => 'example.com');
Adds a new record.
$dnswatch->add_record(domain => 'example.com', record => 'www.example.com', type => 'A', data => '12.34.56.78')
(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).
Deletes a record.
$dnswatch->delete_record(domain => 'example.com', record => 'mail.example.com', type => 'MX');
(Required) Record type.
C Hutchinson, <taint at cpan.org>
<taint at cpan.org>
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.
bug-webservice-dnswatch at rt.cpan.org
You can find documentation for this module with the perldoc command.
perldoc WebService::DNSwatch
You can also look for information at:
RT: CPAN's request tracker
http://rt.cpan.org/NoAuth/Bugs.html?Dist=WebService-DNSwatch
AnnoCPAN: Annotated CPAN documentation
http://annocpan.org/dist/WebService-DNSwatch
CPAN Ratings
http://cpanratings.perl.org/d/WebService-DNSwatch
Search CPAN
http://search.cpan.org/dist/WebService-DNSwatch
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.
To install WebService::DNSwatch, copy and paste the appropriate command in to your terminal.
cpanm
cpanm WebService::DNSwatch
CPAN shell
perl -MCPAN -e shell install WebService::DNSwatch
For more information on module installation, please visit the detailed CPAN module installation guide.