Document toolboxDocument toolbox

Amazon EC2

[ 1 Connect Amazon EC2 with LogicHub ] [ 2 Actions for Amazon EC2 ] [ 2.1 Launch an Instance ] [ 2.1.1 Input Field ] [ 2.1.2 Output ] [ 2.2 Start an Instance ] [ 2.2.1 Input Field ] [ 2.2.2 Output ] [ 2.3 Stop an Instance ] [ 2.3.1 Input Field ] [ 2.3.2 Output ] [ 2.4 Describe Instances ] [ 2.4.1 Input Field ] [ 2.4.2 Output ] [ 2.5 Describe Security Groups ] [ 2.5.1 Input Field ] [ 2.5.2 Output ] [ 2.6 Add IP to Security Group ] [ 2.6.1 Input Field ] [ 2.6.2 Output ] [ 2.7 Remove IP from Security Group ] [ 2.7.1 Input Field ] [ 2.7.2 Output ] [ 3 Release Notes ]

Amazon Elastic Compute Cloud (Amazon EC2) is a web service that provides secure, resizable compute capacity in the cloud.

Connect Amazon EC2 with LogicHub

  1. Navigate to Automations > Integrations.

  2. Search for Amazon EC2.

  3. Click Details, then the + icon. Enter the required information in the following fields.

  4. Label: Enter a connection name.

  5. Reference Values: Define variables here to templatize integration connections and actions. For example, you can use https://www.{{hostname}}.com where, hostname is a variable defined in this input. For more information on how to add data, see 'Add Data' Input Type for Integrations.

  6. Verify SSL: Select option to verify connecting server's SSL certificate (Default is Verify SSL Certificate).

  7. Remote Agent: Run this integration using the LogicHub Remote Agent.

  8. Region: Valid AWS Region Name. (To get a list of available regions, refer to this link).

  9. Access Key: AWS Account Access Key.

  10. Secret Key: AWS Account Secret Key.

  11. After you've entered all the details, click Connect.

Actions for Amazon EC2

Launch an Instance

Launch an instance of Amazon EC2.

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Input Name

Description

Required

Input Name

Description

Required

EC2 Image Id Column name

Column name from parent table holding the Image ID.

Required

EC2 Instance Type Column name

Column name from parent table holding the Instance Type.

Required

EC2 Key Pair Column name

Column name from parent table holding the Key Pair name.

Required

Output

A JSON object containing multiple rows of results:

  • has_error: True/False

  • error: message/null

  • result: Instance Details

Start an Instance

Start an instance of Amazon EC2 that was previously stopped.

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Input Name

Description

Required

Input Name

Description

Required

EC2 Instance ID Column name

Column name from parent table holding the Instance ID.

Required

Output

A JSON object containing multiple rows of results:

  • has_error: True/False

  • error: message/null

Stop an Instance

Stop an instance of Amazon EC2.

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Input Name

Description

Required

Input Name

Description

Required

EC2 Instance ID Column name

Column name from parent table holding the Instance ID.

Required

Output

A JSON object containing multiple rows of results:

  • has_error: True/False

  • error: message/null

Describe Instances

Action will describe one or more of your instances.

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Input Name

Description

Required

Input Name

Description

Required

Filters in JSON

Column name that contains filters in JSON format.

 

Example: [{"Name": "instance-type","Values": ["t2.micro", "t3.micro"]}].

Required

 

Output

A JSON object containing multiple rows of results:

  • has_error: True/False

  • error: message/null

  • result: Instances details

Describe Security Groups

Action will describe one or more of your security groups.

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Input Name

Description

Required

Input Name

Description

Required

Filters in JSON

Column name that contains filters in JSON format.

 

Example: [{"Name": "instance-type","Values": ["t2.micro", "t3.micro"]}].

Required

 

Output

A JSON object containing multiple rows of results:

  • has_error: True/False

  • error: message/null

  • result: Security groups details.

Add IP to Security Group

Action will add IP to a security group.

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Input Name

Description

Required

Input Name

Description

Required

Security group name or id

Column name that contains security group name or ID.

Required

IP Address

Column name that contains IP address.

Required

IP Protocol

Column name that contains IP protocol.

Required

From Port

Column name that contains from the port.

Required

To Port

Column name that contains to port.

Required

Output

A JSON object containing multiple rows of results:

  • has_error: True/False

  • error: message/null

  • result: Success/Failure Message

Remove IP from Security Group

Action will add IP to a security group.

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Input Name

Description

Required

Input Name

Description

Required

Security group name or id

Column name that contains security group name or ID.

Required

IP Address

Column name that contains IP address.

Required

IP Protocol

Column name that contains IP protocol.

Required

From Port

Column name that contains from the port.

Required

To Port

Column name that contains to port.

Required

Output

A JSON object containing multiple rows of results:

  • has_error: True/False

  • error: message/null

  • result: Success/Failure Message

Release Notes

  • v2.0.0 - Updated architecture to support IO via filesystem

  • v1.0.10 - Used NextToken in the following actions: Describe Instances and Describe Security Group.