linodeapi 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1d86a47e855cda5413f6b29faecba76f7e172385
+  data.tar.gz: a9b0503891b6e0b161f1beb2c6b30f0c6e3b9fd4
+SHA512:
+  metadata.gz: ab7d282f83837b58d67a132b7991125ffb6733472b481be6c1efcd515fb76edf8f76c9b8cca71800cc8c56242416478104820a192d3d714c5aeb73213951c213
+  data.tar.gz: a8b5f02ba4c0e36442f382f572cb9720223ef0e2a40e130c6351d284c63dd90e65d034280532d407e61d40959d2ed3cba574e5d559e1784af6620addc5450a18

data/.gitignore

@@ -0,0 +1,4 @@
+pkg/*.gem
+coverage/
+.coveralls.yml
+.bundle

data/.rspec

@@ -0,0 +1,2 @@
+--format Fuubar
+--color

data/.rubocop.yml

@@ -0,0 +1,2 @@
+Encoding:
+    Enabled: false

data/.travis.yml

@@ -0,0 +1,14 @@
+language: ruby
+cache: bundler
+rvm:
+- 2.1.0
+- 2.0.0
+- 1.9.3
+notifications:
+  email: false
+  irc:
+    channels:
+      - ircs://irc.oftc.net:6697#akerl
+    channel_key: sekrit
+    template:
+      - '%{repository}/%{branch}/%{build_number}: %{message} -- %{build_url}'

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+gemspec
+

data/Gemfile.lock

@@ -0,0 +1,75 @@
+PATH
+  remote: .
+  specs:
+    linodeapi (0.0.1)
+      httparty
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (1.1.0)
+    coveralls (0.7.0)
+      multi_json (~> 1.3)
+      rest-client
+      simplecov (>= 0.7)
+      term-ansicolor
+      thor
+    diff-lcs (1.2.5)
+    docile (1.1.1)
+    fuubar (1.3.2)
+      rspec (>= 2.14.0, < 3.1.0)
+      ruby-progressbar (~> 1.3)
+    hashr (0.0.22)
+    httparty (0.12.0)
+      json (~> 1.8)
+      multi_xml (>= 0.5.2)
+    json (1.8.1)
+    mime-types (2.0)
+    multi_json (1.8.2)
+    multi_xml (0.5.5)
+    parser (2.1.2)
+      ast (~> 1.1)
+      slop (~> 3.4, >= 3.4.5)
+    powerpack (0.0.9)
+    rainbow (1.99.1)
+    rake (10.1.1)
+    rest-client (1.6.7)
+      mime-types (>= 1.16)
+    rspec (2.14.1)
+      rspec-core (~> 2.14.0)
+      rspec-expectations (~> 2.14.0)
+      rspec-mocks (~> 2.14.0)
+    rspec-core (2.14.7)
+    rspec-expectations (2.14.4)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.14.4)
+    rubocop (0.16.0)
+      parser (~> 2.1)
+      powerpack (~> 0.0.6)
+      rainbow (>= 1.1.4)
+    ruby-progressbar (1.4.0)
+    simplecov (0.8.2)
+      docile (~> 1.1.0)
+      multi_json
+      simplecov-html (~> 0.8.0)
+    simplecov-html (0.8.0)
+    slop (3.4.7)
+    term-ansicolor (1.2.2)
+      tins (~> 0.8)
+    thor (0.18.1)
+    tins (0.13.1)
+    travis-lint (1.7.0)
+      hashr (~> 0.0.22)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  coveralls
+  fuubar
+  linodeapi!
+  parser (~> 2.1.0.pre1)
+  rake
+  rspec
+  rubocop
+  travis-lint

data/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2013 Les Aker
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+

data/README.md

@@ -0,0 +1,21 @@
+linodeapi
+=========
+
+[![Gem Version](https://badge.fury.io/rb/linodeapi.png)](http://badge.fury.io/rb/linodeapi)
+[![Dependency Status](https://gemnasium.com/akerl/linodeapi.png)](https://gemnasium.com/akerl/linodeapi)
+[![Code Climate](https://codeclimate.com/github/akerl/linodeapi.png)](https://codeclimate.com/github/akerl/linodeapi)
+[![Coverage Status](https://coveralls.io/repos/akerl/linodeapi/badge.png?branch=master)](https://coveralls.io/r/akerl/linodeapi?branch=master)
+[![Build Status](https://travis-ci.org/akerl/linodeapi.png?branch=master)](https://travis-ci.org/akerl/linodeapi)
+
+Ruby API wrapper for the [Linode API](https://www.linode.com/api)
+
+## Usage
+
+## Installation
+
+    gem install linodeapi
+
+## License
+
+linodeapi is released under the MIT License. See the bundled LICENSE file for details.
+

data/Rakefile

@@ -0,0 +1,25 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+require 'rubocop/rake_task'
+
+desc 'Update bundle'
+task :bundle do
+  `bundle update`
+end
+
+desc 'Run tests'
+RSpec::Core::RakeTask.new(:spec)
+
+desc 'Run Rubocop on the gem'
+Rubocop::RakeTask.new(:rubocop) do |task|
+  task.patterns = ['lib/**/*.rb', 'spec/**/*.rb']
+  task.fail_on_error = true
+end
+
+desc 'Run travis-lint on .travis.yml'
+task :travislint do
+  print 'There is an issue with your .travis.yml' unless system('travis-lint')
+end
+
+task default: [:spec, :travislint, :rubocop, :build, :install]
+task release: [:bundle]

data/dev/update_spec.rb

@@ -0,0 +1,55 @@
+#!/usr/bin/env ruby
+
+require 'httparty'
+require 'pp'
+require 'erb'
+
+SPEC_PATH = 'lib/linodeapi/spec.rb'
+
+TEMPLATE = '##
+# Dynamically updated spec from the api.spec call
+# rubocop:disable all
+
+module LinodeAPI
+  SPEC =
+<%= clean %>
+end
+'
+
+raw = HTTParty.get('https://api.linode.com/?api_action=api.spec').body
+raw = JSON.parse(raw)['DATA']['METHODS']
+
+spec = raw.reduce(Hash.new) do |acc, (method, info)|
+  groups = method.split('.').map(&:to_sym)
+  name = groups.pop
+
+  params = info['PARAMETERS'].map do |k, v|
+    [
+      k.downcase.to_sym,
+      {
+        desc: v['DESCRIPTION'],
+        type: v['TYPE'].to_sym,
+        required: v['REQUIRED'],
+      }
+    ]
+  end
+
+  local = groups.reduce(acc) do |layout, new|
+    layout[new] ||= { type: :group, subs: {} }
+    layout[new][:subs]
+  end
+  local[name] = {
+    type: :call,
+    desc: info['DESCRIPTION'],
+    throws: info['THROWS'].split(','),
+    params: Hash[params],
+  }
+
+  acc
+end
+
+clean = ''
+PP.pp({ type: 'group', subs: spec }, clean)
+File.open(SPEC_PATH, 'w') { |fh| fh.write ERB.new(TEMPLATE).result }
+
+puts 'Updated spec file'

