aws_sdk 3.1.5

data/lib/aws/ec2/vpn_gateway.rb

@@ -0,0 +1,123 @@
+# Copyright 2011-2012 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.
+
+require 'aws/ec2/vpn_gateway/attachment'
+
+module AWS
+  class EC2
+
+    class VPNGateway < Resource
+
+      include TaggedItem
+
+      def initialize vpn_gateway_id, options = {}
+        @vpn_gateway_id = vpn_gateway_id
+        super
+      end
+
+      # @return [String]
+      attr_reader :vpn_gateway_id
+
+      alias_method :id, :vpn_gateway_id
+    
+      attribute :state, :to_sym => true
+
+      attribute :vpn_type, :static => true
+
+      attribute :attachment_set, :as => :attachments
+
+      protected :attachment_set
+
+      populates_from(:create_vpn_gateway) do |resp|
+        resp.vpn_gateway if resp.vpn_gateway.vpn_gateway_id == id
+      end
+
+      populates_from(:describe_vpn_gateways) do |resp|
+        resp.vpn_gateway_set.find do |gateway| 
+          gateway.vpn_gateway_id == vpn_gateway_id
+        end
+      end
+
+      # @return [Array<VPNGateway::Attachment>]
+      def attachments
+        attachment_set.map {|details| Attachment.new(self, details) }
+      end
+
+      # @return [VPC,nil] Returns the currently attached VPC, or nil
+      #   if this gateway has not been attached.
+      def vpc
+        if attachment = attachments.first  
+          attachment.vpc
+        end
+      end
+
+      # Attaches this vpn gateway to the given VPC.
+      # @param [VPC,String] vpc A {VPC} object or a vpc id string.
+      # @return [Attachment]
+      def attach vpc
+
+        client_opts = {}
+        client_opts[:vpn_gateway_id] = vpn_gateway_id
+        client_opts[:vpc_id] = vpc_id(vpc)
+
+        resp = client.attach_vpn_gateway(client_opts)
+
+        Attachment.new(self, resp.attachment)
+
+      end
+
+      # Detaches this vpn gateway from the given VPC.
+      # @param [VPC,String] vpc A {VPC} object or a vpc id string.
+      # @return [nil]
+      def detach vpc
+        client_opts = {}
+        client_opts[:vpn_gateway_id] = vpn_gateway_id
+        client_opts[:vpc_id] = vpc_id(vpc)
+        client.detach_vpn_gateway(client_opts)
+        nil
+      end
+
+      # @return [VPNConnectionCollection] Returns a collection
+      #   of VPC connections for this gateway.
+      def vpn_connections
+        connections = VPNConnectionCollection.new(:config => config)
+        connections.filter('vpn-gateway-id', id)
+      end
+
+      # Deletes this vpn gateway.
+      # @return [nil]
+      def delete
+        client_opts = {}
+        client_opts[:vpn_gateway_id] = vpn_gateway_id
+        client.delete_vpn_gateway(client_opts)
+        nil
+      end
+
+      # @return [Boolean] Returns true if the gateway exists.
+      def exists?
+        begin
+          client.describe_vpn_gateways(:vpn_gateway_ids => [id])
+          true
+        rescue Errors::InvalidVPNGatewayID::NotFound
+          false
+        end
+      end
+
+      protected
+      def vpc_id vpc
+        vpc.is_a?(VPC) ? vpc.vpc_id : vpc
+      end
+
+    end
+  end
+end

data/lib/aws/ec2/vpn_gateway/attachment.rb

@@ -0,0 +1,45 @@
+# Copyright 2011-2012 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 EC2
+    class VPNGateway < Resource
+      class Attachment
+
+        # @private
+        def initialize vpn_gateway, details
+          @vpn_gateway = vpn_gateway
+          @vpc = VPC.new(details.vpc_id, :config => vpn_gateway.config)
+          @state = details.state.to_sym
+        end
+
+        # @return [VPNGateway]
+        attr_reader :vpn_gateway
+
+        # @return [VPC]
+        attr_reader :vpc
+
+        # @return [Symbol]
+        attr_reader :state
+
+        # Deletes this attachment.
+        # @return (see VPNGateway#detach)
+        def delete
+          vpn_gateway.detach(vpc)
+        end
+        alias_method :detach, :delete
+
+      end
+    end
+  end
+end

