aws-sdk-euca 1.8.5

data/lib/aws/cloud_formation/stack_resource.rb

@@ -0,0 +1,117 @@
+# Copyright 2011-2013 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+
+module AWS
+  class CloudFormation
+
+    # @attr_reader [String,nil] description
+    #   User defined description associated with the resource.
+    #
+    # @attr_reader [String] physical_resource_id
+    #   The name or unique identifier that corresponds to a physical instance
+    #   ID of a resource supported by AWS CloudFormation.
+    #
+    # @attr_reader [Symbol] resource_status 
+    #   Current status of the resource.
+    #
+    # @attr_reader [String,nil] resource_status_reason
+    #   Success/failure message associated with the resource.
+    #
+    # @attr_reader [String] resource_type
+    #   Type of the resource (e.g. 'AWS::EC2::Instance')
+    #
+    # @attr_reader [String] stack_name
+    #   The name associated with the stack.
+    #
+    # @attr_reader [String] stack_id
+    #   Unique identifier of the stack.
+    #
+    # @attr_reader [Time] last_updated_timestamp
+    #   When the status was last updated.
+    #
+    # @attr_reader [String,nil] metadata
+    #   The JSON format content of the Metadata attribute declared for the 
+    #   resource.
+    #
+    class StackResource < Core::Resource
+
+      # @private
+      def initialize stack, logical_resource_id, options = {}
+        @stack = stack
+        @logical_resource_id = logical_resource_id
+        super
+      end
+
+      # @return [Stack]
+      attr_reader :stack
+
+      # @return [String] The logical name of the resource specified in 
+      #   the template.
+      attr_reader :logical_resource_id
+
+      define_attribute_type :common # return by both describe stack resource methods
+
+      define_attribute_type :detail # returned by DescribeStackResource (singular)
+
+      common_attribute :description, :static => true
+
+      common_attribute :physical_resource_id, :static => true
+
+      common_attribute :resource_status
+
+      common_attribute :resource_status_reason
+
+      common_attribute :resource_type, :static => true
+
+      common_attribute :stack_name, :static => true
+
+      common_attribute :stack_id, :static => true
+
+      # provided by DescribeStackResource
+
+      detail_attribute :last_updated_timestamp
+
+      detail_attribute :metadata
+
+      # this operation returns all attributes
+      populates_from(:describe_stack_resource) do |resp|
+        resp.stack_resource_detail if 
+          resp.stack_resource_detail.logical_resource_id == logical_resource_id
+      end
+
+      # This method provides ALL attributes except :metadata.  The
+      # :last_updated_timestamp attribute is also provided by 
+      # a differnt name (:timestamp instead of :last_updated_timestamp).
+      provider(:describe_stack_resources) do |provider|
+        provider.find do |resp|
+          resp.stack_resources.find do |resource|
+            resource.logical_resource_id == logical_resource_id
+          end
+        end
+        provider.provides *common_attributes.keys
+        provider.provides :last_updated_timestamp, :from => :timestamp
+      end
+
+      protected
+
+      def resource_identifiers
+        [[:stack_name, stack.name], [:logical_resource_id, logical_resource_id]]
+      end
+
+      def get_resource attribute = nil
+        client.describe_stack_resource(resource_options)  
+      end
+
+    end
+  end
+end

data/lib/aws/cloud_formation/stack_resource_collection.rb

@@ -0,0 +1,84 @@
+# Copyright 2011-2013 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+
+module AWS
+  class CloudFormation
+
+    # = StackResourceCollection 
+    #
+    # This collection represents the resources for a single {Stack}.
+    # You can enumerate resources, or request a specific resource
+    # by its logical resource id.
+    #
+    # = Other Ways to Get Resource Details
+    #
+    # If you want to get a {StackResource} by its physical resource
+    # id, then you should use {CloudFormation#stack_resource}.
+    #
+    # You can also take a look at {Stack#resource_summaries} for
+    # light-weight hashes of stack resource details.
+    #
+    # @example Enumerating stack resources
+    #
+    #   # enumerating all resources for a stack
+    #   stack.resources.each do |resource|
+    #     puts resource.resource_type + " " + resource.physical_resource_id
+    #   end
+    # 
+    # @example Getting a stack resource by its logical resource id
+    #
+    #   resource = stack.resources['web']
+    #
+    class StackResourceCollection
+
+      include Core::Collection::Simple
+      include StackOptions
+
+      # @param [Stack] stack
+      # @param [Hash] options
+      def initialize stack, options = {}
+        @stack = stack
+        super
+      end
+
+      # @return [Stack]
+      attr_reader :stack
+
+      # @param [String] logical_resource_id
+      # @return [StackResource] Returns a stack resource with the given
+      #   logical resource id.
+      def [] logical_resource_id 
+        StackResource.new(stack, logical_resource_id)
+      end
+
+      protected
+
+      def _each_item options = {}
+        options[:stack_name] = stack.name
+        response = client.describe_stack_resources(options)
+        response.stack_resources.each do |details|
+
+          stack_resource = StackResource.new_from(
+            :describe_stack_resources, 
+            details,
+            self, 
+            details.logical_resource_id)
+
+          yield(stack_resource)
+
+        end
+      end
+
+    end
+  end
+end

