krisr-amazon-ec2 0.5.0

data/lib/AWS/ELB.rb

@@ -0,0 +1,57 @@
+# Require any lib files that we have bundled with this Ruby Gem in the lib/ELB directory.
+# Parts of the EC2 module and Base class are broken out into separate
+# files for maintainability and are organized by the functional groupings defined
+# in the EC2 API developers guide.
+Dir[File.join(File.dirname(__FILE__), 'ELB/**/*.rb')].sort.each { |lib| require lib }
+
+module AWS
+  module ELB
+
+    # Which host FQDN will we connect to for all API calls to AWS?
+    # If ELB_URL is defined in the users ENV we can use that. It is
+    # expected that this var is set with something like:
+    #   export ELB_URL='https://ec2.amazonaws.com'
+    #
+    if ENV['ELB_URL']
+      ELB_URL = ENV['ELB_URL']
+      VALID_HOSTS = ['elasticloadbalancing.amazonaws.com']
+      raise ArgumentError, "Invalid ELB_URL environment variable : #{ELB_URL}" unless VALID_HOSTS.include?(ELB_URL)
+      DEFAULT_HOST = URI.parse(ELB_URL).host
+    else
+      # default US host
+      DEFAULT_HOST = 'elasticloadbalancing.amazonaws.com'
+    end
+
+    # This is the version of the API as defined by Amazon Web Services
+    API_VERSION = '2009-05-15'
+
+    #Introduction:
+    #
+    # The library exposes one main interface class, 'AWS::ELB::Base'.
+    # This class provides all the methods for using the ELB service
+    # including the handling of header signing and other security issues .
+    # This class uses Net::HTTP to interface with the ELB Query API interface.
+    #
+    #Required Arguments:
+    #
+    # :access_key_id => String (default : "")
+    # :secret_access_key => String (default : "")
+    #
+    #Optional Arguments:
+    #
+    # :use_ssl => Boolean (default : true)
+    # :server => String (default : 'elasticloadbalancing.amazonaws.com')
+    # :proxy_server => String (default : nil)
+    #
+    class Base < AWS::Base
+      def api_version
+        API_VERSION
+      end
+    
+      def default_host
+        DEFAULT_HOST
+      end
+    end
+
+  end
+end

data/lib/AWS/ELB/load_balancers.rb

