right_aws_api 0.1.0

data/lib/cloud/aws/cf/routines/request_signer.rb

@@ -0,0 +1,70 @@
+#--
+# 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.
+#++
+
+module RightScale
+  module CloudApi
+    module AWS
+      module CF
+        
+        # API request signer for CF service.
+        class RequestSigner < CloudApi::Routine
+
+          # CF RequestSigner Error
+          class Error < CloudApi::Error
+          end
+
+          # Authenticates a CloudFront request
+          #
+          # @return [void]
+          #
+          # @example
+          #  # qno example
+          #
+          def process
+            # Fix body
+            unless @data[:request][:body]._blank?
+              # Make sure 'content-type' is set if we have a body
+              @data[:request][:headers].set_if_blank('content-type', 'application/xml' )
+              # Fix body if it is a Hash instance
+              if @data[:request][:body].is_a?(Hash)
+                @data[:request][:body] = Utils::contentify_body(@data[:request][:body], @data[:request][:headers]['content-type'])
+              end
+              # Calculate 'content-md5' when possible (some API calls wanna have it set)
+              if @data[:request][:body].is_a?(String)
+                @data[:request][:headers]['content-md5'] = Base64::encode64(Digest::MD5::digest(@data[:request][:body])).strip
+              end
+            end
+            # Set date
+            @data[:request][:headers].set_if_blank('date', Time::now.utc.httpdate)
+            # Sign a request
+            signature = Utils::AWS::sign(@data[:credentials][:aws_secret_access_key], Utils::dearrayify(@data[:request][:headers]['date']))
+            @data[:request][:headers]['authorization'] = "AWS #{@data[:credentials][:aws_access_key_id]}:#{signature}"
+            # Set path
+            @data[:request][:path] = Utils::join_urn(@data[:connection][:uri].path, @data[:options][:api_version], @data[:request][:relative_path], @data[:request][:params])
+          end
+        end
+        
+      end
+    end
+  end
+end

data/lib/cloud/aws/cf/wrappers/default.rb

