fog 0.9.0 → 0.10.0

data/lib/fog/aws/requests/auto_scaling/describe_scheduled_actions.rb

@@ -0,0 +1,83 @@
+module Fog
+  module AWS
+    class AutoScaling
+
+      class Real
+
+        require 'fog/aws/parsers/auto_scaling/describe_scheduled_actions'
+
+        # List all the actions scheduled for your Auto Scaling group that
+        # haven't been executed. To see a list of action already executed, see
+        # the activity record returned in describe_scaling_activities.
+        #
+        # ==== Parameters
+        # * options<~Hash>:
+        #   * 'AutoScalingGroupName'<~String> - The name of the Auto Scaling
+        #     group.
+        #   * 'EndTime'<~Time> - The latest scheduled start time to return. If
+        #     scheduled action names are provided, this field will be ignored.
+        #   * 'MaxRecords'<~Integer> - The maximum number of scheduled actions
+        #     to return.
+        #   * 'NextToken'<~String> - The token returned by a previous call to
+        #     indicate that there is more data available.
+        #   * 'ScheduledActionNames'<~Array> - A list of scheduled actions to
+        #     be described. If this list is omitted, all scheduled actions are
+        #     described. The list of requested scheduled actions cannot contain
+        #     more than 50 items. If an auto scaling group name is provided,
+        #     the results are limited to that group. If unknown scheduled
+        #     actions are requested, they are ignored with no error.
+        #   * 'StartTime'<~Time> - The earliest scheduled start time to return.
+        #     If scheduled action names are provided, this field will be
+        #     ignored.
+        #
+        # ==== Returns
+        # * response<~Excon::Response>:
+        #   * body<~Hash>:
+        #     * 'ResponseMetadata'<~Hash>:
+        #       * 'RequestId'<~String> - Id of request
+        #     * 'DescribeScheduledActionsResponse'<~Hash>:
+        #       * 'ScheduledUpdateGroupActions'<~Array>:
+        #         * scheduledupdatesroupAction<~Hash>:
+        #           * 'AutoScalingGroupName'<~String> - The name of the Auto
+        #             Scaling group to be updated.
+        #         * 'DesiredCapacity'<~Integer> -The number of instances you
+        #           prefer to maintain in your Auto Scaling group.
+        #         * 'MaxSize'<~Integer> - The maximum size of the Auto Scaling
+        #           group.
+        #         * 'MinSize'<~Integer> - The minimum size of the Auto Scaling
+        #           group.
+        #         * 'ScheduledActionARN'<~String> - The Amazon Resource Name
+        #           (ARN) of this scheduled action.
+        #         * 'Time'<~Time> - The time that the action is scheduled to
+        #           occur. This value can be up to one month in the future.
+        #       * 'NextToken'<~String> - Acts as a paging mechanism for large
+        #         result sets. Set to a non-empty string if there are
+        #         additional results waiting to be returned. Pass this in to
+        #         subsequent calls to return additional results.
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/AutoScaling/latest/APIReference/API_DescribeScheduledActions.html
+        #
+        def describe_scheduled_actions(options = {})
+          if scheduled_action_names = options.delete('ScheduledActionNames')
+            options.merge!(AWS.indexed_param('ScheduledActionNames.member.%d', [*scheduled_action_names]))
+          end
+          request({
+            'Action' => 'DescribeScheduledActions',
+            :parser  => Fog::Parsers::AWS::AutoScaling::DescribeScheduledActions.new
+          }.merge!(options))
+        end
+
+      end
+
+      class Mock
+
+        def describe_scheduled_actions(options = {})
+          Fog::Mock.not_implemented
+        end
+
+      end
+
+    end
+  end
+end

data/lib/fog/aws/requests/auto_scaling/disable_metrics_collection.rb

