aws-sdk-v1 1.52.0

data/lib/aws/ec2/collection.rb

@@ -0,0 +1,36 @@
+# Copyright 2011-2013 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 Collection
+
+      include Core::Model
+      include Enumerable
+      include FilteredCollection
+
+      # @param [String] id Returns the collection member with the given id.
+      def [] id
+        member_class.new(id.to_s, :config => config)
+      end
+
+      protected
+      def member_class
+        raise NotImplementedError
+      end
+
+    end
+
+  end
+end

data/lib/aws/ec2/config.rb

@@ -0,0 +1,21 @@
+# Copyright 2011-2013 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 'EC2', 'ec2', 'ec2'
+
+  # deprecated - no longer has any effect
+  add_option :ec2_signature_version, :v4
+
+end

data/lib/aws/ec2/customer_gateway.rb

@@ -0,0 +1,90 @@
+# Copyright 2011-2013 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
+
+    # @attr_reader [Symbol] state Returns the gateway state (e.g.
+    #   :pending, :available, :deleting, :deleted)
+    #
+    # @attr_reader [String] type The type of VPN connection the customer
+    #   gateway supports (e.g. 'ipsec.1').
+    #
+    # @attr_reader [String] ip_address The Internet-routable IP address of
+    #   the customer gateway's outside interface.
+    #
+    # @attr_reader [Integer] bgp_asn The customer gateway's Border Gateway
+    #   Protocol (BGP) Autonomous System Number (ASN).
+    #
+    class CustomerGateway < Resource
+
+      include TaggedItem
+
+      # @api private
+      def initialize customer_gateway_id, options = {}
+        @customer_gateway_id = customer_gateway_id
+        super
+      end
+
+      # @return [String]
+      attr_reader :customer_gateway_id
+
+      alias_method :id, :customer_gateway_id
+
+      attribute :state, :to_sym => true
+
+      attribute :vpn_type, :static => true
+
+      attribute :ip_address, :static => true
+
+      attribute :bgp_asn, :static => true
+
+      populates_from(:create_customer_gateway) do |resp|
+        resp.customer_gateway if resp.customer_gateway.customer_gateway_id == id
+      end
+
+      populates_from(:describe_customer_gateways) do |resp|
+        resp.customer_gateway_set.find do |gateway|
+          gateway.customer_gateway_id == customer_gateway_id
+        end
+      end
+
+      # @return [VPNConnectionCollection] Returns a collection
+      #   of VPC connections for this gateway.
+      def vpn_connections
+        connections = VPNConnectionCollection.new(:config => config)
+        connections.filter('customer-gateway-id', id)
+      end
+
+      # Deletes this customer gateway.
+      # @return [nil]
+      def delete
+        client_opts = {}
+        client_opts[:customer_gateway_id] = customer_gateway_id
+        client.delete_customer_gateway(client_opts)
+        nil
+      end
+
+      # @return [Boolean] Returns true if the gateway exists.
+      def exists?
+        begin
+          client.describe_customer_gateways(:customer_gateway_ids => [id])
+          true
+        rescue Errors::InvalidCustomerGatewayID::NotFound
+          false
+        end
+      end
+
+    end
+  end
+end

data/lib/aws/ec2/customer_gateway_collection.rb

