right_aws_api 0.1.0

data/lib/cloud/aws/emr/manager.rb

@@ -0,0 +1,86 @@
+#--
+# Copyright (c) 2013 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.
+#++
+
+require "cloud/aws/base/manager"
+
+module RightScale
+  module CloudApi
+    module AWS
+
+      # ElasticMapReduce namespace
+      module EMR
+        
+        # Amazon ElasticMapReduce (EMR) compatible manager (thread safe).
+        #
+        # @example
+        #  require "right_aws_api"
+        #
+        #  emr = RightScale::CloudApi::AWS::EMR::Manager::new(key, secret, 'https://elasticmapreduce.us-east-1.amazonaws.com')
+        #
+        #  # Get a list of job flows that match all of the supplied parameters
+        #  emr.DescribeJobFlows #=>
+        #    {"DescribeJobFlowsResponse"=>
+        #      {"@xmlns"=>"http://elasticmapreduce.amazonaws.com/doc/2009-03-31",
+        #       "DescribeJobFlowsResult"=>{"JobFlows"=>nil},
+        #       "ResponseMetadata"=>{"RequestId"=>"962fa6c0-4f71-11e2-9237-6da8e8d0164c"}}}
+        #
+        # @example
+        #  # Get a job by ID
+        #  emr.DescribeJobFlows('JobFlowIds.member' => 'j-3UN6WX5RRO2AG')
+        #
+        # @see ApiManager
+        # @see http://docs.aws.amazon.com/ElasticMapReduce/latest/API/API_Operations.html
+        #
+        class Manager < AWS::Manager
+        end
+
+
+        # Amazon ElasticMapReduce (EMR) compatible manager (thread unsafe).
+        #
+        # @see Manager
+        #
+        class ApiManager < AWS::ApiManager
+
+          # Default API version for ElasticMapReduce service.
+          # To override the API version use :api_version key when instantiating a manager.
+          #
+          DEFAULT_API_VERSION = '2009-03-31'
+
+          error_pattern :abort_on_timeout,     :path     => /Action=(Run)/
+          error_pattern :retry,                :response => /InternalError|Unavailable/i
+          error_pattern :disconnect_and_abort, :code     => /5..|403|408/
+          error_pattern :disconnect_and_abort, :code     => /4../, :if => Proc.new{ |opts| rand(100) < 10 }
+
+          set :response_error_parser => Parser::AWS::ResponseErrorV2
+          
+          cache_pattern :verb  => /get|post/,
+                        :path  => /Action=List/,
+                        :if    => Proc::new{ |o| (o[:params].keys - COMMON_QUERY_PARAMS)._blank? },
+                        :key   => Proc::new{ |o| o[:params]['Action'] },
+                        :sign  => Proc::new{ |o| o[:response].body.to_s.sub(%r{<RequestId>.+?</RequestId>}i,'') }
+        end
+      end
+      
+    end
+  end
+end

data/lib/cloud/aws/iam/manager.rb

