README

Where to find a list of commands
-------------------------------
You can find an up to date list of all Linode API commands at http://www.linode.com/api/ 

Using the program
----------------
Run linode_bash_api -h for help it will output the following:
Linode Bash API 20110619
options:
-h      Help
-v      Verbose
-F arg     Response format, default json, options wddx or human
-k arg      API Key to use
-f arg      File to get API key from, key must be the only string on the first line
-c arg      The command to run, for a list of commands see http://www.linode.com/api
-d arg      A quote string containing the data to send in "foo=bar&foo2=bar2" format
-i arg      Get data from file if  - is used get data from stdin

If -k or -f are ommited or don't provide an API key then the following loctions are checked
/Users/rowan/.linode_api
/etc/linode/api

Detiails of commands you can run can be found at http://www.linode.com/api/

Examples
--------

1. Modify a disk of a specific linode
1.a List your linodes using
./linode_bash_api -c linode.list
1.b Get the linode ID from the returned results and run
./linode_bash_api -c linode.disk.list -d "linodeid=<id from 1.a>"
1.c Get the the disk ID from the returned results and run
./linode_bash_api -c linode.disk.update -d "linodeid=<id from 1.a>&diskid=<id from 1.b>&label=Label&isreadonly=1"
This will set the disk label to "Label" and make the disk read only.

Contribute
----------
To contirbute to this program please feel free to fork it and submit a pull request or raise an issue.
If you feel generous and would like to donate to the project you can send money via paypal to admin {at} rwky {dot} net or flattr me at https://flattr.com/thing/319205/Linode-Bash-API