@@ -0,0 +1,73 @@
+# Copyright 2011-2013 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 CustomerGatewayCollection < Collection
+
+      include TaggedCollection
+      include Core::Collection::Simple
+
+      # @param [Integer] bgp_asn The customer gateway's Border Gateway
+      #   Protocol (BGP) Autonomous System Number (ASN).
+      #
+      # @param [String] ip_address The Internet-routable IP address for the
+      #   customer gateway's outside interface. The address must be static.
+      #
+      # @param [Hash] options
+      #
+      # @option options [String] :vpn_type ('ipsec.1') The type of VPN
+      #   connection this customer gateway supports.
+      #
+      # @return [CustomerGateway]
+      #
+      def create bgp_asn, ip_address, options = {}
+
+        client_opts = {}
+        client_opts[:bgp_asn] = bgp_asn
+        client_opts[:public_ip] = ip_address
+        client_opts[:type] = options[:vpn_type] || 'ipsec.1'
+
+        resp = client.create_customer_gateway(client_opts)
+
+        CustomerGateway.new_from(:create_customer_gateway,
+          resp.customer_gateway,
+          resp.customer_gateway.customer_gateway_id,
+          :config => config)
+
+      end
+
+      # @param [String] customer_gateway_id
+      # @return [CustomerGateway]
+      def [] customer_gateway_id
+        CustomerGateway.new(customer_gateway_id, :config => config)
+      end
+
+      protected
+
+      def _each_item options = {}, &block
+        response = filtered_request(:describe_customer_gateways, options, &block)
+        response.customer_gateway_set.each do |g|
+
+          gateway = CustomerGateway.new_from(:describe_customer_gateways, g,
+            g.customer_gateway_id, :config => config)
+
+          yield(gateway)
+
+        end
+      end
+
+    end
+  end
+end

data/lib/aws/ec2/dhcp_options.rb

@@ -0,0 +1,106 @@
+# Copyright 2011-2013 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 DHCPOptions < Resource
+
+      include TaggedItem
+
+      # @api private
+      def initialize dhcp_options_id, options = {}
+        @dhcp_options_id = dhcp_options_id
+        super
+      end
+
+      # @return [String]
+      attr_reader :dhcp_options_id
+
+      alias_method :id, :dhcp_options_id
+
+      attribute :dhcp_configuration_set, :static => true
+
+      protected :dhcp_configuration_set
+
+      populates_from(:create_dhcp_options) do |resp|
+        resp.dhcp_options if resp.dhcp_options.dhcp_options_id == id
+      end
+
+      populates_from(:describe_dhcp_options) do |resp|
+        resp.dhcp_options_set.find do |dhcp_options|
+          dhcp_options.dhcp_options_id == dhcp_options_id
+        end
+      end
+
+      # @return [Hash]
+      def configuration
+        dhcp_configuration_set.to_a.inject({}) do |config,opt|
+          key = opt[:key].gsub(/-/, '_').to_sym
+          values = opt[:value_set].map{|v| v[:value] }
+          values = values.first if key == :domain_name
+          values = values.first.to_i if key == :netbios_node_type
+          config.merge(key => values)
+        end
+      end
+
+      # Associates this set of options to the given VPC.
+      # @param [VPC,String] vpc A {VPC} object or a vpc id string.
+      # @return [nil]
+      def associate vpc
+        client_opts = {}
+        client_opts[:dhcp_options_id] = dhcp_options_id
+        client_opts[:vpc_id] = vpc_id_option(vpc)
+        client.associate_dhcp_options(client_opts)
+        nil
+      end
+
+      # Deletes these DHCP options.  An error will be raised if these
+      # options are currently associated to a VPC.  To disassociate this
+      # set of options from a VPC, associate a different set of options
+      # with the VPC.
+      #
+      # @return [nil]
+      #
+      def delete
+        client_opts = {}
+        client_opts[:dhcp_options_id] = dhcp_options_id
+        client.delete_dhcp_options(client_opts)
+        nil
+      end
+
+      # @return [VPCCollection] Returns a collection that represents
+      #   all VPCs currently using this dhcp options.
+      def vpcs
+        vpcs = VPCCollection.new(:config => config)
+        vpcs.filter('dhcp-options-id', dhcp_options_id)
+      end
+
+      # @return [Boolean] Returns true if the dhcp options exists.
+      def exists?
+        begin
+          get_resource
+          true
+        rescue Errors::InvalidDhcpOptionID::NotFound
+          false
+        end
+      end
+
+      protected
+      def vpc_id_option vpc
+        vpc.is_a?(VPC) ? vpc.vpc_id : vpc
+      end
+
+    end
+  end
+end

