fog-rackspace 0.1.0

data/lib/fog/rackspace/models/auto_scale/policies.rb

@@ -0,0 +1,65 @@
+require 'fog/core/collection'
+require 'fog/rackspace/models/auto_scale/policy'
+
+module Fog
+  module Rackspace
+    class AutoScale
+      class Policies < Fog::Collection
+        model Fog::Rackspace::AutoScale::Policy
+
+        attr_accessor :group
+
+        # Returns list of autoscale policies
+        #
+        # @return [Fog::Rackspace::AutoScale::Policies] Retrieves policies
+        #
+        # @raise [Fog::Rackspace::AutoScale:::NotFound] - HTTP 404
+        # @raise [Fog::Rackspace::AutoScale:::BadRequest] - HTTP 400
+        # @raise [Fog::Rackspace::AutoScale:::InternalServerError] - HTTP 500
+        # @raise [Fog::Rackspace::AutoScale:::ServiceError]
+        #
+        # @see http://docs.rackspace.com/cas/api/v1.0/autoscale-devguide/content/GET_getPolicies_v1.0__tenantId__groups__groupId__policies_Policies.html
+        def all
+          data = service.list_policies(group.id).body['policies']
+          load(data)
+        end
+
+        # Returns an individual autoscale policy
+        #
+        # @return [Fog::Rackspace::AutoScale::Group] Retrieves a policy
+        # @return nil if not found
+        #
+        # @raise [Fog::Rackspace::AutoScale:::NotFound] - HTTP 404
+        # @raise [Fog::Rackspace::AutoScale:::BadRequest] - HTTP 400
+        # @raise [Fog::Rackspace::AutoScale:::InternalServerError] - HTTP 500
+        # @raise [Fog::Rackspace::AutoScale:::ServiceError]
+        #
+        # @see http://docs.rackspace.com/cas/api/v1.0/autoscale-devguide/content/GET_getPolicy_v1.0__tenantId__groups__groupId__policies__policyId__Policies.html
+        def get(policy_id)
+          data = service.get_policy(group.id, policy_id).body['policy']
+          new(data)
+        rescue Fog::Rackspace::AutoScale::NotFound
+          nil
+        end
+
+        # Create an autoscale policy
+        #
+        # @return [Fog::Rackspace::AutoScale::Policy] Returns the new policy
+        #
+        # @raise [Fog::Rackspace::AutoScale:::NotFound] - HTTP 404
+        # @raise [Fog::Rackspace::AutoScale:::BadRequest] - HTTP 400
+        # @raise [Fog::Rackspace::AutoScale:::InternalServerError] - HTTP 500
+        # @raise [Fog::Rackspace::AutoScale:::ServiceError]
+        #
+        # @see http://docs.rackspace.com/cas/api/v1.0/autoscale-devguide/content/POST_createPolicies_v1.0__tenantId__groups__groupId__policies_Policies.html
+        def create(attributes = {})
+          super(attributes)
+        end
+
+        def new(attributes = {})
+          super({:group => group}.merge(attributes))
+        end
+      end
+    end
+  end
+end

data/lib/fog/rackspace/models/auto_scale/policy.rb

