aws-sdk 1.0.0

data/lib/aws/ec2/permission_collection.rb

@@ -0,0 +1,177 @@
+# 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.
+
+require 'aws/model'
+require 'aws/inflection'
+
+module AWS
+  class EC2
+
+    # Represents the collection of permissions for an EC2 resource.
+    # Each permission is a string containing the AWS account ID of a
+    # user who has permission to use the resource in question.  The
+    # {Image} and {Snapshot} classes are currently the only ones
+    # that use this interface.
+    class PermissionCollection
+
+      include Model
+      include Enumerable
+
+      # @private
+      def initialize(resource, opts = {})
+        @resource = resource
+        super(opts)
+      end
+
+      # @yield [user_id] Each user ID that has explicit
+      #   permissions to launch this AMI.
+      def each(&block)
+        resp = client.send(describe_call, describe_params)
+        resp.send(inflected_permissions_attribute).each do |permission|
+          if permission.respond_to?(:user_id)
+            user_id = permission.user_id
+            yield(user_id)
+          end
+        end
+      end
+
+      # @return [Integer] The number of users that have explicit
+      #   permissions to launch this AMI.
+      def size
+        inject(0) { |sum, i| sum + 1 }
+      end
+
+      # @return [Boolean] True if the collection is empty.
+      def empty?
+        size == 0
+      end
+
+      # @return [Boolean] True if the resource is public.
+      def public?
+        resp = client.send(describe_call, describe_params)
+        resp.send(inflected_permissions_attribute).any? do |permission|
+          permission.respond_to?(:group) and permission.group == "all"
+        end
+      end
+
+      # @return [Boolean] True if the resource is private (i.e. not
+      #   public).
+      def private?
+        !public?
+      end
+
+      # Sets whether the resource is public or not.  This has no
+      # effect on the explicit AWS account IDs that may already have
+      # permissions to use the resource.
+      #
+      # @param [Boolean] value If true, the resource is made public,
+      #   otherwise the resource is made private.
+      # @return [nil]
+      def public= value
+        params = value ? 
+          { :add => [{ :group => "all" }] } :
+          { :remove => [{ :group => "all" }] }
+        client.send(modify_call, modify_params(params))
+        nil
+      end
+
+      # Adds permissions for specific users to launch this AMI.
+      #
+      # @param [Array of Strings] users The AWS account IDs of the
+      #   users that should be able to launch this AMI.
+      # @return [nil]
+      def add(*users)
+        modify(:add, *users)
+      end
+
+      # Removes permissions for specific users to launch this AMI.
+      # @param [Array of Strings] users The AWS account IDs of the
+      #   users that should no longer be able to launch this AMI.
+      # @return [nil]
+      def remove(*users)
+        modify(:remove, *users)
+      end
+
+      # Resets the launch permissions to their default state.
+      # @return [nil]
+      def reset
+        client.send(reset_call, reset_params)
+      end
+
+      # @private
+      private
+      def describe_call
+        "describe_#{resource_name}_attribute"
+      end
+
+      # @private
+      private
+      def modify_call
+        "modify_#{resource_name}_attribute"
+      end
+
+      # @private
+      private
+      def reset_call
+        "reset_#{resource_name}_attribute"
+      end
+
+      # @private
+      private
+      def describe_params
+        Hash[[["#{resource_name}_id".to_sym, @resource.send(:__resource_id__)],
+              [:attribute, permissions_attribute]]]
+      end
+      alias_method :reset_params, :describe_params
+
+      # @private
+      private
+      def inflected_permissions_attribute
+        Inflection.ruby_name(permissions_attribute).to_sym
+      end
+
+      # @private
+      private
+      def permissions_attribute
+        @resource.__permissions_attribute__
+      end
+
+      # @private
+      private
+      def resource_name
+        @resource.send(:inflected_name)
+      end
+
+      # @private
+      private
+      def modify(action, *users)
+        return if users.empty?
+        opts = modify_params(Hash[[[action,
+                                    users.map do |user_id|
+                                      { :user_id => user_id }
+                                    end]]])
+        client.send(modify_call, opts)
+        nil
+      end
+
+      # @private
+      private
+      def modify_params(modifications)
+        Hash[[["#{resource_name}_id".to_sym, @resource.send(:__resource_id__)],
+              [inflected_permissions_attribute, modifications]]]
+      end
+
+    end
+
+  end
+end

data/lib/aws/ec2/region.rb

