We will need a few things as follows;

1. A sample method that we can call
2. A ruby script to call our web services and execute our sample method.

Here is my sample method, nothing clever, just gonna write to the automate log the result.

</pre>
#
# Automate Method
#
$evm.log("info", "Automate Method Started")
#
# Method Code Goes here
$evm.log("info", " DEMO TEST INSTANCE")
#
#
#
$evm.log("info", "Automate Method Ended")
exit MIQ_OK
<pre>

Next is the ws_demo.rb, which you can find here. https://github.com/jonnyfiveiq/CloudFORMSNOW/blob/master/CFME/WebServices/RUBY/ws_demo.rb

There are two sections we need to edit as follows;

1. Webservice credentials
2. Namespace, Class, Instance and Parameters you want to execute.

Here is the credentials sections, I have highlighted the attributes you need to set;

#
Set username, password, CFME Server below
username, password, servername = 'ws', 'smartvm', '192.168.201.20'

Here is the method section, put your  Namespace, Class, Instance and any Parameters for your sample method.

# Build a hash with the path to the instance you want to run
body_hash = build_body_hash('Sample', 'Methods', 'demo', 'foo=bar|hello=world')

To see the result, run the ws_demo.rb from any machine running Ruby. You will need some GEMs installed

• ‘savon’
• ‘httpi’

If all goes well you should see your result the automate log of the appliance you targeted.

So what else can you do with this???? Endless!

Delete a VM, migrate a host, migrate a vm, stop a vm, start a vm, configure a load balancer, deploy some applications, tag some objects, etc…etc…

This is the complete code listing.

</pre>
###################################
# EVM Automate Method: call_CFME.rb
# Notes: This method is used to call CFME via SOAP to run an automate method
#
###################################
# Method for logging
def log(level, message)
 @method = 'call_CFME'
 puts "#{@method} - #{message}"
end

begin
 log(:info, "Method Started")

#################################
 # Method: buildBody
 # Notes: Build a hash of values for the automation request
 #################################
 def build_body_hash(cfme_namespace, cfme_class, cfme_instance, parms)
 body_hash = {}
 body_hash['version'] = '1.1'
 body_hash['uri_parts'] = "namespace=#{cfme_namespace}|class=#{cfme_class}|instance=#{cfme_instance}|message=create"
 body_hash['parameters'] = parms
 body_hash['requester'] = "auto_approve=true"
 return body_hash
 end

#################################
 # Method: createAutomationRequest
 # Notes: Create a SOAP call to EVM and submit an Automation Request
 #################################
 def createAutomationRequest(body_hash, username, password, servername)
 gem 'savon', '0.8.5'

require 'rubygems'
 require 'savon'
 require 'httpi'

HTTPI.log_level = :debug # changing the log level
 HTTPI.log = false
 HTTPI.adapter = :net_http # [:httpclient, :curb, :net_http]

# Setup Savon Configuration
 Savon.configure do |config|
 config.log = false
 config.log_level = :debug # changing the log level
 end
puts username
puts password
puts servername
puts body_hash

 # Set up Savon client
 client = Savon::Client.new do |wsdl, http|
 wsdl.document = "https://#{servername}/vmdbws/wsdl"
 http.auth.basic username, password
 http.auth.ssl.verify_mode = :none
 end

response = client.request :create_automation_request do
 soap.body = body_hash
 end
 return response.to_hash
 end

# Set username, password, CFME Server below
 username, password, servername = 'ws', 'smartvm', '192.168.201.20'

 # Build a hash with the path to the instance you want to run
 body_hash = build_body_hash('Sample', 'Methods', 'demo', 'foo=bar|hello=world')

 # Call CFME via SOAP
 request_hash = createAutomationRequest(body_hash, username, password, servername)

log(:info, "Request Returned: #{request_hash.inspect}")
 log(:info, "Automation Request Id: #{request_hash[:create_automation_request_response][:return].inspect}")
 # Exit method
 log(:info, "Method Ended")
 exit

# Set Ruby rescue behavior
rescue => err
 log(:error, "[#{err}]n#{err.backtrace.join("n")}")
 exit
end
<pre>

Credits

Kevin Morey – What a great example of SOAP in Ruby for CFME, One I shall be using a lot!