How to use IBM App Connect with Amazon S3

Amazon Simple Storage Service is a simple storage service that provides object storage through a web service interface. It uses the scalable storage infrastructure of Amazon.com and enables you to store objects, download and use data with other AWS services, and build applications that call for internet storage.

Availability:
  • A connector in IBM App Connect on IBM CloudCloud-managed connector (Not for containers)
  • A local connector in a Designer instance of IBM App Connect in containers (Continuous Delivery release)Local connector in containers (Continuous Delivery release)
  • A local connector in a Designer instance of IBM App Connect in containers (Extended Update Support)Local connector in containers (Extended User Support release)
  • A local connector in a Designer instance of IBM App Connect in containers (Long Term Support)Local connector in containers (Long Term Support release)

Connecting to Amazon S3

Complete the connection fields that you see in the App Connect Designer Catalog page or flow editor. If necessary, work with your Amazon S3 administrator to obtain these values.

Amazon S3 connection fields:

Secret access key
The secret access key for your Amazon S3 account, as generated in the Security Credentials page in the AWS Management Console
  • Required: True
Access key ID
The access key ID for your Amazon S3 account, as generated in the Security Credentials page in the AWS Management Console
  • Required: True
Region
The region of your Amazon S3 instance; for example, us-east-1
  • Required: False
To obtain connection values for Amazon S3, complete the following steps.
  1. Sign in to your Amazon Web Services account.
  2. You can find the value for the region parameter at the end of the URL when you are logged in to the AWS Management Console (for example, https://us-east-2.console.aws.amazon.com/console/home?region=us-east-2#).
  3. To find values for the secretAccessKey and accessKeyId parameters, click your account name on the navigation bar and select My Security Credentials.
  4. Existing access key IDs are listed on the AWS IAM Credentials tab. To create an access key, click Create access key, then click Download credentials to download the access key ID and secret access key.

General considerations

Before you use App Connect Designer with Amazon S3, 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 (IBM® Cloud Pak for Integration or App Connect on IBM Cloud) 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 S3 events

These events are for changes in this application that trigger a flow to start performing the actions in the flow.

Note: Events are not available for changes in this application. You can trigger a flow in other ways, such as at a scheduled interval or at specific dates and times.

Amazon S3 actions

These are actions on this application that you want a flow to complete.

Buckets
Create bucket
Retrieve buckets
Object ACLs
Update object ACL
Object tags
Delete object tags
Update object tags
Objects
Create object
Retrieve object metadata
Update or create object
Delete object

More items are available when you have connected App Connect to Amazon S3.

Examples

Screenshot of the dashboard tile for a template that uses Amazon S3

Use templates to quickly create flows for Amazon S3

Learn how to use App Connect templates to quickly create flows that perform actions on Amazon S3; for example, open the Templates gallery then search for amazons3.