talaris-right_aws 2.1.0

data/lib/ec2/right_ec2_images.rb

@@ -0,0 +1,413 @@
+#
+# Copyright (c) 2009 RightScale Inc
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#
+
+module RightAws
+
+  class Ec2
+
+    #-----------------------------------------------------------------
+    #      Images
+    #-----------------------------------------------------------------
+
+    # Describe images helper
+    # params:
+    #   { 'ImageId'      => ['id1', ..., 'idN'],
+    #     'Owner'        => ['self', ..., 'userN'],
+    #     'ExecutableBy' => ['self', 'all', ..., 'userN']
+    #   }
+    def ec2_describe_images(params={}, options={}, cache_for=nil) #:nodoc:
+      request_hash = {}
+      params.each { |list_by, list| request_hash.merge! amazonize_list(list_by, Array(list)) }
+      request_hash.merge!(amazonize_list(['Filter.?.Name', 'Filter.?.Value.?'], options[:filters])) unless options[:filters].right_blank?
+      link = generate_request("DescribeImages", request_hash)
+      request_cache_or_info cache_for, link,  QEc2DescribeImagesParser, @@bench, cache_for
+    rescue Exception
+      on_exception
+    end
+
+    # Retrieve a list of images.
+    #
+    # Accepts a list of images and/or a set of filters as the last parameter.
+    # 
+    # Filters: architecture, block-device-mapping.delete-on-termination block-device-mapping.device-name,
+    # block-device-mapping.snapshot-id, block-device-mapping.volume-size, description, image-id, image-type,
+    # is-public, kernel-id, manifest-location, name, owner-alias, owner-id, platform, product-code,
+    # ramdisk-id, root-device-name, root-device-type, state, state-reason-code, state-reason-message,
+    # tag-key, tag-value, tag:key, virtualization-type
+    #
+    #  ec2.describe_images #=>
+    #    [{:description=>"EBS backed Fedora core 8 i386",
+    #      :aws_architecture=>"i386",
+    #      :aws_id=>"ami-c2a3f5d4",
+    #      :aws_image_type=>"machine",
+    #      :root_device_name=>"/dev/sda1",
+    #      :image_class=>"elastic",
+    #      :aws_owner=>"937766719418",
+    #      :aws_location=>"937766719418/EBS backed FC8 i386",
+    #      :aws_state=>"available",
+    #      :block_device_mappings=>
+    #       [{:ebs_snapshot_id=>"snap-829a20eb",
+    #         :ebs_delete_on_termination=>true,
+    #         :device_name=>"/dev/sda1"}],
+    #      :name=>"EBS backed FC8 i386",
+    #      :aws_is_public=>true}, ... ]
+    #
+    #  ec2.describe_images(:filters => { 'image-type' => 'kernel', 'state' => 'available', 'tag:MyTag' => 'MyValue'})
+    #
+    #  ec2.describe_images("ari-fda54b94", "ami-2ee80247", "aki-00896a69",
+    #                      :filters => { 'image-type' => 'kernel', 'state' => 'available' }) #=>
+    #    [{:root_device_type=>"instance-store",
+    #      :aws_id=>"aki-00896a69",
+    #      :aws_image_type=>"kernel",
+    #      :aws_location=>
+    #       "karmic-kernel-zul/ubuntu-kernel-2.6.31-300-ec2-i386-20091002-test-04.manifest.xml",
+    #      :virtualization_type=>"paravirtual",
+    #      :aws_state=>"available",
+    #      :aws_owner=>"099720109477",
+    #      :tags=>{},
+    #      :aws_is_public=>true,
+    #      :aws_architecture=>"i386"}]
+    #
+    # P.S. filters: http://docs.amazonwebservices.com/AWSEC2/latest/APIReference/index.html?ApiReference-query-DescribeImages.html
+    #
+    def describe_images(*list_and_options)
+      list, options = AwsUtils::split_items_and_params(list_and_options)
+      cache_for     = (list.right_blank? && options[:filters].right_blank?) ? :describe_images : nil
+      ec2_describe_images( {'ImageId'=>list}, options, cache_for)
+    end
+
+    # Retrieve a list of images by image owner.
+    #
+    # Accepts a list of images and/or a set of filters as the last parameter.
+    # 
+    # Filters: architecture, block-device-mapping.delete-on-termination block-device-mapping.device-name,
+    # block-device-mapping.snapshot-id, block-device-mapping.volume-size, description, image-id, image-type,
+    # is-public, kernel-id, manifest-location, name, owner-alias, owner-id, platform, product-code,
+    # ramdisk-id, root-device-name, root-device-type, state, state-reason-code, state-reason-message,
+    # tag-key, tag-value, tag:key, virtualization-type
+    #
+    #   ec2.describe_images_by_owner('522821470517')
+    #   ec2.describe_images_by_owner('self', :filters => { 'block-device-mapping.delete-on-termination' => 'false' })
+    #
+    # P.S. filters: http://docs.amazonwebservices.com/AWSEC2/latest/APIReference/index.html?ApiReference-query-DescribeImages.html
+    #
+    def describe_images_by_owner(*list_and_options)
+      list, options = AwsUtils::split_items_and_params(list_and_options)
+      list          = ['self'] if list.right_blank?
+      cache_for     = (list==['self'] && options[:filters].right_blank?) ? :describe_images_by_owner : nil
+      ec2_describe_images( {'Owner'=>list}, options, cache_for)
+    end
+
+    # Retrieve a list of images by image executable by.
+    # 
+    # Accepts a list of images and/or a set of filters as the last parameter.
+    # 
+    # Filters: architecture, block-device-mapping.delete-on-termination block-device-mapping.device-name,
+    # block-device-mapping.snapshot-id, block-device-mapping.volume-size, description, image-id, image-type,
+    # is-public, kernel-id, manifest-location, name, owner-alias, owner-id, platform, product-code,
+    # ramdisk-id, root-device-name, root-device-type, state, state-reason-code, state-reason-message,
+    # tag-key, tag-value, tag:key, virtualization-type
+    #
+    #   ec2.describe_images_by_executable_by('522821470517')
+    #   ec2.describe_images_by_executable_by('self')
+    #   ec2.describe_images_by_executable_by('all', :filters => { 'architecture' => 'i386' })
+    #
+    # P.S. filters: http://docs.amazonwebservices.com/AWSEC2/latest/APIReference/index.html?ApiReference-query-DescribeImages.html
+    #
+    def describe_images_by_executable_by(*list_and_options)
+      list, options = AwsUtils::split_items_and_params(list_and_options)
+      list          = ['self'] if list.right_blank?
+      cache_for     = (list==['self'] && options[:filters].right_blank?) ? :describe_images_by_executable_by : nil
+      ec2_describe_images( {'ExecutableBy'=>list}, options, cache_for)
+    end
+
+    # Register new image at Amazon.
+    # Options: :image_location, :name, :description, :architecture, :kernel_id, :ramdisk_id,
+    #          :root_device_name, :block_device_mappings, :virtualizationt_type(hvm|paravirtual)
+    #
+    # Returns new image id.
+    #
+    #  # Register S3 image
+    #  ec2.register_image('bucket_for_k_dzreyev/image_bundles/kd__CentOS_1_10_2009_10_21_13_30_43_MSD/image.manifest.xml') #=> 'ami-e444444d'
+    #
+    #  # or
+    #  image_reg_params = {  :image_location => 'bucket_for_k_dzreyev/image_bundles/kd__CentOS_1_10_2009_10_21_13_30_43_MSD/image.manifest.xml',
+    #                        :name => 'my-test-one-1',
+    #                        :description => 'My first test image' }
+    #  ec2.register_image(image_reg_params) #=> "ami-bca1f7aa"
+    #
+    #  # Register EBS image
+    #  image_reg_params = { :name        => 'my-test-image',
+    #                       :description => 'My first test image',
+    #                       :root_device_name => "/dev/sda1",
+    #                       :block_device_mappings => [ { :ebs_snapshot_id=>"snap-7360871a",
+    #                                                     :ebs_delete_on_termination=>true,
+    #                                                     :device_name=>"/dev/sda1"} ] }
+    #  ec2.register_image(image_reg_params) #=> "ami-b2a1f7a4"
+    #
+    def register_image(options)
+      case
+      when options.is_a?(String)
+        options = { :image_location => options }
+      when !options.is_a?(Hash)
+        raise "Unsupported options type"
+      end
+      params = {}
+      params['ImageLocation']  = options[:image_location]   if options[:image_location]
+      params['Name']           = options[:name]             if options[:name]
+      params['Description']    = options[:description]      if options[:description]
+      params['Architecture']   = options[:architecture]     if options[:architecture]
+      params['KernelId']       = options[:kernel_id]        if options[:kernel_id]
+      params['RamdiskId']      = options[:ramdisk_id]       if options[:ramdisk_id]
+      params['RootDeviceName'] = options[:root_device_name] if options[:root_device_name]
+      params['VirtualizationType'] = options[:virtualization_type] if options[:virtualization_type] 
+#      params['SnapshotId']     = options[:snapshot_id]      if options[:snapshot_id]
+      params.merge!(amazonize_block_device_mappings(options[:block_device_mappings]))
+      link = generate_request("RegisterImage", params)
+      request_info(link, QEc2RegisterImageParser.new(:logger => @logger))
+    rescue Exception
+      on_exception
+    end
+
+    # Deregister image at Amazon. Returns +true+ or an exception.
+    #
+    #  ec2.deregister_image('ami-e444444d') #=> true
+    #
+    def deregister_image(image_id)
+      link = generate_request("DeregisterImage",
+                              'ImageId' => image_id.to_s)
+      request_info(link, RightBoolResponseParser.new(:logger => @logger))
+    rescue Exception
+      on_exception
+    end
+
+    # Describe image attributes. Currently 'launchPermission', 'productCodes', 'kernel', 'ramdisk' and 'blockDeviceMapping'  are supported.
+    #
+    #  ec2.describe_image_attribute('ami-e444444d') #=> {:groups=>["all"], :users=>["000000000777"]}
+    #
+    def describe_image_attribute(image_id, attribute='launchPermission')
+      link = generate_request("DescribeImageAttribute",
+                              'ImageId'   => image_id,
+                              'Attribute' => attribute)
+      request_info(link, QEc2DescribeImageAttributeParser.new(:logger => @logger))
+    rescue Exception
+      on_exception
+    end
+
+    # Reset image attribute. Currently, only 'launchPermission' is supported. Returns +true+ or an exception.
+    #
+    #  ec2.reset_image_attribute('ami-e444444d') #=> true
+    #
+    def reset_image_attribute(image_id, attribute='launchPermission')
+      link = generate_request("ResetImageAttribute",
+                              'ImageId'   => image_id,
+                              'Attribute' => attribute)
+      request_info(link, RightBoolResponseParser.new(:logger => @logger))
+    rescue Exception
+      on_exception
+    end
+
+    # Modify an image's attributes. It is recommended that you use
+    # modify_image_launch_perm_add_users, modify_image_launch_perm_remove_users, etc.
+    # instead of modify_image_attribute because the signature of
+    # modify_image_attribute may change with EC2 service changes.
+    #
+    #  attribute      : currently, only 'launchPermission' is supported.
+    #  operation_type : currently, only 'add' & 'remove' are supported.
+    #  vars:
+    #    :user_group  : currently, only 'all' is supported.
+    #    :user_id
+    #    :product_code
+    def modify_image_attribute(image_id, attribute, operation_type = nil, vars = {})
+      params =  {'ImageId'   => image_id,
+                 'Attribute' => attribute}
+      params['OperationType'] = operation_type if operation_type
+      params.update(amazonize_list('UserId',      vars[:user_id]))      if vars[:user_id]
+      params.update(amazonize_list('UserGroup',   vars[:user_group]))   if vars[:user_group]
+      params.update(amazonize_list('ProductCode', vars[:product_code])) if vars[:product_code]
+      link = generate_request("ModifyImageAttribute", params)
+      request_info(link, RightBoolResponseParser.new(:logger => @logger))
+    rescue Exception
+      on_exception
+    end
+
+    # Grant image launch permissions to users.
+    # Parameter +user_id+ is a list of user AWS account ids.
+    # Returns +true+ or an exception.
+    #
+    #  ec2.modify_image_launch_perm_add_users('ami-e444444d',['000000000777','000000000778']) #=> true
+    def modify_image_launch_perm_add_users(image_id, user_id=[])
+      modify_image_attribute(image_id, 'launchPermission', 'add', :user_id => user_id)
+    end
+
+    # Revokes image launch permissions for users. +user_id+ is a list of users AWS accounts ids. Returns +true+ or an exception.
+    #
+    #  ec2.modify_image_launch_perm_remove_users('ami-e444444d',['000000000777','000000000778']) #=> true
+    #
+    def modify_image_launch_perm_remove_users(image_id, user_id=[])
+      modify_image_attribute(image_id, 'launchPermission', 'remove', :user_id => user_id)
+    end
+
+    # Add image launch permissions for users groups (currently only 'all' is supported, which gives public launch permissions).
+    # Returns +true+ or an exception.
+    #
+    #  ec2.modify_image_launch_perm_add_groups('ami-e444444d') #=> true
+    #
+    def modify_image_launch_perm_add_groups(image_id, user_group=['all'])
+      modify_image_attribute(image_id, 'launchPermission', 'add', :user_group => user_group)
+    end
+
+    # Remove image launch permissions for users groups (currently only 'all' is supported, which gives public launch permissions).
+    #
+    #  ec2.modify_image_launch_perm_remove_groups('ami-e444444d') #=> true
+    #
+    def modify_image_launch_perm_remove_groups(image_id, user_group=['all'])
+      modify_image_attribute(image_id, 'launchPermission', 'remove', :user_group => user_group)
+    end
+
+    # Add product code to image
+    #
+    #  ec2.modify_image_product_code('ami-e444444d','0ABCDEF') #=> true
+    #
+    def modify_image_product_code(image_id, product_code=[])
+      modify_image_attribute(image_id, 'productCodes', nil, :product_code => product_code)
+    end
+
+    # Create a new image.
+    # Options: :name, :description, :no_reboot(bool)
+    #
+    #  ec2.create_image(instance, :description => 'KD: test#1',
+    #                             :no_reboot => true,
+    #                             :name => 'kd-1' ) #=> "ami-84a1f792"
+    #
+    def create_image(instance_aws_id, options={})
+      params = { 'InstanceId' => instance_aws_id }
+      params['Name']        = options[:name]            unless options[:name].right_blank?
+      params['Description'] = options[:description]     unless options[:description].right_blank?
+      params['NoReboot']    = options[:no_reboot].to_s  unless options[:no_reboot].nil?
+      link = generate_request("CreateImage", params)
+      request_info(link, QEc2RegisterImageParser.new(:logger => @logger))
+    end
+
+    #-----------------------------------------------------------------
+    #      PARSERS: Images
+    #-----------------------------------------------------------------
+
+    class QEc2DescribeImagesParser < RightAWSParser #:nodoc:
+      def tagstart(name, attributes)
+        case full_tag_name
+        when %r{/imagesSet/item$}
+          @item = { :tags => {} }
+        when %r{/blockDeviceMapping/item$}
+          @item[:block_device_mappings] ||= []
+          @block_device_mapping = {}
+        when %r{/tagSet/item$}
+          @aws_tag = {}
+        end
+      end
+      def tagend(name)
+        case name
+        when 'imageId'         then @item[:aws_id]            = @text
+        when 'imageLocation'   then @item[:aws_location]      = @text
+        when 'imageState'      then @item[:aws_state]         = @text
+        when 'imageOwnerId'    then @item[:aws_owner]         = @text
+        when 'isPublic'        then @item[:aws_is_public]     = @text == 'true' ? true : false
+        when 'productCode'     then (@item[:aws_product_codes] ||= []) << @text
+        when 'architecture'    then @item[:aws_architecture]  = @text
+        when 'imageType'       then @item[:aws_image_type]    = @text
+        when 'kernelId'        then @item[:aws_kernel_id]     = @text
+        when 'ramdiskId'       then @item[:aws_ramdisk_id]    = @text
+        when 'platform'        then @item[:aws_platform]      = @text
+        when 'imageOwnerAlias' then @item[:image_owner_alias] = @text
+        when 'name'            then @item[:name]              = @text
+        when 'description'     then @item[:description]       = @text
+        when 'rootDeviceType'  then @item[:root_device_type]  = @text
+        when 'rootDeviceName'  then @item[:root_device_name]  = @text
+        when 'imageClass'      then @item[:image_class]       = @text
+        when 'virtualizationType' then @item[:virtualization_type] = @text
+        else
+          case full_tag_name
+          when %r{/stateReason/code$}    then @item[:state_reason_code]    = @text.to_i
+          when %r{/stateReason/message$} then @item[:state_reason_message] = @text
+          when %r{/blockDeviceMapping/item} # no trailing $
+            case name
+            when 'deviceName'          then @block_device_mapping[:device_name]                = @text
+            when 'virtualName'         then @block_device_mapping[:virtual_name]               = @text
+            when 'volumeSize'          then @block_device_mapping[:ebs_volume_size]            = @text.to_i
+            when 'snapshotId'          then @block_device_mapping[:ebs_snapshot_id]            = @text
+            when 'deleteOnTermination' then @block_device_mapping[:ebs_delete_on_termination]  = @text == 'true' ? true : false
+            when 'item'                then @item[:block_device_mappings]                    << @block_device_mapping
+            end
+          when %r{/tagSet/item/key$}   then @aws_tag[:key]               = @text
+          when %r{/tagSet/item/value$} then @aws_tag[:value]             = @text
+          when %r{/tagSet/item$}       then @item[:tags][@aws_tag[:key]] = @aws_tag[:value]
+          when %r{/imagesSet/item$}    then @result                     << @item
+          end
+        end
+      end
+      def reset
+        @result = []
+      end
+    end
+
+    class QEc2RegisterImageParser < RightAWSParser #:nodoc:
+      def tagend(name)
+        @result = @text if name == 'imageId'
+      end
+    end
+
+    #-----------------------------------------------------------------
+    #      PARSERS: Image Attribute
+    #-----------------------------------------------------------------
+
+    class QEc2DescribeImageAttributeParser < RightAWSParser #:nodoc:
+      def tagstart(name, attributes)
+        case name
+          when 'launchPermission'
+            @result[:groups] = []
+            @result[:users]  = []
+          when 'productCodes'
+            @result[:aws_product_codes] = []
+        end
+      end
+      def tagend(name)
+          # right now only 'launchPermission' is supported by Amazon.
+          # But nobody know what will they xml later as attribute. That is why we
+          # check for 'group' and 'userId' inside of 'launchPermission/item'
+        case name
+          when 'imageId'            then @result[:aws_id] = @text
+          when 'group'              then @result[:groups] << @text if @xmlpath == 'DescribeImageAttributeResponse/launchPermission/item'
+          when 'userId'             then @result[:users]  << @text if @xmlpath == 'DescribeImageAttributeResponse/launchPermission/item'
+          when 'productCode'        then @result[:aws_product_codes] << @text
+          when 'kernel'             then @result[:aws_kernel]  = @text
+          when 'ramdisk'            then @result[:aws_ramdisk] = @text
+        end
+      end
+      def reset
+        @result = {}
+      end
+    end
+
+  end
+  
+end