@@ -0,0 +1,201 @@
+module AWS
+  module ELB
+    class Base < AWS::Base
+      # Amazon Developer Guide Docs:
+      #
+      # This API creates a new LoadBalancer. Once the call has completed
+      # successfully, a new LoadBalancer will be created, but it will not be
+      # usable until at least one instance has been registered. When the
+      # LoadBalancer creation is completed, you can check whether it is usable
+      # by using the DescribeInstanceHealth API. The LoadBalancer is usable as
+      # soon as any registered instance is InService.
+      #
+      # Required Arguments:
+      #
+      #  :load_balancer_name => String
+      #  :listeners => Array of Hashes (:protocol, :load_balancer_port, :instance_port)
+      #  :availability_zones => Array of Strings
+      #
+      def create_load_balancer( options = {} )
+        raise ArgumentError, "No :availability_zones provided" if options[:availability_zones].nil? || options[:availability_zones].empty?
+        raise ArgumentError, "No :listeners provided" if options[:listeners].nil? || options[:listeners].empty?
+        raise ArgumentError, "No :load_balancer_name provided" if options[:load_balancer_name].nil? || options[:load_balancer_name].empty?
+
+        params = {}
+      
+        params.merge!(pathlist('AvailabilityZones.member', [options[:availability_zones]].flatten))
+        params.merge!(pathhashlist('Listeners.member', [options[:listeners]].flatten, {
+          :protocol => 'Protocol',
+          :load_balancer_port => 'LoadBalancerPort',
+          :instance_port => 'InstancePort'
+        }))
+        params['LoadBalancerName'] = options[:load_balancer_name]
+
+        return response_generator(:action => "CreateLoadBalancer", :params => params)
+      end
+    
+      # Amazon Developer Guide Docs:
+      #
+      # This API deletes the specified LoadBalancer. On deletion, all of the
+      # configured properties of the LoadBalancer will be deleted. If you
+      # attempt to recreate the LoadBalancer, you need to reconfigure all the
+      # settings. The DNS name associated with a deleted LoadBalancer is no
+      # longer be usable. Once deleted, the name and associated DNS record of
+      # the LoadBalancer no longer exist and traffic sent to any of its IP
+      # addresses will no longer be delivered to your instances. You will not
+      # get the same DNS name even if you create a new LoadBalancer with same
+      # LoadBalancerName.
+      #  
+      # Required Arguments:
+      #
+      #  :load_balancer_name => String
+      #
+      def delete_load_balancer( options = {} )
+        raise ArgumentError, "No :load_balancer_name provided" if options[:load_balancer_name].nil? || options[:load_balancer_name].empty?
+      
+        params = { 'LoadBalancerName' => options[:load_balancer_name] }
+      
+        return response_generator(:action => "DeleteLoadBalancer", :params => params)
+      end
+    
+      # Amazon Developer Guide Docs:
+      #
+      # This API returns detailed configuration information for the specified
+      # LoadBalancers, or if no LoadBalancers are specified, then the API
+      # returns configuration information for all LoadBalancers created by the
+      # caller. For more information, please see LoadBalancer.
+      #
+      # You must have created the specified input LoadBalancers in order to
+      # retrieve this information. In other words, in order to successfully call
+      # this API, you must provide the same account credentials as those that
+      # were used to create the LoadBalancer. 
+      # 
+      # Optional Arguments:
+      # 
+      #  :load_balancer_names => String
+      # 
+      def describe_load_balancers( options = {} )
+        options = { :load_balancer_names => [] }.merge(options)
+
+        params = pathlist("LoadBalancerName.member", options[:load_balancer_names])
+
+        return response_generator(:action => "DescribeLoadBalancers", :params => params)
+      end
+      
+      # Amazon Developer Guide Docs:
+      #
+      # This API adds new instances to the LoadBalancer.
+      #  
+      # Once the instance is registered, it starts receiving traffic and
+      # requests from the LoadBalancer. Any instance that is not in any of the
+      # Availability Zones registered for the LoadBalancer will be moved to
+      # the OutOfService state. It will move to the InService state when the
+      # Availability Zone is added to the LoadBalancer.
+      #  
+      # You must have been the one who created the LoadBalancer. In other
+      # words, in order to successfully call this API, you must provide the
+      # same account credentials as those that were used to create the
+      # LoadBalancer.
+      #  
+      # NOTE: Completion of this API does not guarantee that operation has
+      # completed. Rather, it means that the request has been registered and
+      # the changes will happen shortly.
+      #
+      # Required Arguments:
+      # 
+      #  :instances => Array of Strings
+      #  :load_balancer_name => String
+      #
+      def register_instances_with_load_balancer( options = {} )
+        raise ArgumentError, "No :instances provided" if options[:instances].nil? || options[:instances].empty?
+        raise ArgumentError, "No :load_balancer_name provided" if options[:load_balancer_name].nil? || options[:load_balancer_name].empty?
+
+        params = {}
+      
+        params.merge!(pathhashlist('Instances.member', [options[:instances]].flatten.map{|instance| {:instance_id => instance}}, {
+          :instance_id => 'InstanceId'
+        }))
+        params['LoadBalancerName'] = options[:load_balancer_name]
+
+        return response_generator(:action => "RegisterInstancesWithLoadBalancer", :params => params)
+      end
+      
+      # Amazon Developer Guide Docs:
+      #  
+      # This API deregisters instances from the LoadBalancer. Trying to
+      # deregister an instance that is not registered with the LoadBalancer
+      # does nothing.
+      #
+      # In order to successfully call this API, you must provide the same
+      # account credentials as those that were used to create the
+      # LoadBalancer.
+      #  
+      # Once the instance is deregistered, it will stop receiving traffic from
+      # the LoadBalancer.
+      #
+      # Required Arguments:
+      # 
+      #  :instances => Array of Strings
+      #  :load_balancer_name => String
+      #
+      def deregister_instances_from_load_balancer( options = {} )
+        raise ArgumentError, "No :instances provided" if options[:instances].nil? || options[:instances].empty?
+        raise ArgumentError, "No :load_balancer_name provided" if options[:load_balancer_name].nil? || options[:load_balancer_name].empty?
+        
+        params = {}
+        
+        params.merge!(pathhashlist('Instances.member', [options[:instances]].flatten.map{|instance| {:instance_id => instance}}, {
+          :instance_id => 'InstanceId'
+        }))
+        params['LoadBalancerName'] = options[:load_balancer_name]
+
+        return response_generator(:action => "DeregisterInstancesFromLoadBalancer", :params => params)
+      end
+      
+      # Amazon Developer Guide Docs:
+      #
+      # This API enables you to define an application healthcheck for the
+      # instances.
+      #
+      # Note: Completion of this API does not guarantee that operation has completed. Rather, it means that the request has been registered and the changes will happen shortly.
+      #
+      # Required Arguments
+      #
+      #  :health_check => Hash (:timeout, :interval, :unhealthy_threshold, :healthy_threshold)
+      #  :load_balancer_name => String
+      #
+      def configure_health_check( options = {} )
+        raise ArgumentError, "No :health_check provided" if options[:health_check].nil? || options[:health_check].empty?
+        raise ArgumentError, "No :health_check => :target provided" if options[:health_check][:target].nil? || options[:health_check][:target].empty?
+        raise ArgumentError, "No :health_check => :timeout provided" if options[:health_check][:timeout].nil? || options[:health_check][:timeout].empty?
+        raise ArgumentError, "No :health_check => :interval provided" if options[:health_check][:interval].nil? || options[:health_check][:interval].empty?
+        raise ArgumentError, "No :health_check => :unhealthy_threshold provided" if options[:health_check][:unhealthy_threshold].nil? || options[:health_check][:unhealthy_threshold].empty?
+        raise ArgumentError, "No :health_check => :healthy_threshold provided" if options[:health_check][:healthy_threshold].nil? || options[:health_check][:healthy_threshold].empty?
+        raise ArgumentError, "No :load_balancer_name provided" if options[:load_balancer_name].nil? || options[:load_balancer_name].empty?
+        
+        params = {}
+        
+        params['LoadBalancerName'] = options[:load_balancer_name]
+        params['HealthCheck.Target'] = options[:health_check][:target]
+        params['HealthCheck.Timeout'] = options[:health_check][:timeout]
+        params['HealthCheck.Interval'] = options[:health_check][:interval]
+        params['HealthCheck.UnhealthyThreshold'] = options[:health_check][:unhealthy_threshold]
+        params['HealthCheck.HealthyThreshold'] = options[:health_check][:healthy_threshold]
+        
+        return response_generator(:action => "ConfigureHealthCheck", :params => params)
+      end
+      
+      def describe_intance_health( options = {} )
+        raise "Not yet implemented"
+      end
+      
+      def disable_availability_zones_for_load_balancer( options = {} )
+        raise "Not yet implemented"
+      end
+      
+      def enable_availability_zones_for_load_balancer( options = {} )
+        raise "Not yet implemented"
+      end
+    end
+  end
+end