@@ -0,0 +1,100 @@
+#--
+# Copyright (c) 2013 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.
+#++
+
+require "cloud/aws/base/manager"
+
+module RightScale
+  module CloudApi
+    module AWS
+
+      # Identity and Access Management namespace
+      module IAM
+        
+        # Amazon Identity and Access Management (IAM) compatible manager (thread safe).
+        # 
+        # @example
+        #  require "right_aws_api"
+        #
+        #  iam = RightScale::CloudApi::AWS::IAM::Manager::new(key, secret, 'https://iam.amazonaws.com')
+        #
+        #  # Get information about the Access Key IDs associated with the specified user.
+        #  iam.ListAccessKeys #=>
+        #    {"ListAccessKeysResponse"=>
+        #      {"@xmlns"=>"https://iam.amazonaws.com/doc/2010-05-08/",
+        #       "ListAccessKeysResult"=>
+        #        {"IsTruncated"=>"false",
+        #         "AccessKeyMetadata"=>
+        #          {"member"=>
+        #            [{"Status"=>"Inactive",
+        #              "AccessKeyId"=>"AKIAJ23FVBWT2CPC74RQ",
+        #              "CreateDate"=>"2010-11-19T07:40:23Z"},
+        #             {"Status"=>"Active",
+        #              "AccessKeyId"=>"AKIAJDAKGFLR3C44FUTA",
+        #              "CreateDate"=>"2011-10-14T23:32:16Z"}]}},
+        #       "ResponseMetadata"=>{"RequestId"=>"68732a2a-4f72-11e2-8c9d-7786bfa02548"}}}
+        #
+        # @example
+        #  # List keys by user
+        #  iam.ListAccessKeys('UserName' => 'Bob')
+        #
+        # @example
+        #  # Create a new User
+        #  iam.CreateUser('Path' => '/division_abc/subdivision_xyz/bob/',
+        #                 'UserName' => 'Bob')
+        #
+        # @see ApiManager
+        # @see http://docs.aws.amazon.com/IAM/latest/APIReference/API_Operations.html
+        #
+        class Manager < AWS::Manager
+        end
+
+
+        # Amazon Identity and Access Management (IAM) compatible manager (thread safe).
+        #
+        # @see Manager
+        #
+        class ApiManager < AWS::ApiManager
+
+          # Default API version for Identity and Access Management service.
+          # To override the API version use :api_version key when instantiating a manager.
+          #
+          DEFAULT_API_VERSION = '2010-05-08'
+
+          error_pattern :abort_on_timeout,     :path     => /Action=(Create|Put)/
+          error_pattern :retry,                :response => /InternalError|Unavailable/i
+          error_pattern :disconnect_and_abort, :code     => /5..|403|408/
+          error_pattern :disconnect_and_abort, :code     => /4../, :if => Proc.new{ |opts| rand(100) < 10 }
+
+          set :response_error_parser => Parser::AWS::ResponseErrorV2
+          
+          cache_pattern :verb  => /get|post/,
+                        :path  => /Action=List/,
+                        :if    => Proc::new{ |o| (o[:params].keys - COMMON_QUERY_PARAMS)._blank? },
+                        :key   => Proc::new{ |o| o[:params]['Action'] },
+                        :sign  => Proc::new{ |o| o[:response].body.to_s.sub(%r{<RequestId>.+?</RequestId>}i,'') }
+        end
+      end
+      
+    end
+  end
+end

data/lib/cloud/aws/rds/manager.rb

