Project

General

Profile

Download (8.86 KB) Statistics
| Branch: | Tag: | Revision:
module Api
module V2
class ParametersController < V2::BaseController
include Api::Version2
include Api::TaxonomyScope

before_filter :find_required_nested_object
before_filter :find_parameter, :only => [:show, :update, :destroy]

resource_description do
desc <<-DOC
These API calls are related to <b>nested parameters for a host, domain, host group, operating system</b>. If you are looking for
<a href="common_parameters.html">global parameters</a>, go to <a href="common_parameters.html">this link</a>.
DOC
end

api :GET, "/hosts/:host_id/parameters", N_("List all parameters for a host")
api :GET, "/hostgroups/:hostgroup_id/parameters", N_("List all parameters for a host group")
api :GET, "/domains/:domain_id/parameters", N_("List all parameters for a domain")
api :GET, "/operatingsystems/:operatingsystem_id/parameters", N_("List all parameters for an operating system")
api :GET, "/locations/:location_id/parameters", N_("List all parameters for a location")
api :GET, "/organizations/:organization_id/parameters", N_("List all parameters for an organization")
param :host_id, String, :desc => N_("ID of host")
param :hostgroup_id, String, :desc => N_("ID of host group")
param :domain_id, String, :desc => N_("ID of domain")
param :operatingsystem_id, String, :desc => N_("ID of operating system")
param :location_id, String, :desc => N_("ID of location")
param :organization_id, String, :desc => N_("ID of organization")
param_group :search_and_pagination, ::Api::V2::BaseController

def index
@parameters = nested_obj.send(parameters_method).search_for(*search_options).paginate(paginate_options)
@total = nested_obj.send(parameters_method).count
end

api :GET, "/hosts/:host_id/parameters/:id", N_("Show a nested parameter for a host")
api :GET, "/hostgroups/:hostgroup_id/parameters/:id", N_("Show a nested parameter for a host group")
api :GET, "/domains/:domain_id/parameters/:id", N_("Show a nested parameter for a domain")
api :GET, "/operatingsystems/:operatingsystem_id/parameters/:id", N_("Show a nested parameter for an operating system")
api :GET, "/locations/:location_id/parameters/:id", N_("Show a nested parameter for a location")
api :GET, "/organizations/:organization_id/parameters/:id", N_("Show a nested parameter for an organization")
param :host_id, String, :desc => N_("ID of host")
param :hostgroup_id, String, :desc => N_("ID of host group")
param :domain_id, String, :desc => N_("ID of domain")
param :operatingsystem_id, String, :desc => N_("ID of operating system")
param :location_id, String, :desc => N_("ID of location")
param :organization_id, String, :desc => N_("ID of organization")
param :id, String, :required => true, :desc => N_("ID of parameter")

def show
end

def_param_group :parameter do
param :parameter, Hash, :required => true, :action_aware => true do
param :name, String, :required => true
param :value, String, :required => true
end
end

api :POST, "/hosts/:host_id/parameters/", N_("Create a nested parameter for a host")
api :POST, "/hostgroups/:hostgroup_id/parameters/", N_("Create a nested parameter for a host group")
api :POST, "/domains/:domain_id/parameters/", N_("Create a nested parameter for a domain")
api :POST, "/operatingsystems/:operatingsystem_id/parameters/", N_("Create a nested parameter for an operating system")
api :POST, "/locations/:location_id/parameters/", N_("Create a nested parameter for a location")
api :POST, "/organizations/:organization_id/parameters/", N_("Create a nested parameter for an organization")
param :host_id, String, :desc => N_("ID of host")
param :hostgroup_id, String, :desc => N_("ID of host group")
param :domain_id, String, :desc => N_("ID of domain")
param :operatingsystem_id, String, :desc => N_("ID of operating system")
param :location_id, String, :desc => N_("ID of location")
param :organization_id, String, :desc => N_("ID of organization")
param_group :parameter, :as => :create

def create
@parameter = nested_obj.send(parameters_method).new(params[:parameter])
@parameter.reference_id = nested_obj.id if Rails.version == '3.2.8' # hack to override 3.2.8 hack ensure_reference_nil on parameter.rb
process_response @parameter.save
end

