aws_sdk 3.1.5

data/lib/aws/ec2/security_group/egress_ip_permission_collection.rb

@@ -0,0 +1,63 @@
+# 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 SecurityGroup < Resource
+      class EgressIpPermissionCollection
+
+        include Core::Model
+        include Enumerable
+
+        def initialize security_group, options = {}
+          @security_group = security_group
+          super
+        end
+
+        # @return [SecurityGroup]
+        attr_reader :security_group
+
+        def each
+          security_group.ip_permissions_list_egress.each do |p|
+
+            # egress permissions don't always have ports
+            if p[:from_port]
+              ports = [p[:from_port], p[:to_port]]
+            else
+              ports = nil
+            end
+
+            ip_ranges = p.ip_ranges.collect{|ip| ip.cidr_ip }
+
+            groups = p.groups.collect do |group|
+              SecurityGroup.new(group[:group_id],
+                :owner_id => group[:user_id],
+                :vpc_id => security_group.vpc_id,
+                :config => config)
+            end
+
+            permission = IpPermission.new(security_group, p.ip_protocol, ports,
+              :ip_ranges => ip_ranges,
+              :groups => groups,
+              :egress => true,
+              :config => config)
+
+            yield(permission)
+
+          end
+        end
+
+      end
+    end
+  end
+end

data/lib/aws/ec2/security_group/ingress_ip_permission_collection.rb

@@ -0,0 +1,61 @@
+# 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 SecurityGroup < Resource
+
+      class IngressIpPermissionCollection
+
+        include Core::Model
+        include Enumerable
+
+        def initialize security_group, options = {}
+          @security_group = security_group
+          super
+        end
+
+        # @return [SecurityGroup]
+        attr_reader :security_group
+
+        def each
+          security_group.ip_permissions_list.each do |p|
+
+            ports = p[:from_port] ? [p[:from_port], p[:to_port]] : nil
+
+            ip_ranges = p.ip_ranges.collect{|ip| ip.cidr_ip }
+
+            groups = p.groups.collect do |group|
+              SecurityGroup.new(group.group_id,
+                :owner_id => group.user_id,
+                :config => config)
+            end
+
+            permission = IpPermission.new(security_group, p.ip_protocol, ports,
+              :ip_ranges => ip_ranges,
+              :groups => groups,
+              :config => config)
+
+            yield(permission)
+
+          end
+        end
+
+      end
+
+      # alias for ingress permissions
+      IpPermissionCollection = IngressIpPermissionCollection
+
+    end
+  end
+end

data/lib/aws/ec2/security_group/ip_permission.rb

@@ -0,0 +1,128 @@
+# 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 SecurityGroup < Resource
+      class IpPermission
+
+        include Core::Model
+
+        # @param protocol [:tcp, :udp, :icmp]
+        #
+        # @param [Integer,Range<Integer>] ports A port or port range to allow.
+        #
+        # @param [Hash] options
+        #
+        # @option options [Array] :ip_ranges An array of CIDR ip address
+        #   to grant permission to.
+        #
+        # @option options [Array] :groups An array of SecurityGroup objects to
+        #   grant permission to.
+        #
+        # @option options [Boolean] :egress (false) When true this IpPermission
+        #   is assumed to be an egree permission.
+        #
+        def initialize security_group, protocol, ports, options = {}
+
+          @security_group = security_group
+
+          @protocol = protocol == '-1' ?  :any : protocol.to_s.downcase.to_sym
+
+          @ip_ranges = Array(options[:ip_ranges])
+
+          @groups = Array(options[:groups])
+
+          @egress = options[:egress]
+
+          # not all egress permissions require port ranges, depends on the
+          # protocol
+          if ports
+            @port_range = Array(ports).first.to_i..Array(ports).last.to_i
+          end
+
+          super
+
+        end
+
+        # @return [SecurityGroup] The security group this permission is 
+        #   authorized for.
+        attr_reader :security_group
+
+        # @return [Symbol] The protocol (:tcp, :udp, :icmp)
+        attr_reader :protocol
+
+        # @return [Range] The port range (e.g. 80..80, 4000..4010, etc)
+        attr_reader :port_range
+
+        # @return [Array] An array of string CIDR ip addresses.
+        attr_reader :ip_ranges
+
+        # @return [Array] An array of security groups that have been 
+        # granted access with this permission.
+        attr_reader :groups
+
+        # @return [Boolean] Returns true if this is an egress permission.
+        def egress?
+          @egress ? true : false
+        end
+
+        # Authorizes this permission from its security group.
+        # @return [IpPermission] Returns self
+        def authorize
+          update_sg(egress? ? :authorize_egress : :authorize_ingress)
+        end
+
+        # Revokes this permission from its security group.
+        # @return [IpPermission] Returns self
+        def revoke
+          update_sg(egress? ? :revoke_egress : :revoke_ingress)
+        end
+
+        # @return [Boolean] Returns true if the other IpPermission matches
+        #   this one.
+        def eql? other
+          other.is_a?(IpPermission) and
+          other.security_group == security_group and
+          other.protocol == protocol and
+          other.port_range == port_range and
+          other.ip_ranges == ip_ranges and
+          other.groups == groups and
+          other.egress == egress?
+        end
+        alias_method :==, :eql?
+
+        protected
+        def update_sg method
+
+          sources = []
+          sources += ip_ranges
+          sources += groups
+
+          if egress?
+            opts = {}
+            opts[:protocol] = protocol
+            opts[:ports] = port_range if port_range
+            sources << opts
+            security_group.send(method, *sources)
+          else
+            security_group.send(method, protocol, port_range, *sources)
+          end
+
+          self
+        end
+
+      end
+    end
+  end
+end