data/lib/AWS/exceptions.rb

@@ -0,0 +1,169 @@
+#--
+# Amazon Web Services EC2 Query API Ruby library
+#
+# Ruby Gem Name::  amazon-ec2
+# Author::    Glenn Rempe  (mailto:glenn@rempe.us)
+# Copyright:: Copyright (c) 2007-2008 Glenn Rempe
+# License::   Distributes under the same terms as Ruby
+# Home::      http://github.com/grempe/amazon-ec2/tree/master
+#++
+
+module AWS
+  # OUR CUSTOM ERROR CODES
+
+  # All of our errors are superclassed by Error < RuntimeError
+  class Error < RuntimeError #:nodoc:
+  end
+
+  # A client side only argument error
+  class ArgumentError < Error #:nodoc:
+  end
+
+
+  # AWS EC2 CLIENT ERROR CODES
+
+  # AWS EC2 can throw error exceptions that contain a '.' in them.
+  # since we can't name an exception class with that '.' I compressed
+  # each class name into the non-dot version.  This allows us to retain
+  # the granularity of the exception.
+
+  # User not authorized.
+  class AuthFailure < Error #:nodoc:
+  end
+
+  # Invalid AWS Account
+  class InvalidClientTokenId < Error #:nodoc:
+  end
+
+  # Invalid Parameters for Value
+  class InvalidParameterValue < Error #:nodoc:
+  end
+
+  # Specified AMI has an unparsable manifest.
+  class InvalidManifest < Error #:nodoc:
+  end
+
+  # Specified AMI ID is not valid.
+  class InvalidAMIIDMalformed < Error #:nodoc:
+  end
+
+  # Specified AMI ID does not exist.
+  class InvalidAMIIDNotFound < Error #:nodoc:
+  end
+
+  # Specified AMI ID has been deregistered and is no longer available.
+  class InvalidAMIIDUnavailable < Error #:nodoc:
+  end
+
+  # Specified instance ID is not valid.
+  class InvalidInstanceIDMalformed < Error #:nodoc:
+  end
+
+  # Specified instance ID does not exist.
+  class InvalidInstanceIDNotFound < Error #:nodoc:
+  end
+
+  # Specified keypair name does not exist.
+  class InvalidKeyPairNotFound < Error #:nodoc:
+  end
+
+  # Attempt to create a duplicate keypair.
+  class InvalidKeyPairDuplicate < Error #:nodoc:
+  end
+
+  # Specified group name does not exist.
+  class InvalidGroupNotFound < Error #:nodoc:
+  end
+
+  # Attempt to create a duplicate group.
+  class InvalidGroupDuplicate < Error #:nodoc:
+  end
+
+  # Specified group can not be deleted because it is in use.
+  class InvalidGroupInUse < Error #:nodoc:
+  end
+
+  # Specified group name is a reserved name.
+  class InvalidGroupReserved < Error #:nodoc:
+  end
+
+  # Attempt to authorize a permission that has already been authorized.
+  class InvalidPermissionDuplicate < Error #:nodoc:
+  end
+
+  # Specified permission is invalid.
+  class InvalidPermissionMalformed < Error #:nodoc:
+  end
+
+  # Specified reservation ID is invalid.
+  class InvalidReservationIDMalformed < Error #:nodoc:
+  end
+
+  # Specified reservation ID does not exist.
+  class InvalidReservationIDNotFound < Error #:nodoc:
+  end
+
+  # User has reached max allowed concurrent running instances.
+  class InstanceLimitExceeded < Error #:nodoc:
+  end
+
+  # An invalid set of parameters were passed as arguments
+  # e.g. RunInstances was called with minCount and maxCount set to 0 or minCount > maxCount.
+  class InvalidParameterCombination < Error #:nodoc:
+  end
+
+  # An unknown parameter was passed as an argument
+  class UnknownParameter < Error #:nodoc:
+  end
+
+  # The user ID is neither in the form of an AWS account ID or one
+  # of the special values accepted by the owner or executableBy flags
+  # in the DescribeImages call.
+  class InvalidUserIDMalformed < Error #:nodoc:
+  end
+
+  # The value of an item added to, or removed from, an image attribute is invalid.
+  class InvalidAMIAttributeItemValue < Error #:nodoc:
+  end
+  
+  class MalformedInput < Error #:nodoc:
+  end
+  
+  # ELB ERRORS
+  
+  class LoadBalancerNotFound < Error #:nodoc:
+  end
+  
+  class ValidationError < Error #:nodoc:
+  end
+  
+  class DuplicateLoadBalancerName < Error #:nodoc:
+  end
+  
+  class TooManyLoadBalancers < Error #:nodoc:
+  end
+  
+  class InvalidInstance < Error #:nodoc:
+  end
+  
+  class InvalidConfigurationRequest < Error #:nodoc:
+  end
+
+  # AWS EC2 SERVER ERROR CODES
+
+  # Internal AWS EC2 Error.
+  class InternalError < Error #:nodoc:
+  end
+
+  # There are not enough available instances to satify your minimum request.
+  class InsufficientInstanceCapacity < Error #:nodoc:
+  end
+
+  # The server is overloaded and cannot handle request.
+  class Unavailable < Error #:nodoc:
+  end
+
+  class SignatureDoesNotMatch < Error #:nodoc:
+  end
+
+end