@@ -0,0 +1,213 @@
+#--
+# 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.
+#++
+
+module RightScale
+  module CloudApi
+    module AWS
+      module CF
+
+        # CF wrapper namespace
+        module Wrapper
+
+          # Default wrapper
+          module DEFAULT
+            
+            # Defines QUERY API like methods for the service
+            #
+            # @return [void]
+            #
+            # @example
+            #  # no example
+            #
+            def self.extended(base)
+
+              distribution_config = {
+                'DistributionConfig' => {
+                  '@xmlns'            => "http://cloudfront.amazonaws.com/doc/2010-11-01/",
+                  'S3Origin'          => :S3Origin,
+                  'CustomOrigin'      => :CustomOrigin,
+                  'CallerReference'   => :CallerReference,
+                  'CNAME'             => :CNAME,
+                  'Comment'           => :Comment,
+                  'Enabled'           => :Enabled,
+                  'DefaultRootObject' => :DefaultRootObject,
+                  'Logging'           => :Logging,
+                  'TrustedSigners'    => :TrustedSigners,
+                  'RequiredProtocols{!remove-if-blank}' => {
+                    'Protocol' => :Protocol
+                  }
+                }
+              }
+              distribution_config_defaults = {
+                :S3Origin          => Utils::NONE,
+                :CustomOrigin      => Utils::NONE,
+                :CNAME             => Utils::NONE,
+                :Comment           => Utils::NONE,
+                :DefaultRootObject => Utils::NONE,
+                :Logging           => Utils::NONE,
+                :Protocol          => Utils::NONE,
+                :TrustedSigners    => Utils::NONE,
+              }
+
+              
+              streaming_distribution_config = {
+                'StreamingDistributionConfig' => {
+                  '@xmlns'          => "http://cloudfront.amazonaws.com/doc/2010-11-01/",
+                  'S3Origin'        => :S3Origin,
+                  'CallerReference' => :CallerReference,
+                  'CNAME'           => :CNAME,
+                  'Comment'         => :Comment,
+                  'Enabled'         => :Enabled,
+                  'Logging'         => :Logging,
+                  'TrustedSigners'  => :TrustedSigners
+                }
+              }
+              streaming_distribution_config_defaults = {
+                :CNAME             => Utils::NONE,
+                :Comment           => Utils::NONE,
+                :DefaultRootObject => Utils::NONE,
+                :TrustedSigners    => Utils::NONE,
+                :Logging           => Utils::NONE
+              }
+
+              
+              origin_access_identity_config = {
+                'CloudFrontOriginAccessIdentityConfig' => {
+                  '@xmlns'          => 'http://cloudfront.amazonaws.com/doc/2010-11-01/',
+                  'CallerReference' => :CallerReference,
+                  'Comment'         => :Comment
+                }
+              }
+              origin_access_identity_defaults = {
+               :Comment =>  Utils::NONE                
+              } 
+              
+                            
+              #-----------------
+              # Distributions
+              #-----------------
+              
+              
+              base.query_api_pattern 'ListDistributions', :get, 'distribution'
+
+              
+              base.query_api_pattern 'GetDistribution', :get, 'distribution/{:DistributionId}'
+
+              
+              base.query_api_pattern 'GetDistributionConfig', :get, 'distribution/{:DistributionId}/config'
+
+              
+              base.query_api_pattern 'CreateDistribution', :post, 'distribution',
+                :body     => distribution_config,
+                :defaults => distribution_config_defaults
+              
+              
+              base.query_api_pattern 'UpdateDistribution', :put, 'distribution/{:DistributionId}/config',
+                :body     => distribution_config,
+                :defaults => distribution_config_defaults
+              
+              
+              base.query_api_pattern 'DeleteDistribution', :delete, 'distribution/{:DistributionId}'
+              
+              
+              #---------------------------
+              # Streaming Distributions
+              #--------------------------
+              
+              
+              base.query_api_pattern 'ListStreamingDistributions', :get, 'streaming-distribution'
+
+              
+              base.query_api_pattern 'GetStreamingDistribution', :get, 'streaming-distribution/{:DistributionId}'
+
+              
+              base.query_api_pattern 'GetStreamingDistributionConfig', :get, 'streaming-distribution/{:DistributionId}/config'
+
+              
+              base.query_api_pattern 'CreateStreamingDistribution', :post, 'streaming-distribution',
+                :body     => streaming_distribution_config,
+                :defaults => streaming_distribution_config_defaults
+              
+              
+              base.query_api_pattern 'UpdateStreamingDistribution', :put, 'streaming-distribution/{:DistributionId}/config',
+                :body     => streaming_distribution_config,
+                :defaults => streaming_distribution_config_defaults
+              
+              
+              base.query_api_pattern 'DeleteStreamingDistribution', :delete, 'streaming-distribution/{:DistributionId}'
+              
+              
+              #---------------------------
+              # Origin Access Identities
+              #--------------------------
+              
+              
+              base.query_api_pattern 'ListOriginAccessIdentities', :get, 'origin-access-identity/cloudfront'
+              
+              
+              base.query_api_pattern 'GetOriginAccessIdentity', :get, 'origin-access-identity/cloudfront/{:IdentityId}'
+              
+              
+              base.query_api_pattern 'GetOriginAccessIdentityConfig', :get, 'origin-access-identity/cloudfront/{:IdentityId}/config'
+              
+              
+              base.query_api_pattern 'CreateOriginAccessIdentity', :post, 'origin-access-identity/cloudfront',
+                :body     => origin_access_identity_config,
+                :defaults => origin_access_identity_defaults
+              
+              
+              base.query_api_pattern 'UpdateOriginAccessIdentity', :pup, 'origin-access-identity/cloudfront/{:IdentityId}/config',
+                :body     => origin_access_identity_config,
+                :defaults => origin_access_identity_defaults
+              
+              
+              base.query_api_pattern 'DeleteOriginAccessIdentity', :delete, 'origin-access-identity/cloudfront/{:IdentityId}'
+              
+
+              #---------------------------
+              # Origin Access Identities
+              #--------------------------
+              
+              
+              base.query_api_pattern 'ListInvalidations', :get,  'distribution/{:DistributionId}/invalidation'
+
+              
+              base.query_api_pattern 'GetInvalidation', :get,  'distribution/{:DistributionId}/invalidation/{:InvalidationId}'
+
+              
+              base.query_api_pattern 'CreateInvalidation', :post,  'distribution/{:DistributionId}/invalidation',
+                :body => {
+                  'InvalidationBatch' => {
+                    'CallerReference' => :CallerReference,
+                    'Path'            => :Path
+                  }
+                }
+              
+            end
+            
+          end          
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,90 @@
+#--
+# 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
+
+      # CloudFormation namespace
+      module CFM
+        
+        # Amazon CloudFormation (CFM) compatible manager (thread safe).
+        #
+        # @example
+        #  require "right_aws_api"
+        #
+        #  cfm = RightScale::CloudApi::AWS::CFM::Manager::new(key, secret, 'https://cloudformation.us-east-1.amazonaws.com')
+        #
+        #  # Describe the description for the specified stack
+        #  cfm.DescribeStacks #=>
+        #    {"DescribeStacksResponse"=>
+        #      {"@xmlns"=>"http://cloudformation.amazonaws.com/doc/2010-05-15/",
+        #       "DescribeStacksResult"=>{"Stacks"=>nil},
+        #       "ResponseMetadata"=>{"RequestId"=>"363a6f90-4f60-11e2-a5b9-17ce5ae131c1"}}}
+        #
+        # @example
+        #  # Describe a custom stack:
+        #  cfm.DescribeStacks('StackName' => 'MyStack')
+        #
+        # @example
+        #  # Estimate template cost:
+        #  cfm.EstimateTemplateCost('TemplateURL' =>  'https://s3.amazonaws.com/cloudformation-samples-us-east-1/Drupal_Simple.template')
+        #
+        # @see ApiManager
+        # @see http://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_Operations.html
+        #
+        class Manager < AWS::Manager
+        end
+
+
+        # Amazon CloudFormation (CFM) compatible manager (thread unsafe).
+        #
+        # @see Manager
+        #
+        class ApiManager < AWS::ApiManager
+
+          # Default API version for CloudFormation service.
+          # To override the API version use :api_version key when instantiating a manager.
+          #
+          DEFAULT_API_VERSION = '2010-05-15'
+
+          error_pattern :abort_on_timeout,     :path     => /Action=(Create)/
+          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|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/cw/manager.rb

