(Xojo Plugin) 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 Xojo Plugin Download Xojo Plugin for Windows, Linux, Mac OS X, and ARM, ARM64

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

Dim rest As New Chilkat.Rest

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

// Provide AWS credentials for the REST call.
Dim authAws As New Chilkat.AuthAws
authAws.AccessKey = "AWS_ACCESS_KEY"
authAws.SecretKey = "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.ServiceName = "ec2"

success = rest.SetAuthAws(authAws)

success = rest.AddQueryParam("Action","StopInstances")
success = 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")
success = rest.AddQueryParam("DryRun","true")
success = 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.

Dim responseXml As String
responseXml = rest.FullRequestNoBody("GET","/")
If (rest.LastMethodSuccess <> True) Then
    System.DebugLog(rest.LastErrorText)
    Return
End If

// A successful response will have a status code equal to 200.
If (rest.ResponseStatusCode <> 200) Then
    System.DebugLog("response status code = " + Str(rest.ResponseStatusCode))
    System.DebugLog("response status text = " + rest.ResponseStatusText)
    System.DebugLog("response header: " + rest.ResponseHeader)
    System.DebugLog("response body: " + responseXml)
    Return
End If

// Examine the successful XML response.
Dim xml As New Chilkat.Xml
success = xml.LoadXml(responseXml)
System.DebugLog(xml.GetXml())