@@ -0,0 +1,220 @@
+require 'fog/core/model'
+require 'fog/rackspace/models/auto_scale/webhooks'
+
+module Fog
+  module Rackspace
+    class AutoScale
+      class Policy < Fog::Model
+        # @!attribute [r] id
+        # @return [String] The policy id
+        identity :id
+
+        # @!attribute [r] group
+        # @return [Group] The autoscale group
+        attribute :group
+
+        # @!attribute [r] links
+        # @return [Array] Policy links
+        attribute :links
+
+        # @!attribute [r] name
+        # @return [String] The policy's name
+        attribute :name
+
+        # @!attribute [r] change
+        # @return [Fixnum] The fixed change to the autoscale group's number of units
+        attribute :change
+
+        # @!attribute [r] changePercent
+        # @return [Fixnum] The percentage change to the autoscale group's number of units
+        attribute :change_percent, :aliases => 'changePercent'
+
+        # @!attribute [r] cooldown
+        # @return [Fixnum] The policy's cooldown
+        attribute :cooldown
+
+        # @!attribute [r] type
+        # @note Can only be "webhook", "schedule" or "cloud_monitoring"
+        # @return [String] The policy's type
+        attribute :type
+
+        # @!attribute [r] args
+        # @example See below:
+        # - "cron": "23 * * * *"
+        # - "at": "2013-06-05T03:12Z"
+        # - "check": {
+        #         "label": "Website check 1",
+        #         "type": "remote.http",
+        #         "details": {
+        #             "url": "http://www.example.com",
+        #             "method": "GET"
+        #         },
+        #         "monitoring_zones_poll": [
+        #             "mzA"
+        #         ],
+        #         "timeout": 30,
+        #         "period": 100,
+        #         "target_alias": "default"
+        #     },
+        #     "alarm_criteria": {
+        #          "criteria": "if (metric[\"duration\"] >= 2) { return new AlarmStatus(OK); } return new AlarmStatus(CRITICAL);"
+        #     }
+        #
+        # @return [String] Arguments used for the policy
+        attribute :args
+
+        # @!attribute [r] desiredCapacity
+        # @return [Fixnum] The desired capacity of the group
+        attribute :desired_capacity, :aliases => 'desiredCapacity'
+
+        # Basic sanity check to make sure attributes are valid
+        #
+        # @raise ArgumentError If no type is set
+        # @raise ArgumentError If args attribute is missing required keys (if type == 'schedule')
+
+        # @return [Boolean] Returns true if the check passes
+        def check_attributes
+          raise ArgumentError, "This #{self.name} resource requires the #{type} argument" if type.nil?
+
+          if type == 'schedule'
+            raise ArgumentError, "This #{self.name} resource requires the args[cron] OR args[at] argument" if args['cron'].nil? && args['at'].nil?
+          end
+
+          true
+        end
+
+        def group=(group)
+          attributes[:group] = group.is_a?(Group) ? group : service.groups.new(:id => group)
+        end
+
+        # Creates policy
+        # * requires attributes: :name, :type, :cooldown
+        #
+        # @return [Boolean] returns true if policy is being created
+        #
+        # @raise [Fog::Rackspace::AutoScale:::NotFound] - HTTP 404
+        # @raise [Fog::Rackspace::AutoScale:::BadRequest] - HTTP 400
+        # @raise [Fog::Rackspace::AutoScale:::InternalServerError] - HTTP 500
+        # @raise [Fog::Rackspace::AutoScale:::ServiceError]
+        #
+        # @see Policies#create
+        # @see http://docs.rackspace.com/cas/api/v1.0/autoscale-devguide/content/POST_createPolicies_v1.0__tenantId__groups__groupId__policies_Policies.html
+        def create
+          requires :name, :type, :cooldown
+
+          check_attributes
+
+          options = {}
+          options['name'] = name unless name.nil?
+          options['change'] = change unless change.nil?
+          options['changePercent'] = change_percent unless change_percent.nil?
+          options['cooldown'] = cooldown unless cooldown.nil?
+          options['type'] = type unless type.nil?
+          options['desiredCapacity'] = desired_capacity unless desired_capacity.nil?
+
+          if type == 'schedule'
+            options['args'] = args
+          end
+
+          data = service.create_policy(group.id, options)
+          merge_attributes(data.body['policies'][0])
+          true
+        end
+
+        # Updates the policy
+        #
+        # @return [Boolean] returns true if policy has started updating
+        #
+        # @raise [Fog::Rackspace::AutoScale:::NotFound] - HTTP 404
+        # @raise [Fog::Rackspace::AutoScale:::BadRequest] - HTTP 400
+        # @raise [Fog::Rackspace::AutoScale:::InternalServerError] - HTTP 500
+        # @raise [Fog::Rackspace::AutoScale:::ServiceError]
+        #
+        # @see http://docs.rackspace.com/cas/api/v1.0/autoscale-devguide/content/PUT_putPolicy_v1.0__tenantId__groups__groupId__policies__policyId__Policies.html
+        def update
+          requires :identity
+
+          check_attributes
+
+          options = {}
+          options['name'] = name unless name.nil?
+          options['change'] = change unless change.nil?
+          options['changePercent'] = change_percent unless change_percent.nil?
+          options['cooldown'] = cooldown unless cooldown.nil?
+          options['type'] = type unless type.nil?
+          options['desiredCapacity'] = desired_capacity unless desired_capacity.nil?
+
+          if type == 'schedule'
+            options['args'] = args
+          end
+
+          data = service.update_policy(group.id, identity, options)
+          merge_attributes(data.body)
+          true
+        end
+
+        # Saves the policy
+        # Creates policy if it is new, otherwise it will update it
+        # @return [Boolean] true if policy has saved
+        def save
+          if persisted?
+            update
+          else
+            create
+          end
+          true
+        end
+
+        # Destroy the policy
+        #
+        # @return [Boolean] returns true if policy has started deleting
+        #
+        # @raise [Fog::Rackspace::AutoScale:::NotFound] - HTTP 404
+        # @raise [Fog::Rackspace::AutoScale:::BadRequest] - HTTP 400
+        # @raise [Fog::Rackspace::AutoScale:::InternalServerError] - HTTP 500
+        # @raise [Fog::Rackspace::AutoScale:::ServiceError]
+        #
+        # @see http://docs.rackspace.com/cas/api/v1.0/autoscale-devguide/content/DELETE_deletePolicy_v1.0__tenantId__groups__groupId__policies__policyId__Policies.html
+        def destroy
+          requires :identity
+          service.delete_policy(group.id, identity)
+          true
+        end
+
+        # Executes the scaling policy
+        #
+        # @return [Boolean] returns true if policy has been executed
+        #
+        # @raise [Fog::Rackspace::AutoScale:::NotFound] - HTTP 404
+        # @raise [Fog::Rackspace::AutoScale:::BadRequest] - HTTP 400
+        # @raise [Fog::Rackspace::AutoScale:::InternalServerError] - HTTP 500
+        # @raise [Fog::Rackspace::AutoScale:::ServiceError]
+        #
+        # @see http://docs.rackspace.com/cas/api/v1.0/autoscale-devguide/content/POST_executePolicy_v1.0__tenantId__groups__groupId__policies__policyId__execute_Policies.html
+        def execute
+          requires :identity
+          service.execute_policy(group.id, identity)
+          true
+        end
+
+        # Gets the associated webhooks for this policy
+        #
+        # @return [Fog::Rackspace::AutoScale::Webhooks] returns Webhooks
+        #
+        # @raise [Fog::Rackspace::AutoScale:::NotFound] - HTTP 404
+        # @raise [Fog::Rackspace::AutoScale:::BadRequest] - HTTP 400
+        # @raise [Fog::Rackspace::AutoScale:::InternalServerError] - HTTP 500
+        # @raise [Fog::Rackspace::AutoScale:::ServiceError]
+        def webhooks
+          requires :identity
+
+          @webhooks ||= Fog::Rackspace::AutoScale::Webhooks.new({
+            :service   => service,
+            :policy => self,
+            :group  => group
+          })
+        end
+      end
+    end
+  end
+end