@@ -0,0 +1,113 @@
+#--
+# 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
+
+      # CloudWatch namespace
+      module CW
+        
+        # Amazon CloudWatch (CW) compatible manager (thread safe).
+        #
+        # @example
+        #  require "right_aws_api"
+        #
+        #  cw = RightScale::CloudApi::AWS::CW::Manager::new(key, secret, 'https://monitoring.us-east-1.amazonaws.com')
+        #
+        #  # Get a list of valid metrics stored for the AWS account owner.
+        #  cw.ListMetrics #=>
+        #    {"ListMetricsResponse"=>
+        #      {"@xmlns"=>"http://monitoring.amazonaws.com/doc/2010-08-01/",
+        #       "ListMetricsResult"=>
+        #        {"Metrics"=>
+        #          {"member"=>
+        #            [{"Dimensions"=>
+        #               {"member"=>{"Name"=>"InstanceId", "Value"=>"i-29fc074d"}},
+        #              "MetricName"=>"DiskReadOps",
+        #              "Namespace"=>"AWS/EC2"},
+        #             {"Dimensions"=>
+        #               {"member"=>
+        #                 {"Name"=>"QueueName",
+        #                  "Value"=>"dano7_audit_queue_server_array_test"}},
+        #              "MetricName"=>"ApproximateNumberOfMessagesDelayed",
+        #              "Namespace"=>"AWS/SQS"},
+        #             {"Dimensions"=>
+        #               {"member"=>
+        #                 {"Name"=>"QueueName",
+        #                  "Value"=>"dano_input_queue_server_array_test"}},
+        #              "MetricName"=>"ApproximateNumberOfMessagesNotVisible",
+        #              "Namespace"=>"AWS/SQS"}]},
+        #         "NextToken"=>
+        #          "w9...xhCEA=="},
+        #       "ResponseMetadata"=>{"RequestId"=>"bd188949-4f61-11e2-9a69-59e1411d80ca"}}}
+        #
+        # @example
+        #  # Get alarms history.
+        #  cw.DescribeAlarmHistory #=>
+        #    {"DescribeAlarmHistoryResponse"=>
+        #      {"@xmlns"=>"http://monitoring.amazonaws.com/doc/2010-08-01/",
+        #       "DescribeAlarmHistoryResult"=>{"AlarmHistoryItems"=>nil},
+        #       "ResponseMetadata"=>{"RequestId"=>"2f087a3b-4f62-11e2-b8d8-754622cf5638"}}}
+        #
+        #  # Get a history for the specified alarm.
+        #  cw.DescribeAlarmHistory('AlarmName' => 'MyAlarm')
+        #
+        # @see ApiManager
+        # @see http://docs.amazonwebservices.com/AmazonCloudWatch/latest/APIReference/Welcome.html
+        #
+        class Manager < AWS::Manager
+        end
+
+
+        # Amazon CloudWatch (CW) compatible manager (thread unsafe).
+        #
+        # @see Manager
+        #
+        class  ApiManager < AWS::ApiManager
+
+          # Default API version for CloudWatch service.
+          # To override the API version use :api_version key when instantiating a manager.
+          #
+          DEFAULT_API_VERSION = '2010-08-01'
+
+          error_pattern :abort_on_timeout,     :path     => /Action=(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