amazon-ec2 0.4.8 → 0.5.0

data/lib/EC2/console.rb

@@ -1,44 +0,0 @@
-#--
-# Amazon Web Services EC2 Query API Ruby library
-#
-# Ruby Gem Name::  amazon-ec2
-# Author::    Glenn Rempe  (mailto:glenn@rempe.us)
-# Copyright:: Copyright (c) 2007-2008 Glenn Rempe
-# License::   Distributes under the same terms as Ruby
-# Home::      http://github.com/grempe/amazon-ec2/tree/master
-#++
-
-module EC2
-
-  class Base
-
-    #Amazon Developer Guide Docs:
-    #
-    # The GetConsoleOutput operation retrieves console output that has been posted for the specified instance.
-    #
-    # Instance console output is buffered and posted shortly after instance boot, reboot and once the instance
-    # is terminated. Only the most recent 64 KB of posted output is available. Console output is available for
-    # at least 1 hour after the most recent post.
-    #
-    #Required Arguments:
-    #
-    # :instance_id => String (default : "")
-    #
-    #Optional Arguments:
-    #
-    # none
-    #
-    def get_console_output( options ={} )
-
-      options = {:instance_id => ""}.merge(options)
-
-      raise ArgumentError, "No instance ID provided" if options[:instance_id].nil? || options[:instance_id].empty?
-
-      params = { "InstanceId" => options[:instance_id] }
-
-      return response_generator(:action => "GetConsoleOutput", :params => params)
-
-    end
-  end
-
-end

data/lib/EC2/elastic_ips.rb

@@ -1,153 +0,0 @@
-#--
-# Amazon Web Services EC2 Query API Ruby library
-#
-# Ruby Gem Name::  amazon-ec2
-# Author::    Glenn Rempe  (mailto:glenn@rempe.us)
-# Copyright:: Copyright (c) 2007-2008 Glenn Rempe
-# License::   Distributes under the same terms as Ruby
-# Home::      http://github.com/grempe/amazon-ec2/tree/master
-#++
-
-module EC2
-
-  class Base
-
-
-    #Amazon Developer Guide Docs:
-    #
-    # The AllocateAddress operation acquires an elastic IP address for use with your account.
-    #
-    #Required Arguments:
-    #
-    # none
-    #
-    #Optional Arguments:
-    #
-    # none
-    #
-    def allocate_address
-
-      return response_generator(:action => "AllocateAddress")
-
-    end
-
-    #Amazon Developer Guide Docs:
-    #
-    # The DescribeAddresses operation lists elastic IP addresses assigned to your account.
-    #
-    #Required Arguments:
-    #
-    # :public_ip => Array (default : [], can be empty)
-    #
-    #Optional Arguments:
-    #
-    # none
-    #
-    def describe_addresses( options = {} )
-
-      options = { :public_ip => [] }.merge(options)
-
-      params = pathlist("PublicIp", options[:public_ip])
-
-      return response_generator(:action => "DescribeAddresses", :params => params)
-
-    end
-
-    #Amazon Developer Guide Docs:
-    #
-    # The ReleaseAddress operation releases an elastic IP address associated with your account.
-    #
-    # If you run this operation on an elastic IP address that is already released, the address
-    # might be assigned to another account which will cause Amazon EC2 to return an error.
-    #
-    # Note : Releasing an IP address automatically disassociates it from any instance
-    # with which it is associated. For more information, see DisassociateAddress.
-    #
-    # Important! After releasing an elastic IP address, it is released to the IP
-    # address pool and might no longer be available to your account. Make sure
-    # to update your DNS records and any servers or devices that communicate
-    # with the address.
-    #
-    #Required Arguments:
-    #
-    # :public_ip => String (default : '')
-    #
-    #Optional Arguments:
-    #
-    # none
-    #
-    def release_address( options = {} )
-
-      options = { :public_ip => '' }.merge(options)
-
-      raise ArgumentError, "No ':public_ip' provided" if options[:public_ip].nil? || options[:public_ip].empty?
-
-      params = { "PublicIp" => options[:public_ip] }
-
-      return response_generator(:action => "ReleaseAddress", :params => params)
-
-    end
-
-    #Amazon Developer Guide Docs:
-    #
-    # The AssociateAddress operation associates an elastic IP address with an instance.
-    #
-    # If the IP address is currently assigned to another instance, the IP address
-    # is assigned to the new instance. This is an idempotent operation. If you enter
-    # it more than once, Amazon EC2 does not return an error.
-    #
-    #Required Arguments:
-    #
-    # :instance_id  => String (default : '')
-    # :public_ip    => String (default : '')
-    #
-    #Optional Arguments:
-    #
-    # none
-    #
-    def associate_address( options = {} )
-
-      options = { :instance_id => '', :public_ip => '' }.merge(options)
-
-      raise ArgumentError, "No ':instance_id' provided" if options[:instance_id].nil? || options[:instance_id].empty?
-      raise ArgumentError, "No ':public_ip' provided" if options[:public_ip].nil? || options[:public_ip].empty?
-
-      params = {
-        "InstanceId" => options[:instance_id],
-        "PublicIp" => options[:public_ip]
-      }
-
-      return response_generator(:action => "AssociateAddress", :params => params)
-
-    end
-
-    #Amazon Developer Guide Docs:
-    #
-    # The DisassociateAddress operation disassociates the specified elastic IP
-    # address from the instance to which it is assigned. This is an idempotent
-    # operation. If you enter it more than once, Amazon EC2 does not return
-    # an error.
-    #
-    #Required Arguments:
-    #
-    # :public_ip    => String (default : '')
-    #
-    #Optional Arguments:
-    #
-    # none
-    #
-    def disassociate_address( options = {} )
-
-      options = { :public_ip => '' }.merge(options)
-
-      raise ArgumentError, "No ':public_ip' provided" if options[:public_ip].nil? || options[:public_ip].empty?
-
-      params = { "PublicIp" => options[:public_ip] }
-
-      return response_generator(:action => "DisassociateAddress", :params => params)
-
-    end
-
-  end
-
-end