@@ -0,0 +1,56 @@
+module Fog
+  module AWS
+    class AutoScaling
+
+      class Real
+
+        require 'fog/aws/parsers/auto_scaling/basic'
+
+        # Disables monitoring of group metrics for the Auto Scaling group
+        # specified in AutoScalingGroupName. You can specify the list of
+        # affected metrics with the Metrics parameter.
+        #
+        # ==== Parameters
+        # * 'AutoScalingGroupName'<~String> - The name or ARN of the Auto
+        #   Scaling group.
+        # * options<~Hash>:
+        #   * Metrics<~Array> - The list of metrics to disable. If no metrics
+        #     are specified, all metrics are disabled.
+        #
+        # ==== Returns
+        # * response<~Excon::Response>:
+        #   * body<~Hash>:
+        #     * 'ResponseMetadata'<~Hash>:
+        #       * 'RequestId'<~String> - Id of request
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/AutoScaling/latest/APIReference/API_DisableMetricsCollection.html
+        #
+        def disable_metrics_collection(auto_scaling_group_name, options = {})
+          if metrics = options.delete('Metrics')
+            options.merge!(AWS.indexed_param('Metrics.member.%d', [*metrics]))
+          end
+          request({
+            'Action'               => 'DisableMetricsCollection',
+            'AutoScalingGroupName' => auto_scaling_group_name,
+            :parser                => Fog::Parsers::AWS::AutoScaling::Basic.new
+          }.merge!(options))
+        end
+
+      end
+
+      class Mock
+
+        def disable_metrics_collection(auto_scaling_group_name, options = {})
+          unless data[:auto_scaling_groups].has_key?(auto_scaling_group_name)
+            Fog::AWS::AutoScaling::ValidationError.new("Group #{auto_scaling_group_name} not found")
+          end
+
+          Fog::Mock.not_implemented
+        end
+
+      end
+
+    end
+  end
+end

data/lib/fog/aws/requests/auto_scaling/enable_metrics_collection.rb

@@ -0,0 +1,66 @@
+module Fog
+  module AWS
+    class AutoScaling
+
+      class Real
+
+        require 'fog/aws/parsers/auto_scaling/basic'
+
+        # Enables monitoring of group metrics for the Auto Scaling group
+        # specified in auto_scaling_group_name. You can specify the list of
+        # enabled metrics with the metrics parameter.
+        #
+        # Auto scaling metrics collection can be turned on only if the
+        # instance_monitoring.enabled flag, in the Auto Scaling group's launch
+        # configuration, is set to true.
+        #
+        # ==== Parameters
+        # * 'AutoScalingGroupName'<~String>: The name or ARN of the Auto
+        #   Scaling group
+        # * options<~Hash>:
+        #   * Granularity<~String>: The granularity to associate with the
+        #     metrics to collect.
+        #   * Metrics<~Array>: The list of metrics to collect. If no metrics
+        #     are specified, all metrics are enabled.
+        #
+        # ==== Returns
+        # * response<~Excon::Response>:
+        #   * body<~Hash>:
+        #     * 'ResponseMetadata'<~Hash>:
+        #       * 'RequestId'<~String> - Id of request
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/AutoScaling/latest/APIReference/API_EnableMetricsCollection.html
+        #
+        def enable_metrics_collection(auto_scaling_group_name, granularity, options = {})
+          if metrics = options.delete('Metrics')
+            options.merge!(AWS.indexed_param('Metrics.member.%d', [*metrics]))
+          end
+          request({
+            'Action'               => 'EnableMetricsCollection',
+            'AutoScalingGroupName' => auto_scaling_group_name,
+            'Granularity'          => granularity,
+            :parser                => Fog::Parsers::AWS::AutoScaling::Basic.new
+          }.merge!(options))
+        end
+
+      end
+
+      class Mock
+
+        def enable_metrics_collection(auto_scaling_group_name, granularity, options = {})
+          unless data[:auto_scaling_groups].has_key?(auto_scaling_group_name)
+            Fog::AWS::AutoScaling::ValidationError.new("Group #{auto_scaling_group_name} not found")
+          end
+          unless data[:metric_collection_types][:granularities].include?(granularity)
+            Fog::AWS::AutoScaling::ValidationError.new('Valid metrics granularity type is: [1Minute].')
+          end
+
+          Fog::Mock.not_implemented
+        end
+
+      end
+
+    end
+  end
+end