data/lib/aws/cloud_formation/stack_resource_summary_collection.rb

@@ -0,0 +1,64 @@
+# Copyright 2011-2013 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+
+module AWS
+  class CloudFormation
+
+    # = Stack Resource Summaries
+    #
+    # Stack summaries contain information about CloudFormation
+    # stack resources.  You can enumerate these from a stack.
+    #
+    #   stack = cfm.stacks['stack-name']
+    #   stack.resource_summaries.each do |summary|
+    #     puts "#{summary[:physical_resource_id]}: #{summary[:resource_status]}"
+    #   end
+    #
+    # Each summary yielded is a hash with the following keys:
+    #
+    # * +:logical_resource_id+
+    # * +:physical_resource_id+
+    # * +:resource_type+
+    # * +:resource_status+
+    # * +:resource_status_reason+
+    # * +:last_updated_timestamp+
+    #
+    class StackResourceSummaryCollection
+
+      include Core::Collection::WithNextToken
+
+      # @param [Stack] stack
+      # @param [Hash] options
+      def initialize stack, options = {}
+        @stack = stack
+        super
+      end
+
+      # @return [Stack]
+      attr_reader :stack
+
+      protected
+
+      def _each_item next_token, options = {}, &block
+        options[:next_token] = next_token if next_token
+        options[:stack_name] = stack.name
+        resp = client.list_stack_resources(options)
+        resp.data[:stack_resource_summaries].each do |summary|
+          yield(summary)
+        end
+        resp.data[:next_token]
+      end
+
+    end
+  end
+end

data/lib/aws/cloud_formation/stack_summary_collection.rb

