NAME

WebService::Linode - Perl Interface to the Linode.com API.

VERSION

Version 0.11

SYNOPSIS

my $api = WebService::Linode->new( apikey => 'your api key here');
print Dumper($api->linode_list);
$api->linode_reboot(linodeid=>242);

This module implements the Linode.com api methods. Linode methods have had dots replaced with underscores to generate the perl method name. All keys and parameters have been lower cased but returned data remains otherwise the same. For additional information see http://www.linode.com/api/autodoc.cfm

Methods from the Linode API

avail_stackscripts

Required Parameters:

Optional Parameters:

• distributionid

• keywords

• distributionvendor

avail_kernels

Required Parameters:

Optional Parameters:

• kernelid

• isxen

avail_linodeplans

Required Parameters:

Optional Parameters:

• planid

avail_datacenters

Required Parameters:

Optional Parameters:

avail_distributions

Required Parameters:

Optional Parameters:

• distributionid

domain_create

Required Parameters:

• type

• domain

Optional Parameters:

• refresh_sec

• retry_sec

• master_ips

• expire_sec

• soa_email

• axfr_ips

• description

• ttl_sec

• status

domain_delete

Required Parameters:

• domainid

Optional Parameters:

domain_update

Required Parameters:

• domainid

Optional Parameters:

• refresh_sec

• retry_sec

• master_ips

• type

• expire_sec

• domain

• soa_email

• axfr_ips

• description

• ttl_sec

• status

domain_list

Required Parameters:

Optional Parameters:

• domainid

domain_resource_create

Required Parameters:

• type

• domainid

Optional Parameters:

• protocol

• name

• weight

• target

• priority

• ttl_sec

• port

domain_resource_delete

Required Parameters:

• resourceid

• domainid

Optional Parameters:

domain_resource_update

Required Parameters:

• resourceid

Optional Parameters:

• weight

• target

• priority

• ttl_sec

• domainid

• port

• protocol

• name

domain_resource_list

Required Parameters:

• domainid

Optional Parameters:

• resourceid

linode_mutate

Required Parameters:

• linodeid

Optional Parameters:

linode_create

Required Parameters:

• datacenterid

• planid

• paymentterm

Optional Parameters:

linode_reboot

Required Parameters:

• linodeid

Optional Parameters:

• configid

linode_webconsoletoken

Required Parameters:

• linodeid

Optional Parameters:

linode_boot

Required Parameters:

• linodeid

Optional Parameters:

• configid

linode_resize

Required Parameters:

• linodeid

• planid

Optional Parameters:

linode_clone

Required Parameters:

• linodeid

• paymentterm

• datacenterid

• planid

Optional Parameters:

linode_shutdown

Required Parameters:

• linodeid

Optional Parameters:

linode_delete

Required Parameters:

• linodeid

Optional Parameters:

• skipchecks

linode_update

Required Parameters:

• linodeid

Optional Parameters:

• alert_diskio_threshold

• lpm_displaygroup

• watchdog

• alert_bwout_threshold

• ms_ssh_disabled

• ms_ssh_ip

• ms_ssh_user

• alert_bwout_enabled

• alert_diskio_enabled

• ms_ssh_port

• alert_bwquota_enabled

• alert_bwin_threshold

• backupweeklyday

• alert_cpu_enabled

• alert_bwquota_threshold

• backupwindow

• alert_cpu_threshold

• alert_bwin_enabled

• label

linode_list

Required Parameters:

Optional Parameters:

• linodeid

linode_config_create

Required Parameters:

• kernelid

• linodeid

• label

Optional Parameters:

• rootdevicero

• helper_disableupdatedb

• rootdevicenum

• comments

• rootdevicecustom

• devtmpfs_automount

• ramlimit

• runlevel

• helper_depmod

• helper_xen

• disklist

linode_config_delete

Required Parameters:

• linodeid

• configid

Optional Parameters:

linode_config_update

Required Parameters:

• configid

Optional Parameters:

• helper_disableupdatedb

• rootdevicero

• comments

• rootdevicenum

• rootdevicecustom

• kernelid

• runlevel

• ramlimit

• devtmpfs_automount

• helper_depmod

• linodeid

• helper_xen

• disklist

• label

linode_config_list

Required Parameters:

• linodeid

Optional Parameters:

• configid

linode_disk_create

Required Parameters:

• label

• size

• type

• linodeid

Optional Parameters:

linode_disk_resize

Required Parameters:

• diskid

• linodeid

• size

Optional Parameters:

linode_disk_createfromdistribution

Required Parameters:

• rootpass

• linodeid

• distributionid

• size

• label

Optional Parameters:

• rootsshkey

linode_disk_duplicate

Required Parameters:

• diskid

• linodeid

Optional Parameters:

linode_disk_delete

Required Parameters:

• linodeid

• diskid

Optional Parameters:

linode_disk_update

Required Parameters:

• diskid

Optional Parameters:

• linodeid

• label

• isreadonly

linode_disk_list

Required Parameters:

• linodeid

Optional Parameters:

• diskid

linode_disk_createfromstackscript

Required Parameters:

• size

• label

• linodeid

• stackscriptid

• distributionid

• rootpass

• stackscriptudfresponses

Optional Parameters:

linode_ip_addprivate

Required Parameters:

• linodeid

Optional Parameters:

linode_ip_list

Required Parameters:

• linodeid

Optional Parameters:

• ipaddressid

linode_job_list

Required Parameters:

• linodeid

Optional Parameters:

• pendingonly

• jobid

stackscript_create

Required Parameters:

• label

• distributionidlist

• script

Optional Parameters:

• rev_note

• description

• ispublic

stackscript_delete

Required Parameters:

• stackscriptid

Optional Parameters:

stackscript_update

Required Parameters:

• stackscriptid

Optional Parameters:

• distributionidlist

• description

• script

• ispublic

• rev_note

• label

stackscript_list

Required Parameters:

Optional Parameters:

• stackscriptid

nodebalancer_config_create

Required Parameters:

• nodebalancerid

Optional Parameters:

• protocol

• check

• check_path

• check_interval

• algorithm

• check_attempts

• stickiness

• check_timeout

• check_body

• port

nodebalancer_config_delete

Required Parameters:

• configid

Optional Parameters:

nodebalancer_config_update

Required Parameters:

• configid

Optional Parameters:

• check_body

• stickiness

• check_attempts

• check_timeout

• algorithm

• port

• check

• protocol

• check_path

• check_interval

nodebalancer_config_list

Required Parameters:

• nodebalancerid

Optional Parameters:

• configid

nodebalancer_node_create

Required Parameters:

• label

• address

• configid

Optional Parameters:

• mode

• weight

nodebalancer_node_delete

Required Parameters:

• nodeid

Optional Parameters:

nodebalancer_node_update

Required Parameters:

• nodeid

Optional Parameters:

• mode

• label

• address

• weight

nodebalancer_node_list

Required Parameters:

• configid

Optional Parameters:

• nodeid

user_getapikey

Required Parameters:

• username

• password

Optional Parameters:

Additional Helper Methods

These methods are deprecated and will be going away.

getDomainIDbyName( domain => 'example.com' )

Returns the ID for a domain given the name.

getDomainResourceIDbyName( domainid => 242, name => 'www')

Takes a record name and domainid or domain and returns the resourceid.

AUTHORS

• Michael Greb, <mgreb@linode.com>

• Stan "The Man" Schwertly <stan@linode.com>

COPYRIGHT & LICENSE

Copyright 2008-2009 Linode, LLC, all rights reserved.

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

cpanm WebService::Linode

perl -MCPAN -e shell
install WebService::Linode