data/lib/aws/ec2/dhcp_options_collection.rb

@@ -0,0 +1,87 @@
+# Copyright 2011-2013 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 DHCPOptionsCollection < Collection
+
+      include TaggedCollection
+      include Core::Collection::Simple
+
+      # @param [Hash] options
+      #
+      # @option options [required,String] :domain_name A domain name of your
+      #   choice (e.g., example.com).
+      #
+      # @option options [Array<String>] :domain_name_servers
+      #   The IP addresses of domain name servers. You can specify up to
+      #   four addresses.
+      #
+      # @option options [Array<String>] :ntp_servers
+      #   The IP addresses of Network Time Protocol (NTP) servers. You can
+      #   specify up to four addresses.
+      #
+      # @option options [Array<String>] :netbios_name_servers
+      #   The IP addresses of NetBIOS name servers. You can specify up to
+      #   four addresses.
+      #
+      # @option options [String] :netbios_node_type Value indicating the
+      #   NetBIOS node type (1, 2, 4, or 8). For more information about the
+      #   values, go to RFC 2132. We recommend you only use 2 at this time
+      #   (broadcast and multicast are currently not supported).
+      #
+      def create options = {}
+
+        configurations = []
+        options.each_pair do |opt,values|
+          opt = opt.to_s.gsub(/_/, '-')
+          values = values.is_a?(Array) ? values : [values]
+          configurations << { :key => opt, :values => values.map(&:to_s) }
+        end
+
+        client_opts = {}
+        client_opts[:dhcp_configurations] = configurations
+
+        resp = client.create_dhcp_options(client_opts)
+
+        DHCPOptions.new_from(:create_dhcp_options,
+          resp.dhcp_options,
+          resp.dhcp_options.dhcp_options_id,
+          :config => config)
+
+      end
+
+      # @param [String] dhcp_options_id
+      # @return [DHCPOptions]
+      def [] dhcp_options_id
+        DHCPOptions.new(dhcp_options_id, :config => config)
+      end
+
+      protected
+
+      def _each_item options = {}, &block
+        response = filtered_request(:describe_dhcp_options, options, &block)
+        response.dhcp_options_set.each do |opts|
+
+          options = DHCPOptions.new_from(:describe_dhcp_options, opts,
+            opts.dhcp_options_id, :config => config)
+
+          yield(options)
+
+        end
+      end
+
+    end
+  end
+end

data/lib/aws/ec2/elastic_ip.rb