api :PUT, "/hosts/:host_id/parameters/:id", N_("Update a nested parameter for a host")
api :PUT, "/hostgroups/:hostgroup_id/parameters/:id", N_("Update a nested parameter for a host group")
api :PUT, "/domains/:domain_id/parameters/:id", N_("Update a nested parameter for a domain")
api :PUT, "/operatingsystems/:operatingsystem_id/parameters/:id", N_("Update a nested parameter for an operating system")
api :PUT, "/locations/:location_id/parameters/:id", N_("Update a nested parameter for a location")
api :PUT, "/organizations/:organization_id/parameters/:id", N_("Update a nested parameter for an organization")
param :host_id, String, :desc => N_("ID of host")
param :hostgroup_id, String, :desc => N_("ID of host group")
param :domain_id, String, :desc => N_("ID of domain")
param :operatingsystem_id, String, :desc => N_("ID of operating system")
param :location_id, String, :desc => N_("ID of location")
param :organization_id, String, :desc => N_("ID of organization")
param :id, String, :required => true, :desc => N_("ID of parameter")
param_group :parameter

def update
process_response @parameter.update_attributes(params[:parameter])
end

api :DELETE, "/hosts/:host_id/parameters/:id", N_("Delete a nested parameter for a host")
api :DELETE, "/hostgroups/:hostgroup_id/parameters/:id", N_("Delete a nested parameter for a host group")
api :DELETE, "/domains/:domain_id/parameters/:id", N_("Delete a nested parameter for a domain")
api :DELETE, "/operatingsystems/:operatingsystem_id/parameters/:id", N_("Delete a nested parameter for an operating system")
api :DELETE, "/locations/:location_id/parameters/:id", N_("Delete a nested parameter for a location")
api :DELETE, "/organizations/:organization_id/parameters/:id", N_("Delete a nested parameter for an organization")
param :host_id, String, :desc => N_("ID of host")
param :hostgroup_id, String, :desc => N_("ID of host group")
param :domain_id, String, :desc => N_("ID of domain")
param :operatingsystem_id, String, :desc => N_("ID of operating system")
param :location_id, String, :desc => N_("ID of location")
param :organization_id, String, :desc => N_("ID of organization")
param :id, String, :required => true, :desc => N_("ID of parameter")

def destroy
process_response @parameter.destroy
end

api :DELETE, "/hosts/:host_id/parameters", N_("Delete all nested parameters for a host")
api :DELETE, "/hostgroups/:hostgroup_id/parameters", N_("Delete all nested parameters for a host group")
api :DELETE, "/domains/:domain_id/parameters", N_("Delete all nested parameters for a domain")
api :DELETE, "/operatingsystems/:operatingsystem_id/parameters", N_("Delete all nested parameters for an operating system")
api :DELETE, "/locations/:location_id/parameters", N_("Delete all nested parameter for a location")
api :DELETE, "/organizations/:organization_id/parameters", N_("Delete all nested parameter for an organization")
param :host_id, String, :desc => N_("ID of host")
param :hostgroup_id, String, :desc => N_("ID of host group")
param :domain_id, String, :desc => N_("ID of domain")
param :operatingsystem_id, String, :desc => N_("ID of operating system")
param :location_id, String, :desc => N_("ID of location")
param :organization_id, String, :desc => N_("ID of organization")

def reset
@parameter = nested_obj.send(parameters_method)
process_response @parameter.destroy_all
end

private

def action_permission
case params[:action]
when 'reset'
:destroy
else
super
end
end

def parameters_method
# hostgroup.rb has a method def parameters, so I didn't create has_many :parameters like Host, Domain, Os
nested_obj.is_a?(Hostgroup) ? :group_parameters : :parameters
end

def allowed_nested_id
%w(host_id hostgroup_id domain_id operatingsystem_id location_id organization_id)
end

def find_parameter
# nested_obj is required, so no need to check here
@parameters = nested_obj.send(parameters_method)
@parameter = @parameters.find(params[:id])
return @parameter if @parameter
not_found
end
end
end
end
(34-34/52)