Dart

EC2 Stop Instances

See more Amazon EC2 Examples

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

import 'package:chilkat/chilkat.dart';

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

  final rest = CkRest();

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

  // Provide AWS credentials for the REST call.
  final authAws = 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', '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.

  final String responseXml;
  try {
    responseXml = rest.fullRequestNoBody('GET', '/');
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  // A successful response will have a status code equal to 200.
  if (rest.responseStatusCode != 200) {
    print('response status code = ${rest.responseStatusCode}');
    print('response status text = ${rest.responseStatusText}');
    print('response header: ${rest.responseHeader}');
    print('response body: $responseXml');
    return;
  }

  // Examine the successful XML response.
  final xml = CkXml();
  xml.loadXml(responseXml);
  print(xml.getXml());
}