Skip to main content
Kinetic Community

AWS EC2 Instance Start

This handler sends a start request to an AWS EC2 machine instance.

Downloads

By downloading this file, you acknowledge that you agree to our Terms of Service

aws_ec2_instance_start_v2.zip

Detailed Description

The start_instance function can be executed against any valid instance in any
state. When executed against an already started instance, the Previous Status
and Current Status will both be "running".

Detailed Description
The start_instance function can be executed against any valid instance in any
state. When executed against an already started instance, the Previous Status
and Current Status will both be "running".

The result of the start_instance call is a mixed hash/array with the  following
structure:

<resultSet>
    <requestId/>
    <instancesSet>
        <item>
            <currentState>
                <name/>
                <code/>
            </currentState>
            <previousState>
                <name/>
                <code/>
            </previousState>
            <instanceId/>
        </item>
    </instancesSet>
</resultsSet>

Parameters

Name Description
Instance ID The instance id of the EC2 virtual machine that this handler will send a start request to.

Sample Configuration

Parameter Example Configuration
Instance ID <%= @answers['Instance ID'] %>

Authentication

This handler requires two info values for AWS authentication: Access Key ID and
the Secret Access Key. These are analogous to username and password.

To find authentication values from the AWS account:

  1. Navigate to the following URL: https://aws.amazon.com/account/
  2. Click the "Security Credentials" link (if you are not logged in, you will
     be prompted to do so).
  3. Click the "Access Credentials" link.  Here you will find a list of your
     Access Keys.
  5. Use the Access Key ID to configure the access_key_id info value of this
     handler.
  6. To retrieve the Secret Access Key, click the "Show" link next to the Access
     Key ID that will be used.
  7. Use the Secret Access Key to configure the secret_access_key info value of
     this handler.

Results

Name Description
Request ID The transaction id of the start request. For use when engaging Amazon EC2 Support in the event of an error. This ID will allow for back tracing from the server side.
Previous Status The state of the machine instance prior to the start request being issued.
Current Status The state of the machine instance after the start request. The state will typically be "pending".

Change Log

Version Date Description
1 2011-03-04 Initial version
2 2011-03-04 * Changed 'Previous State' result to 'Previous Status' to be more consistent
  with the AWS EC2 console.
* Changed 'Current State' result to 'Current Status' to be more consistent with
  the AWS EC2 console.
* Added comments for execute method in init.rb.