data/lib/AWS/responses.rb

@@ -0,0 +1,61 @@
+#--
+# Amazon Web Services EC2 Query API Ruby library
+#
+# Ruby Gem Name::  amazon-ec2
+# Author::    Glenn Rempe  (mailto:glenn@rempe.us)
+# Copyright:: Copyright (c) 2007-2008 Glenn Rempe
+# License::   Distributes under the same terms as Ruby
+# Home::      http://github.com/grempe/amazon-ec2/tree/master
+#++
+
+# This allows us to access hash values as if they were methods
+# e.g. foo[:bar] can be accessed as foo.bar
+
+class Hash
+  def method_missing(meth, *args, &block)
+    if args.size == 0
+      self[meth.to_s] || self[meth.to_sym]
+    end
+  end
+end
+
+module AWS
+
+  # The make_request() and aws_error? methods, which are shared by all, will raise any
+  # exceptions encountered along the way as it converses with EC2.
+  #
+  # Exception Handling: If for some reason an error occurrs when executing a method
+  # (e.g. its arguments were incorrect, or it simply failed) then an exception will
+  # be thrown.  The exceptions are defined in exceptions.rb as individual classes and should
+  # match the exceptions that Amazon has defined for EC2.  If the exception raised cannot be
+  # identified then a more generic exception class will be thrown.
+  #
+  # The implication of this is that you need to be prepared to handle any exceptions that
+  # may be raised by this library in YOUR code with a 'rescue' clauses.  It is up to you
+  # how gracefully you want to handle these exceptions that are raised.
+
+  begin
+    require 'xmlsimple' unless defined? XmlSimple
+  rescue Exception => e
+    require 'xml-simple' unless defined? XmlSimple
+  end
+
+  class Response
+
+    def self.parse(options = {})
+      options = {
+        :xml => "",
+        :parse_options => { 'forcearray' => ['item', 'member'], 'suppressempty' => nil, 'keeproot' => false }
+      }.merge(options)
+
+      # NOTE: Parsing the response as a nested set of Response objects was extremely
+      # memory intensive and appeared to leak (the memory was not freed on subsequent requests).
+      # It was changed to return the raw XmlSimple response.
+      response = XmlSimple.xml_in(options[:xml], options[:parse_options])
+
+      return response
+    end
+
+  end  # class Response
+
+end  # module AWS