data/lib/aws/ec2/vpn_gateway_collection.rb

@@ -0,0 +1,77 @@
+# Copyright 2011-2012 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 EC2
+
+    class VPNGatewayCollection < Collection
+
+      include TaggedCollection
+      include Core::Collection::Simple
+
+      # Creates a new virtual private gateway. A virtual private gateway is 
+      # the VPC-side endpoint for your VPN connection. You can create a 
+      # virtual private gateway before creating the VPC itself.
+      #
+      # @param [Hash] options
+      #
+      # @option options [String] :vpn_type ('ipsec.1') The type of VPN 
+      #   connection this virtual private gateway supports.
+      #
+      # @option options [AvailabilityZone,String] :availability_zone
+      #   The Availability Zone where you want the virtual private gateway.
+      #   AWS can select a default zone for you.  This can be an
+      #   {AvailabilityZone} object or availability zone name string.
+      #   
+      # @return [VPNGateway]
+      #
+      def create options = {}
+
+        client_opts = {}
+        client_opts[:type] = options[:vpn_type] || 'ipsec.1'
+
+        if az = options[:availability_zone]
+          az = az.name if az.is_a?(AvailabilityZone)
+          client_opts[:availability_zone] = az
+        end
+
+        resp = client.create_vpn_gateway(client_opts)
+
+        VPNGateway.new_from(:create_vpn_gateway, resp.vpn_gateway,
+          resp.vpn_gateway.vpn_gateway_id, :config => config)
+
+      end
+
+      # @param [String] vpn_gateway_id
+      # @return [VPNGateway]
+      def [] vpn_gateway_id
+        VPNGateway.new(vpn_gateway_id, :config => config)
+      end
+
+      protected
+
+      def _each_item options = {}, &block
+        response = filtered_request(:describe_vpn_gateways, options, &block)
+        response.vpn_gateway_set.each do |g|
+
+          gateway = VPNGateway.new_from(:describe_vpn_gateways, g, 
+            g.vpn_gateway_id, :config => config)
+
+          yield(gateway)
+
+        end
+      end
+
+    end
+  end
+end

data/lib/aws/elb.rb

@@ -0,0 +1,65 @@
+# Copyright 2011-2012 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.
+
+require 'aws/core'
+require 'aws/elb/config'
+
+module AWS
+
+  # Provides an expressive, object-oriented interface to Elastic Load 
+  # Balancing (ELB).
+  #
+  # == Credentials
+  #
+  # You can setup default credentials for all AWS services via
+  # AWS.config:
+  #
+  #   AWS.config(
+  #     :access_key_id => 'YOUR_ACCESS_KEY_ID',
+  #     :secret_access_key => 'YOUR_SECRET_ACCESS_KEY')
+  #
+  # Or you can set them directly on the ELB interface:
+  #
+  #   elb = AWS::ELB.new(
+  #     :access_key_id => 'YOUR_ACCESS_KEY_ID',
+  #     :secret_access_key => 'YOUR_SECRET_ACCESS_KEY')
+  #
+  class ELB
+
+    AWS.register_autoloads(self) do
+      autoload :AvailabilityZoneCollection,    'availability_zone_collection'
+      autoload :BackendServerPolicyCollection, 'backend_server_policy_collection'
+      autoload :Client,                        'client'
+      autoload :Errors,                        'errors'
+      autoload :InstanceCollection,            'instance_collection'
+      autoload :ListenerOpts,                  'listener_opts'
+      autoload :Listener,                      'listener'
+      autoload :ListenerCollection,            'listener_collection'
+      autoload :LoadBalancer,                  'load_balancer'
+      autoload :LoadBalancerCollection,        'load_balancer_collection'
+      autoload :LoadBalancerPolicy,            'load_balancer_policy'
+      autoload :LoadBalancerPolicyCollection,  'load_balancer_policy_collection'
+      autoload :Request,                       'request'
+    end
+
+    include Core::ServiceInterface
+
+    # @return [LoadBalancerCollection] Returns a collection that represents
+    #   all of your load balancers.
+    def load_balancers
+      LoadBalancerCollection.new(:config => config)
+    end
+
+  end
+
+end

