(PowerShell) 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 .NET Downloads Chilkat .NET Assemblies

Add-Type -Path "C:\chilkat\ChilkatDotNet47-9.5.0-x64\ChilkatDotNet47.dll"

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

$rest = New-Object Chilkat.Rest

# 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 = New-Object 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"

$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.LastMethodSuccess -ne $true) {
    $($rest.LastErrorText)
    exit
}

# A successful response will have a status code equal to 200.
if ($rest.ResponseStatusCode -ne 200) {
    $("response status code = " + $rest.ResponseStatusCode)
    $("response status text = " + $rest.ResponseStatusText)
    $("response header: " + $rest.ResponseHeader)
    $("response body: " + $responseXml)
    exit
}

# Examine the successful XML response.
$xml = New-Object Chilkat.Xml
$xml.LoadXml($responseXml)
$($xml.GetXml())