data/lib/fog/aws/requests/auto_scaling/execute_policy.rb

@@ -0,0 +1,50 @@
+module Fog
+  module AWS
+    class AutoScaling
+
+      class Real
+
+        require 'fog/aws/parsers/auto_scaling/basic'
+
+        # Runs the policy you create for your Auto Scaling group in
+        # put_scaling_policy.
+        #
+        # ==== Parameters
+        # * 'PolicyName'<~String> - The name or PolicyARN of the policy you
+        #   want to run.
+        # * options<~Hash>:
+        #   * 'AutoScalingGroupName'<~String> - The name or ARN of the Auto
+        #     Scaling group.
+        #   * 'HonorCooldown'<~Boolean> - Set to true if you want Auto Scaling
+        #     to reject this request if the Auto Scaling group is in cooldown.
+        #
+        # ==== Returns
+        # * response<~Excon::Response>:
+        #   * body<~Hash>:
+        #     * 'ResponseMetadata'<~Hash>:
+        #       * 'RequestId'<~String> - Id of request
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/AutoScaling/latest/APIReference/API_ExecutePolicy.html
+        #
+        def execute_policy(policy_name, options = {})
+          request({
+            'Action'     => 'ExecutePolicy',
+            'PolicyName' => policy_name,
+            :parser      => Fog::Parsers::AWS::AutoScaling::Basic.new
+          }.merge!(options))
+        end
+
+      end
+
+      class Mock
+
+        def execute_policy(policy_name, options = {})
+          Fog::Mock.not_implemented
+        end
+
+      end
+
+    end
+  end
+end

data/lib/fog/aws/requests/auto_scaling/put_scaling_policy.rb

@@ -0,0 +1,66 @@
+module Fog
+  module AWS
+    class AutoScaling
+
+      class Real
+
+        require 'fog/aws/parsers/auto_scaling/put_scaling_policy'
+
+        # Creates or updates a policy for an Auto Scaling group. To update an
+        # existing policy, use the existing policy name and set the
+        # parameter(s) you want to change. Any existing parameter not changed
+        # in an update to an existing policy is not changed in this update
+        # request.
+        #
+        # ==== Parameters
+        # * adjustment_type<~String> - Specifies whether the scaling_adjustment
+        #   is an absolute number or a percentage of the current capacity.
+        # * auto_scaling_group_name<~String> - The name or ARN of the Auto
+        #   Scaling group.
+        # * policy_name<~String> - The name of the policy you want to create or
+        #   update.
+        # * scaling_adjustment<~Integer> - The number of instances by which to
+        #   scale. AdjustmentType determines the interpretation of this number
+        #   (e.g., as an absolute number or as a percentage of the existing
+        #   Auto Scaling group size). A positive increment adds to the current
+        #   capacity and a negative value removes from the current capacity.
+        # * options<~Hash>:
+        #   * 'CoolDown'<~Integer> - The amount of time, in seconds, after a
+        #     scaling activity completes before any further trigger-related
+        #     scaling activities can start
+        #
+        # ==== Returns
+        # * response<~Excon::Response>:
+        #   * body<~Hash>:
+        #     * 'ResponseMetadata'<~Hash>:
+        #       * 'RequestId'<~String> - Id of request
+        #     * 'PutScalingPolicyResponse'<~Hash>:
+        #       * 'PolicyARN'<~String> - A policy's Amazon Resource Name (ARN).
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/AutoScaling/latest/APIReference/API_PutScalingPolicy.html
+        #
+        def put_scaling_policy(adjustment_type, auto_scaling_group_name, policy_name, scaling_adjustment, options = {})
+          request({
+            'Action'               => 'PutScalingPolicy',
+            'AdjustmentType'       => adjustment_type,
+            'AutoScalingGroupName' => auto_scaling_group_name,
+            'PolicyName'           => policy_name,
+            'ScalingAdjustment'     => scaling_adjustment,
+            :parser                => Fog::Parsers::AWS::AutoScaling::PutScalingPolicy.new
+          }.merge!(options))
+        end
+
+      end
+
+      class Mock
+
+        def put_scaling_policy(adjustment_type, auto_scaling_group_name, policy_name, scaling_adjustment, options = {})
+          Fog::Mock.not_implemented
+        end
+
+      end
+
+    end
+  end
+end

