Amazon Simple Storage Service (S3)

Amazon Simple Storage Service (Amazon S3) is an internet-based storage service that allows you to store and retrieve data from anywhere, at any time. These tasks can be easily managed through the AWS Management Console's simple and intuitive web interface.

API versions: 01-03-2006 (AWS4)

API types: REST

Authentication and authorization

The Amazon S3 connector supports the following authentication methods:
  • AWS V4 authentication – Uses an AWS access key ID and secret access key for authentication.
  • IAM role (Assume role) – Uses AWS access key ID and secret access key to obtain temporary credentials by assuming an IAM role.

IAM role configuration options

Connector-generated credentials

Provide the following details:

  • Role ARN
  • Role session name
  • External ID (optional)

The connector automatically generates, manages, and refreshes the temporary credentials.

Pre-generated credentials

If temporary credentials have already been generated using the AWS CLI, SDK, or API, provide the following values:

  • Access key ID
  • Secret access key
  • Session token
  • Role ID
  • Expiration
  • ARN session name
Note: All types of session management are supported for IAM Assume Role–based authentication. Basic AWS authentication does not require session management, as AWS key details remain unchanged.

Prerequisites

  • An AWS account
  • A working webMethods Integration tenant
  • An IAM role configured with the required Amazon S3 permissions
  • A trust relationship that allows your AWS user to assume the IAM role
  • An IAM policy attached to the user that grants sts:AssumeRole permission

Actions

  • getBucket: Retrieves the objects present in the bucket that is specified in the parameters

  • getObject: Retrieves an object from the specified bucket

  • listAllMyBuckets: Retrieves a list of all the buckets owned by the sender

  • multipartDownload: Performs multipart download for a specific object in a bucket and returns the specific part number and its stream

  • createBucket: Creates a bucket

  • deleteBucket: Deletes an existing bucket

  • deleteObject: Deletes an object from the specified bucket

  • putObject: Adds an object to a bucket

  • upload: Performs multipart upload for a specific file and returns the 'upload ID' along with the number of file parts uploaded

Custom Actions

You can use this connector to create your own custom actions for performing specific tasks. The actions that you create look and work exactly like the other actions do.

Learn more about how to create custom actions.