aws-sdk 1.1.4 → 1.2.0

data/lib/aws/elb/client.rb

@@ -0,0 +1,35 @@
+# Copyright 2011 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+
+module AWS
+  class ELB
+
+    # @private
+    class Client < Core::Client
+
+      AWS.register_autoloads(self) do
+        autoload :XML, 'xml'
+      end
+
+      include Core::ConfiguredClientMethods
+
+      API_VERSION = '2011-08-15'
+
+      # @private
+      REQUEST_CLASS = ELB::Request
+
+      configure_client
+
+    end
+  end
+end

data/lib/aws/elb/client/xml.rb

@@ -0,0 +1,33 @@
+# Copyright 2011 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+
+module AWS
+  class ELB
+    class Client < Core::Client
+
+      # @private
+      module XML
+
+        include Core::ConfiguredXmlGrammars
+        extend Core::IgnoreResultElement
+
+        BaseError = Core::XmlGrammar.customize do
+          element("Error") { ignore }
+        end
+
+        define_configured_grammars
+
+      end
+    end
+  end
+end

data/lib/aws/elb/config.rb

@@ -0,0 +1,18 @@
+# Copyright 2011 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+
+AWS::Core::Configuration.module_eval do
+
+  add_service 'ELB', 'elb', 'elasticloadbalancing.us-east-1.amazonaws.com'
+
+end

data/lib/aws/elb/errors.rb

@@ -0,0 +1,30 @@
+# Copyright 2011 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+
+module AWS
+  class ELB
+
+    # @private
+    module Errors
+
+      BASE_ERROR_GRAMMAR = Client::XML::BaseError
+
+      include Core::LazyErrorClasses
+
+      def self.error_class(code)
+        super(code.sub(/^ElasticLoadBalancing\./, ''))
+      end
+
+    end
+  end
+end

data/lib/aws/elb/instance_collection.rb

@@ -0,0 +1,174 @@
+# Copyright 2011 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+
+module AWS
+  class ELB
+
+    class InstanceCollection
+      
+      include Core::Collection::Simple
+
+      def initialize load_balancer, options = {}
+        @load_balancer = load_balancer
+        super
+      end
+
+      # Returns an {EC2::Instance} object with 3 extra methods added:
+      #
+      # * +#load_balancer+
+      #
+      # * +#remove_from_load_balancer+
+      #
+      # * +#elb_health+
+      #
+      # See {#health} for more information about what +#elb_health+ returns.
+      #
+      # @return [EC2::Instance] Return an EC2::Instance object with additional
+      #   methods added.
+      #
+      def [] instance_id
+
+        load_balancer = self.load_balancer
+
+        instance = EC2.new(:config => config).instances[instance_id]
+
+        Core::MetaUtils.extend_method(instance, :load_balancer) do
+          load_balancer
+        end
+
+        Core::MetaUtils.extend_method(instance, :elb_health) do
+          health = load_balancer.instances.health(id).first
+          health.delete(:instance)
+          health
+        end
+
+        Core::MetaUtils.extend_method(instance, :remove_from_load_balancer) do
+          load_balancer.instances.deregister(self)
+        end
+
+        instance
+        
+      end
+
+      # Returns an array of instance health descriptions.  Each description
+      # is a hash with the following entries:
+      #
+      #   * +:instance+ - The {EC2::Instance} being described.
+      #
+      #   * +:description+ - Provides a description of the instance.
+      #
+      #   * +:state+ - Specifies the current state of the instance.
+      #
+      #   * +:reason_code+ - Provides information about the cause of 
+      #     OutOfService instances. Specifically, it indicates whether the 
+      #     cause is Elastic Load Balancing or the instance behind the 
+      #     load balancer.
+      #
+      # You can get the health of all instances for this load balancer
+      # by passing no arguments to this method:
+      #
+      #   # get the health of all instances in the collection
+      #   load_balancer.instances.health.each do |instance_health|
+      #      puts "Instance: "    + instance_health[:instance].id
+      #      puts "description: " + instance_health[:description]
+      #      puts "state: "       + instance_health[:state]
+      #      puts "reason code: " + instance_health[:reason_code]
+      #   end
+      #
+      # If you want the health of a specific list of instances, pass
+      # instance ids or instance objects to this method:
+      #
+      #   # get the health for a few specific instances
+      #   load_balancer.instances.health('i-12345', 'i-67890').each{|h| ... }
+      #
+      # == Health for a Single Instance
+      #
+      # If you want the health of a single instance you can use the {#[]} 
+      # instead:
+      #
+      #   load_balancer.instances['i-123456'].elb_health
+      #   # => { :state => ..., :reason_code => ..., :description => ... }
+      #
+      # @param [String,EC2::Instance] One or more instances to receive 
+      #   health information for.
+      #
+      # @return [Array<Hash>] Returns an array of hashes.  Each hash represents
+      #   the health of a single instance.  Each hash includes the following
+      #   entries:
+      #
+      def health *instances
+
+        instance_ids = instance_ids(instances)
+
+        opts = {}
+        opts[:load_balancer_name] = load_balancer.name
+        opts[:instances] = instance_ids unless instance_ids.empty?
+
+        client.describe_instance_health(opts).instance_states.map do |state|
+          {
+            :instance => self[state.instance_id],
+            :description => state.description,
+            :state => state.state,
+            :reason_code => state.reason_code,
+          }
+        end
+
+      end
+
+      # @return [LoadBalancer] Returns the load balancer this collection 
+      #   belongs to.
+      attr_reader :load_balancer
+
+      def register *instances
+
+        client.register_instances_with_load_balancer(
+          :load_balancer_name => load_balancer.name,
+          :instances => instance_ids(instances))
+
+        nil
+
+      end
+      alias_method :add, :register
+
+      def deregister *instances
+
+        client.deregister_instances_from_load_balancer(
+          :load_balancer_name => load_balancer.name,
+          :instances => instance_ids(instances))
+
+        nil
+
+      end
+      alias_method :remove, :deregister
+
+      protected
+      def instance_ids instances
+        instances.flatten.collect do |instance|
+          case instance
+          when EC2::Instance then { :instance_id => instance.id }
+          else { :instance_id => instance }
+          end
+        end
+      end
+
+      protected
+      def _each_item options = {}
+        load_balancer.instance_descriptions.each do |instance|
+          instance = self[instance.instance_id]
+          yield(instance)
+        end
+      end
+
+    end
+  end
+end