data/lib/fog/aws/requests/auto_scaling/put_scheduled_update_group_action.rb

@@ -0,0 +1,57 @@
+module Fog
+  module AWS
+    class AutoScaling
+
+      class Real
+
+        require 'fog/aws/parsers/auto_scaling/basic'
+
+        # Creates a scheduled scaling action for a Auto Scaling group. If you
+        # leave a parameter unspecified, the corresponding value remains
+        # unchanged in the affected Auto Scaling group.
+        #
+        # ==== Parameters
+        # * auto_scaling_group_name<~String> - The name or ARN of the Auto
+        #   Scaling Group.
+        # * scheduled_action_name<~String> - Name of this scaling action.
+        # * time<~Datetime> - The time for this action to start
+        # * options<~Hash>:
+        #   * 'DesiredCapacity'<~Integer> - The number of EC2 instances that
+        #     should be running in this group.
+        #   * 'MaxSize'<~Integer> - The maximum size for the Auto Scaling
+        #     group.
+        #   * 'MinSize'<~Integer> - The minimum size for the Auto Scaling
+        #     group.
+        #
+        # ==== Returns
+        # * response<~Excon::Response>:
+        #   * body<~Hash>:
+        #     * 'ResponseMetadata'<~Hash>:
+        #       * 'RequestId'<~String> - Id of request
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/AutoScaling/latest/APIReference/API_PutScheduledUpdateGroupAction.html
+        #
+        def put_scheduled_update_group_action(auto_scaling_group_name, scheduled_action_name, time, options = {})
+          request({
+            'Action'               => 'PutScheduledUpdateGroupAction',
+            'AutoScalingGroupName' => auto_scaling_group_name,
+            'ScheduledActionName'  => scheduled_action_name,
+            'Time'                 => time.utc.strftime('%FT%T.%3NZ'),
+            :parser                => Fog::Parsers::AWS::AutoScaling::Basic.new
+          }.merge!(options))
+        end
+
+      end
+
+      class Mock
+
+        def put_scheduled_update_group_action(auto_scaling_group_name, scheduled_policy_name, time, options = {})
+          Fog::Mock.not_implemented
+        end
+
+      end
+
+    end
+  end
+end

data/lib/fog/aws/requests/auto_scaling/resume_processes.rb

@@ -0,0 +1,50 @@
+module Fog
+  module AWS
+    class AutoScaling
+
+      class Real
+
+        require 'fog/aws/parsers/auto_scaling/basic'
+
+        # Resumes Auto Scaling processes for an Auto Scaling group.
+        #
+        # ==== Parameters
+        # * auto_scaling_group_name'<~String> - The name or Amazon Resource
+        #   Name (ARN) of the Auto Scaling group.
+        # * options<~Hash>:
+        #   * 'ScalingProcesses'<~Array> - The processes that you want to
+        #     resume. To resume all process types, omit this parameter.
+        #
+        # ==== Returns
+        # * response<~Excon::Response>:
+        #   * body<~Hash>:
+        #     * 'ResponseMetadata'<~Hash>:
+        #       * 'RequestId'<~String> - Id of request
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/AutoScaling/latest/APIReference/API_ResumeProcesses.html
+        #
+        def resume_processes(auto_scaling_group_name, options = {})
+          if scaling_processes = options.delete('ScalingProcesses')
+            options.merge!(AWS.indexed_param('ScalingProcesses.member.%d', [*scaling_processes]))
+          end
+          request({
+            'Action'               => 'ResumeProcesses',
+            'AutoScalingGroupName' => auto_scaling_group_name,
+            :parser                => Fog::Parsers::AWS::AutoScaling::Basic.new
+          }.merge!(options))
+        end
+
+      end
+
+      class Mock
+
+        def resume_processes(auto_scaling_group_name, options = {})
+          Fog::Mock.not_implemented
+        end
+
+      end
+
+    end
+  end
+end