@@ -0,0 +1,209 @@
+# Copyright 2011-2013 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
+
+    # @attr_reader [String,nil] instance_id Returns the instance id if
+    #   assigned to an EC2 instance, nil otherwise.
+    #
+    # @attr_reader [String,nil] allocation_id
+    #   The ID representing the allocation of the address for use with Amazon
+    #   VPC.
+    #
+    # @attr_reader [String] domain Indicates whether this elastic ip address
+    #   is for EC2 instances ('standard') or VPC instances ('vpc').
+    #
+    # @attr_reader [String,nil] association_id The ID of the association
+    #   between this elastic ip address and an EC2 VPC instance (VPC only).
+    #
+    # @attr_reader [String,nil] network_interface_id The ID of the network
+    #   interface (VPC only).
+    #
+    # @attr_reader [String,nil] network_interface_owner_id
+    #   The ID of the AWS account that owns the network interface (VPC only).
+    #
+    class ElasticIp < Resource
+
+      def initialize public_ip, options = {}
+        @public_ip = public_ip
+        super
+      end
+
+      # @return [String] The public IP address.
+      attr_reader :public_ip
+
+      alias_method :ip_address, :public_ip
+
+      attribute :instance_id
+
+      # vpc related attributes
+
+      attribute :allocation_id, :static => true
+
+      attribute :domain, :static => true
+
+      attribute :association_id
+
+      attribute :network_interface_id
+
+      attribute :network_interface_owner_id
+
+      populates_from(:describe_addresses) do |resp|
+        resp.address_index[public_ip]
+      end
+
+      # @return [Boolean] Returns true if this is an EC2 VPC Elastic IP.
+      def vpc?
+        domain == 'vpc'
+      end
+
+      # @return [Boolean] Returns true if this IP address is associated
+      #   with an EC2 instance or a network interface.
+      def associated?
+        !!(instance_id || association_id)
+      end
+
+      alias_method :attached?, :associated?
+
+      # @return [Instance,nil] If associated, returns the {Instance} this
+      #   elastic IP address is associated to, nil otherwise.
+      def instance
+        if instance_id = self.instance_id
+          Instance.new(instance_id, :config => config)
+        end
+      end
+
+      # @return [NetworkInterface,nil] Returns the network interface this
+      #   elastic ip is associated with.  Returns `nil` if this is not
+      #   associated with an elastic ip address.
+      def network_interface
+        if nid = network_interface_id
+          NetworkInterface.new(nid, :config => config)
+        end
+      end
+
+      # Releases the elastic IP address.
+      #
+      # (For non-VPC elastic ips) Releasing an IP address automatically
+      # disassociates it from any instance it's associated with.
+      #
+      # @return [nil]
+      def delete
+        if vpc?
+          client.release_address(:allocation_id => allocation_id)
+        else
+          client.release_address(:public_ip => public_ip)
+        end
+        nil
+      end
+      alias_method :release, :delete
+
+      # Associates this elastic IP address with an instance or a network
+      # interface.  You may provide `:instance` or `:network_interface`
+      # but not both options.
+      #
+      #     # associate with an instance
+      #     eip.associate :instance => 'i-12345678'
+      #
+      #     # associate with a network interface
+      #     eip.associate :network_interface => 'ni-12345678'
+      #
+      # @param [Hash] options
+      #
+      # @option options [String,Instance] :instance The id of an instance
+      #   or an {Instance} object.
+      #
+      # @option options [String,NetworkInterface] :network_interface The id
+      #   of a network interface or a {NetworkInterface} object.
+      #
+      # @return [String] Returns the resulting association id.
+      #
+      def associate options
+
+        client_opts = {}
+
+        [:instance,:network_interface,:private_ip_address].each do |opt|
+          if value = options[opt]
+            	key = ( opt.to_s=='instance' || opt.to_s=='network_interface' ? opt.to_s+"_id" : opt.to_s ) 
+		client_opts[:"#{key}"] = value.is_a?(Resource) ? value.id : value
+          end
+        end
+
+        if vpc?
+          client_opts[:allocation_id] = allocation_id
+        else
+          client_opts[:public_ip] = public_ip
+        end
+
+        resp = client.associate_address(client_opts)
+        resp.data[:association_id]
+
+      end
+
+      # Disassociates this elastic IP address from an EC2 instance.
+      # Raises an exception if this elastic IP is not currently
+      # associated with an instance.
+      # @return [nil]
+      def disassociate
+        if vpc?
+          client.disassociate_address(:association_id => association_id)
+        else
+          client.disassociate_address(:public_ip => public_ip)
+        end
+        nil
+      end
+
+      # @return [Boolean] Returns true the elastic ip address exists in
+      #   your account.
+      def exists?
+        begin
+          get_resource
+          true
+        rescue Errors::InvalidAddress::NotFound
+          false
+        end
+      end
+
+      # @return [String] Returns the public IP address
+      def to_s
+        public_ip.to_s
+      end
+
+      # @api private
+      protected
+      def resource_id_method
+        :public_ip
+      end
+
+      # @api private
+      protected
+      def response_id_method
+        :public_ip
+      end
+
+      # @api private
+      protected
+      def describe_call_name
+        :describe_addresses
+      end
+
+      # @api private
+      protected
+      def self.describe_call_name
+        :describe_addresses
+      end
+
+    end
+  end
+end