data/lib/aws/elb/listener.rb

@@ -0,0 +1,189 @@
+# Copyright 2011 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+
+module AWS
+  class ELB
+
+    class Listener
+
+      include Core::Model
+
+      # @param [LoadBalancer] load_balancer The load balancer this listener
+      #   belongs to.
+      #
+      # @param [Integer] port The external load balancer port number.
+      #
+      # @param [Hash] options
+      #
+      # @option (see ListenerCollection#create)
+      #
+      def initialize load_balancer, port, options = {}
+
+        @load_balancer = load_balancer
+        @port = port.to_i
+        @protocol = options[:protocol]
+        @instance_port = options[:instance_port]
+        @instance_protocol = options[:instance_protocol]
+
+        super
+
+      end
+
+      # @return [LoadBalancer]
+      attr_reader :load_balancer
+
+      # @return [Integer] 
+      attr_reader :port
+
+      # @return [Symbol] Returns the protocl for this listener.
+      def protocol
+        proto = @protocol || _description.listener.protocol
+        proto.to_s.downcase.to_sym
+      end
+
+      # @return [Integer]
+      def instance_port
+        @instance_port || _description.listener.instance_port
+      end
+
+      # @return [Symbol]
+      def instance_protocol
+        proto = @instance_protocol || _description.listener.instance_protocol
+        proto.to_s.downcase.to_sym
+      end
+
+      # Sets the certificate that terminates the specified listener's SSL 
+      # connections. The specified certificate replaces any prior 
+      # certificate for this listener.
+      #
+      # @param [String,IAM::ServerCertificate] server_certificate The ARN 
+      #   of an IAM::ServerCertificate or an IAM::ServerCertificate object.
+      #
+      # @return [nil]
+      #
+      def server_certificate= server_certificate
+
+        arn = server_certificate.is_a?(IAM::ServerCertificate) ?
+          server_certificate.arn : server_certificate
+
+        client.set_load_balancer_listener_ssl_certificate(
+          :load_balancer_name => load_balancer.name,
+          :load_balancer_port => port,
+          :ssl_certificate_id => arn)
+
+        nil
+
+      end
+
+      # @return [IAM::ServerCertificate,nil] Returns the IAM::ServerCertificate
+      #   associated with this listener, or nil if there is none.
+      def server_certificate
+        desc = _description
+        if desc.listener.respond_to?(:ssl_certificate_id)
+          AWS.memoize do
+            arn = desc.listener.ssl_certificate_id
+            iam = IAM.new(:config => config)
+            iam.server_certificates.find{|cert| cert.arn == arn }
+          end
+        else
+          nil
+        end
+      end
+
+      # @return [LoadBalancerPolicy,nil] Returns the current policy for this
+      #   listener.  Returns nil if no load balancer policy has been 
+      #   associated with it.
+      def policy
+        policy_name = _description.policy_names.first
+        policy_name ? load_balancer.policies[policy_name] : nil
+      end
+
+      # @param [String,LoadBalancerPolicy] policy_or_policy_name Sets
+      #   the policy for this listener.
+      # @return [LoadBalancerPolicy]
+      def policy= policy_or_policy_name
+
+        policy_name = policy_or_policy_name.is_a?(LoadBalancerPolicy) ?
+          policy_or_policy_name.name : policy_or_policy_name.to_s
+      
+        client.set_load_balancer_policies_of_listener(
+          :load_balancer_name => load_balancer.name,
+          :load_balancer_port => port,
+          :policy_names => [policy_name])
+
+        LoadBalancerPolicy.new(load_balancer, policy_name, :config => config)
+
+      end
+
+      # Removes the current policy from this listener.
+      # @return [nil]
+      def remove_policy
+
+        client.set_load_balancer_policies_of_listener(
+          :load_balancer_name => load_balancer.name,
+          :load_balancer_port => port,
+          :policy_names => [])
+
+        nil
+
+      end
+
+      # Returns true if this listener exists.
+      #
+      #   load_balancer = ELB.new.load_balancers['my-load-balancer']
+      #   listener = load_balancer.listeners[80] # port 80
+      #   listener.exists?
+      #
+      # @return [Boolean] Returns true if the load balancer has a listener
+      #   on this port.
+      def exists?
+        !_description.nil?
+      rescue AWS::Core::Resource::NotFound
+        false
+      end
+
+      # Deletes the listener from its load balancer.
+      # @return [nil]
+      def delete
+
+        client.delete_load_balancer_listeners(
+          :load_balancer_name => load_balancer.name,
+          :load_balancer_ports => [port])
+
+        nil
+
+      end
+
+      # @private
+      def inspect
+        "#{self.class.name} port:#{port}>"
+      end
+
+      # @private
+      def == other
+        other.is_a?(Listener) and 
+        other.load_balancer == load_balancer and
+        other.port == port
+      end
+      alias_method :eql?, :==
+
+      protected
+      def _description
+        load_balancer.listener_descriptions.find do |desc| 
+          desc.listener.load_balancer_port == port
+        end
+      end
+
+    end
+  end
+end