data/lib/aws/ec2/security_group_collection.rb

@@ -0,0 +1,135 @@
+# 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
+
+    # Represents all EC2 security groups in an AWS account.
+    class SecurityGroupCollection < Collection
+
+      include TaggedCollection
+
+      # Creates a new 
+      # @param [String] name The name of the security group to create.
+      # @param [Hash] options
+      # @option options [String] :description An informal description 
+      #   of this security group.  Accepts alphanumeric characters, spaces,
+      #   dashes, and underscores. If left blank the description will be set
+      #   to the name.
+      #
+      # @option options [VPC,String] :vpc (nil) A VPC or VPC id string to 
+      #   create the security group in.  When specified a VPC security
+      #   group is created.
+      #
+      # @return [SecurityGroup]
+      #
+      def create name, options = {}
+
+        description = options[:description] || name
+
+        create_opts = {}
+        create_opts[:group_name] = name
+        create_opts[:description] = description
+
+        vpc_id = options[:vpc]
+        vpc_id ||= options[:vpc_id] # for backwards compatability
+        vpc_id ||= filter_value_for('vpc-id')
+        vpc_id = vpc_id.id if vpc_id.is_a?(VPC)
+
+        create_opts[:vpc_id] = vpc_id if vpc_id
+
+        response = client.create_security_group(create_opts)
+
+        SecurityGroup.new(response.group_id, {
+          :name => name,
+          :description => description,
+          :vpc_id => create_opts[:vpc_id],
+          :config => config })
+
+      end
+
+      # @param [String] group_id The group id of a security group.
+      # @return [SecurityGroup] The group with the given id.
+      def [] group_id
+        SecurityGroup.new(group_id, :config => config)
+      end
+
+      # Specify one or more criteria to filter security groups by.
+      # A subsequent call to #each will limit the security groups returned
+      # by the set of filters.
+      #
+      # If you supply multiple values to #filter then these values are 
+      # treated as an OR condition.  To return security groups named
+      # 'test' or 'fake':
+      #
+      #   security_groups.filter('group-name', 'test', 'fake')
+      #
+      # If you want to and conditions together you need to chain calls to
+      # filter.  To limit security groups to those with a name like
+      # 'test' and like 'ruby':
+      #
+      #   security_groups.
+      #     filter('group-name', '*test*').
+      #     filter('group-name', '*ruby*').each do |group|
+      #     #...
+      #   end
+      #  
+      # Note that * matches one or more characters and ? matches any one
+      # character.
+      #
+      # === Valid Filters
+      #
+      # * description - Description of the security group.
+      # * group-id - ID of the security group.
+      # * group-name - Name of the security group.
+      # * ip-permission.cidr - CIDR range that has been granted the 
+      #   permission.
+      # * ip-permission.from-port - Start of port range for the TCP and UDP 
+      #    protocols, or an ICMP type number.
+      # * ip-permission.group-name - Name of security group that has been 
+      #   granted the permission.
+      # * ip-permission.protocol - IP protocol for the permission. Valid 
+      #   values include 'tcp', 'udp', 'icmp' or a protocol number.
+      # * ip-permission.to-port - End of port range for the TCP and UDP 
+      #   protocols, or an ICMP code.
+      # * ip-permission.user-id - ID of AWS account that has been granted 
+      #   the permission.
+      # * owner-id - AWS account ID of the owner of the security group.
+      # * tag-key - Key of a tag assigned to the security group.
+      # * tag-value - Value of a tag assigned to the security group.
+      #
+      # @return [SecurityGroupCollection] A new collection that represents
+      #   a subset of the security groups associated with this account.
+
+      # Yields once for each security group in this account. 
+      #
+      # @yield [group]
+      # @yieldparam [SecurityGroup] group
+      # @return [nil]
+      def each &block
+
+        response = filtered_request(:describe_security_groups)
+        response.security_group_info.each do |info|
+
+          group = SecurityGroup.new_from(:describe_security_groups, info, 
+            info.group_id, :config => config)
+
+          yield(group)
+
+        end
+        nil
+      end
+
+    end
+  end
+end