data/lib/fog/rackspace/models/auto_scale/webhook.rb

@@ -0,0 +1,116 @@
+require 'fog/core/model'
+
+module Fog
+  module Rackspace
+    class AutoScale
+      class Webhook < Fog::Model
+        # @!attribute [r] id
+        # @return [String] The webhook id
+        identity :id
+
+        # @!attribute [r] group
+        # @return [String] The associated group
+        attribute :group
+
+        # @!attribute [r] policy
+        # @return [String] The associated policy
+        attribute :policy
+
+        # @!attribute [r] name
+        # @return [String] The webhook name
+        attribute :name
+
+        # @!attribute [r] metadata
+        # @return [Hash] The metadata
+        attribute :metadata
+
+        # @!attribute [r] links
+        # @return [Array] The webhook links
+        attribute :links
+
+        # Create webhook
+        # * requires attribute: :name
+        #
+        # @return [Boolean] returns true if webhook is being created
+        #
+        # @raise [Fog::Rackspace::AutoScale:::NotFound] - HTTP 404
+        # @raise [Fog::Rackspace::AutoScale:::BadRequest] - HTTP 400
+        # @raise [Fog::Rackspace::AutoScale:::InternalServerError] - HTTP 500
+        # @raise [Fog::Rackspace::AutoScale:::ServiceError]
+        #
+        # @see Webhooks#create
+        # @see
+        def create
+          requires :name
+
+          options = {}
+          options['name'] = name if name
+          options['metadata'] = metadata if metadata
+
+          data = service.create_webhook(group.id, policy.id, options)
+          merge_attributes(data.body['webhooks'][0])
+          true
+        end
+
+        # Updates the webhook
+        #
+        # @return [Boolean] returns true if webhook has started updating
+        #
+        # @raise [Fog::Rackspace::AutoScale:::NotFound] - HTTP 404
+        # @raise [Fog::Rackspace::AutoScale:::BadRequest] - HTTP 400
+        # @raise [Fog::Rackspace::AutoScale:::InternalServerError] - HTTP 500
+        # @raise [Fog::Rackspace::AutoScale:::ServiceError]
+        #
+        # @see http://docs.rackspace.com/cas/api/v1.0/autoscale-devguide/content/PUT_putWebhook_v1.0__tenantId__groups__groupId__policies__policyId__webhooks__webhookId__Webhooks.html
+        def update
+          requires :identity
+
+          options = {
+            'name' => name,
+            'metadata' => metadata
+          }
+
+          data = service.update_webhook(group.id, policy.id, identity, options)
+          merge_attributes(data.body)
+          true
+        end
+
+        # Saves the webhook
+        # Creates hook if it is new, otherwise it will update it
+        # @return [Boolean] true if policy has saved
+        def save
+          if persisted?
+            update
+          else
+            create
+          end
+          true
+        end
+
+        # Destroy the webhook
+        #
+        # @return [Boolean] returns true if webhook has started deleting
+        #
+        # @raise [Fog::Rackspace::AutoScale:::NotFound] - HTTP 404
+        # @raise [Fog::Rackspace::AutoScale:::BadRequest] - HTTP 400
+        # @raise [Fog::Rackspace::AutoScale:::InternalServerError] - HTTP 500
+        # @raise [Fog::Rackspace::AutoScale:::ServiceError]
+        #
+        # @see http://docs.rackspace.com/cas/api/v1.0/autoscale-devguide/content/DELETE_deleteWebhook_v1.0__tenantId__groups__groupId__policies__policyId__webhooks__webhookId__Webhooks.html
+        def destroy
+          requires :identity
+          service.delete_webhook(group.id, policy.id, identity)
+          true
+        end
+
+        # Retrieves the URL for anonymously executing the policy webhook
+        # @return [String] the URL
+        def execution_url
+          requires :links
+          link = links.find { |l| l['rel'] == 'capability' }
+          link['href'] rescue nil
+        end
+      end
+    end
+  end
+end