@@ -0,0 +1,110 @@
+#--
+# Copyright (c) 2013 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.
+#++
+
+require "cloud/aws/base/manager"
+
+module RightScale
+  module CloudApi
+    module AWS
+
+      # Relational Database Service namespace
+      module RDS
+        
+        # Amazon Relational Database Service (RDS) compatible manager (thread safe).
+        #
+        # @example
+        #  require "right_aws_api"
+        #
+        #  rds = RightScale::CloudApi::AWS::RDS::Manager::new(key, secret, 'https://rds.amazonaws.com')
+        #
+        #  # Describe DB Engine Versions
+        #  rds.DescribeDBEngineVersions #=>
+        #    {"DescribeDBEngineVersionsResponse"=>
+        #      {"@xmlns"=>"http://rds.amazonaws.com/doc/2011-04-01/",
+        #       "DescribeDBEngineVersionsResult"=>
+        #        {"DBEngineVersions"=>
+        #          {"DBEngineVersion"=>
+        #            [{"DBParameterGroupFamily"=>"mysql5.1",
+        #              "Engine"=>"mysql",
+        #              "DBEngineDescription"=>"MySQL Community Edition",
+        #              "EngineVersion"=>"5.1.45",
+        #              "DBEngineVersionDescription"=>"MySQL 5.1.45"},
+        #              ...
+        #             {"DBParameterGroupFamily"=>"sqlserver-web-11.0",
+        #              "Engine"=>"sqlserver-web",
+        #              "DBEngineDescription"=>"Microsoft SQL Server Web Edition",
+        #              "EngineVersion"=>"11.00.2100.60.v1",
+        #              "DBEngineVersionDescription"=>"SQL Server 2012 11.00.2100.60.v1"}]}},
+        #       "ResponseMetadata"=>{"RequestId"=>"2cea9327-4f73-11e2-b200-6b97351ff318"}}}
+        #
+        # @example
+        #  # Create a new RDS instance
+        #  rds.CreateDBInstance( 'DBInstanceIdentifier' => 'SimCoProd01',
+        #                        'Engine'               => 'mysql',
+        #                        'MasterUserPassword'   => 'Password01',
+        #                        'AllocatedStorage'     => 10,
+        #                        'MasterUsername'       => 'master',
+        #                        'DBInstanceClass'      => 'db.m1.large',
+        #                        'DBSubnetGroupName'    => 'dbSubnetgroup01')
+        #
+        # @example
+        #  # Delete an instance
+        #  rds.DeleteDBInstance('DBInstanceIdentifier' => 'SimCoProd01')
+        #
+        # @see ApiManager
+        # @see http://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_Operations.html
+        #
+        class Manager < AWS::Manager
+        end
+
+
+        # Amazon Relational Database Service (RDS) compatible manager (thread safe).
+        #
+        # @see Manager
+        #
+        class  ApiManager < AWS::ApiManager
+
+          # Default API version for RDS service.
+          # To override the API version use :api_version key when instantiating a manager.
+          #
+          DEFAULT_API_VERSION = '2013-02-12'
+          
+          error_pattern :abort_on_timeout,     :path     => /Action=(Create|Purchase)/
+          error_pattern :retry,                :response => /InternalError|Unavailable/i
+          error_pattern :disconnect_and_abort, :code     => /5..|403|408/
+          error_pattern :disconnect_and_abort, :code     => /4../, :if => Proc.new{ |opts| rand(100) < 10 }
+          
+          set :response_error_parser => Parser::AWS::ResponseErrorV2
+          
+          cache_pattern :verb  => /get|post/,
+                        :path  => /Action=Describe/,
+                        :if    => Proc::new{ |o| (o[:params].keys - COMMON_QUERY_PARAMS)._blank? },
+                        :key   => Proc::new{ |o| o[:params]['Action'] },
+                        :sign  => Proc::new{ |o| o[:response].body.to_s.sub(%r{<RequestId>.+?</RequestId>}i,'') }
+          
+        end
+      end
+        
+    end
+  end
+end

data/lib/cloud/aws/route53/manager.rb

