jamesn-softlayer-ruby 0.5.0.0

data/LICENSE

@@ -0,0 +1,26 @@
+Copyright (c) 2009, James Nuckolls. All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions are met:
+
+  * Redistributions of source code must retain the above copyright notice,
+    this list of conditions and the following disclaimer.
+  * Redistributions in binary form must reproduce the above copyright notice,
+    this list of conditions and the following disclaimer in the documentation
+    and/or other materials provided with the distribution.
+  * Neither "James Nuckolls" nor the names of any contributors may
+    be used to endorse or promote products derived from this software without
+    specific prior written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+ LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ POSSIBILITY OF SUCH DAMAGE.
+ 

data/README

@@ -0,0 +1,61 @@
+This is a module and class factory for SoftLayer's customer portal API (http://sldn.softlayer.com/).  See the rdoc documentation and the sample directory for usage details.
+
+The factory creates classes as they are declared.  As a group:
+
+SLAPICLASSES = [ 'SoftLayer::Account' ]
+SLAPISERVICES = [ 'SoftLayer_Billing_Item', 'SoftLayer_Network_Storage' ]
+SoftLayer::declareClasses(:ruby => SLAPICLASSES, :soap => SLAPISERVICES)
+
+Or one at a time:
+
+SoftLayer::ClassFactory(:class => 'SoftLayer::Account')
+
+Objects are then created and used like normal Ruby objects:
+
+account = SoftLayer::Account.new(:user => AUTH_USER, :key => AUTH_KEY, :initParam => ACCT_ID)
+puts account.getBalance
+
+The object's associated Type is available like a hash:
+
+puts account['email']
+
+Object Masks:
+
+account.objectMask = { 'allBillingItems' => nil }
+pp account['allBillingItems]
+
+
+API user and key is cached after first use (but can be overridden on a per object basis):
+
+SLAPISERVICES = [ 'SoftLayer_Account', 'SoftLayer_Billing_Item', 'SoftLayer_Network_Storage' ]
+SoftLayer::declareClasses(:soap => SLAPISERVICES)
+
+account = SoftLayer::Account.new(:user => AUTH_USER, :key => AUTH_KEY, :initParam => ACCT_ID)
+account.objectMask={ 'allBillingItems' => nil, 'nasNetworkStorage' => nil }
+account['allBillingItems'].each do |bi|
+	billingItem = SoftLayer::Billing::Item.new(:initParam => bi['id'])
+	pp billingItem.getLocation['longName']
+end
+
+account['nasNetworkStorage'].each do |n|
+	nas = SoftLayer::Network::Storage(:user => OTHER_AUTH_USER, :key => OTHER_AUTH_KEY, :initParam => n['id'])
+	pp nas.capacityGb
+end
+
+ToDo:
+
+Result Limits.  Can be done now as a parameter to any method, but should be integrated such that this does the right thing:
+
+account.getAllBillingItems(:limit => [X,Y]) do |o,bia|
+	( blah )
+end
+
+Such that is +o+ is the offset and +bia+ is an array containing X or fewer elements (or a single element if :limit[0] == 1); 
+blah executes on each batch until it's done.  
+
+Without a block, should return the 5 elements offset from Y:
+
+bia = account.getAllBillingItems(:limit => [5,Y])
+bia.size <= 5
+
+

data/lib/softlayer.rb

@@ -0,0 +1,298 @@
+#!/usr/bin/env ruby
+# softlayer
+#
+# Copyright (c) 2009, James Nuckolls. All rights reserved.
+# 
+#  Redistribution and use in source and binary forms, with or without
+#  modification, are permitted provided that the following conditions are met:
+# 
+#   * Redistributions of source code must retain the above copyright notice,
+#     this list of conditions and the following disclaimer.
+#   * Redistributions in binary form must reproduce the above copyright notice,
+#     this list of conditions and the following disclaimer in the documentation
+#     and/or other materials provided with the distribution.
+#   * Neither "James Nuckolls" nor the names of any contributors may
+#     be used to endorse or promote products derived from this software without
+#     specific prior written permission.
+# 
+#  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+#  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+#  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+#  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+#  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+#  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+#  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+#  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+#  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+#  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+#  POSSIBILITY OF SUCH DAMAGE.
+#
+#= Description
+#
+#= ToDo
+#
+
+require 'rubygems' rescue LoadError
+gem 'soap4r'
+require 'soap/header/simplehandler'
+require 'soap/wsdlDriver'
+
+
+module SoftLayer
+
+  # Declare SLAPI clases.  Args take class names in two forms:
+  # +soap+:: Service names in SOAP format (example: SoftLayer_Account)
+  # +ruby+:: Class names in Ruby format (example:  SoftLayer::Account)
+  # Creates the class, and retrieves and caches the endpoint WSDL.
+  def SoftLayer::declareClasses(args)
+    classes = args[:ruby]
+    services = args[:soap]
+    
+    unless (services.nil? || services.empty?)
+      services.each do |s|
+        c = s.gsub(/_/,'::')
+        classes.push(c)
+      end
+    end
+
+    classes.each do |cstr|
+      k = SoftLayer::ClassFactory(:class => cstr)
+      k.cacheWSDL
+    end
+  end
+  
+  # Derive a Class from a SOAP::Mapping::Object
+  # +obj+:: The object to derive a class from.
+  # Returns a new object with +obj+ as the cached object. (obj['id'] == :initParam)
+  #
+  #  XXX:  We should use the SOAP mapping registry to avoid doing this, but what the hell.
+  #  Also, there's no guartinee there's a class here to be created, so the assumption is
+  #  that you know what you're doing when you use this (much like everything else).
+  def SoftLayer::deriveClass(args)
+  end
+
+  # Create a Ruby class to match an SLAPI WSDL endpoint.
+  # Args:
+  # +class+:: The name of the class to create in Ruby format.
+  # +parent+:: The parent namespace to add the class to (this should be somewere in SoftLayer; optional).
+  # This recursively walks up +class+ creating them as needed, so SoftLayer::Dns::Domain will create
+  # classes for Dns and Domain (even though the Dns class will never be used).
+  def SoftLayer::ClassFactory(args)
+    cname = args[:class]
+    parent = args[:parent] unless args[:parent].nil?
+
+    cary = cname.split('::')
+    parent = const_get(cary.shift) if parent.nil? # This should always be SoftLayer, but maybe not...
+    cur = cary.shift
+    newclass = nil
+    unless parent.const_defined?(cur)
+      newclass = SoftLayer::makeSLAPIKlass(:class => cur, :parent => parent)
+    else
+      newclass = parent.const_get(cur)
+    end
+    return newclass if cary.empty?
+
+    left = cary.join('::')
+    k = SoftLayer::ClassFactory(:class => left, :parent => newclass) 
+    return k
+  end
+
+  # This really creates the class.
+  # +class+:: The name of the class to create in Ruby format.
+  # +parent+:: The parent namespace to add the class to (this should be somewhere in SoftLayer, not optional).
+  def SoftLayer::makeSLAPIKlass(args)
+    cname = args[:class]
+    parent = args[:parent]
+    realKlassName = "#{cname}"
+    klass = Class.new SoftLayer::BaseClass do 
+
+    end
+    parent.const_set realKlassName, klass
+    return klass
+  end
+
+# A class to old Paramaters.
+  class ParamHeader < SOAP::Header::SimpleHandler
+    def initialize(tag, out)
+      @out = out
+      super(XSD::QName.new(nil, tag))
+    end
+
+    def on_simple_outbound
+      @out
+    end
+        
+    def [](k)
+      return @out[k]
+    end
+    
+    def []=(k,v)
+      @out[k]=v
+    end
+  end
+
+  # A class to hold the object mask.
+  class ObjectMaskHeader < SOAP::Header::SimpleHandler
+    def initialize(tag, out)
+      @out = out
+      super(XSD::QName.new(nil, tag))
+    end
+
+    def on_simple_outbound
+      { 'mask' => @out }
+    end
+    
+    def [](k)
+      @out[k]
+    end
+    
+    def []=(k,v)
+      @out[k]=v
+    end
+    
+  end
+
+  # The Base class for our generated class.
+  class BaseClass
+
+    WSDLBASE='http://api.service.softlayer.com/soap/v3'
+    WSDLPARAM='?wsdl'
+
+    @@wsdl = { }
+    @@apiUser = nil
+    @@apiKey = nil
+
+    # The initializer.
+    # Arguments:
+    # +user+::  The API User
+    # +key+:: The API Key
+    # +initParams+:: This object's initParam (just the key)
+    # +debug+:: Enable debug after driver creation. (IO handler)
+    #
+    # +user+ and +key+ are optional.  The first time they're presented
+    # they're saved to class variables and reused later as necessary.  Supplying
+    # +user+ and +key+ later does not overwrite the class variables.  +initParams+ is
+    # required where the api requires it.
+    def initialize(args)
+      @apiUser = args[:user] unless args[:user].nil?
+      @apiKey = args[:key] unless args[:key].nil?
+      @initParam = args[:initParam]
+
+      @@apiUser = args[:user] unless (args[:user].nil? || !@@apiUser.nil?)
+      @@apiKey = args[:key] unless (args[:key].nil? || !@@apiKey.nil?)
+      @apiUser = @@apiUser unless (@@apiUser.nil? || !@apiUser.nil?)
+      @apiKey = @@apiKey unless (@@apiKey.nil? || !@apiKey.nil?)
+
+      self.class.cacheWSDL
+      @slapi = @@wsdl[self.soapClass].create_rpc_driver
+      self.debug=args[:debug] unless args[:debug].nil?
+    end
+
+    # Return this's object's matching SLAPI SOAP Class.
+    def soapClass
+      return self.class.to_s.gsub(/::/, '_')
+    end
+
+    # This returns key values from this Service's associated Type (retrieved using #getObject).
+    def [](key)
+      @slapiObject = self.getObject if @slapiobject.nil?
+      return @slapiObject[key.to_s]
+    end
+    
+    def setObject(obj)
+      @slapiObject = obj
+    end
+
+    # Set the object mask which ia passed as a hash of optional hashes (otherwise the hash elements should have a nil value).
+    # Using the example from the wiki:
+    #  <SoftLayer_AccountObjectMask xsi:type="v3:SoftLayer_AccountObjectMask">
+    #    <mask xsi:type="slt:SoftLayer_Account" xmlns:slt="http://api.service.softlayer.com/soap/v3/SLTypes/">
+    #        <domains>
+    #            <resourceRecords />
+    #        </domains>
+    #        <openTickets>
+    #            <assignedUser />
+    #            <attachedHardware />
+    #            <updates />
+    #        </openTickets>
+    #        <userCount />
+    #    </mask>
+    #  </SoftLayer_AccountObjectMask>
+    #
+    #  { 'domains' => { 'resourceRecords' => nil }, 'openTicket' => { 'assignedUser' => nil, 'attachedHardware' => nil, 'updates' => nil },
+    #   userCount => nil }
+    # Changing this resets the cached object used by #[]
+    def objectMask=(mask)
+      if mask.class == ObjectMaskHeader
+        @objectMask = mask
+      else
+        @objectMask = ObjectMaskHeader.new("#{self.soapClass}ObjectMask", mask)
+      end
+      @slapiObject = nil
+    end
+    
+    def objectMask
+      return @objectMask
+    end
+
+
+    # Make a direct api call.  Paramaters are a hash where the key is passed to ParamHeader as the tag, and the value
+    # is passed as the tag content, unless it's a magic paramater.
+    # Magic Paramaters:
+    # +initParam+:: Initialization paramater for this call (just the key).  Otherwise @initParam is used.
+    #
+    # Aliased to #method_missing.
+    def slapiCall(method, args = { })
+      initParam = args[:initParam] unless args[:initParam].nil?
+      args.delete(:initParam) unless args[:initParam].nil?
+      initParam = @initParam if initParam.nil?
+
+      @slapi.headerhandler << ParamHeader.new('authenticate', {'username' => @apiUser, 'apiKey' => @apiKey})
+      unless args.nil?
+        args.each do |k,v|
+          @slapi.headerhandler << ParamHeader.new(k.to_s,v)
+        end
+      end
+      @slapi.headerhandler << ParamHeader.new("#{self.soapClass}InitParameters", { 'id' => initParam})
+      @slapi.headerhandler << @objectMask unless @objectMask.nil?
+      return @slapi.call(method.to_s)
+    end
+
+    # Alias the above call method to #method_missing.
+    alias_method  :method_missing, :slapiCall
+
+    # Enable (or disable) debug. (paramater is the IO handler to write to)
+    def debug=(dev)
+      @slapi.wiredump_dev=(dev)
+    end
+
+    # Get the WSDL, parse it, and save it to a Class level hash.
+    # Returns false of we couldn't parse the WSDL.
+    def self.cacheWSDL
+      return unless @@wsdl[self.soapClass].nil?
+      
+      begin
+        @@wsdl[self.soapClass] = SOAP::WSDLDriverFactory.new(self.wsdlUrl)
+        return true
+      rescue => e
+        return false
+      end 
+    end
+
+    # Return this Class's WSDL.
+    def self.wsdl
+      return @@wsdl[self.soapClass]
+    end
+
+    # Return this Class's WSDL URL.
+    def self.wsdlUrl
+      return URI.parse("#{WSDLBASE}/#{self.soapClass}#{WSDLPARAM}")
+    end
+
+    # Returns this Class's SOAP Class.
+    def self.soapClass
+      self.name.to_s.gsub(/::/, '_')
+    end
+
+  end
+end

data/sample/billingreport.rb

@@ -0,0 +1,94 @@
+#!/usr/bin/env ruby
+# billingreport
+#
+# Copyright (c) 2009, James Nuckolls. All rights reserved.
+# 
+#  Redistribution and use in source and binary forms, with or without
+#  modification, are permitted provided that the following conditions are met:
+# 
+#   * Redistributions of source code must retain the above copyright notice,
+#     this list of conditions and the following disclaimer.
+#   * Redistributions in binary form must reproduce the above copyright notice,
+#     this list of conditions and the following disclaimer in the documentation
+#     and/or other materials provided with the distribution.
+#   * Neither "James Nuckolls" nor the names of any contributors may
+#     be used to endorse or promote products derived from this software without
+#     specific prior written permission.
+# 
+#  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+#  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+#  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+#  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+#  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+#  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+#  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+#  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+#  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+#  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+#  POSSIBILITY OF SUCH DAMAGE.
+#
+#= Description
+#  Retrieves the current Account's BillingItems using an objectMask and outputs a report of the
+#  current (not-canceled) items.
+#= ToDo
+#
+
+require 'rubygems' rescue LoadError
+require 'pp'
+require 'softlayer'
+
+AUTH_USER = ARGV[0]
+AUTH_KEY = ARGV[2]
+ACCT_ID = ARGV[1]
+
+SLAPICLASSES = [ 'SoftLayer::Account' ]
+SoftLayer::declareClasses(:ruby => SLAPICLASSES)
+
+account = SoftLayer::Account.new(:user => AUTH_USER, :key => AUTH_KEY, :initParam => ACCT_ID)
+account.objectMask={ 'allBillingItems' => nil }
+  
+rtotal = rtax = 0
+ottotal = ottax = 0
+lftotal = lftax = 0
+sftotal = sftax = 0
+account['allBillingItems'].each do |b|
+  if b['cancellationDate'].nil?
+    rtotal = rtotal + rf = b['recurringFee'].to_f
+    ottotal = ottotal + ot = b['oneTimeFee'].to_f
+    lftotal = lftotal + lf = b['laborFee'].to_f
+    sftotal = sftotal + sf = b['setupFee'].to_f
+    rt = rf * rtr = b['recurringFeeTaxRate'].to_f
+    ott = ot * otr = b['oneTimeFeeTaxRate'].to_f
+    lft = lf * lfr = b['laborFeeTaxRate'].to_f
+    sft = sf * sfr = b['setupFeeTaxRate'].to_f
+    rtax = rtax + rt
+    ottax = ottax + ott
+    lftax = lftax + lft
+    sftax = sftax + sft
+
+    puts "Item Id #{b['id']}"
+    puts "Description #{b['description']}"
+    puts "Recurring Fee #{"$%.2f" % rf}"
+    puts "Recurring Tax #{"$%.2f" % rt} (#{rtr * 100}%)"
+    puts "One Time Fee #{"$%.2f" % ot}" unless ot == 0
+    puts "One Time Tax #{"$%.2f" % ott} (#{otr * 100}%)" unless ot == 0
+    puts "Labor Fee #{"$%.2f" % lf}" unless lf == 0
+    puts "Labor Fee Tax #{"$%.2f" % lft} (#{lfr * 100}%)" unless lf == 0
+    puts "Setup Fee #{"$%.2f" % sf}" unless sf == 0
+    puts "Setup Fee Tax #{"$%.2f" % sft} (#{sfr * 100}%)" unless sf == 0
+    puts "Recurring Months #{b['recurringMonths']}"
+    puts "Last Bill Date #{b['lastBillDate'].strftime("%b %d, %Y %X")}"
+    puts "Next Bill Date #{b['nextBillDate'].strftime("%b %d, %Y %X")}"
+    puts "Modify Date #{b['modifyDate'].strftime("%b %d, %Y %X")}"
+    puts "Create Date #{b['createDate'].strftime("%b %d, %Y %X")}"
+    puts "Associated Billing Item Id #{b['associatedBillingItemId']}"  unless b['associatedBillingItemId'].nil?
+    puts "=================================="
+    # pp b
+  end
+end
+puts ""
+puts "Totals:"
+puts "\tRecurring: #{"$%.2f" % rtotal} Tax: #{"$%.2f" % rtax} == #{"$%.2f" % (rtotal + rtax)}"
+puts "\tOne Time : #{"$%.2f" % ottotal} Tax: #{"$%.2f" % ottax} == #{"$%.2f" % (ottotal + ottax)}" unless ottotal == 0
+puts "\tLabor    : #{"$%.2f" % lftotal} Tax: #{"$%.2f" % lftax} == #{"$%.2f" % (lftotal + lftax)}" unless lftotal == 0
+puts "\tSetup    : #{"$%.2f" % sftotal} Tax: #{"$%.2f" % sftax} == #{"$%.2f" % (sftotal + sftax)}" unless sftotal == 0

data/sample/nascapacity.rb

@@ -0,0 +1,59 @@
+#!/usr/bin/env ruby
+# nascapacity
+#
+# Copyright (c) 2009, James Nuckolls. All rights reserved.
+# 
+#  Redistribution and use in source and binary forms, with or without
+#  modification, are permitted provided that the following conditions are met:
+# 
+#   * Redistributions of source code must retain the above copyright notice,
+#     this list of conditions and the following disclaimer.
+#   * Redistributions in binary form must reproduce the above copyright notice,
+#     this list of conditions and the following disclaimer in the documentation
+#     and/or other materials provided with the distribution.
+#   * Neither "James Nuckolls" nor the names of any contributors may
+#     be used to endorse or promote products derived from this software without
+#     specific prior written permission.
+# 
+#  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+#  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+#  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+#  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+#  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+#  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+#  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+#  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+#  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+#  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+#  POSSIBILITY OF SUCH DAMAGE.
+#
+#= Description
+# Prints a list of all StorageLater objects and their capacity.
+#= ToDo
+#
+
+require 'rubygems' rescue LoadError
+require 'pp'
+require 'softlayer'
+
+require 'soap/header/simplehandler'
+require 'soap/wsdlDriver'
+
+AUTH_USER = ARGV[0]
+AUTH_KEY = ARGV[2]
+ACCT_ID = ARGV[1]
+
+SLAPICLASSES = [ 'SoftLayer::Account', 'SoftLayer::Network::Storage' ]
+SoftLayer::declareClasses(:ruby => SLAPICLASSES)
+
+account = SoftLayer::Account.new(:user => AUTH_USER, :key => AUTH_KEY, :initParam => ACCT_ID)
+account.objectMask={ 'networkStorage' => { 'serviceResource' => nil } }
+
+nas = account['networkStorage'].each do |nas|
+  # pp nas
+  type = nas['nasType']
+  puts "//#{nas['serviceResource']['backendIpAddress']}/#{nas['username']} -- #{nas['capacityGb']}G" if (type == 'NAS' || type == 'LOCKBOX')
+  puts "#{nas['username']}@#{nas['serviceResource']['backendIpAddress']} -- #{nas['capacityGb']}G" if (type == 'EVAULT' || type == 'ISCSI')
+  puts "CloudLayer: #{nas['username']} -- #{nas['capacityGb']}G" if (type == 'HUB')
+end
+

data/sample/objectmask.rb

@@ -0,0 +1,56 @@
+#!/usr/bin/env ruby
+# objectmask
+#
+# Copyright (c) 2009, James Nuckolls. All rights reserved.
+# 
+#  Redistribution and use in source and binary forms, with or without
+#  modification, are permitted provided that the following conditions are met:
+# 
+#   * Redistributions of source code must retain the above copyright notice,
+#     this list of conditions and the following disclaimer.
+#   * Redistributions in binary form must reproduce the above copyright notice,
+#     this list of conditions and the following disclaimer in the documentation
+#     and/or other materials provided with the distribution.
+#   * Neither "James Nuckolls" nor the names of any contributors may
+#     be used to endorse or promote products derived from this software without
+#     specific prior written permission.
+# 
+#  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+#  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+#  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+#  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+#  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+#  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+#  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+#  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+#  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+#  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+#  POSSIBILITY OF SUCH DAMAGE.
+#
+#= Description
+# Fun with Object Masks.
+#= ToDo
+#
+
+require 'rubygems' rescue LoadError
+require 'pp'
+require 'softlayer'
+
+AUTH_USER = ARGV[0]
+AUTH_KEY = ARGV[2]
+ACCT_ID = ARGV[1]
+
+SLAPICLASSES = [ 'SoftLayer::Account' ]
+SoftLayer::declareClasses(:ruby => SLAPICLASSES)
+
+puts "Before: "
+account = SoftLayer::Account.new(:user => AUTH_USER, :key => AUTH_KEY, :initParam => ACCT_ID)
+account.objectMask={ 'allRecurringTopLevelBillingItems' => nil }
+pp account['allRecurringTopLevelBillingItems']
+puts "=================================="
+
+puts ""
+puts "After: "
+account.objectMask['allRecurringTopLevelBillingItems'] = { 'associatedChildren' => nil }
+# account.debug=STDOUT
+pp account['allRecurringTopLevelBillingItems']

metadata

@@ -0,0 +1,68 @@
+--- !ruby/object:Gem::Specification 
+name: jamesn-softlayer-ruby
+version: !ruby/object:Gem::Version 
+  version: 0.5.0.0
+platform: ruby
+authors: 
+- James Nuckolls
+autorequire: softlayer
+bindir: bin
+cert_chain: []
+
+date: 2009-04-11 22:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: soap4r
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.5.0
+    version: 
+description: 
+email: jamesn@what.net
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+- LICENSE
+files: 
+- lib/softlayer.rb
+- sample/nascapacity.rb
+- sample/billingreport.rb
+- sample/objectmask.rb
+- README
+- LICENSE
+has_rdoc: true
+homepage: http://github.com/jamesn/softlayer-ruby
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: A module and class factory for SoftLayer's customer portal API
+test_files: []
+