data/lib/EC2/image_attributes.rb

@@ -1,166 +0,0 @@
-#--
-# Amazon Web Services EC2 Query API Ruby library
-#
-# Ruby Gem Name::  amazon-ec2
-# Author::    Glenn Rempe  (mailto:glenn@rempe.us)
-# Copyright:: Copyright (c) 2007-2008 Glenn Rempe
-# License::   Distributes under the same terms as Ruby
-# Home::      http://github.com/grempe/amazon-ec2/tree/master
-#++
-
-module EC2
-
-  class Base
-
-    #Amazon Developer Guide Docs:
-    #
-    # The ModifyImageAttribute operation modifies an attribute of an AMI.  The following attributes may
-    # currently be modified:
-    #
-    # 'launchPermission' : Controls who has permission to launch the AMI. Launch permissions can be
-    # granted to specific users by adding userIds. The AMI can be made public by adding the 'all' group.
-    #
-    # 'productCodes' : Associates product codes with AMIs. This allows a developer to charge a user extra
-    # for using the AMIs. productCodes is a write once attribute - once it has been set it can not be
-    # changed or removed.  Currently only one product code is supported per AMI.
-    #
-    #Required Arguments:
-    #
-    # :image_id => String (default : "")
-    # :attribute => String ('launchPermission' or 'productCodes', default : "launchPermission")
-    # :operation_type => String (default : "")
-    #
-    #Optional Arguments:
-    #
-    # :user_id => Array (default : [])
-    # :group => Array (default : [])
-    # :product_code => Array (default : [])
-    #
-    def modify_image_attribute( options = {} )
-
-      # defaults
-      options = { :image_id => "",
-                  :attribute => "launchPermission",
-                  :operation_type => "",
-                  :user_id => [],
-                  :group => [],
-                  :product_code => [] }.merge(options)
-
-      raise ArgumentError, "No ':image_id' provided" if options[:image_id].nil? || options[:image_id].empty?
-      raise ArgumentError, "No ':attribute' provided" if options[:attribute].nil? || options[:attribute].empty?
-
-      # OperationType is not required if modifying a product code.
-      unless options[:attribute] == 'productCodes'
-        raise ArgumentError, "No ':operation_type' provided" if options[:operation_type].nil? || options[:operation_type].empty?
-      end
-
-      params = {
-        "ImageId" => options[:image_id],
-        "Attribute" => options[:attribute],
-        "OperationType" => options[:operation_type]
-      }
-
-      # test options provided and make sure they are valid
-      case options[:attribute]
-      when "launchPermission"
-
-        unless options[:operation_type] == "add" || options[:operation_type] == "remove"
-          raise ArgumentError, ":operation_type was #{options[:operation_type].to_s} but must be either 'add' or 'remove'"
-        end
-
-        if (options[:user_id].nil? || options[:user_id].empty?) && (options[:group].nil? || options[:group].empty?)
-          raise ArgumentError, "Option :attribute=>'launchPermission' requires ':user_id' or ':group' options to also be specified"
-        end
-        params.merge!(pathlist("UserId", options[:user_id])) unless options[:user_id].nil?
-        params.merge!(pathlist("Group", options[:group])) unless options[:group].nil?
-      when "productCodes"
-        if (options[:product_code].nil? || options[:product_code].empty?)
-          raise ArgumentError, "Option :attribute=>'productCodes' requires ':product_code' to be specified"
-        end
-        params.merge!(pathlist("ProductCode", options[:product_code])) unless options[:product_code].nil?
-      else
-        raise ArgumentError, "attribute : #{options[:attribute].to_s} is not an known attribute."
-      end
-
-      return response_generator(:action => "ModifyImageAttribute", :params => params)
-
-    end
-
-    #Amazon Developer Guide Docs:
-    #
-    # The DescribeImageAttribute operation returns information about an attribute of an AMI.
-    #
-    #Required Arguments:
-    #
-    # :image_id => String (default : "")
-    # :attribute => String ("launchPermission" or "productCodes", default : "launchPermission")
-    #
-    #Optional Arguments:
-    #
-    # none
-    #
-    def describe_image_attribute( options = {} )
-
-      # defaults
-      options = {:image_id => "",
-                 :attribute => "launchPermission"
-                 }.merge(options)
-
-      raise ArgumentError, "No ':image_id' provided" if options[:image_id].nil? || options[:image_id].empty?
-      raise ArgumentError, "No ':attribute' provided" if options[:attribute].nil? || options[:attribute].empty?
-
-      params = { "ImageId" => options[:image_id], "Attribute" => options[:attribute] }
-
-      # test options provided and make sure they are valid
-      case options[:attribute]
-      when "launchPermission", "productCodes"
-        # these args are ok
-      else
-        raise ArgumentError, "attribute : #{options[:attribute].to_s} is not an known attribute."
-      end
-
-      return response_generator(:action => "DescribeImageAttribute", :params => params)
-
-    end
-
-
-    #Amazon Developer Guide Docs:
-    #
-    # The ResetImageAttribute operation resets an attribute of an AMI to its default value.
-    #
-    #Required Arguments:
-    #
-    # :image_id => String (default : "")
-    # :attribute => String (default : "launchPermission")
-    #
-    #Optional Arguments:
-    #
-    # none
-    #
-    def reset_image_attribute( options = {} )
-
-      # defaults
-      options = {:image_id => "",
-                 :attribute => "launchPermission"}.merge(options)
-
-      raise ArgumentError, "No ':image_id' provided" if options[:image_id].nil? || options[:image_id].empty?
-      raise ArgumentError, "No ':attribute' provided" if options[:attribute].nil? || options[:attribute].empty?
-
-      params = {"ImageId" => options[:image_id],
-                "Attribute" => options[:attribute] }
-
-      # test options provided and make sure they are valid
-      case options[:attribute]
-      when "launchPermission"
-        # these args are ok
-      else
-        raise ArgumentError, "attribute : #{options[:attribute].to_s} is not an known attribute."
-      end
-
-      return response_generator(:action => "ResetImageAttribute", :params => params)
-
-    end
-
-  end
-
-end