data/lib/aws/elb/availability_zone_collection.rb

@@ -0,0 +1,138 @@
+# Copyright 2011-2012 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
+
+    # A collection that help maanage the availability zones for 
+    # a load balancer.
+    #
+    #   load_balancer = AWS::ELB.new.load_balancers['my-load-balancer']
+    #
+    #   zones = load_balancer.availability_zones
+    #
+    #   # adding zones
+    #   zones.enable('us-east-1b', 'us-east-1c')
+    #
+    #   # removing zones
+    #   zones.disable('us-east-1b')
+    #
+    #   # enumerating enabled zones
+    #   zones.each do |zone|
+    #     puts zone.name
+    #   end
+    #
+    class AvailabilityZoneCollection
+
+      include Core::Collection::Simple
+
+      # @param [LoadBalancer] load_balancer The load balancer this list of 
+      #   availability zones belongs to.
+      def initialize load_balancer, options = {}
+        @load_balancer = load_balancer
+        super
+      end
+
+      # @return [LoadBalancer] Returns the load balancer this list describes.
+      attr_reader :load_balancer
+
+      # Adds one or more EC2 Availability Zones to the load balancer.
+      #
+      #   load_balancer.availability_zones.enable("us-east-1a", "us-east-1b")
+      #
+      # You can also pass {EC2::AvailabilityZone} objects:
+      #
+      #   # enable all availabilty zones for this region
+      #   zones = AWS::EC2.new.availability_zones.to_a
+      #   load_balancer.availability_zones.enable(zones)
+      #
+      # The load balancer evenly distributes requests across all its 
+      # registered availability zones that contain instances. As a result, 
+      # the client must ensure that its load balancer is appropriately 
+      # scaled for each registered Availability Zone.
+      #
+      # @param [String,EC2::AvailabilityZone] availability_zones One or more
+      #   availability zone names (strings) or objects {EC2::AvailabilityZone}.
+      #
+      # @return [nil]
+      # 
+      def enable *availability_zones
+
+        names = availability_zones.flatten.collect do |av|
+          av.is_a?(EC2::AvailabilityZone) ? av.name : av.to_s
+        end
+
+        client.enable_availability_zones_for_load_balancer(
+          :load_balancer_name => load_balancer.name,
+          :availability_zones => names)
+
+        nil
+
+      end
+
+      # Removes the specified EC2 availability zones from the set of 
+      # configured availability zones for the load balancer.
+      #
+      #   load_balancer.availability_zones.disable("us-east-1a", "us-east-1b")
+      #
+      # You can also pass {EC2::AvailabilityZone} objects:
+      #
+      #   # disable all availabilty zones
+      #   zones = AWS::EC2.new.availability_zones.to_a
+      #   load_balancer.availability_zones.disable(zones)
+      #
+      # There must be at least one availability zone registered with a 
+      # load balancer at all times. A client cannot remove all the availability 
+      # zones from a load balancer. Once an availability zone is removed, 
+      # all the instances registered with the load balancer that are in the 
+      # removed availability zone go into the out of service state. 
+      #
+      # Upon availability zone removal, the load balancer attempts to 
+      # equally balance the traffic among its remaining usable availability 
+      # zones. Trying to remove an availability zone that was not 
+      # associated with the load balancer does nothing.
+      #
+      # @param [String,EC2::AvailabilityZone] availability_zones One or more
+      #   availability zone names (strings) or objects {EC2::AvailabilityZone}.
+      #
+      # @return [nil]
+      # 
+      def disable *availability_zones
+
+        names = availability_zones.flatten.collect do |av|
+          av.is_a?(EC2::AvailabilityZone) ? av.name : av.to_s
+        end
+
+        client.disable_availability_zones_for_load_balancer(
+          :load_balancer_name => load_balancer.name,
+          :availability_zones => names)
+
+        nil
+
+      end
+
+      protected
+      def _each_item options = {}, &block
+        load_balancer.availability_zone_names.each do |az_name|
+
+          availability_zone = EC2::AvailabilityZone.new(
+            az_name, :config => config)
+
+          yield(availability_zone)
+
+        end
+      end
+
+    end
+  end
+end