(JavaScript) EC2 Start Instances

See more Amazon EC2 Examples

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

Note

This example is intended for running within a Chilkat.Js embedded JavaScript engine. All Chilkat JavaScript examples require Chilkat v11.4.0 or greater.

var success = false;

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

var rest = new CkRest();

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

// Provide AWS credentials for the REST call.
var authAws = new CkAuthAws();
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","StartInstances");
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");

var responseXml = rest.FullRequestNoBody("GET","/");
if (rest.LastMethodSuccess !== true) {
    console.log(rest.LastErrorText);
    return;
}

// A successful response will have a status code equal to 200.
if (rest.ResponseStatusCode !== 200) {
    console.log("response status code = " + rest.ResponseStatusCode);
    console.log("response status text = " + rest.ResponseStatusText);
    console.log("response header: " + rest.ResponseHeader);
    console.log("response body: " + responseXml);
    return;
}

// Examine the successful XML response.
var xml = new CkXml();
xml.LoadXml(responseXml);
console.log(xml.GetXml());