fog-maestrodev 1.15.0.20130829165835 → 1.15.0.20130927082724

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

@@ -0,0 +1,60 @@
+require 'fog/core/model'
+
+module Fog
+  module Rackspace
+    class AutoScale
+      class GroupConfig < Fog::Model
+
+        # @!attribute [r] group
+        # @return [Fog::Rackspace::AutoScale::Group] The parent group
+        attribute :group
+
+        # @!attribute [r] name
+        # @return [String] The name of the group 
+      	attribute :name
+
+        # @!attribute [r] cooldown
+        # @return [String] The group's cooldown
+      	attribute :cooldown
+
+        # @!attribute [r] min_entities
+        # @return [Fixnum] The minimum amount of units which should exist in the group
+      	attribute :min_entities, :aliases => 'minEntities'
+
+        # @!attribute [r] max_entities
+        # @return [Fixnum] The maximum amount of units which should exist in the group
+      	attribute :max_entities, :aliases => 'maxEntities'
+
+        # @!attribute [r] metadata
+        # @return [Hash] The group's metadata
+      	attribute :metadata
+
+        # Update this group's configuration
+        #
+        # @return [Boolean] returns true if group config has been updated
+        #
+        # @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_putGroupConfig_v1.0__tenantId__groups__groupId__config_Configurations.html
+        def update
+          
+          options = {}
+
+          options['name'] = name unless name.nil?
+          options['cooldown'] = cooldown unless cooldown.nil?
+          options['minEntities'] = min_entities
+          options['maxEntities'] = max_entities
+          options['metadata'] = metadata unless metadata.nil?
+
+          data = service.update_group_config(group.id, options)
+          merge_attributes(data.body)
+          true
+        end
+
+      end
+  	end
+  end
+end

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

@@ -0,0 +1,46 @@
+require 'fog/core/collection'
+require 'fog/rackspace/models/auto_scale/group'
+
+module Fog
+  module Rackspace
+    class AutoScale
+      class Groups < Fog::Collection
+
+        model Fog::Rackspace::AutoScale::Group
+
+        # Returns list of autoscale grouos
+        #
+        # @return [Fog::Rackspace::AutoScale::Groups] Retrieves a list images.
+        #
+        # @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_getGroups_v1.0__tenantId__groups_Groups.html
+        def all
+          data = service.list_groups.body['groups']
+          load(data)
+        end
+
+        # Returns an individual autoscale group
+        #
+        # @return [Fog::Rackspace::AutoScale::Group] Retrieves a list images.
+        # @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_getGroupManifest_v1.0__tenantId__groups__groupId__Groups.html
+        def get(group_id)          
+          data = service.get_group(group_id).body['group']
+          new(data)
+        rescue Fog::Rackspace::AutoScale::NotFound
+          nil
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,44 @@
+require 'fog/core/model'
+
+module Fog
+  module Rackspace
+    class AutoScale
+      class LaunchConfig < Fog::Model
+
+        # @!attribute [r] group
+        # @return [Fog::Rackspace::AutoScale::Group] The parent group
+        attribute :group
+      	
+        # @!attribute [r] type
+        # @return [Fog::Rackspace::AutoScale::Group] The type of operation (usually "launch_server")
+        attribute :type
+      	
+        # @!attribute [r] args
+        # @return [Fog::Rackspace::AutoScale::Group] The arguments for the operation
+        attribute :args
+
+        # Update this group's launch configuration
+        #
+        # @return [Boolean] returns true if launch config has been updated
+        #
+        # @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_putLaunchConfig_v1.0__tenantId__groups__groupId__launch_Configurations.html
+        def update
+          
+          options = {}
+          options['type'] = type unless type.nil?
+          options['args'] = args unless args.nil?
+
+          data = service.update_launch_config(group.id, options)
+          merge_attributes(data.body['launchConfiguration'])
+          true
+        end
+
+      end
+  	end
+  end
+end

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']
+          data['group_id'] = group.id
+          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 = {})
+          attributes['group_id'] = group.id
+          super(attributes)
+        end
+
+      end
+    end
+  end
+end

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

@@ -0,0 +1,206 @@
+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_id
+        # @return [String] The autoscale group's id
+      	attribute :group_id
+
+      	# @!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
+
+      	# 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 save
+          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
+
+      	# 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
+          data = service.list_webhooks(group_id, self.id)
+
+          Fog::Rackspace::AutoScale::Webhooks.new({
+            :service   => service,
+            :policy_id => self.id,
+            :group_id  => group_id
+          }).merge_attributes(data.body)
+        end
+
+      end
+  	end
+  end
+end

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

@@ -0,0 +1,105 @@
+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] id
+        # @return [String] The group id (i.e. grand-parent)
+        attribute :group_id
+        
+        # @!attribute [r] id
+        # @return [String] The policy id (i.e. parent)
+        attribute :policy_id
+
+      	# @!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
+
+        # Creates 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 save
+          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)
+      	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