NAME

WebService::EditDNS - Perl interface to EditDNS API

VERSION

Version 0.11

SYNOPSIS

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

    use WebService::EditDNS;

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

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

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

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

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

METHODS

new

Creates a new instance of WebService::EditDNS.

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

Parameters:

• email

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

• apihash

  (Required) API hash generated for the EditDNS 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.

    $editdns->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.

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

Parameters:

• domain

  (Required) Domain name.

add_record

Adds a new record.

    $editdns->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.

    $editdns->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

Michal Wojciechowski, <odyniec at cpan.org>

BUGS

Please report any bugs or feature requests to bug-webservice-editdns at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=WebService-EditDNS. 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::EditDNS

You can also look for information at:

• RT: CPAN's request tracker

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=WebService-EditDNS

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/WebService-EditDNS

• CPAN Ratings

  http://cpanratings.perl.org/d/WebService-EditDNS

• Search CPAN

  http://search.cpan.org/dist/WebService-EditDNS

COPYRIGHT & LICENSE

Copyright 2010 Michal Wojciechowski, all rights reserved.

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