data/lib/EC2/images.rb

@@ -1,134 +0,0 @@
-#--
-# Amazon Web Services EC2 Query API Ruby library
-#
-# Ruby Gem Name::  amazon-ec2
-# Author::    Glenn Rempe  (mailto:glenn@rempe.us)
-# Copyright:: Copyright (c) 2007-2008 Glenn Rempe
-# License::   Distributes under the same terms as Ruby
-# Home::      http://github.com/grempe/amazon-ec2/tree/master
-#++
-
-module EC2
-
-  class Base
-
-    #Amazon Developer Guide Docs:
-    #
-    # The RegisterImage operation registers an AMI with Amazon EC2. Images must be registered before
-    # they can be launched.  Each AMI is associated with an unique ID which is provided by the EC2
-    # service via the Registerimage operation. As part of the registration process, Amazon EC2 will
-    # retrieve the specified image manifest from Amazon S3 and verify that the image is owned by the
-    # user requesting image registration.  The image manifest is retrieved once and stored within the
-    # Amazon EC2 network. Any modifications to an image in Amazon S3 invalidate this registration.
-    # If you do have to make changes and upload a new image deregister the previous image and register
-    # the new image.
-    #
-    #Required Arguments:
-    #
-    # :image_location => String (default : "")
-    #
-    #Optional Arguments:
-    #
-    # none
-    #
-    def register_image( options = {} )
-
-      options = {:image_location => ""}.merge(options)
-
-      raise ArgumentError, "No :image_location provided" if options[:image_location].nil? || options[:image_location].empty?
-
-      params = { "ImageLocation" => options[:image_location] }
-
-      return response_generator(:action => "RegisterImage", :params => params)
-
-    end
-
-    #Amazon Developer Guide Docs:
-    #
-    # The DescribeImages operation returns information about AMIs available for use by the user. This
-    # includes both public AMIs (those available for any user to launch) and private AMIs (those owned by
-    # the user making the request and those owned by other users that the user making the request has explicit
-    # launch permissions for).
-    #
-    # The list of AMIs returned can be modified via optional lists of AMI IDs, owners or users with launch
-    # permissions. If all three optional lists are empty all AMIs the user has launch permissions for are
-    # returned. Launch permissions fall into three categories:
-    #
-    # Launch Permission Description
-    #
-    # public - The all group has launch permissions for the AMI. All users have launch permissions for these AMIs.
-    # explicit - The owner of the AMIs has granted a specific user launch permissions for the AMI.
-    # implicit - A user has implicit launch permissions for all AMIs he or she owns.
-    #
-    # If one or more of the lists are specified the result set is the intersection of AMIs matching the criteria of
-    # the individual lists.
-    #
-    # Providing the list of AMI IDs requests information for those AMIs only. If no AMI IDs are provided,
-    # information of all relevant AMIs will be returned. If an AMI is specified that does not exist a fault is
-    # returned. If an AMI is specified that exists but the user making the request does not have launch
-    # permissions for, then that AMI will not be included in the returned results.
-    #
-    # Providing the list of owners requests information for AMIs owned by the specified owners only. Only
-    # AMIs the user has launch permissions for are returned. The items of the list may be account ids for
-    # AMIs owned by users with those account ids, amazon for AMIs owned by Amazon or self for AMIs
-    # owned by the user making the request.
-    #
-    # The executable list may be provided to request information for AMIs that only the specified users have
-    # launch permissions for. The items of the list may be account ids for AMIs owned by the user making the
-    # request that the users with the specified account ids have explicit launch permissions for, self for AMIs
-    # the user making the request has explicit launch permissions for or all for public AMIs.
-    #
-    # Deregistered images will be included in the returned results for an unspecified interval subsequent to
-    # deregistration.
-    #
-    #Required Arguments:
-    #
-    # none
-    #
-    #Optional Arguments:
-    #
-    # :image_id => Array (default : [])
-    # :owner_id => Array (default : [])
-    # :executable_by => Array (default : [])
-    #
-    def describe_images( options = {} )
-
-      options = { :image_id => [], :owner_id => [], :executable_by => [] }.merge(options)
-
-      params = pathlist( "ImageId", options[:image_id] )
-      params.merge!(pathlist( "Owner", options[:owner_id] ))
-      params.merge!(pathlist( "ExecutableBy", options[:executable_by] ))
-
-      return response_generator(:action => "DescribeImages", :params => params)
-
-    end
-
-    #Amazon Developer Guide Docs:
-    #
-    # The DeregisterImage operation deregisters an AMI. Once deregistered, instances of the AMI may no
-    # longer be launched.
-    #
-    #Required Arguments:
-    #
-    # :image_id => String (default : "")
-    #
-    #Optional Arguments:
-    #
-    # none
-    #
-    def deregister_image( options = {} )
-
-      # defaults
-      options = { :image_id => "" }.merge(options)
-
-      raise ArgumentError, "No :image_id provided" if options[:image_id].nil? || options[:image_id].empty?
-
-      params = { "ImageId" => options[:image_id] }
-
-      return response_generator(:action => "DeregisterImage", :params => params)
-
-    end
-
-  end
-
-end