@@ -0,0 +1,81 @@
+# 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.
+
+require 'aws/ec2/resource'
+
+module AWS
+  class EC2
+
+    # Represents an EC2 region.  You can use this to find the
+    # endpoint for a given region:
+    #
+    #  ec2.regions["us-west-1"].endpoint
+    #
+    # Region also responds to all of the methods of {EC2} except
+    # {EC2#regions}; for example, to list instance IDs by region,
+    # you can do:
+    #
+    #  ec2.regions.inject({}) do |h,region|
+    #    h[region.name] = region.instances.map(&:id)
+    #    h
+    #  end
+    class Region < Resource
+
+      # The name of the region (e.g. "us-east-1")
+      attr_reader :name
+
+      def initialize(name, options = {})
+        @name = name
+        super(options)
+      end
+
+      # @return [String] The endpoint to use for this region.
+      def endpoint; end
+      describe_call_attribute :region_endpoint, :getter => :endpoint, :memoize => true
+
+      # @return [Boolean] True if the region is available for this
+      #   account.
+      def exists?
+        !client.describe_regions(:filters => [{ :name => "region-name",
+                                                :values => [name] }]).
+          region_info.empty?
+      end
+
+      PROXIED_METHODS = [:instances,
+                         :security_groups,
+                         :key_pairs,
+                         :elastic_ips,
+                         :tags,
+                         :availability_zones,
+                         :images,
+                         :volumes,
+                         :snapshots,
+                         :reserved_instances,
+                         :reserved_instances_offerings]
+
+      PROXIED_METHODS.each do |method|
+        define_method(method) do
+          EC2.new(:config => config, :ec2_endpoint => endpoint).
+            send(method)
+        end
+      end
+
+      protected
+      def find_in_response(resp)
+        resp.region_info.find { |r| r.region_name == name }
+      end
+
+    end
+
+  end
+end

data/lib/aws/ec2/region_collection.rb

@@ -0,0 +1,55 @@
+# 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.
+
+require 'aws/model'
+require 'aws/ec2/collection'
+require 'aws/ec2/region'
+
+module AWS
+  class EC2
+
+    # Represents all the regions available to your account.
+    #
+    # @example Getting a map of endpoints by region name
+    #   ec2.regions.inject({}) { |m, r| m[r.name] = r.endpoint; m }
+    class RegionCollection < Collection
+
+      # @yield [Region] Each region that is available to your account.
+      # @return [nil]
+      def each
+        response = filtered_request(:describe_regions)
+        response.region_info.each do |r|
+          region = Region.new(r.region_name,
+                              :endpoint => r.region_endpoint,
+                              :config => config)
+          yield(region)
+        end
+        nil
+      end
+
+      # @return [Region] The region identified by the given name
+      #   (e.g. "us-east-1").
+      def [](name)
+        super
+      end
+
+      # @private
+      protected
+      def member_class
+        Region
+      end
+
+    end
+
+  end
+end

data/lib/aws/ec2/request.rb

@@ -0,0 +1,27 @@
+# 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.
+
+require 'aws/http/request'
+require 'aws/authorize_v2'
+
+module AWS
+  class EC2
+
+    # @private
+    class Request < AWS::Http::Request
+
+      include AuthorizeV2
+
+    end
+  end
+end

data/lib/aws/ec2/reserved_instances.rb

@@ -0,0 +1,50 @@
+# 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.
+
+require 'aws/ec2/resource'
+require 'aws/ec2/tagged_item'
+
+module AWS
+  class EC2
+    class ReservedInstances < Resource
+
+      ATTRIBUTES = [
+        :start,
+        :instance_count,
+        :instance_type,
+        :availability_zone,
+        :duration,
+        :fixed_price,
+        :usage_price,
+        :product_description,
+        :instance_tenancy,
+        :currency_code,
+      ]
+
+      include TaggedItem
+
+      def initialize id, options = {}
+        @id = id
+        super
+      end
+
+      # @return [String] The id of this reserved instance.
+      attr_reader :id
+
+      ATTRIBUTES.each do |attr_name|
+        describe_call_attribute attr_name, :memoize => true
+      end
+
+    end
+  end
+end

data/lib/aws/ec2/reserved_instances_collection.rb

@@ -0,0 +1,44 @@
+# 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.
+
+require 'aws/ec2/collection'
+require 'aws/ec2/reserved_instances'
+require 'aws/ec2/tagged_collection'
+
+module AWS
+  class EC2
+    class ReservedInstancesCollection < Collection
+      
+      include TaggedCollection
+
+      def member_class
+        ReservedInstances
+      end
+
+      def each &block
+
+        response = filtered_request(:describe_reserved_instances)
+        response.reserved_instances_set.each do |item|
+
+          reserved_instance = ReservedInstances.new(
+            item.reserved_instances_id,
+            :config => config)
+
+          yield(reserved_instance)
+
+        end
+      end
+
+    end
+  end
+end

data/lib/aws/ec2/reserved_instances_offering.rb

@@ -0,0 +1,55 @@
+# 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.
+
+require 'aws/ec2/resource'
+require 'aws/ec2/tagged_item'
+
+module AWS
+  class EC2
+    class ReservedInstancesOffering < Resource
+
+      ATTRIBUTES = [
+        :instance_type,
+        :availability_zone,
+        :duration,
+        :fixed_price,
+        :usage_price,
+        :product_description,
+        :instance_tenancy,
+        :currency_code,
+      ]
+
+      include TaggedItem
+
+      def initialize id, options = {}
+        @id = id
+        super
+      end
+
+      # @return [String] The id of this reserved instance offering.
+      attr_reader :id
+
+      ATTRIBUTES.each do |attr_name|
+        describe_call_attribute attr_name, :memoize => true
+      end
+
+      def purchase options = {}
+        options[:instance_count] = 1 unless options[:instance_count]
+        options[:reserved_instances_offering_id] = id 
+        response = client.purchase_reserved_instances_offering(options)
+        ReservedInstances.new(response.reserved_instances_id, :config => config)
+      end
+
+    end
+  end
+end