data/lib/linodeapi.rb

@@ -0,0 +1,22 @@
+##
+# Linode API wrapper
+
+module LinodeAPI
+  ##
+  # Default API endpoint
+
+  DEFAULT_ENDPOINT = 'https://api.linode.com/'
+
+  class << self
+    ##
+    # Insert a helper .new() method for creating a new API object
+
+    def new(*args)
+      self::API.new(*args)
+    end
+  end
+end
+
+require 'linodeapi/spec'
+require 'linodeapi/raw'
+require 'linodeapi/api'

data/lib/linodeapi/api.rb

@@ -0,0 +1,7 @@
+##
+# Friendlier Ruby interface to the Linode API
+
+module LinodeAPI
+  class API
+  end
+end

data/lib/linodeapi/raw.rb

@@ -0,0 +1,103 @@
+require 'httparty'
+
+##
+# Raw API wrapper, dynamically loaded from the published spec
+
+module LinodeAPI
+  ##
+  # Raw API object
+
+  class Raw
+    include HTTParty
+
+    attr_reader :apikey, :spec, :names
+
+    def initialize(params = {})
+      self.class.base_uri params.fetch(:endpoint, DEFAULT_ENDPOINT)
+      @names = params.fetch(:names) { [] }
+      @spec = params.fetch(:spec) { SPEC }
+      @apikey = params.fetch(:apikey) { authenticate(params).first }
+    end
+
+    def respond_to?(method, include_private = false)
+      super || @spec[:subs].include?(method)
+    end
+
+    def to_s
+      'LinodeAPI::Raw object'
+    end
+    alias_method :inspect, :to_s
+
+    private
+
+    def authenticate(params = {})
+      return [] unless @names.empty?
+      unless (params.values_at :username, :password).all?
+        fail ArgumentError, 'You must provide either an API key or user/pass'
+      end
+      user.getapikey(params).values_at :api_key
+    end
+
+    def method_missing(method, *args, &block)
+      return super unless respond_to? method
+      case @spec[:subs][method][:type]
+      when :group then make_group method
+      when :call then make_call method, *args
+      end
+    end
+
+    def make_group(method)
+      options = {
+        spec: @spec[:subs][method],
+        apikey: @apikey,
+        username: @username,
+        names: @names + [method]
+      }
+      instance_eval "def #{method}() @#{method} end"
+      instance_variable_set "@#{method}".to_sym, Raw.new(options)
+    end
+
+    def make_call(method, *args)
+      instance_eval "def #{method}(*args) call(:#{method}, *args) end"
+      send(method, *args)
+    end
+
+    def call(method, params = {})
+      spec = @spec[:subs][method]
+      method = (@names + [method.to_s]).join '.'
+      options = self.class.validate method, spec[:params], params
+      options.merge! api_key: @apikey, api_action: method
+      self.class.parse self.class.post('', body: options).parsed_response
+    end
+
+    def self.parse(resp)
+      unless resp['ERRORARRAY'].empty?
+        fail "API Error on #{resp['ACTION']}: #{resp['ERRORARRAY']}"
+      end
+      data = resp['DATA']
+      data.is_a?(Hash) ? clean(data) : data.map { |x| clean x }
+    end
+
+    def self.clean(object)
+      Hash[object.map { |k, v| [k.downcase.to_sym, v] }]
+    end
+
+    def self.validate(method, spec, given)
+      spec.each_with_object({}) do |(param, info), options|
+        if given.include? param
+          options[param] = VALIDATION_METHODS[info[:type]].call given[param]
+        else
+          fail ArgumentError, "#{method} requires #{param}" if info[:required]
+        end
+      end
+    end
+  end
+
+  private
+
+  VALIDATION_METHODS = {
+    boolean: proc { |e| e == true },
+    numeric: proc { |e| Integer(e) },
+    string: proc { |e| e.to_s },
+  }
+end

data/lib/linodeapi/spec.rb

