The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
WebService-EditDNS-0.11
River stage zero No dependents
++
/ WebService::EditDNS

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:

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.