data/lib/fog/rackspace/models/auto_scale/webhooks.rb

@@ -0,0 +1,62 @@
+require 'fog/core/collection'
+require 'fog/rackspace/models/auto_scale/webhook'
+
+module Fog
+  module Rackspace
+    class AutoScale
+      class Webhooks < Fog::Collection
+        model Fog::Rackspace::AutoScale::Webhook
+
+        attr_accessor :group
+        attr_accessor :policy
+
+        # Returns list of autoscale webhooks
+        #
+        # @return [Fog::Rackspace::AutoScale::Policies] Retrieves webhooks
+        #
+        # @raise [Fog::Rackspace::AutoScale:::NotFound] - HTTP 404
+        # @raise [Fog::Rackspace::AutoScale:::BadRequest] - HTTP 400
+        # @raise [Fog::Rackspace::AutoScale:::InternalServerError] - HTTP 500
+        # @raise [Fog::Rackspace::AutoScale:::ServiceError]
+        def all
+          data = service.list_webhooks(group.id, policy.id).body['webhooks']
+          load(data)
+        end
+
+        # Returns an individual webhook
+        #
+        # @return [Fog::Rackspace::AutoScale::Webhook] Retrieves a webhook
+        # @return nil if not found
+        #
+        # @raise [Fog::Rackspace::AutoScale:::NotFound] - HTTP 404
+        # @raise [Fog::Rackspace::AutoScale:::BadRequest] - HTTP 400
+        # @raise [Fog::Rackspace::AutoScale:::InternalServerError] - HTTP 500
+        # @raise [Fog::Rackspace::AutoScale:::ServiceError]
+        #
+        # @see http://docs.rackspace.com/cas/api/v1.0/autoscale-devguide/content/GET_getWebhook_v1.0__tenantId__groups__groupId__policies__policyId__webhooks__webhookId__Webhooks.html
+        def get(webhook_id)
+          data = service.get_webhook(group.id, policy.id, webhook_id).body['webhook']
+          new(data)
+        rescue Fog::Rackspace::AutoScale::NotFound
+          nil
+        end
+
+        # Create a webhook
+        #
+        # @return [Fog::Rackspace::AutoScale::Webhook] Returns the new webhook
+        #
+        # @raise [Fog::Rackspace::AutoScale:::NotFound] - HTTP 404
+        # @raise [Fog::Rackspace::AutoScale:::BadRequest] - HTTP 400
+        # @raise [Fog::Rackspace::AutoScale:::InternalServerError] - HTTP 500
+        # @raise [Fog::Rackspace::AutoScale:::ServiceError]
+        def create(attributes = {})
+          super(attributes)
+        end
+
+        def new(attributes = {})
+          super({:group => group, :policy => policy}.merge(attributes))
+        end
+      end
+    end
+  end
+end