@@ -0,0 +1,1176 @@
+##
+# Dynamically updated spec from the api.spec call
+# rubocop:disable all
+
+module LinodeAPI
+  SPEC =
+{:type=>"group",
+ :subs=>
+  {:linode=>
+    {:type=>:group,
+     :subs=>
+      {:list=>
+        {:type=>:call,
+         :desc=>
+          "Returns a list of all Linodes user has access or delete to, including some properties",
+         :throws=>[],
+         :params=>
+          {:linodeid=>
+            {:desc=>"Limits the list to the specified LinodeID",
+             :type=>:numeric,
+             :required=>false}}},
+       :disk=>
+        {:type=>:group,
+         :subs=>
+          {:delete=>
+            {:type=>:call,
+             :desc=>"",
+             :throws=>["NOTFOUND", "VALIDATION"],
+             :params=>
+              {:linodeid=>{:desc=>"", :type=>:numeric, :required=>true},
+               :diskid=>{:desc=>"", :type=>:numeric, :required=>true}}},
+           :update=>
+            {:type=>:call,
+             :desc=>"",
+             :throws=>["NOTFOUND", "VALIDATION"],
+             :params=>
+              {:label=>
+                {:desc=>"The display label for this Disk",
+                 :type=>:string,
+                 :required=>false},
+               :isreadonly=>
+                {:desc=>"Enable forced read-only for this Disk",
+                 :type=>:boolean,
+                 :required=>false},
+               :linodeid=>{:desc=>"", :type=>:numeric, :required=>false},
+               :diskid=>{:desc=>"", :type=>:numeric, :required=>true}}},
+           :create=>
+            {:type=>:call,
+             :desc=>"",
+             :throws=>["NOTFOUND", "VALIDATION"],
+             :params=>
+              {:label=>
+                {:desc=>"The display label for this Disk",
+                 :type=>:string,
+                 :required=>true},
+               :size=>
+                {:desc=>"The size in MB of this Disk.",
+                 :type=>:numeric,
+                 :required=>true},
+               :linodeid=>{:desc=>"", :type=>:numeric, :required=>true},
+               :type=>
+                {:desc=>
+                  "The formatted type of this disk.  Valid types are: ext3, swap, raw",
+                 :type=>:string,
+                 :required=>true}}},
+           :createfromstackscript=>
+            {:type=>:call,
+             :desc=>"",
+             :throws=>["NOTFOUND", "VALIDATION"],
+             :params=>
+              {:stackscriptudfresponses=>
+                {:desc=>
+                  "JSON encoded name/value pairs, answering this StackScript's User Defined Fields",
+                 :type=>:string,
+                 :required=>"yes"},
+               :distributionid=>
+                {:desc=>
+                  "Which Distribution to apply this StackScript to.  Must be one from the script's DistributionIDList",
+                 :type=>:numeric,
+                 :required=>true},
+               :rootpass=>
+                {:desc=>"The root user's password",
+                 :type=>:string,
+                 :required=>true},
+               :label=>
+                {:desc=>"The label of this new disk image",
+                 :type=>:string,
+                 :required=>true},
+               :size=>
+                {:desc=>"Size of this disk image in MB",
+                 :type=>:numeric,
+                 :required=>true},
+               :linodeid=>{:desc=>"", :type=>:numeric, :required=>true},
+               :stackscriptid=>
+                {:desc=>"The StackScript to create this image from",
+                 :type=>:numeric,
+                 :required=>"yes"}}},
+           :list=>
+            {:type=>:call,
+             :desc=>"",
+             :throws=>[],
+             :params=>
+              {:linodeid=>{:desc=>"", :type=>:numeric, :required=>true},
+               :diskid=>{:desc=>"", :type=>:numeric, :required=>false}}},
+           :createfromdistribution=>
+            {:type=>:call,
+             :desc=>"",
+             :throws=>["NOTFOUND", "VALIDATION"],
+             :params=>
+              {:rootsshkey=>
+                {:desc=>
+                  "Optionally sets this string into /root/.ssh/authorized_keys upon distribution configuration.",
+                 :type=>:string,
+                 :required=>false},
+               :label=>
+                {:desc=>"The label of this new disk image",
+                 :type=>:string,
+                 :required=>true},
+               :size=>
+                {:desc=>"Size of this disk image in MB",
+                 :type=>:numeric,
+                 :required=>true},
+               :distributionid=>
+                {:desc=>
+                  "The DistributionID to create this disk from.  Found in avail.distributions()",
+                 :type=>:numeric,
+                 :required=>true},
+               :linodeid=>{:desc=>"", :type=>:numeric, :required=>true},
+               :rootpass=>
+                {:desc=>"The root user's password",
+                 :type=>:string,
+                 :required=>true}}},
+           :duplicate=>
+            {:type=>:call,
+             :desc=>"Performs a bit-for-bit copy of a disk image.",
+             :throws=>["NOTFOUND", "VALIDATION"],
+             :params=>
+              {:linodeid=>{:desc=>"", :type=>:numeric, :required=>true},
+               :diskid=>{:desc=>"", :type=>:numeric, :required=>true}}},
+           :resize=>
+            {:type=>:call,
+             :desc=>"",
+             :throws=>["NOTFOUND", "VALIDATION"],
+             :params=>
+              {:size=>
+                {:desc=>"The requested new size of this Disk in MB",
+                 :type=>:numeric,
+                 :required=>true},
+               :linodeid=>{:desc=>"", :type=>:numeric, :required=>true},
+               :diskid=>{:desc=>"", :type=>:numeric, :required=>true}}}}},
+       :webconsoletoken=>
+        {:type=>:call,
+         :desc=>
+          "Generates a console token starting a web console LISH session for the requesting IP",
+         :throws=>["NOTFOUND", "VALIDATION"],
+         :params=>{:linodeid=>{:desc=>"", :type=>:numeric, :required=>true}}},
+       :create=>
+        {:type=>:call,
+         :desc=>
+          "Creates a Linode and assigns you full privileges. There is a 75-linodes-per-hour limiter.",
+         :throws=>
+          ["NOACCESS",
+           "CCFAILED",
+           "VALIDATION",
+           "LINODELIMITER",
+           "ACCOUNTLIMIT"],
+         :params=>
+          {:planid=>
+            {:desc=>"The desired PlanID available from avail.LinodePlans()",
+             :type=>:numeric,
+             :required=>true},
+           :paymentterm=>
+            {:desc=>
+              "Subscription term in months for non-metered customers.  One of: 1, 12, or 24",
+             :type=>:numeric,
+             :required=>false},
+           :datacenterid=>
+            {:desc=>
+              "The DatacenterID from avail.datacenters() where you wish to place this new Linode",
+             :type=>:numeric,
+             :required=>true}}},
+       :update=>
+        {:type=>:call,
+         :desc=>"Updates a Linode's properties.",
+         :throws=>["NOTFOUND", "VALIDATION"],
+         :params=>
+          {:ms_ssh_user=>{:desc=>"", :type=>:string, :required=>false},
+           :alert_cpu_enabled=>
+            {:desc=>"Enable the cpu usage email alert",
+             :type=>:boolean,
+             :required=>false},
+           :alert_bwin_enabled=>
+            {:desc=>"Enable the incoming bandwidth email alert",
+             :type=>:boolean,
+             :required=>false},
+           :alert_cpu_threshold=>
+            {:desc=>"CPU Alert threshold, percentage 0-800",
+             :type=>:numeric,
+             :required=>false},
+           :alert_bwquota_enabled=>
+            {:desc=>"Enable the bw quote email alert",
+             :type=>:boolean,
+             :required=>false},
+           :backupwindow=>{:desc=>"", :type=>:numeric, :required=>false},
+           :alert_diskio_threshold=>
+            {:desc=>"IO ops/sec", :type=>:numeric, :required=>false},
+           :backupweeklyday=>{:desc=>"", :type=>:numeric, :required=>false},
+           :label=>
+            {:desc=>"This Linode's label", :type=>:string, :required=>false},
+           :watchdog=>
+            {:desc=>"Enable the Lassie shutdown watchdog",
+             :type=>:boolean,
+             :required=>false},
+           :alert_diskio_enabled=>
+            {:desc=>"Enable the disk IO email alert",
+             :type=>:boolean,
+             :required=>false},
+           :ms_ssh_port=>{:desc=>"", :type=>:numeric, :required=>false},
+           :lpm_displaygroup=>
+            {:desc=>
+              "Display group in the Linode list inside the Linode Manager",
+             :type=>:string,
+             :required=>false},
+           :ms_ssh_disabled=>{:desc=>"", :type=>:boolean, :required=>false},
+           :alert_bwquota_threshold=>
+            {:desc=>"Percentage of monthly bw quota",
+             :type=>:numeric,
+             :required=>false},
+           :ms_ssh_ip=>{:desc=>"", :type=>:string, :required=>false},
+           :linodeid=>{:desc=>"", :type=>:numeric, :required=>true},
+           :alert_bwin_threshold=>
+            {:desc=>"Mb/sec", :type=>:numeric, :required=>false},
+           :alert_bwout_threshold=>
+            {:desc=>"Mb/sec", :type=>:numeric, :required=>false},
+           :alert_bwout_enabled=>
+            {:desc=>"Enable the outgoing bandwidth email alert",
+             :type=>:boolean,
+             :required=>false}}},
+       :ip=>
+        {:type=>:group,
+         :subs=>
+          {:list=>
+            {:type=>:call,
+             :desc=>"Lists a Linode's IP addresses.",
+             :throws=>["NOTFOUND"],
+             :params=>
+              {:ipaddressid=>
+                {:desc=>"If specified, limits the result to this IPAddressID",
+                 :type=>:numeric,
+                 :required=>false},
+               :linodeid=>{:desc=>"", :type=>:numeric, :required=>true}}},
+           :addprivate=>
+            {:type=>:call,
+             :desc=>
+              "Assigns a Private IP to a Linode.  Returns the IPAddressID that was added.",
+             :throws=>["NOTFOUND"],
+             :params=>
+              {:linodeid=>{:desc=>"", :type=>:numeric, :required=>true}}}}},
+       :clone=>
+        {:type=>:call,
+         :desc=>
+          "Creates a new Linode, assigns you full privileges, and then clones the specified LinodeID to the new Linode. There is a limit of 5 active clone operations per source Linode.  It is recommended that the source Linode be powered down during the clone.",
+         :throws=>
+          ["NOACCESS",
+           "NOTFOUND",
+           "CCFAILED",
+           "VALIDATION",
+           "LINODELIMITER",
+           "ACCOUNTLIMIT"],
+         :params=>
+          {:datacenterid=>
+            {:desc=>
+              "The DatacenterID from avail.datacenters() where you wish to place this new Linode",
+             :type=>:numeric,
+             :required=>true},
+           :paymentterm=>
+            {:desc=>
+              "Subscription term in months for non-metered customers.  One of: 1, 12, or 24",
+             :type=>:numeric,
+             :required=>false},
+           :planid=>
+            {:desc=>"The desired PlanID available from avail.LinodePlans()",
+             :type=>:numeric,
+             :required=>true},
+           :linodeid=>
+            {:desc=>"The LinodeID that you want cloned",
+             :type=>:numeric,
+             :required=>true}}},
+       :delete=>
+        {:type=>:call,
+         :desc=>
+          "Immediately removes a Linode from your account and issues a pro-rated credit back to your account, if applicable.  To prevent accidental deletes, this requires the Linode has no Disk images.  You must first delete its disk images.\"",
+         :throws=>["NOTFOUND", "LINODENOTEMPTY"],
+         :params=>
+          {:linodeid=>
+            {:desc=>"The LinodeID to delete",
+             :type=>:numeric,
+             :required=>true},
+           :skipchecks=>
+            {:desc=>
+              "Skips the safety checks and will always delete the Linode",
+             :type=>:boolean,
+             :required=>false}}},
+       :reboot=>
+        {:type=>:call,
+         :desc=>"Issues a shutdown, and then boot job for a given LinodeID.",
+         :throws=>["NOTFOUND"],
+         :params=>
+          {:linodeid=>{:desc=>"", :type=>:numeric, :required=>true},
+           :configid=>{:desc=>"", :type=>:numeric, :required=>false}}},
+       :config=>
+        {:type=>:group,
+         :subs=>
+          {:list=>
+            {:type=>:call,
+             :desc=>"Lists a Linode's Configuration Profiles.",
+             :throws=>["NOTFOUND"],
+             :params=>
+              {:linodeid=>{:desc=>"", :type=>:numeric, :required=>true},
+               :configid=>{:desc=>"", :type=>:numeric, :required=>false}}},
+           :delete=>
+            {:type=>:call,
+             :desc=>"Deletes a Linode Configuration Profile.",
+             :throws=>["NOTFOUND", "VALIDATION"],
+             :params=>
+              {:linodeid=>{:desc=>"", :type=>:numeric, :required=>true},
+               :configid=>{:desc=>"", :type=>:numeric, :required=>true}}},
+           :update=>
+            {:type=>:call,
+             :desc=>"Updates a Linode Configuration Profile.",
+             :throws=>["NOTFOUND", "VALIDATION"],
+             :params=>
+              {:rootdevicecustom=>
+                {:desc=>"A custom root device setting.",
+                 :type=>:string,
+                 :required=>false},
+               :comments=>
+                {:desc=>"Comments you wish to save along with this profile",
+                 :type=>:string,
+                 :required=>false},
+               :devtmpfs_automount=>
+                {:desc=>
+                  "Controls if pv_ops kernels should automount devtmpfs at boot. ",
+                 :type=>:boolean,
+                 :required=>false},
+               :helper_disableupdatedb=>
+                {:desc=>"Enable the disableUpdateDB filesystem helper",
+                 :type=>:boolean,
+                 :required=>false},
+               :label=>
+                {:desc=>"The Label for this profile",
+                 :type=>:string,
+                 :required=>false},
+               :configid=>{:desc=>"", :type=>:numeric, :required=>true},
+               :disklist=>
+                {:desc=>
+                  "A comma delimited list of DiskIDs; position reflects device node.  The 9th element for specifying the initrd.",
+                 :type=>:string,
+                 :required=>false},
+               :runlevel=>
+                {:desc=>"One of 'default', 'single', 'binbash' ",
+                 :type=>:string,
+                 :required=>false},
+               :rootdevicero=>
+                {:desc=>
+                  "Enables the 'ro' kernel flag.  Modern distros want this. ",
+                 :type=>:boolean,
+                 :required=>false},
+               :rootdevicenum=>
+                {:desc=>
+                  "Which device number (1-8) that contains the root partition.  0 to utilize RootDeviceCustom.",
+                 :type=>:numeric,
+                 :required=>false},
+               :helper_xen=>
+                {:desc=>
+                  "Enable the Xen filesystem helper.  Corrects fstab and inittab/upstart entries depending on the kernel you're booting.  You want this.",
+                 :type=>:boolean,
+                 :required=>false},
+               :ramlimit=>
+                {:desc=>"RAMLimit in MB.  0 for max.",
+                 :type=>:numeric,
+                 :required=>false},
+               :linodeid=>{:desc=>"", :type=>:numeric, :required=>false},
+               :kernelid=>
+                {:desc=>
+                  "The KernelID for this profile.  Found in avail.kernels()",
+                 :type=>:numeric,
+                 :required=>false},
+               :helper_depmod=>
+                {:desc=>
+                  "Creates an empty modprobe file for the kernel you're booting. ",
+                 :type=>:boolean,
+                 :required=>false}}},
+           :create=>
+            {:type=>:call,
+             :desc=>"Creates a Linode Configuration Profile.",
+             :throws=>["NOTFOUND", "VALIDATION"],
+             :params=>
+              {:rootdevicecustom=>
+                {:desc=>"A custom root device setting.",
+                 :type=>:string,
+                 :required=>false},
+               :comments=>
+                {:desc=>"Comments you wish to save along with this profile",
+                 :type=>:string,
+                 :required=>false},
+               :devtmpfs_automount=>
+                {:desc=>
+                  "Controls if pv_ops kernels should automount devtmpfs at boot. ",
+                 :type=>:boolean,
+                 :required=>false},
+               :helper_disableupdatedb=>
+                {:desc=>"Enable the disableUpdateDB filesystem helper",
+                 :type=>:boolean,
+                 :required=>false},
+               :label=>
+                {:desc=>"The Label for this profile",
+                 :type=>:string,
+                 :required=>true},
+               :disklist=>
+                {:desc=>
+                  "A comma delimited list of DiskIDs; position reflects device node.  The 9th element for specifying the initrd.",
+                 :type=>:string,
+                 :required=>false},
+               :runlevel=>
+                {:desc=>"One of 'default', 'single', 'binbash' ",
+                 :type=>:string,
+                 :required=>false},
+               :rootdevicero=>
+                {:desc=>
+                  "Enables the 'ro' kernel flag.  Modern distros want this. ",
+                 :type=>:boolean,
+                 :required=>false},
+               :rootdevicenum=>
+                {:desc=>
+                  "Which device number (1-8) that contains the root partition.  0 to utilize RootDeviceCustom.",
+                 :type=>:numeric,
+                 :required=>false},
+               :helper_xen=>
+                {:desc=>
+                  "Enable the Xen filesystem helper.  Corrects fstab and inittab/upstart entries depending on the kernel you're booting.  You want this.",
+                 :type=>:boolean,
+                 :required=>false},
+               :ramlimit=>
+                {:desc=>"RAMLimit in MB.  0 for max.",
+                 :type=>:numeric,
+                 :required=>false},
+               :linodeid=>{:desc=>"", :type=>:numeric, :required=>true},
+               :helper_depmod=>
+                {:desc=>
+                  "Creates an empty modprobe file for the kernel you're booting. ",
+                 :type=>:boolean,
+                 :required=>false},
+               :kernelid=>
+                {:desc=>
+                  "The KernelID for this profile.  Found in avail.kernels()",
+                 :type=>:numeric,
+                 :required=>true}}}}},
+       :resize=>
+        {:type=>:call,
+         :desc=>
+          "Resizes a Linode from one plan to another.  Immediately shuts the Linode down, charges/credits the account, and issue a migration to another host server.",
+         :throws=>["NOTFOUND", "CCFAILED", "VALIDATION"],
+         :params=>
+          {:planid=>
+            {:desc=>"The desired PlanID available from avail.LinodePlans()",
+             :type=>:numeric,
+             :required=>true},
+           :linodeid=>{:desc=>"", :type=>:numeric, :required=>true}}},
+       :job=>
+        {:type=>:group,
+         :subs=>
+          {:list=>
+            {:type=>:call,
+             :desc=>"",
+             :throws=>[],
+             :params=>
+              {:jobid=>
+                {:desc=>"Limits the list to the specified JobID",
+                 :type=>:numeric,
+                 :required=>false},
+               :linodeid=>{:desc=>"", :type=>:numeric, :required=>true},
+               :pendingonly=>
+                {:desc=>"", :type=>:boolean, :required=>false}}}}},
+       :boot=>
+        {:type=>:call,
+         :desc=>
+          "Issues a boot job for the provided ConfigID.  If no ConfigID is provided boots the last used configuration profile, or the first configuration profile if this Linode has never been booted.",
+         :throws=>["NOTFOUND"],
+         :params=>
+          {:linodeid=>{:desc=>"", :type=>:numeric, :required=>true},
+           :configid=>
+            {:desc=>
+              "The ConfigID to boot, available from linode.config.list().",
+             :type=>:numeric,
+             :required=>false}}},
+       :mutate=>
+        {:type=>:call,
+         :desc=>"Upgrades a Linode to its next generation.",
+         :throws=>["NOTFOUND", "VALIDATION"],
+         :params=>{:linodeid=>{:desc=>"", :type=>:numeric, :required=>true}}},
+       :shutdown=>
+        {:type=>:call,
+         :desc=>"Issues a shutdown job for a given LinodeID.",
+         :throws=>["NOTFOUND"],
+         :params=>
+          {:linodeid=>{:desc=>"", :type=>:numeric, :required=>true}}}}},
+   :nodebalancer=>
+    {:type=>:group,
+     :subs=>
+      {:node=>
+        {:type=>:group,
+         :subs=>
+          {:update=>
+            {:type=>:call,
+             :desc=>"Updates a Node's properties",
+             :throws=>["NOTFOUND", "VALIDATION"],
+             :params=>
+              {:label=>
+                {:desc=>"This backend Node's label",
+                 :type=>:string,
+                 :required=>false},
+               :nodeid=>{:desc=>"", :type=>:numeric, :required=>true},
+               :mode=>
+                {:desc=>
+                  "The connections mode for this node.  One of 'accept', 'reject', or 'drain'",
+                 :type=>:string,
+                 :required=>false},
+               :weight=>
+                {:desc=>
+                  "Load balancing weight, 1-255. Higher means more connections.",
+                 :type=>:numeric,
+                 :required=>false},
+               :address=>
+                {:desc=>
+                  "The address:port combination used to communicate with this Node",
+                 :type=>:string,
+                 :required=>false}}},
+           :list=>
+            {:type=>:call,
+             :desc=>
+              "Returns a list of Nodes associated with a NodeBalancer Config",
+             :throws=>[],
+             :params=>
+              {:nodeid=>
+                {:desc=>"Limits the list to the specified NodeID",
+                 :type=>:numeric,
+                 :required=>false},
+               :configid=>{:desc=>"", :type=>:numeric, :required=>true}}},
+           :create=>
+            {:type=>:call,
+             :desc=>"",
+             :throws=>["NOTFOUND", "VALIDATION"],
+             :params=>
+              {:label=>
+                {:desc=>"This backend Node's label",
+                 :type=>:string,
+                 :required=>true},
+               :mode=>
+                {:desc=>
+                  "The connections mode for this node.  One of 'accept', 'reject', or 'drain'",
+                 :type=>:string,
+                 :required=>false},
+               :configid=>
+                {:desc=>"The parent ConfigID to attach this Node to",
+                 :type=>:numeric,
+                 :required=>true},
+               :weight=>
+                {:desc=>
+                  "Load balancing weight, 1-255. Higher means more connections.",
+                 :type=>:numeric,
+                 :required=>false},
+               :address=>
+                {:desc=>
+                  "The address:port combination used to communicate with this Node",
+                 :type=>:string,
+                 :required=>true}}},
+           :delete=>
+            {:type=>:call,
+             :desc=>"Deletes a Node from a NodeBalancer Config",
+             :throws=>["NOTFOUND"],
+             :params=>
+              {:nodeid=>
+                {:desc=>"The NodeID to delete",
+                 :type=>:numeric,
+                 :required=>true}}}}},
+       :create=>
+        {:type=>:call,
+         :desc=>"",
+         :throws=>["NOACCESS", "CCFAILED", "VALIDATION"],
+         :params=>
+          {:label=>
+            {:desc=>"This NodeBalancer's label",
+             :type=>:string,
+             :required=>false},
+           :clientconnthrottle=>
+            {:desc=>
+              "To help mitigate abuse, throttle connections per second, per client IP. 0 to disable. Max of 20.",
+             :type=>:numeric,
+             :required=>false},
+           :datacenterid=>
+            {:desc=>
+              "The DatacenterID from avail.datacenters() where you wish to place this new NodeBalancer",
+             :type=>:numeric,
+             :required=>true},
+           :paymentterm=>
+            {:desc=>"Subscription term in months.  One of: 0, 1, 12, or 24",
+             :type=>:numeric,
+             :required=>true}}},
+       :delete=>
+        {:type=>:call,
+         :desc=>
+          "Immediately removes a NodeBalancer from your account and issues a pro-rated credit back to your account, if applicable.",
+         :throws=>["NOTFOUND"],
+         :params=>
+          {:nodebalancerid=>
+            {:desc=>"The NodeBalancerID to delete",
+             :type=>:numeric,
+             :required=>true}}},
+       :config=>
+        {:type=>:group,
+         :subs=>
+          {:create=>
+            {:type=>:call,
+             :desc=>"",
+             :throws=>["NOTFOUND", "VALIDATION"],
+             :params=>
+              {:stickiness=>
+                {:desc=>
+                  "Session persistence.  One of 'none', 'table', 'http_cookie'",
+                 :type=>:string,
+                 :required=>false},
+               :check_path=>
+                {:desc=>"When check=http, the path to request",
+                 :type=>:string,
+                 :required=>false},
+               :check_body=>
+                {:desc=>
+                  "When check=http_body, a regex against the expected result body",
+                 :type=>:string,
+                 :required=>false},
+               :check_interval=>
+                {:desc=>"Seconds between health check probes.  2-3600",
+                 :type=>:numeric,
+                 :required=>false},
+               :algorithm=>
+                {:desc=>
+                  "Balancing algorithm.  One of 'roundrobin', 'leastconn', 'source'",
+                 :type=>:string,
+                 :required=>false},
+               :nodebalancerid=>
+                {:desc=>"The parent NodeBalancer's ID",
+                 :type=>:numeric,
+                 :required=>true},
+               :check_attempts=>
+                {:desc=>
+                  "Number of failed probes before taking a node out of rotation. 1-30",
+                 :type=>:string,
+                 :required=>false},
+               :port=>
+                {:desc=>"Port to bind to on the public interfaces. 1-65534",
+                 :type=>:numeric,
+                 :required=>false},
+               :check=>
+                {:desc=>
+                  "Perform active health checks on the backend nodes.  One of 'connection', 'http', 'http_body'",
+                 :type=>:string,
+                 :required=>false},
+               :ssl_key=>
+                {:desc=>
+                  "Unpassphrased private key for the SSL certificate when protocol is 'https'",
+                 :type=>:string,
+                 :required=>false},
+               :protocol=>
+                {:desc=>"Either 'tcp', 'http', or 'https'",
+                 :type=>:string,
+                 :required=>false},
+               :check_timeout=>
+                {:desc=>
+                  "Seconds to wait before considering the probe a failure. 1-30.  Must be less than check_interval.",
+                 :type=>:string,
+                 :required=>false},
+               :ssl_cert=>
+                {:desc=>
+                  "SSL certificate served by the NodeBalancer when the protocol is 'https'",
+                 :type=>:string,
+                 :required=>false}}},
+           :update=>
+            {:type=>:call,
+             :desc=>"Updates a Config's properties",
+             :throws=>["NOTFOUND", "VALIDATION"],
+             :params=>
+              {:stickiness=>
+                {:desc=>
+                  "Session persistence.  One of 'none', 'table', 'http_cookie'",
+                 :type=>:string,
+                 :required=>false},
+               :check_path=>
+                {:desc=>"When check=http, the path to request",
+                 :type=>:string,
+                 :required=>false},
+               :check_body=>
+                {:desc=>
+                  "When check=http_body, a regex against the expected result body",
+                 :type=>:string,
+                 :required=>false},
+               :check_interval=>
+                {:desc=>"Seconds between health check probes.  2-3600",
+                 :type=>:numeric,
+                 :required=>false},
+               :algorithm=>
+                {:desc=>
+                  "Balancing algorithm.  One of 'roundrobin', 'leastconn', 'source'",
+                 :type=>:string,
+                 :required=>false},
+               :configid=>{:desc=>"", :type=>:numeric, :required=>true},
+               :check_attempts=>
+                {:desc=>
+                  "Number of failed probes before taking a node out of rotation. 1-30",
+                 :type=>:string,
+                 :required=>false},
+               :port=>
+                {:desc=>"Port to bind to on the public interfaces. 1-65534",
+                 :type=>:numeric,
+                 :required=>false},
+               :check=>
+                {:desc=>
+                  "Perform active health checks on the backend nodes.  One of 'connection', 'http', 'http_body'",
+                 :type=>:string,
+                 :required=>false},
+               :ssl_key=>
+                {:desc=>
+                  "Unpassphrased private key for the SSL certificate when protocol is 'https'",
+                 :type=>:string,
+                 :required=>false},
+               :protocol=>
+                {:desc=>"Either 'tcp', 'http', or 'https'",
+                 :type=>:string,
+                 :required=>false},
+               :check_timeout=>
+                {:desc=>
+                  "Seconds to wait before considering the probe a failure. 1-30.  Must be less than check_interval.",
+                 :type=>:string,
+                 :required=>false},
+               :ssl_cert=>
+                {:desc=>
+                  "SSL certificate served by the NodeBalancer when the protocol is 'https'",
+                 :type=>:string,
+                 :required=>false}}},
+           :delete=>
+            {:type=>:call,
+             :desc=>"Deletes a NodeBalancer's Config",
+             :throws=>["NOTFOUND"],
+             :params=>
+              {:configid=>
+                {:desc=>"The NodeBalancerID to delete",
+                 :type=>:numeric,
+                 :required=>true}}},
+           :list=>
+            {:type=>:call,
+             :desc=>
+              "Returns a list of NodeBalancers this user has access or delete to, including their properties",
+             :throws=>[],
+             :params=>
+              {:nodebalancerid=>{:desc=>"", :type=>:numeric, :required=>true},
+               :configid=>
+                {:desc=>"Limits the list to the specified ConfigID",
+                 :type=>:numeric,
+                 :required=>false}}}}},
+       :update=>
+        {:type=>:call,
+         :desc=>"Updates a NodeBalancer's properties",
+         :throws=>["NOTFOUND", "VALIDATION"],
+         :params=>
+          {:label=>
+            {:desc=>"This NodeBalancer's label",
+             :type=>:string,
+             :required=>false},
+           :clientconnthrottle=>
+            {:desc=>
+              "To help mitigate abuse, throttle connections per second, per client IP. 0 to disable. Max of 20.",
+             :type=>:numeric,
+             :required=>false},
+           :nodebalancerid=>{:desc=>"", :type=>:numeric, :required=>true}}},
+       :list=>
+        {:type=>:call,
+         :desc=>
+          "Returns a list of NodeBalancers this user has access or delete to, including their properties",
+         :throws=>[],
+         :params=>
+          {:nodebalancerid=>
+            {:desc=>"Limits the list to the specified NodeBalancerID",
+             :type=>:numeric,
+             :required=>false}}}}},
+   :domain=>
+    {:type=>:group,
+     :subs=>
+      {:update=>
+        {:type=>:call,
+         :desc=>"Update a domain record.",
+         :throws=>["NOTFOUND", "VALIDATION"],
+         :params=>
+          {:domainid=>{:desc=>"", :type=>:numeric, :required=>true},
+           :description=>
+            {:desc=>"Currently undisplayed.",
+             :type=>:string,
+             :required=>false},
+           :retry_sec=>{:desc=>"", :type=>:numeric, :required=>false},
+           :expire_sec=>{:desc=>"", :type=>:numeric, :required=>false},
+           :status=>
+            {:desc=>"0, 1, or 2 (disabled, active, edit mode)",
+             :type=>:numeric,
+             :required=>false},
+           :master_ips=>
+            {:desc=>
+              "When type=slave, the zone's master DNS servers list, semicolon separated ",
+             :type=>:string,
+             :required=>false},
+           :refresh_sec=>{:desc=>"", :type=>:numeric, :required=>false},
+           :lpm_displaygroup=>
+            {:desc=>
+              "Display group in the Domain list inside the Linode DNS Manager",
+             :type=>:string,
+             :required=>false},
+           :soa_email=>
+            {:desc=>"Required when type=master",
+             :type=>:string,
+             :required=>false},
+           :ttl_sec=>{:desc=>"", :type=>:numeric, :required=>false},
+           :domain=>
+            {:desc=>"The zone's name", :type=>:string, :required=>false},
+           :type=>{:desc=>"master or slave", :type=>:string, :required=>false},
+           :axfr_ips=>
+            {:desc=>
+              "IP addresses allowed to AXFR the entire zone, semicolon separated",
+             :type=>:string,
+             :required=>false}}},
+       :create=>
+        {:type=>:call,
+         :desc=>"Create a domain record.",
+         :throws=>["NOACCESS", "VALIDATION"],
+         :params=>
+          {:soa_email=>
+            {:desc=>"Required when type=master",
+             :type=>:string,
+             :required=>false},
+           :description=>
+            {:desc=>"Currently undisplayed.",
+             :type=>:string,
+             :required=>false},
+           :ttl_sec=>{:desc=>"", :type=>:numeric, :required=>false},
+           :retry_sec=>{:desc=>"", :type=>:numeric, :required=>false},
+           :expire_sec=>{:desc=>"", :type=>:numeric, :required=>false},
+           :status=>
+            {:desc=>"0, 1, or 2 (disabled, active, edit mode)",
+             :type=>:numeric,
+             :required=>false},
+           :domain=>
+            {:desc=>"The zone's name", :type=>:string, :required=>true},
+           :master_ips=>
+            {:desc=>
+              "When type=slave, the zone's master DNS servers list, semicolon separated ",
+             :type=>:string,
+             :required=>false},
+           :refresh_sec=>{:desc=>"", :type=>:numeric, :required=>false},
+           :lpm_displaygroup=>
+            {:desc=>
+              "Display group in the Domain list inside the Linode DNS Manager",
+             :type=>:string,
+             :required=>false},
+           :type=>{:desc=>"master or slave", :type=>:string, :required=>true},
+           :axfr_ips=>
+            {:desc=>
+              "IP addresses allowed to AXFR the entire zone, semicolon separated",
+             :type=>:string,
+             :required=>false}}},
+       :resource=>
+        {:type=>:group,
+         :subs=>
+          {:delete=>
+            {:type=>:call,
+             :desc=>"",
+             :throws=>["NOTFOUND"],
+             :params=>
+              {:domainid=>{:desc=>"", :type=>:numeric, :required=>true},
+               :resourceid=>{:desc=>"", :type=>:numeric, :required=>true}}},
+           :list=>
+            {:type=>:call,
+             :desc=>"",
+             :throws=>[],
+             :params=>
+              {:domainid=>{:desc=>"", :type=>:numeric, :required=>true},
+               :resourceid=>{:desc=>"", :type=>:numeric, :required=>false}}},
+           :create=>
+            {:type=>:call,
+             :desc=>"Create a domain record.",
+             :throws=>["NOACCESS", "VALIDATION"],
+             :params=>
+              {:domainid=>{:desc=>"", :type=>:numeric, :required=>true},
+               :port=>{:desc=>"", :type=>:numeric, :required=>false},
+               :name=>
+                {:desc=>
+                  "The hostname or FQDN.  When Type=MX the subdomain to delegate to the Target MX server.",
+                 :type=>:string,
+                 :required=>false},
+               :weight=>{:desc=>"", :type=>:numeric, :required=>false},
+               :ttl_sec=>
+                {:desc=>"TTL.  Leave as 0 to accept our default.",
+                 :type=>:numeric,
+                 :required=>false},
+               :priority=>
+                {:desc=>"Priority for MX and SRV records, 0-255",
+                 :type=>:numeric,
+                 :required=>false},
+               :target=>
+                {:desc=>
+                  "When Type=MX the hostname.  When Type=CNAME the target of the alias.  When Type=TXT the value of the record.  \n\t\tWhen Type=A or AAAA the token of '[remote_addr]' will be substituted with the IP address of the request.",
+                 :type=>:string,
+                 :required=>false},
+               :protocol=>
+                {:desc=>
+                  "The protocol to append to an SRV record.  Ignored on other record types.",
+                 :type=>:string,
+                 :required=>false},
+               :type=>
+                {:desc=>"One of: NS, MX, A, AAAA, CNAME, TXT, or SRV",
+                 :type=>:string,
+                 :required=>true}}},
+           :update=>
+            {:type=>:call,
+             :desc=>"Update a domain record.",
+             :throws=>["NOTFOUND", "VALIDATION"],
+             :params=>
+              {:domainid=>{:desc=>"", :type=>:numeric, :required=>false},
+               :port=>{:desc=>"", :type=>:numeric, :required=>false},
+               :resourceid=>{:desc=>"", :type=>:numeric, :required=>true},
+               :name=>
+                {:desc=>
+                  "The hostname or FQDN.  When Type=MX the subdomain to delegate to the Target MX server.",
+                 :type=>:string,
+                 :required=>false},
+               :weight=>{:desc=>"", :type=>:numeric, :required=>false},
+               :ttl_sec=>
+                {:desc=>"TTL.  Leave as 0 to accept our default.",
+                 :type=>:numeric,
+                 :required=>false},
+               :priority=>
+                {:desc=>"Priority for MX and SRV records, 0-255",
+                 :type=>:numeric,
+                 :required=>false},
+               :target=>
+                {:desc=>
+                  "When Type=MX the hostname.  When Type=CNAME the target of the alias.  When Type=TXT the value of the record.  \n\t\tWhen Type=A or AAAA the token of '[remote_addr]' will be substituted with the IP address of the request.",
+                 :type=>:string,
+                 :required=>false},
+               :protocol=>
+                {:desc=>
+                  "The protocol to append to an SRV record.  Ignored on other record types.",
+                 :type=>:string,
+                 :required=>false}}}}},
+       :list=>
+        {:type=>:call,
+         :desc=>"Lists domains you have access to.",
+         :throws=>[],
+         :params=>
+          {:domainid=>
+            {:desc=>"Limits the list to the specified DomainID",
+             :type=>:numeric,
+             :required=>false}}},
+       :delete=>
+        {:type=>:call,
+         :desc=>"",
+         :throws=>["NOTFOUND"],
+         :params=>
+          {:domainid=>{:desc=>"", :type=>:numeric, :required=>true}}}}},
+   :avail=>
+    {:type=>:group,
+     :subs=>
+      {:datacenters=>
+        {:type=>:call,
+         :desc=>"Returns a list of Linode data center facilities.",
+         :throws=>[],
+         :params=>{}},
+       :linodeplans=>
+        {:type=>:call,
+         :desc=>
+          "Returns a structure of Linode PlanIDs containing the Plan label and the availability in each Datacenter. Please note, this method is deprecated and will be removed in the future.",
+         :throws=>[],
+         :params=>
+          {:planid=>
+            {:desc=>"Limits the list to the specified PlanID",
+             :type=>:numeric,
+             :required=>false}}},
+       :stackscripts=>
+        {:type=>:call,
+         :desc=>"Returns a list of available public StackScripts.",
+         :throws=>[],
+         :params=>
+          {:distributionid=>
+            {:desc=>
+              "Limit the results to StackScripts that can be applied to this DistributionID",
+             :type=>:numeric,
+             :required=>false},
+           :keywords=>
+            {:desc=>"Search terms", :type=>:string, :required=>false},
+           :distributionvendor=>
+            {:desc=>"Debian, Ubuntu, Fedora, etc.",
+             :type=>:string,
+             :required=>false}}},
+       :distributions=>
+        {:type=>:call,
+         :desc=>"Returns a list of available Linux Distributions.",
+         :throws=>[],
+         :params=>
+          {:distributionid=>
+            {:desc=>"Limits the results to the specified DistributionID",
+             :type=>:numeric,
+             :required=>false}}},
+       :kernels=>
+        {:type=>:call,
+         :desc=>"List available kernels.",
+         :throws=>[],
+         :params=>
+          {:isxen=>
+            {:desc=>"Limits the results to show only Xen kernels",
+             :type=>:boolean,
+             :required=>false},
+           :kernelid=>{:desc=>"", :type=>:numeric, :required=>false}}}}},
+   :account=>
+    {:type=>:group,
+     :subs=>
+      {:estimateinvoice=>
+        {:type=>:call,
+         :desc=>
+          "Estimates the invoice for adding a new Linode or NodeBalancer as well as resizing a Linode. This returns two fields: PRICE which is the estimated cost of the invoice, and INVOICE_TO which is the date invoice would be though with timezone set to America/New_York",
+         :throws=>["VALIDATION"],
+         :params=>
+          {:paymentterm=>
+            {:desc=>
+              "Subscription term in months. One of: 1, 12, or 24. This is required for modes 'linode_new' and 'nodebalancer_new'.",
+             :type=>:numeric,
+             :required=>false},
+           :mode=>
+            {:desc=>
+              "This is one of the following options: 'linode_new', 'linode_resize', or 'nodebalancer_new'.",
+             :type=>:string,
+             :required=>true},
+           :planid=>
+            {:desc=>
+              "The desired PlanID available from avail.LinodePlans(). This is required for modes 'linode_new' and 'linode_resize'.",
+             :type=>:numeric,
+             :required=>false},
+           :linodeid=>
+            {:desc=>
+              "This is the LinodeID you want to resize and is required for mode 'linode_resize'.",
+             :type=>:numeric,
+             :required=>false}}},
+       :updatecard=>
+        {:type=>:call,
+         :desc=>"",
+         :throws=>[],
+         :params=>
+          {:ccexpmonth=>{:desc=>"", :type=>:numeric, :required=>true},
+           :ccexpyear=>{:desc=>"", :type=>:numeric, :required=>true},
+           :ccnumber=>{:desc=>"", :type=>:numeric, :required=>true}}},
+       :info=>
+        {:type=>:call,
+         :desc=>
+          "Shows information about your account such as the date your account was opened as well as your network utilization for the current month in gigabytes.",
+         :throws=>[],
+         :params=>{}},
+       :paybalance=>
+        {:type=>:call,
+         :desc=>"Pays current balance on file, returning it in the response.",
+         :throws=>
+          ["CCEXPIRED",
+           "CCFAILED",
+           "NOACCESS",
+           "PAYMENTLIMITER",
+           "VALIDATION"],
+         :params=>{}}}},
+   :stackscript=>
+    {:type=>:group,
+     :subs=>
+      {:create=>
+        {:type=>:call,
+         :desc=>"Create a StackScript.",
+         :throws=>["NOACCESS", "VALIDATION"],
+         :params=>
+          {:label=>
+            {:desc=>"The Label for this StackScript",
+             :type=>:string,
+             :required=>true},
+           :rev_note=>{:desc=>"", :type=>:string, :required=>false},
+           :script=>
+            {:desc=>"The actual script", :type=>:string, :required=>true},
+           :ispublic=>
+            {:desc=>
+              "Whether this StackScript is published in the Library, for everyone to use",
+             :type=>:boolean,
+             :required=>false},
+           :distributionidlist=>
+            {:desc=>
+              "Comma delimited list of DistributionIDs that this script works on ",
+             :type=>:string,
+             :required=>true},
+           :description=>{:desc=>"", :type=>:string, :required=>false}}},
+       :delete=>
+        {:type=>:call,
+         :desc=>"",
+         :throws=>["NOTFOUND"],
+         :params=>
+          {:stackscriptid=>{:desc=>"", :type=>:numeric, :required=>true}}},
+       :update=>
+        {:type=>:call,
+         :desc=>"Update a StackScript.",
+         :throws=>["NOTFOUND", "VALIDATION"],
+         :params=>
+          {:rev_note=>{:desc=>"", :type=>:string, :required=>false},
+           :script=>
+            {:desc=>"The actual script", :type=>:string, :required=>false},
+           :description=>{:desc=>"", :type=>:string, :required=>false},
+           :distributionidlist=>
+            {:desc=>
+              "Comma delimited list of DistributionIDs that this script works on ",
+             :type=>:string,
+             :required=>false},
+           :label=>
+            {:desc=>"The Label for this StackScript",
+             :type=>:string,
+             :required=>false},
+           :ispublic=>
+            {:desc=>
+              "Whether this StackScript is published in the Library, for everyone to use",
+             :type=>:boolean,
+             :required=>false},
+           :stackscriptid=>{:desc=>"", :type=>:numeric, :required=>true}}},
+       :list=>
+        {:type=>:call,
+         :desc=>"Lists StackScripts you have access to.",
+         :throws=>[],
+         :params=>
+          {:stackscriptid=>
+            {:desc=>"Limits the list to the specified StackScriptID",
+             :type=>:numeric,
+             :required=>false}}}}},
+   :api=>
+    {:type=>:group,
+     :subs=>
+      {:spec=>
+        {:type=>:call,
+         :desc=>
+          "Returns a data structure of the entire Linode API specification.  This method does not require authorization.<br><br>For example: <a target=\"_blank\" href=\"https://api.linode.com/?api_action=api.spec\">https://api.linode.com/?api_action=api.spec</a>",
+         :throws=>[],
+         :params=>{}}}},
+   :user=>
+    {:type=>:group,
+     :subs=>
+      {:getapikey=>
+        {:type=>:call,
+         :desc=>
+          "Returns a user's API key.  If no API key exists, one is generated.  This method does not require an api_key to be passed in.",
+         :throws=>[],
+         :params=>
+          {:password=>{:desc=>"", :type=>:string, :required=>true},
+           :username=>{:desc=>"", :type=>:string, :required=>true}}}}},
+   :test=>
+    {:type=>:group,
+     :subs=>
+      {:echo=>
+        {:type=>:call,
+         :desc=>"Echos back parameters that were passed in.",
+         :throws=>[],
+         :params=>{}}}}}}
+
+end