Skip to main content
Kinetic Community

AWS EC2 Instance Retrieve Status

Retrieves the status of a particular EC2 instance.

Downloads

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

aws_ec2_instance_retrieve_status_v2.zip

Detailed Description

This handler uses the AWS REST API to retrieve the status of a particular EC2 instance. The instance you are inquiring about is identified by its instance ID. For more information see the AWS Amazon Virtual Private Cloud User Guide online.

The Dry Run parameter validates user permissions and inputs. If it is set to true, an error will always be thrown by the handler before completing the handler action. Error response will be 'DryRunOperation' if the account has proper permissions and inputs; 'UnauthorizedOperation' if the account does not have proper permissions.

Parameters

Name Description
Dry Run Dry run validates user permissions and inputs without completing the EC2 action (true or false).
Instance ID The instance id of the EC2 virtual machine that this handler will retrieve a status from

Sample Configuration

Parameter Example Configuration
Dry Run true
Instance ID i-615670a7

Results

Name Description
Instance Status The status of the instance you are querying information about.

Change Log

Version Date Description
2 2017-08-24 * Update the EC2 gem to AWS SDK 2.2.34.
* Change Info Values to be more consistent with the other AWS handlers.
* Internal tweaks to make execution similar to other AWS handlers.
* Added Dry Run parameter.
1 2017-08-24 * Initial version. See README for details.