data/lib/ec2/right_ec2_instances.rb

@@ -0,0 +1,785 @@
+#
+# Copyright (c) 2009 RightScale Inc
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#
+
+module RightAws
+
+  class Ec2
+
+  #-----------------------------------------------------------------
+  #      Instances
+  #-----------------------------------------------------------------
+
+    def get_desc_instances(instances)  # :nodoc:
+      result = []
+      instances.each do |reservation|
+        reservation[:instances_set].each do |instance|
+          # Parse and remove timestamp from the reason string. The timestamp is of
+          # the request, not when EC2 took action, thus confusing & useless...
+          instance[:aws_reason]         = instance[:aws_reason].sub(/\(\d[^)]*GMT\) */, '')
+          instance[:aws_owner]          = reservation[:aws_owner]
+          instance[:aws_reservation_id] = reservation[:aws_reservation_id]
+          instance[:aws_groups]         = reservation[:aws_groups]
+          result << instance
+        end
+      end
+      result
+    rescue Exception
+      on_exception
+    end
+
+    # Retrieve information about EC2 instances.
+    #
+    # Accepts a list of instances and/or a set of filters as the last parameter.
+    # 
+    # Filters: architecture, availability-zone, block-device-mapping.attach-time, block-device-mapping.delete-on-termination,
+    # block-device-mapping.device-name, block-device-mapping.status, block-device-mapping.volume-id, client-token, dns-name,
+    # group-id, image-id, instance-id, instance-lifecycle, instance-state-code, instance-state-name, instance-type, ip-address,
+    # kernel-id, key-name, launch-index, launch-time, monitoring-state, owner-id, placement-group-name, platform,
+    # private-dns-name, private-ip-address, product-code, ramdisk-id, reason, requester-id, reservation-id, root-device-name,
+    # root-device-type, spot-instance-request-id, state-reason-code, state-reason-message, subnet-id, tag-key, tag-value,
+    # tag:key, virtualization-type, vpc-id,
+    #
+    #
+    #  ec2.describe_instances #=>
+    #    [{:private_ip_address=>"10.240.7.99",
+    #      :aws_image_id=>"ami-c2a3f5d4",
+    #      :ip_address=>"174.129.134.109",
+    #      :dns_name=>"ec2-174-129-134-109.compute-1.amazonaws.com",
+    #      :aws_instance_type=>"m1.small",
+    #      :aws_owner=>"826693181925",
+    #      :root_device_name=>"/dev/sda1",
+    #      :instance_class=>"elastic",
+    #      :aws_state=>"running",
+    #      :private_dns_name=>"domU-12-31-39-04-00-95.compute-1.internal",
+    #      :aws_reason=>"",
+    #      :aws_launch_time=>"2009-11-18T14:03:25.000Z",
+    #      :aws_reservation_id=>"r-54d38542",
+    #      :aws_state_code=>16,
+    #      :ami_launch_index=>"0",
+    #      :aws_availability_zone=>"us-east-1a",
+    #      :aws_groups=>["default"],
+    #      :monitoring_state=>"disabled",
+    #      :aws_product_codes=>[],
+    #      :ssh_key_name=>"",
+    #      :block_device_mappings=>
+    #       [{:ebs_status=>"attached",
+    #         :ebs_delete_on_termination=>true,
+    #         :ebs_attach_time=>"2009-11-18T14:03:34.000Z",
+    #         :device_name=>"/dev/sda1",
+    #         :ebs_volume_id=>"vol-e600f98f"},
+    #        {:ebs_status=>"attached",
+    #         :ebs_delete_on_termination=>true,
+    #         :ebs_attach_time=>"2009-11-18T14:03:34.000Z",
+    #         :device_name=>"/dev/sdk",
+    #         :ebs_volume_id=>"vol-f900f990"}],
+    #      :aws_instance_id=>"i-8ce84ae4"} , ... ]
+    #
+    #   ec2.describe_instances("i-8ce84ae6", "i-8ce84ae8", "i-8ce84ae0")
+    #   ec2.describe_instances(:filters => { 'availability-zone' => 'us-east-1a', 'instance-type' => 'c1.medium' })
+    #
+    # P.S. filters: http://docs.amazonwebservices.com/AWSEC2/latest/APIReference/index.html?ApiReference-query-DescribeInstances.html
+    #
+    def describe_instances(*list_and_options)
+      describe_resources_with_list_and_options('DescribeInstances', 'InstanceId', QEc2DescribeInstancesParser, list_and_options) do |parser|
+        get_desc_instances(parser.result)
+      end
+    end
+
+    # Return the product code attached to instance or +nil+ otherwise.
+    #
+    #  ec2.confirm_product_instance('ami-e444444d','12345678') #=> nil
+    #  ec2.confirm_product_instance('ami-e444444d','00001111') #=> "000000000888"
+    #
+    def confirm_product_instance(instance, product_code)
+      link = generate_request("ConfirmProductInstance", { 'ProductCode' => product_code,
+                                'InstanceId'  => instance })
+      request_info(link, QEc2ConfirmProductInstanceParser.new(:logger => @logger))
+    end
+
+    # Launch new EC2 instances. Returns a list of launched instances or an exception.
+    #
+    #  ec2.run_instances('ami-e444444d',1,1,['my_awesome_group'],'my_awesome_key', 'Woohoo!!!', 'public') #=>
+    #   [{:aws_image_id       => "ami-e444444d",
+    #     :aws_reason         => "",
+    #     :aws_state_code     => "0",
+    #     :aws_owner          => "000000000888",
+    #     :aws_instance_id    => "i-123f1234",
+    #     :aws_reservation_id => "r-aabbccdd",
+    #     :aws_state          => "pending",
+    #     :dns_name           => "",
+    #     :ssh_key_name       => "my_awesome_key",
+    #     :aws_groups         => ["my_awesome_group"],
+    #     :private_dns_name   => "",
+    #     :aws_instance_type  => "m1.small",
+    #     :aws_launch_time    => "2008-1-1T00:00:00.000Z"
+    #     :aws_ramdisk_id     => "ari-8605e0ef"
+    #     :aws_kernel_id      => "aki-9905e0f0",
+    #     :ami_launch_index   => "0",
+    #     :aws_availability_zone => "us-east-1b"
+    #     }]
+    #
+    def run_instances(image_id, min_count, max_count, group_ids, key_name, user_data='',
+                      addressing_type = nil, instance_type = nil,
+                      kernel_id = nil, ramdisk_id = nil, availability_zone = nil,
+                      monitoring_enabled = nil, subnet_id = nil, disable_api_termination = nil,
+                      instance_initiated_shutdown_behavior = nil, block_device_mappings = nil,
+                      placement_group_name = nil, client_token = nil)
+ 	    launch_instances(image_id, { :min_count                            => min_count,
+ 	                                 :max_count                            => max_count,
+ 	                                 :user_data                            => user_data,
+                                   :group_ids                            => group_ids,
+                                   :key_name                             => key_name,
+                                   :instance_type                        => instance_type,
+                                   :addressing_type                      => addressing_type,
+                                   :kernel_id                            => kernel_id,
+                                   :ramdisk_id                           => ramdisk_id,
+                                   :availability_zone                    => availability_zone,
+                                   :monitoring_enabled                   => monitoring_enabled,
+                                   :subnet_id                            => subnet_id,
+                                   :disable_api_termination              => disable_api_termination,
+                                   :instance_initiated_shutdown_behavior => instance_initiated_shutdown_behavior,
+                                   :block_device_mappings                => block_device_mappings,
+                                   :placement_group_name                 => placement_group_name,
+                                   :client_token                         => client_token
+                                 })
+    end
+
+    # Launch new EC2 instances.
+    # Options: :image_id, :addressing_type, :min_count, max_count, :key_name, :kernel_id, :ramdisk_id,
+    # :availability_zone, :monitoring_enabled, :subnet_id, :disable_api_termination, :instance_initiated_shutdown_behavior,
+    # :block_device_mappings, :placement_group_name, :license_pool
+    # 
+    # Returns a list of launched instances or an exception.
+    #
+    #  ec2.launch_instances( 'ami-c2a3f5d4',
+    #                        :min_count => 1,
+    #                        :group_ids => 'default',
+    #                        :user_data => 'Ohoho!',
+    #                        :availability_zone => "us-east-1a",
+    #                        :disable_api_termination => true,
+    #                        :instance_initiated_shutdown_behavior => 'terminate',
+    #                        :block_device_mappings => [ {:ebs_snapshot_id=>"snap-7360871a",
+    #                                                     :ebs_delete_on_termination=>true,
+    #                                                     :device_name => "/dev/sdk",
+    #                                                     :virtual_name => "mystorage"} ] ) #=>
+    #    [{:aws_image_id=>"ami-c2a3f5d4",
+    #      :dns_name=>"",
+    #      :aws_instance_type=>"m1.small",
+    #      :aws_owner=>"826693181925",
+    #      :root_device_name=>"/dev/sda1",
+    #      :instance_class=>"elastic",
+    #      :state_reason_code=>0,
+    #      :aws_state=>"pending",
+    #      :private_dns_name=>"",
+    #      :aws_reason=>"",
+    #      :aws_launch_time=>"2009-11-18T14:03:25.000Z",
+    #      :aws_reservation_id=>"r-54d38542",
+    #      :state_reason_message=>"pending",
+    #      :aws_state_code=>0,
+    #      :ami_launch_index=>"0",
+    #      :aws_availability_zone=>"us-east-1a",
+    #      :aws_groups=>["default"],
+    #      :monitoring_state=>"disabled",
+    #      :aws_product_codes=>[],
+    #      :ssh_key_name=>"",
+    #      :aws_instance_id=>"i-8ce84ae4"}]
+    #
+    def launch_instances(image_id, options={})
+      options[:image_id]    = image_id
+      options[:min_count] ||= 1
+      options[:max_count] ||= options[:min_count]
+      params = prepare_instance_launch_params(options)
+      # Log debug information
+      @logger.info("Launching instance of image #{image_id}. Options: #{params.inspect}")
+      link = generate_request("RunInstances", params)
+      instances = request_info(link, QEc2DescribeInstancesParser.new(:logger => @logger))
+      get_desc_instances(instances)
+    rescue Exception
+      on_exception
+    end
+
+    def prepare_instance_launch_params(options={}) # :nodoc:
+      params = amazonize_list('SecurityGroup', Array(options[:group_ids]))
+      params['InstanceType']                      = options[:instance_type] || DEFAULT_INSTANCE_TYPE
+      params['ImageId']                           = options[:image_id]                             unless options[:image_id].right_blank?
+      params['AddressingType']                    = options[:addressing_type]                      unless options[:addressing_type].right_blank?
+      params['MinCount']                          = options[:min_count]                            unless options[:min_count].right_blank?
+      params['MaxCount']                          = options[:max_count]                            unless options[:max_count].right_blank?
+      params['KeyName']                           = options[:key_name]                             unless options[:key_name].right_blank?
+      params['KernelId']                          = options[:kernel_id]                            unless options[:kernel_id].right_blank?
+      params['RamdiskId']                         = options[:ramdisk_id]                           unless options[:ramdisk_id].right_blank?
+      params['Placement.AvailabilityZone']        = options[:availability_zone]                    unless options[:availability_zone].right_blank?
+      params['Monitoring.Enabled']                = options[:monitoring_enabled].to_s              if     options[:monitoring_enabled]
+      params['SubnetId']                          = options[:subnet_id]                            unless options[:subnet_id].right_blank?
+      params['AdditionalInfo']                    = options[:additional_info]                      unless options[:additional_info].right_blank?
+      params['DisableApiTermination']             = options[:disable_api_termination].to_s         unless options[:disable_api_termination].nil?
+      params['InstanceInitiatedShutdownBehavior'] = options[:instance_initiated_shutdown_behavior] unless options[:instance_initiated_shutdown_behavior].right_blank?
+      params['Placement.GroupName']               = options[:placement_group_name]                 unless options[:placement_group_name].right_blank?
+      params['License.Pool']                      = options[:license_pool]                         unless options[:license_pool].right_blank?
+      params['ClientToken']                       = options[:client_token] || AwsUtils::generate_unique_token
+      params.merge!(amazonize_block_device_mappings(options[:block_device_mappings]))
+      # KD: https://github.com/rightscale/right_aws/issues#issue/11
+      # Do not modify user data and pass it as is: one may pass there a hex-binary data
+      options[:user_data] = options[:user_data].to_s
+      unless options[:user_data].empty?
+        # Do not use CGI::escape(encode64(...)) as it is done in Amazons EC2 library.
+        # Amazon 169.254.169.254 does not like escaped symbols!
+        # And it doesn't like "\n" inside of encoded string! Grrr....
+        # Otherwise, some of UserData symbols will be lost...
+        params['UserData'] = Base64.encode64(options[:user_data]).delete("\n")
+      end
+      params
+    end
+
+    # Start instances.
+    #
+    #  ec2.start_instances("i-36e84a5e") #=>
+    #    [{:aws_prev_state_name=>"stopped",
+    #      :aws_instance_id=>"i-36e84a5e",
+    #      :aws_current_state_code=>16,
+    #      :aws_current_state_name=>"running",
+    #      :aws_prev_state_code=>80}]
+    #
+    def start_instances(*instance_aws_ids)
+      instance_aws_ids = instance_aws_ids.flatten
+      link = generate_request("StartInstances", amazonize_list('InstanceId', instance_aws_ids))
+      request_info(link, QEc2TerminateInstancesParser.new(:logger => @logger))
+     end
+
+    # Stop instances.
+    #
+    #  ec2.stop_instances("i-36e84a5e") #=>
+    #    [{:aws_prev_state_code=>16,
+    #      :aws_prev_state_name=>"running",
+    #      :aws_instance_id=>"i-36e84a5e",
+    #      :aws_current_state_code=>64,
+    #      :aws_current_state_name=>"stopping"}]
+    #
+    def stop_instances(*instance_aws_ids)
+      instance_aws_ids = instance_aws_ids.flatten
+      link = generate_request("StopInstances", amazonize_list('InstanceId', instance_aws_ids))
+      request_info(link, QEc2TerminateInstancesParser.new(:logger => @logger))
+    end
+
+    # Terminates EC2 instances. Returns a list of termination params or an exception.
+    #
+    #  ec2.terminate_instances(['i-cceb49a4']) #=>
+    #    [{:aws_instance_id=>"i-cceb49a4",
+    #      :aws_current_state_code=>32,
+    #      :aws_current_state_name=>"shutting-down",
+    #      :aws_prev_state_code=>16,
+    #      :aws_prev_state_name=>"running"}]
+    #
+    def terminate_instances(*instance_aws_ids)
+      instance_aws_ids = instance_aws_ids.flatten
+      link = generate_request("TerminateInstances", amazonize_list('InstanceId', instance_aws_ids))
+      request_info(link, QEc2TerminateInstancesParser.new(:logger => @logger))
+    rescue Exception
+      on_exception
+    end
+
+    # Retreive EC2 instance OS logs. Returns a hash of data or an exception.
+    #
+    #  ec2.get_console_output('i-f222222d') =>
+    #    {:aws_instance_id => 'i-f222222d',
+    #     :aws_timestamp   => "2007-05-23T14:36:07.000-07:00",
+    #     :timestamp       => Wed May 23 21:36:07 UTC 2007,          # Time instance
+    #     :aws_output      => "Linux version 2.6.16-xenU (builder@patchbat.amazonsa) (gcc version 4.0.1 20050727 ..."
+    def get_console_output(instance_id)
+      link = generate_request("GetConsoleOutput", { 'InstanceId.1' => instance_id })
+      request_info(link, QEc2GetConsoleOutputParser.new(:logger => @logger))
+    rescue Exception
+      on_exception
+    end
+
+    # Reboot an EC2 instance. Returns +true+ or an exception.
+    #
+    #  ec2.reboot_instances(['i-f222222d','i-f222222e']) #=> true
+    #
+    def reboot_instances(*instances)
+      instances = instances.flatten
+      link = generate_request("RebootInstances", amazonize_list('InstanceId', instances))
+      request_info(link, RightBoolResponseParser.new(:logger => @logger))
+    rescue Exception
+      on_exception
+    end
+
+    INSTANCE_ATTRIBUTE_MAPPING = {
+      "instance_type"                        => "instanceType",
+      "kernel"                               => "kernel",
+      "ramdisk"                              => "ramdisk",
+      "user_data"                            => "userData",
+      "disable_api_termination"              => "disableApiTermination",
+      "instance_initiated_shutdown_behavior" => "instanceInitiatedShutdownBehavior",
+      "root_device_name"                     => "rootDeviceName",
+      "block_device_mapping"                 => "blockDeviceMapping"
+    }
+
+    # Describe instance attribute.
+    # Attributes: :instance_type, :kernel, :ramdisk, :user_data, :disable_api_termination, :instance_initiated_shutdown_behavior, :root_device_name, :block_device_mapping
+    #
+    #  ec2.describe_instance_attribute(instance, "BlockDeviceMapping") #=>
+    #     [{:ebs_delete_on_termination=>true,
+    #       :ebs_volume_id=>"vol-683dc401",
+    #       :device_name=>"/dev/sda1"}]
+    #
+    #  ec2.describe_instance_attribute(instance, "InstanceType") #=> "m1.small"
+    #
+    #  ec2.describe_instance_attribute(instance, "InstanceInitiatedShutdownBehavior") #=> "stop"
+    #
+    def describe_instance_attribute(instance_id, attribute)
+      attribute = INSTANCE_ATTRIBUTE_MAPPING[attribute.to_s] || attribute.to_s
+      link = generate_request('DescribeInstanceAttribute',
+                              'InstanceId' => instance_id,
+                              'Attribute'  => attribute)
+      value = request_info(link, QEc2DescribeInstanceAttributeParser.new(:logger => @logger))
+      case attribute
+      when "userData"
+        Base64.decode64(value)
+      else
+        value
+      end
+    rescue Exception
+      on_exception
+    end
+
+    # Describe instance attribute.
+    # Attributes: :kernel, :ramdisk
+    #
+    #  ec2.reset_instance_attribute(instance, :kernel) #=> true
+    #
+    def reset_instance_attribute(instance_id, attribute)
+      attribute = INSTANCE_ATTRIBUTE_MAPPING[attribute.to_s] || attribute.to_s
+      link = generate_request('ResetInstanceAttribute',
+                              'InstanceId' => instance_id,
+                              'Attribute'  => attribute )
+      request_info(link, RightBoolResponseParser.new(:logger => @logger))
+    rescue Exception
+      on_exception
+    end
+
+    # Modify instance attribute.
+    # Attributes: :instance_type, :kernel, :ramdisk, :user_data, :disable_api_termination, :instance_initiated_shutdown_behavior, :root_device_name, :block_device_mapping
+    #
+    #  ec2.modify_instance_attribute(instance, :instance_initiated_shutdown_behavior, "stop") #=> true
+    #
+    def modify_instance_attribute(instance_id, attribute, value)
+      attribute = INSTANCE_ATTRIBUTE_MAPPING[attribute.to_s] || attribute.to_s
+      params = { 'InstanceId' => instance_id,
+                 'Attribute'  => attribute }
+      case attribute
+      when "blockDeviceMapping"
+        params.merge!(amazonize_block_device_mappings(value))
+      when "userData"
+        params['Value'] = Base64.encode64(value).delete("\n")
+      else
+        params['Value'] = value
+      end
+      link = generate_request('ModifyInstanceAttribute', params)
+      request_info(link, RightBoolResponseParser.new(:logger => @logger))
+    rescue Exception
+      on_exception
+    end
+
+    #-----------------------------------------------------------------
+    #      Instances: Windows addons
+    #-----------------------------------------------------------------
+
+    # Get initial Windows Server setup password from an instance console output.
+    #
+    #  my_awesome_key = ec2.create_key_pair('my_awesome_key') #=>
+    #    {:aws_key_name    => "my_awesome_key",
+    #     :aws_fingerprint => "01:02:03:f4:25:e6:97:e8:9b:02:1a:26:32:4e:58:6b:7a:8c:9f:03",
+    #     :aws_material    => "-----BEGIN RSA PRIVATE KEY-----\nMIIEpQIBAAK...Q8MDrCbuQ=\n-----END RSA PRIVATE KEY-----"}
+    #
+    #  my_awesome_instance = ec2.run_instances('ami-a000000a',1,1,['my_awesome_group'],'my_awesome_key', 'WindowsInstance!!!') #=>
+    #   [{:aws_image_id       => "ami-a000000a",
+    #     :aws_instance_id    => "i-12345678",
+    #     ...
+    #     :aws_availability_zone => "us-east-1b"
+    #     }]
+    #
+    #  # wait until instance enters 'operational' state and get it's initial password
+    #
+    #  puts ec2.get_initial_password(my_awesome_instance[:aws_instance_id], my_awesome_key[:aws_material]) #=> "MhjWcgZuY6"
+    #
+    def get_initial_password(instance_id, private_key)
+      console_output = get_console_output(instance_id)
+      crypted_password = console_output[:aws_output][%r{<Password>(.+)</Password>}m] && $1
+      unless crypted_password
+        raise AwsError.new("Initial password was not found in console output for #{instance_id}")
+      else
+        OpenSSL::PKey::RSA.new(private_key).private_decrypt(Base64.decode64(crypted_password))
+      end
+    rescue Exception
+      on_exception
+    end
+
+    # Get Initial windows instance password using Amazon API call GetPasswordData.
+    #
+    #  puts ec2.get_initial_password_v2(my_awesome_instance[:aws_instance_id], my_awesome_key[:aws_material]) #=> "MhjWcgZuY6"
+    #
+    # P.S. To say the truth there is absolutely no any speedup if to compare to the old get_initial_password method... ;(
+    #
+    def get_initial_password_v2(instance_id, private_key)
+      link = generate_request('GetPasswordData',
+                              'InstanceId' => instance_id )
+      response = request_info(link, QEc2GetPasswordDataParser.new(:logger => @logger))
+      if response[:password_data].right_blank?
+        raise AwsError.new("Initial password is not yet created for #{instance_id}")
+      else
+        OpenSSL::PKey::RSA.new(private_key).private_decrypt(Base64.decode64(response[:password_data]))
+      end
+    rescue Exception
+      on_exception
+    end
+
+    # Bundle a Windows image.
+    # Internally, it queues the bundling task and shuts down the instance.
+    # It then takes a snapshot of the Windows volume bundles it, and uploads it to
+    # S3. After bundling completes, Rightaws::Ec2#register_image may be used to
+    # register the new Windows AMI for subsequent launches.
+    #
+    #   ec2.bundle_instance('i-e3e24e8a', 'my-awesome-bucket', 'my-win-image-1') #=>
+    #    [{:aws_update_time => "2008-10-16T13:58:25.000Z",
+    #      :s3_bucket       => "kd-win-1",
+    #      :s3_prefix       => "win2pr",
+    #      :aws_state       => "pending",
+    #      :aws_id          => "bun-26a7424f",
+    #      :aws_instance_id => "i-878a25ee",
+    #      :aws_start_time  => "2008-10-16T13:58:02.000Z"}]
+    #
+    def bundle_instance(instance_id, s3_bucket, s3_prefix,
+                        s3_owner_aws_access_key_id=nil, s3_owner_aws_secret_access_key=nil,
+                        s3_expires = S3Interface::DEFAULT_EXPIRES_AFTER,
+                        s3_upload_policy='ec2-bundle-read')
+      # S3 access and signatures
+      s3_owner_aws_access_key_id     ||= @aws_access_key_id
+      s3_owner_aws_secret_access_key ||= @aws_secret_access_key
+      s3_expires = Time.now.utc + s3_expires if s3_expires.is_a?(Fixnum) && (s3_expires < S3Interface::ONE_YEAR_IN_SECONDS)
+      # policy
+      policy = { 'expiration' => AwsUtils::utc_iso8601(s3_expires),
+                 'conditions' => [ { 'bucket' => s3_bucket },
+                                   { 'acl'    => s3_upload_policy },
+                                   [ 'starts-with', '$key', s3_prefix ] ] }.to_json
+      policy64        = Base64.encode64(policy).gsub("\n","")
+      signed_policy64 = AwsUtils.sign(s3_owner_aws_secret_access_key, policy64)
+      # fill request params
+      params = { 'InstanceId'                       => instance_id,
+                 'Storage.S3.AWSAccessKeyId'        => s3_owner_aws_access_key_id,
+                 'Storage.S3.UploadPolicy'          => policy64,
+                 'Storage.S3.UploadPolicySignature' => signed_policy64,
+                 'Storage.S3.Bucket'                => s3_bucket,
+                 'Storage.S3.Prefix'                => s3_prefix,
+                 }
+      link = generate_request("BundleInstance", params)
+      request_info(link, QEc2BundleInstanceParser.new)
+    rescue Exception
+      on_exception
+    end
+
+    # Describe the status of the Windows AMI bundlings.
+    #
+    # Accepts a list of tasks and/or a set of filters as the last parameter.
+    #
+    # Filters" bundle-id, error-code, error-message, instance-id, progress, s3-aws-access-key-id, s3-bucket, s3-prefix,
+    # start-time, state, update-time
+    #
+    #  ec2.describe_bundle_tasks('bun-4fa74226') #=>
+    #    [{:s3_bucket         => "my-awesome-bucket"
+    #      :aws_id            => "bun-0fa70206",
+    #      :s3_prefix         => "win1pr",
+    #      :aws_start_time    => "2008-10-14T16:27:57.000Z",
+    #      :aws_update_time   => "2008-10-14T16:37:10.000Z",
+    #      :aws_error_code    => "Client.S3Error",
+    #      :aws_error_message =>
+    #       "AccessDenied(403)- Invalid according to Policy: Policy Condition failed: [\"eq\", \"$acl\", \"aws-exec-read\"]",
+    #      :aws_state         => "failed",
+    #      :aws_instance_id   => "i-e3e24e8a"}]
+    #
+    #   ec2.describe_bundle_tasks(:filters => { 'state' => 'pending' })
+    #
+    # P.S. filters: http://docs.amazonwebservices.com/AWSEC2/latest/APIReference/ApiReference-query-DescribeBundleTasks.html
+    #
+    def describe_bundle_tasks(*list_and_options)
+      describe_resources_with_list_and_options('DescribeBundleTasks', 'BundleId', QEc2DescribeBundleTasksParser, list_and_options)
+    end
+
+    # Cancel an in‐progress or pending bundle task by id.
+    #
+    #  ec2.cancel_bundle_task('bun-73a7421a') #=>
+    #   [{:s3_bucket         => "my-awesome-bucket"
+    #     :aws_id            => "bun-0fa70206",
+    #     :s3_prefix         => "win02",
+    #     :aws_start_time    => "2008-10-14T13:00:29.000Z",
+    #     :aws_error_message => "User has requested bundling operation cancellation",
+    #     :aws_state         => "failed",
+    #     :aws_update_time   => "2008-10-14T13:01:31.000Z",
+    #     :aws_error_code    => "Client.Cancelled",
+    #     :aws_instance_id   => "i-e3e24e8a"}
+    #
+    def cancel_bundle_task(bundle_id)
+      link = generate_request("CancelBundleTask", { 'BundleId' => bundle_id })
+      request_info(link, QEc2BundleInstanceParser.new)
+    rescue Exception
+      on_exception
+    end
+
+    #-----------------------------------------------------------------
+    #      PARSERS: Instances
+    #-----------------------------------------------------------------
+
+    class QEc2DescribeInstancesParser < RightAWSParser #:nodoc:
+      def tagstart(name, attributes)
+           # DescribeInstances property
+        case full_tag_name
+        when 'DescribeInstancesResponse/reservationSet/item',
+             'RunInstancesResponse'
+          @reservation = { :aws_groups    => [],
+                           :instances_set => [] }
+        when %r{instancesSet/item$}
+            # the optional params (sometimes are missing and we dont want them to be nil)
+          @item = { :aws_reason       => '',
+                    :dns_name         => '',
+                    :private_dns_name => '',
+                    :ami_launch_index => '',
+                    :ssh_key_name     => '',
+                    :aws_state        => '',
+                    :aws_product_codes => [],
+                    :tags              => {} }
+        when %r{blockDeviceMapping/item$}
+          @item[:block_device_mappings] ||= []
+          @block_device_mapping = {}
+        when %r{/tagSet/item$}
+          @aws_tag = {}
+        end
+      end
+      def tagend(name)
+        case name
+        when 'reservationId'    then @reservation[:aws_reservation_id] = @text
+        when 'ownerId'          then @reservation[:aws_owner]          = @text
+        when 'groupId'          then @reservation[:aws_groups]        << @text
+        when 'instanceId'       then @item[:aws_instance_id]       = @text
+        when 'imageId'          then @item[:aws_image_id]          = @text
+        when 'privateDnsName'   then @item[:private_dns_name]      = @text
+        when 'dnsName'          then @item[:dns_name]              = @text
+        when 'reason'           then @item[:aws_reason]            = @text
+        when 'keyName'          then @item[:ssh_key_name]          = @text
+        when 'amiLaunchIndex'   then @item[:ami_launch_index]      = @text
+        when 'productCode'      then @item[:aws_product_codes]    << @text
+        when 'instanceType'     then @item[:aws_instance_type]     = @text
+        when 'launchTime'       then @item[:aws_launch_time]       = @text
+        when 'availabilityZone' then @item[:aws_availability_zone] = @text
+        when 'kernelId'         then @item[:aws_kernel_id]         = @text
+        when 'ramdiskId'        then @item[:aws_ramdisk_id]        = @text
+        when 'platform'         then @item[:aws_platform]          = @text
+        when 'subnetId'         then @item[:subnet_id]             = @text
+        when 'vpcId'            then @item[:vpc_id]                = @text
+        when 'privateIpAddress' then @item[:private_ip_address]    = @text
+        when 'ipAddress'        then @item[:ip_address]            = @text
+        when 'architecture'     then @item[:architecture]          = @text
+        when 'rootDeviceType'   then @item[:root_device_type]      = @text
+        when 'rootDeviceName'   then @item[:root_device_name]      = @text
+        when 'instanceClass'    then @item[:instance_class]        = @text
+        when 'instanceLifecycle'     then @item[:instance_lifecycle]       = @text
+        when 'spotInstanceRequestId' then @item[:spot_instance_request_id] = @text
+        when 'requesterId'           then @item[:requester_id]             = @text
+        when 'groupName'             then @item[:placement_group_name]     = @text 
+        when 'virtualizationType'    then @item[:virtualization_type]      = @text
+        when 'clientToken'           then @item[:client_token]     = @text
+        else
+          case full_tag_name
+          when %r{/stateReason/code$}    then @item[:state_reason_code]    = @text
+          when %r{/stateReason/message$} then @item[:state_reason_message] = @text
+          when %r{/instanceState/code$}  then @item[:aws_state_code]       = @text.to_i
+          when %r{/instanceState/name$}  then @item[:aws_state]            = @text
+          when %r{/monitoring/state$}    then @item[:monitoring_state]     = @text
+          when %r{/license/pool$}        then @item[:license_pool]         = @text
+          when %r{/blockDeviceMapping/item} # no trailing $
+            case name
+            when 'deviceName'          then @block_device_mapping[:device_name]                = @text
+            when 'virtualName'         then @block_device_mapping[:virtual_name]               = @text
+            when 'volumeId'            then @block_device_mapping[:ebs_volume_id]              = @text
+            when 'status'              then @block_device_mapping[:ebs_status]                 = @text
+            when 'attachTime'          then @block_device_mapping[:ebs_attach_time]            = @text
+            when 'deleteOnTermination' then @block_device_mapping[:ebs_delete_on_termination]  = @text == 'true' ? true : false
+            when 'item'                then @item[:block_device_mappings]                     << @block_device_mapping
+            end
+          when %r{/instancesSet/item$} then @reservation[:instances_set] << @item
+          when %r{/tagSet/item/key$}   then @aws_tag[:key]               = @text
+          when %r{/tagSet/item/value$} then @aws_tag[:value]             = @text
+          when %r{/tagSet/item$}       then @item[:tags][@aws_tag[:key]] = @aws_tag[:value]
+          when 'DescribeInstancesResponse/reservationSet/item',
+               'RunInstancesResponse'
+            @result << @reservation
+          end
+        end
+      end
+      def reset
+        @result = []
+      end
+    end
+
+    class QEc2ConfirmProductInstanceParser < RightAWSParser #:nodoc:
+      def tagend(name)
+        @result = @text if name == 'ownerId'
+      end
+    end
+
+    class QEc2TerminateInstancesParser < RightAWSParser #:nodoc:
+      def tagstart(name, attributes)
+        @instance = {} if name == 'item'
+      end
+      def tagend(name)
+        case full_tag_name
+        when %r{/instanceId$}         then @instance[:aws_instance_id]        = @text
+        when %r{/currentState/code$}  then @instance[:aws_current_state_code] = @text.to_i
+        when %r{/currentState/name$}  then @instance[:aws_current_state_name] = @text
+        when %r{/previousState/code$} then @instance[:aws_prev_state_code]    = @text.to_i
+        when %r{/previousState/name$} then @instance[:aws_prev_state_name]    = @text
+        when %r{/item$}               then @result << @instance
+        end
+      end
+      def reset
+        @result = []
+      end
+    end
+
+    class QEc2DescribeInstanceAttributeParser < RightAWSParser #:nodoc:
+      def tagstart(name, attributes)
+        case full_tag_name
+        when %r{blockDeviceMapping$}      then @result = []
+        when %r{blockDeviceMapping/item$} then @block_device_mapping = {}
+        end
+      end
+      def tagend(name)
+        case full_tag_name
+        when %r{/instanceType/value$}   then @result = @text
+        when %r{/kernel$}               then @result = @text
+        when %r{/ramdisk$}              then @result = @text
+        when %r{/userData$}             then @result = @text
+        when %r{/rootDeviceName/value$} then @result = @text
+        when %r{/disableApiTermination/value}              then @result = @text == 'true' ? true : false
+        when %r{/instanceInitiatedShutdownBehavior/value$} then @result = @text
+        when %r{/blockDeviceMapping/item} # no trailing $
+          case name
+          when 'deviceName'          then @block_device_mapping[:device_name]                = @text
+          when 'virtualName'         then @block_device_mapping[:virtual_name]               = @text
+          when 'noDevice'            then @block_device_mapping[:no_device]                  = @text
+          when 'volumeId'            then @block_device_mapping[:ebs_volume_id]              = @text
+          when 'status'              then @block_device_mapping[:ebs_status]                 = @text
+          when 'attachTime'          then @block_device_mapping[:ebs_attach_time]            = @text
+          when 'deleteOnTermination' then @block_device_mapping[:ebs_delete_on_termination]  = @text == 'true' ? true : false
+          when 'item'                then @result                                           << @block_device_mapping
+          end
+        end
+      end
+      def reset
+        @result = nil
+      end
+    end
+
+  #-----------------------------------------------------------------
+  #      PARSERS: Console
+  #-----------------------------------------------------------------
+
+    class QEc2GetConsoleOutputParser < RightAWSParser #:nodoc:
+      def tagend(name)
+        case name
+        when 'instanceId' then @result[:aws_instance_id] = @text
+        when 'timestamp'  then @result[:aws_timestamp]   = @text
+                               @result[:timestamp]       = (Time.parse(@text)).utc
+        when 'output'     then @result[:aws_output]      = Base64.decode64(@text)
+        end
+      end
+      def reset
+        @result = {}
+      end
+    end
+
+  #-----------------------------------------------------------------
+  #      Instances: Windows related part
+  #-----------------------------------------------------------------
+
+    class QEc2DescribeBundleTasksParser < RightAWSParser #:nodoc:
+      def tagstart(name, attributes)
+        @bundle = {} if name == 'item'
+      end
+      def tagend(name)
+        case name
+#        when 'requestId'  then @bundle[:request_id]    = @text
+        when 'instanceId' then @bundle[:aws_instance_id]   = @text
+        when 'bundleId'   then @bundle[:aws_id]            = @text
+        when 'bucket'     then @bundle[:s3_bucket]         = @text
+        when 'prefix'     then @bundle[:s3_prefix]         = @text
+        when 'startTime'  then @bundle[:aws_start_time]    = @text
+        when 'updateTime' then @bundle[:aws_update_time]   = @text
+        when 'state'      then @bundle[:aws_state]         = @text
+        when 'progress'   then @bundle[:aws_progress]      = @text
+        when 'code'       then @bundle[:aws_error_code]    = @text
+        when 'message'    then @bundle[:aws_error_message] = @text
+        when 'item'       then @result                    << @bundle
+        end
+      end
+      def reset
+        @result = []
+      end
+    end
+
+    class QEc2BundleInstanceParser < RightAWSParser #:nodoc:
+      def tagend(name)
+        case name
+#        when 'requestId'  then @result[:request_id]    = @text
+        when 'instanceId' then @result[:aws_instance_id]   = @text
+        when 'bundleId'   then @result[:aws_id]            = @text
+        when 'bucket'     then @result[:s3_bucket]         = @text
+        when 'prefix'     then @result[:s3_prefix]         = @text
+        when 'startTime'  then @result[:aws_start_time]    = @text
+        when 'updateTime' then @result[:aws_update_time]   = @text
+        when 'state'      then @result[:aws_state]         = @text
+        when 'progress'   then @result[:aws_progress]      = @text
+        when 'code'       then @result[:aws_error_code]    = @text
+        when 'message'    then @result[:aws_error_message] = @text
+        end
+      end
+      def reset
+        @result = {}
+      end
+    end
+
+    class QEc2GetPasswordDataParser < RightAWSParser #:nodoc:
+      def tagend(name)
+        case name
+        when 'instanceId'   then @result[:aws_instance_id] = @text
+        when 'timestamp'    then @result[:timestamp]       = @text
+        when 'passwordData' then @result[:password_data]   = @text
+        end
+      end
+      def reset
+        @result = {}
+      end
+    end
+
+  end
+
+end