(Ruby) EC2 Stop Instances

See more Amazon EC2 Examples

Demonstrates how to send a request to stop Amazon EC2 instances.

For more information, see https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_StopInstances.html

Chilkat Ruby Downloads install from rubygems.org gem install chilkat or download... Ruby Library for Windows, MacOS, Linux, Alpine Linux

require 'chilkat'

# This example requires the Chilkat API to have been previously unlocked.
# See Global Unlock Sample for sample code.

rest = Chilkat::CkRest.new()

# Connect to the Amazon AWS server.
# such as https://ec2.amazonaws.com/
bTls = true
port = 443
bAutoReconnect = true
success = rest.Connect("ec2.us-west-2.amazonaws.com",port,bTls,bAutoReconnect)

# Provide AWS credentials for the REST call.
authAws = Chilkat::CkAuthAws.new()
authAws.put_AccessKey("AWS_ACCESS_KEY")
authAws.put_SecretKey("AWS_SECRET_KEY")
# the region should match the region part of the domain passed to the REST connect method (above).
authAws.put_Region("us-west-2")
authAws.put_ServiceName("ec2")

rest.SetAuthAws(authAws)

rest.AddQueryParam("Action","StopInstances")
rest.AddQueryParam("Version","2016-11-15")
# If DryRun is true then checks whether you have the required permissions for the action, 
# without actually making the request, and provides an error response. If you have the required permissions, 
# the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
# Omit the DryRun query parameter to actually start the instance.  (Or set DryRun equal to "false")
rest.AddQueryParam("DryRun","true")
rest.AddQueryParam("InstanceId.1","i-999719995399c9999")

# See EC2 Stop Instances Reference Documentation
# for more information about the Force and Hibernate query params, which are optional and true/false just like DryRun.

responseXml = rest.fullRequestNoBody("GET","/")
if (rest.get_LastMethodSuccess() != true)
    print rest.lastErrorText() + "\n";
    exit
end

# A successful response will have a status code equal to 200.
if (rest.get_ResponseStatusCode() != 200)
    print "response status code = " + rest.get_ResponseStatusCode().to_s() + "\n";
    print "response status text = " + rest.responseStatusText() + "\n";
    print "response header: " + rest.responseHeader() + "\n";
    print "response body: " + responseXml + "\n";
    exit
end

# Examine the successful XML response.
xml = Chilkat::CkXml.new()
xml.LoadXml(responseXml)
print xml.getXml() + "\n";