data/lib/fog/aws/requests/auto_scaling/set_desired_capacity.rb

@@ -0,0 +1,87 @@
+module Fog
+  module AWS
+    class AutoScaling
+
+      class Real
+
+        require 'fog/aws/parsers/auto_scaling/basic'
+
+        # Adjusts the desired size of the AutoScalingGroup by initiating
+        # scaling activities. When reducing the size of the group, it is not
+        # possible to define which EC2 instances will be terminated. This
+        # applies to any auto-scaling decisions that might result in
+        # terminating instances.
+        #
+        # There are two common use cases for set_desired_capacity: one for
+        # users of the Auto Scaling triggering system, and another for
+        # developers who write their own triggering systems. Both use cases
+        # relate to the concept of cooldown.
+        #
+        # In the first case, if you use the Auto Scaling triggering system,
+        # set_desired_capacity changes the size of your Auto Scaling group
+        # without regard to the cooldown period. This could be useful, for
+        # example, if Auto Scaling did something unexpected for some reason. If
+        # your cooldown period is 10 minutes, Auto Scaling would normally
+        # reject requests to change the size of the group for that entire 10
+        # minute period. The set_desired_capacity command allows you to
+        # circumvent this restriction and change the size of the group before
+        # the end of the cooldown period.
+        #
+        # In the second case, if you write your own triggering system, you can
+        # use set_desired_capacity to control the size of your Auto Scaling
+        # group. If you want the same cooldown functionality that Auto Scaling
+        # offers, you can configure set_desired_capacity to honor cooldown by
+        # setting the HonorCooldown parameter to true.
+        #
+        # ==== Parameters
+        # * auto_scaling_group_name<~String> - The name of the Auto Scaling
+        #   group.
+        # * desired_capacity<~Integer> - The new capacity setting for the Auto
+        #   Scaling group.
+        # * options<~Hash>:
+        #   * 'HonorCooldown'<~Boolean> - By default, set_desired_capacity
+        #     overrides any cooldown period. Set to true if you want Auto
+        #     Scaling to reject this request if the Auto Scaling group is in
+        #     cooldown.
+        #
+        # ==== Returns
+        # * response<~Excon::Response>:
+        #   * body<~Hash>:
+        #     * 'ResponseMetadata'<~Hash>:
+        #       * 'RequestId'<~String> - Id of request
+        #
+        # ==== See Also
+        # http://docs.amazonwebservices.com/AutoScaling/latest/APIReference/API_SetDesiredCapacity.html
+        #
+        def set_desired_capacity(auto_scaling_group_name, desired_capacity, options = {})
+          request({
+            'Action'               => 'SetDesiredCapacity',
+            'AutoScalingGroupName' => auto_scaling_group_name,
+            'DesiredCapacity'      => desired_capacity,
+            :parser                => Fog::Parsers::AWS::AutoScaling::Basic.new
+          }.merge!(options))
+        end
+
+      end
+
+      class Mock
+
+        def set_desired_capacity(auto_scaling_group_name, desired_capacity, options = {})
+          unless data[:auto_scaling_groups].has_key?(auto_scaling_group_name)
+            Fog::AWS::AutoScaling::ValidationError.new('AutoScalingGroup name not found - null')
+          end
+          data[:auto_scaling_groups][auto_scaling_group_name]['DesiredCapacity'] = desired_capacity
+
+          response = Excon::Response.new
+          response.status = 200
+          response.body = {
+            'ResponseMetadata' => { 'RequestId' => Fog::AWS::Mock.request_id }
+          }
+          response
+        end
+
+      end
+
+    end
+  end
+end