data/lib/aws/ec2/snapshot.rb

@@ -0,0 +1,143 @@
+# 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
+
+    # Represents an Amazon EBS snapshot.
+    #
+    # @example Taking a snapshot from a volume
+    #  snapshot = volume.create_snapshot("Database Backup 12/21/2010")
+    #  sleep 1 until [:completed, :error].include?(snapshot.status)
+    #
+    # @example Managing snapshot permissions
+    #  unless snapshot.public?
+    #    snapshot.permissions.add("12345678901")
+    #  end
+    #
+    # @attr_reader [String] volume_id The ID of the volume this
+    #   snapshot was created from.
+    #
+    # @attr_reader [Symbol] status The status of the snapshot.
+    #   Possible values:
+    #
+    #   * +:pending+
+    #   * +:completed+
+    #   * +:error+
+    #
+    # @attr_reader [Time] start_time The time at which the snapshot
+    #   was initiated.
+    #
+    # @attr_reader [Integer] progress The progress of the snapshot
+    #   as a percentage.
+    #
+    # @attr_reader [String] owner_id The AWS account ID of the
+    #   snapshot owner.
+    #
+    # @attr_reader [Integer] volume_size The size of the volume from
+    #   which the snapshot was created.
+    #
+    # @attr_reader [String] description The description of the
+    #   snapshot provided at snapshot initiation.
+    class Snapshot < Resource
+
+      include TaggedItem
+      include HasPermissions
+
+      # @private
+      def initialize id, options = {}
+        @id = id
+        super(options)
+      end
+
+      # @return [String] Returns the snapshot's ID.
+      attr_reader :id
+
+      attribute :status, :to_sym => true
+
+      attribute :start_time, :static => true
+
+      attribute :progress do
+        translates_output {|value| value.to_i if value }
+      end
+
+      attribute :owner_id, :static => true
+
+      attribute :volume_size, :static => true
+
+      attribute :volume_id, :static => true
+
+      attribute :owner_alias, :static => true
+
+      attribute :description, :static => true
+
+      alias_method :create_volume_permissions, :permissions
+
+      populates_from(:create_snapshot) do |resp|
+        resp if resp.snapshot_id == id
+      end
+
+      populates_from(:describe_snapshots) do |resp|
+        resp.snapshot_index[id]
+      end
+
+      # Deletes the snapshot.
+      # @return [nil]
+      def delete
+        client.delete_snapshot(:snapshot_id => id)
+        nil
+      end
+
+      # Creates a volume from the snapshot.
+      #
+      # @param [AvailabilityZone or String] availability_zone The
+      #   Availability Zone in which to create the new volume. See
+      #   {EC2#availability_zones} for how to get a list of
+      #   availability zones.
+      #
+      # @param [Hash] options Additional options for creating the volume
+      #
+      # @option options [Integer] size The desired size (in gigabytes)
+      #   for the volume.
+      #
+      # @return [Volume] The newly created volume
+      def create_volume availability_zone, options = {}
+        volumes = VolumeCollection.new(:config => config)
+        volumes.create(options.merge(
+          :availability_zone => availability_zone,
+          :snapshot => self
+        ))
+      end
+
+      # @return [Boolean] True if the snapshot exists.
+      def exists?
+        resp =
+          client.describe_snapshots(:filters => [{ :name => 'snapshot-id',
+                                                   :values => [id] }]) and
+          !resp.snapshot_set.empty?
+      end
+
+      # @return [Volume] The volume this snapshot was created from.
+      def volume
+        Volume.new(volume_id, :config => config) if volume_id
+      end
+
+      # @private
+      def __permissions_attribute__
+        "createVolumePermission"
+      end
+
+    end
+
+  end
+end