@@ -0,0 +1,177 @@
+#--
+# Copyright (c) 2013 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.
+#++
+
+require "cloud/aws/base/helpers/utils"
+require "cloud/aws/base/parsers/response_error"
+require "cloud/aws/route53/routines/request_signer"
+require "cloud/aws/route53/wrappers/default"
+
+module RightScale
+  module CloudApi
+    module AWS
+
+      # Route 53 namespace
+      module Route53
+
+        # Amazon Route 53 (Route53) compatible manager (thread safe).
+        #
+        # @example
+        #  require "right_aws_api"
+        #
+        #  r53 = RightScale::CloudApi::AWS::Route53::Manager::new(
+        #    ENV['AWS_ACCESS_KEY_ID'],
+        #    ENV['AWS_SECRET_ACCESS_KEY'],
+        #    'https://route53.amazonaws.com'
+        #    )
+        #
+        #  r53.ListHostedZones #=> 
+        #    {"ListHostedZonesResponse"=>
+        #      {"IsTruncated"=>"false",
+        #       "HostedZones"=>
+        #        {"HostedZone"=>
+        #          {"Name"=>"aws.rightscale.com.",
+        #           "CallerReference"=>"RightScaleTest",
+        #           "Config"=>{"Comment"=>"This is RightScale test hosted zone."},
+        #           "Id"=>"/hostedzone/Z3AINKOIEY1X3X"}},
+        #       "MaxItems"=>"100",
+        #       "@xmlns"=>"https://route53.amazonaws.com/doc/2011-05-05/"}}
+        #
+        #
+        # @example
+        #  r53.ListResourceRecordSets #=>        
+        #    {"ListResourceRecordSetsResponse"=>
+        #      {"IsTruncated"=>"false",
+        #       "MaxItems"=>"100",
+        #       "@xmlns"=>"https://route53.amazonaws.com/doc/2011-05-05/",
+        #       "ResourceRecordSets"=>
+        #        {"ResourceRecordSet"=>
+        #          [{"ResourceRecords"=>
+        #             {"ResourceRecord"=>
+        #               [{"Value"=>"ns-671.awsdns-19.net."},
+        #                {"Value"=>"ns-1057.awsdns-04.org."},
+        #                {"Value"=>"ns-1885.awsdns-43.co.uk."},
+        #                {"Value"=>"ns-438.awsdns-54.com."}]},
+        #            "TTL"=>"172800",
+        #            "Name"=>"aws.rightscale.com.",
+        #            "Type"=>"NS"},
+        #           {"ResourceRecords"=>
+        #             {"ResourceRecord"=>
+        #               {"Value"=>
+        #                 "ns-671.awsdns-19.net. awsdns-hostmaster.amazon.com. 1 7200 900 1209600 86400"}},
+        #            "TTL"=>"1000",
+        #            "Name"=>"aws.rightscale.com.",
+        #            "Type"=>"SOA"},
+        #           {"ResourceRecords"=>{"ResourceRecord"=>{"Value"=>"10.244.154.211"}},
+        #            "TTL"=>"60",
+        #            "Name"=>"test.aws.rightscale.com.",
+        #            "Type"=>"A"},
+        #           {"ResourceRecords"=>{"ResourceRecord"=>{"Value"=>"10.194.215.64"}},
+        #            "TTL"=>"60",
+        #            "Name"=>"test1.aws.rightscale.com.",
+        #            "Type"=>"A"},
+        #           {"ResourceRecords"=>{"ResourceRecord"=>{"Value"=>"10.136.127.175"}},
+        #            "TTL"=>"60",
+        #            "Name"=>"testslave9.aws.rightscale.com.",
+        #            "Type"=>"A"}]}}}
+        #
+        # @see ApiManager
+        # @see Wrapper::DEFAULT.extended Wrapper::DEFAULT.extended (click [View source])
+        # @see http://docs.aws.amazon.com/Route53/latest/APIReference/Welcome.html
+        #
+        class Manager < CloudApi::Manager
+        end
+
+
+        # Amazon Route 53 (Route) compatible manager (thread safe)
+        #
+        # @see Manager
+        #
+        class  ApiManager < CloudApi::ApiManager
+
+          # RequestSigner Error
+          class Error < CloudApi::Error
+          end
+          
+          # Default API version for Route53 service.
+          # To override the API version use :api_version key when instantiating a manager.
+          #
+          DEFAULT_API_VERSION = '2011-05-05'
+
+          include Mixin::QueryApiPatterns
+
+          set_routine CloudApi::RetryManager
+          set_routine CloudApi::RequestInitializer
+          set_routine AWS::Route53::RequestSigner
+          set_routine CloudApi::RequestGenerator
+          set_routine CloudApi::ConnectionProxy
+          set_routine CloudApi::ResponseAnalyzer
+          set_routine CloudApi::ResponseParser
+          set_routine CloudApi::ResultWrapper
+
+          set :response_error_parser => Parser::AWS::ResponseErrorV2
+
+
+          # Constructor
+          #
+          # @param [String] aws_access_key_id
+          # @param [String] aws_secret_access_key
+          # @param [String] endpoint
+          # @param [Hash] options
+          #
+          # @example
+          #   # see Manager class usage
+          #
+          # @see Manager 
+          #
+          def initialize(aws_access_key_id, aws_secret_access_key, endpoint, options={})
+            credentials = { :aws_access_key_id     => aws_access_key_id,
+                            :aws_secret_access_key => aws_secret_access_key }
+            super(credentials, endpoint, options)
+          end
+
+
+          # Makes an API call to AWS::Route53 compatible cloud
+          #
+          # @param [String,Symbol] verb
+          # @param [Objects] args
+          #
+          # @return [Object]
+          #
+          # @example
+          #   api(verb,         opts={})
+          #   # Where opts may have next keys: :options, :headers, :params
+          #   api(verb, 'path', opts={})
+          #
+          def api(verb, *args, &block)
+            relative_path = args.first.is_a?(String) ? args.shift : ''
+            opts          = args.shift || {}
+            raise Error::new("Opts must be Hash not #{opts.class.name}") unless opts.is_a?(Hash)
+            process_api_request(verb, relative_path, opts, &block)
+          end
+                    
+        end
+
+      end
+    end
+  end
+end