How to use IBM App Connect with Amazon EC2
The Amazon Elastic Compute Cloud (Amazon EC2) is a web-based service that provides scalable computing capacity that allows businesses to run application programs in the Amazon Web Services (AWS) Cloud.
- App Connect Enterprise as a Service connector
-
Local
connector in containers (Continuous Delivery release) 12.0.5.0-r4 or later -
Local connector in containers (Long Term Support Cycle-2 release)
Supported product and API versions
To find out which product and API versions this connector supports, see Detailed System Requirements on the IBM Support page.
Connecting to Amazon EC2
Complete the connection fields that you see in the App Connect Designer Catalog page or flow editor. If necessary, work with your Amazon EC2 administrator to obtain these values.
| Connection field | Description |
|---|---|
| Secret access key | The secret access key of your Amazon EC2 account. Get the secret access key from the Security Credentials page in the AWS Management Console. |
| Access key ID | The access key ID of your Amazon EC2 account. Get the access key ID from the Security Credentials page in the AWS Management Console. |
| Region | The region of your Amazon EC2 instance, for example, us-east-1.
|
- Log in to your AWS account.Note: You can choose between Root user or IAM user based on your role.
- Root user: Account owner that performs tasks requiring unrestricted access.
- IAM user: User within an account that performs daily tasks.
Note: AWS recommends using identity-based managed policies to attach permission sets and roles to an identity, and grant only the permissions the user needs. These policies control what actions that identity can perform, on which resources, and under what conditions. While setting the permissions for an identity in IAM, you can decide whether to use an AWS-managed policy, a customer-managed policy, or an inline policy.An AWS-managed policy is a standalone policy that is created and administered by AWS. The following are some examples of AWS-managed policies that are specific to Amazon EC2:
- AmazonEC2FullAccess policy provides full access to Amazon EC2 service and all connector operations are accessible.
- AmazonEC2ReadOnlyAccess policy gives limited read-only access and few connector operations are accessible.
- On the navigation menu, click Users.
- Select your applicable user name or account name.
- Click the Security credentials tab, and then click Create access key.
- To view the new access key, click Show.Note: You can retrieve the secret access key only when you create the key pair for the first time.
- For more information, see AWS Account and Access Keys on the AWS documentation page.
To connect to an Amazon EC2 endpoint from the App Connect Designer Catalog page for the first time, expand Amazon EC2, then click Connect. For more information, see Managing accounts.
Before you use the account that is created in App Connect in a flow, rename the account to something meaningful that helps you to identify it. To rename the account on the Catalog page, select the account, open its options menu (⋮), then click Rename Account.
General considerations
Before you use App Connect Designer with Amazon EC2, take note of the following considerations:
- (General consideration) You can see lists of the trigger events and
actions that are available on the Catalog page of the App Connect Designer.
For some applications, the events and actions in the catalog depend on the environment and whether the connector supports configurable events and dynamic discovery of actions. If the application supports configurable events, you see a Show more configurable events link under the events list. If the application supports dynamic discovery of actions, you see a Show more link under the actions list.
- (General consideration) If you are using multiple accounts for an application, the set of fields that is displayed when you select an action for that application can vary for different accounts. In the flow editor, some applications always provide a curated set of static fields for an action. Other applications use dynamic discovery to retrieve the set of fields that are configured on the instance that you are connected to. For example, if you have two accounts for two instances of an application, the first account might use settings that are ready for immediate use. However, the second account might be configured with extra custom fields.
Events and actions
Amazon EC2 events
These events are for changes in this application that trigger a flow to start completing the actions in the flow.
Amazon EC2 actions
Your flow completes these actions on this application.
- Amazon Machine Images
-
- Retrieve images
- Availability zones
-
- Retrieve availability zones
- Instance types
-
- Retrieve instance types
- Instances
-
- Retrieve instances
- Launch instances
- Start instances
- Stop instances
- Reboot instances
- Terminate instances
- Key pairs
-
- Retrieve key pairs
- Launch templates
-
- Retrieve launch templates
- Security groups
-
- Retrieve security groups
Examples
Use templates to quickly create flows for Amazon EC2
Learn how to use App Connect templates to quickly create flows that perform actions on Amazon EC2. For example, open the Templates gallery, and then search for Amazon EC2.
Use IBM® App Connect to build flows that integrate with Amazon EC2.
Read the blog in the IBM Community to learn how to stop, start or reboot the Amazon EC2 instance whenever a Zendesk Service ticket gets created. Click Read the blog to go to the blog.