Lua

EC2 Stop Instances

See more Amazon EC2 Examples

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

local chilkat = require("chilkat")

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

local rest = chilkat.Rest.new()

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

-- Provide AWS credentials for the REST call.
local authAws = chilkat.AuthAws.new()
authAws.access_key = "AWS_ACCESS_KEY"
authAws.secret_key = "AWS_SECRET_KEY"
-- the region should match the region part of the domain passed to the REST connect method (above).
authAws.region = "us-west-2"
authAws.service_name = "ec2"

rest:set_auth_aws(authAws)

rest:add_query_param("Action", "StopInstances")
rest:add_query_param("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:add_query_param("DryRun", "true")
rest:add_query_param("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.

local responseXml = rest:full_request_no_body("GET", "/")
if not rest.last_method_success then
    print(rest.last_error_text)
    return
end

-- A successful response will have a status code equal to 200.
if rest.response_status_code ~= 200 then
    print("response status code = " .. rest.response_status_code)
    print("response status text = " .. rest.response_status_text)
    print("response header: " .. rest.response_header)
    print("response body: " .. responseXml)
    return
end

-- Examine the successful XML response.
local xml = chilkat.Xml.new()
xml:load_xml(responseXml)
print(xml:get_xml())