@@ -0,0 +1,123 @@
+# Copyright 2011-2013 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+
+module AWS
+  class CloudFormation
+
+    # = Stack Summaries
+    #
+    # Stack summaries contain information about CloudFormation
+    # stacks.  You can filter the stacks you want summary information
+    # for by one or more statuses.  You can even get information
+    # about deleted stacks for up to 90 days.
+    #
+    # == Enumerating Stack Summaries
+    #
+    # You can enumerate all available summaries using enumerable
+    # methods.  Yielded summaries are simple hashes.
+    #
+    #   cfm = AWS::CloudFormation.new
+    #   cfm.stack_summaries.each do |summary|
+    #     puts summary.to_yaml
+    #   end
+    #
+    # == Filtering Stack Summaries
+    #
+    # You can optionally provide one or more stack stasus values
+    # to filter the results by.  Only stacks with the given status(es)
+    # will be enumerated.
+    #
+    #   cfm.stack_summaries.with_status(:create_failed).each do |summary|
+    #     # ...
+    #   end
+    #
+    #   # enumerate stacks with various delete statuses
+    #   statuses = %w(delete_in_progress delete_failed delete_complete)
+    #   cf.stack_summaries.with_status(statuses).each do |summary|
+    #     # ...
+    #   end
+    #
+    class StackSummaryCollection
+
+      include Core::Collection::WithNextToken
+
+      # @private
+      def initialize options = {}
+        @filters = options[:filters]
+        super
+      end
+
+      # Limits the stacks summaries that are enumerated.
+      #
+      #   cfm.stack_summaries.with_status(:create_complete).each do |summary|
+      #     puts summary[:stack_name]
+      #   end
+      #
+      # You can provide multiple statuses:
+      #
+      #   statuses = [:create_failed, :rollback_failed]
+      #   cfm.stack_summaries.with_status(statuses).each do |summary|
+      #     puts summary[:stack_name]
+      #   end
+      #
+      # Status names may be symbolized (snake-cased) or upper-cased strings
+      # (e.g. :create_in_progress, 'CREATE_IN_PROGRESS').
+      #
+      # @param [Symbol,String] status_filters One or more statuses to filter
+      #   stacks with. Valid values include:
+      #   * +:create_in_progress+
+      #   * +:create_failed+
+      #   * +:create_complete+
+      #   * +:rollback_in_progress+
+      #   * +:rollback_failed+
+      #   * +:rollback_complete+
+      #   * +:delete_in_progress+
+      #   * +:delete_failed+
+      #   * +:delete_complete+
+      #   * +:update_in_progress+
+      #   * +:update_complete_cleanup_in_progress+
+      #   * +:update_complete+
+      #   * +:update_rollback_in_progress+
+      #   * +:update_rollback_failed+
+      #   * +:update_rollback_complete_cleanup_in_progress+
+      #   * +:update_rollback_complete+
+      #
+      # @return [StackSummaryCollection] Returns a new stack summary
+      #   collection that restricts what stack summariess will be
+      #   enumerated.
+      #
+      def with_status *status_filters
+        StackSummaryCollection.new(
+          :filters => status_filters.flatten.map(&:to_s).map(&:upcase),
+          :config => config)
+      end
+
+      protected
+
+      def _each_item next_token, options = {}, &block
+
+        options[:next_token] = next_token if next_token
+        options[:stack_status_filter] = @filters if @filters
+
+        resp = client.list_stacks(options)
+        resp.data[:stack_summaries].each do |summary|
+          yield(summary)
+        end
+
+        resp.data[:next_token]
+
+      end
+
+    end
+  end
+end

data/lib/aws/cloud_front.rb

@@ -0,0 +1,73 @@
+# Copyright 2011-2013 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"). You
+# may not use this file except in compliance with the License. A copy of
+# the License is located at
+#
+#     http://aws.amazon.com/apache2.0/
+#
+# or in the "license" file accompanying this file. This file is
+# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# ANY KIND, either express or implied. See the License for the specific
+# language governing permissions and limitations under the License.
+
+require 'aws/core'
+require 'aws/cloud_front/config'
+
+module AWS
+
+  # This class is the starting point for working with Amazon CloudFront.
+  #
+  # To use Amazon CloudFront you must first
+  # {sign up here}[http://aws.amazon.com/cloudfront/].
+  #
+  # For more information about Amazon CloudFront:
+  #
+  # * {Amazon CloudFront}[http://aws.amazon.com/cloudfront/]
+  # * {Amazon CloudFront Documentation}[http://aws.amazon.com/documentation/cloudfront/]
+  #
+  # = Credentials
+  #
+  # You can setup default credentials for all AWS services via
+  # AWS.config:
+  #
+  #   AWS.config(
+  #     :access_key_id => 'YOUR_ACCESS_KEY_ID',
+  #     :secret_access_key => 'YOUR_SECRET_ACCESS_KEY')
+  #
+  # Or you can set them directly on the AWS::Route53 interface:
+  #
+  #   cf = AWS::CloudFront.new(
+  #     :access_key_id => 'YOUR_ACCESS_KEY_ID',
+  #     :secret_access_key => 'YOUR_SECRET_ACCESS_KEY')
+  #
+  # = Using the Client
+  #
+  # AWS::CloudFront does not provide higher level abstractions for CloudFront at
+  # this time.  You can still access all of the API methods using
+  # {AWS::CloudFront::Client}.  Here is how you access the client and make
+  # a simple request:
+  #
+  #   cf = AWS::CloudFront.new
+  #
+  #   resp = cf.client.list_distributions
+  #   resp[:items].each do |distribution|
+  #     # ...
+  #   end
+  #
+  # See {Client} for documentation on all of the supported operations.
+  #
+  # @!attribute [r] client
+  #   @return [Client] the low-level CloudFront client object
+  class CloudFront
+
+    AWS.register_autoloads(self, 'aws/cloud_front') do
+      autoload :Client,  'client'
+      autoload :Errors,  'errors'
+      autoload :Request, 'request'
+    end
+
+    include Core::ServiceInterface
+
+  end
+end