The Amazon S3 communication point enables you to connect to an Amazon Simple Storage Service (Amazon S3) data bucket, an object storage with a simple web service interface. The endpoint allows routes to push output to Amazon S3.

The S3 bucket must be created prior to using the communication point as Rhapsody will not automatically create it if it does not exist.

Supported Operational Modes: Output.

Output Mode Properties

Property Description
Endpoint URL The HTTPS endpoint URL for the Amazon S3 service in the target AWS region (in path-style format).

For example: http://s3-sa-east-1.amazonaws.com/bucket refers to the South America (São Paulo) region.
S3 Bucket Name The S3 data bucket name. The bucket must be in the same region as AWS region provided in Endpoint URL.
AWS Access Key Id

The AWS access key identifier as provided by Amazon.

To read temporary credentials via an AWS IAM role while running in EC2, leave this property blank.
AWS Secret Key

The AWS access secret key associated with your Amazon account.

To read temporary credentials via an AWS IAM role while running in EC2, leave this property blank.

Object Key Prefix 

An optional prefix that is prepended to the specified or generated object key for the message. This can be used to emulate a directory structure by providing a prefix that separates path elements using forward slashes (for example, 'dir1/dir2/'). A trailing forward slash is not added to this value.

Object Key

The object key to use when storing the message in S3. If this is blank then a type-4 UUID is generated and used as the object key. A message property may be used here by prefixing the name of the message property with $. Forward slashes may be included in this value to emulate a directory structure in the S3 bucket.

Encryption Mode

Determines what type of encryption is applied to the messages uploaded to S3:

  • Server Side Encryption (AES-256).
  • None.

Storage Class

Determines which S3 storage class should be used for uploaded messages:

  • Standard.
  • Reduced Redundancy.
  • Infrequent Access.

Canned ACL

Determines which S3 canned ACL should be used on the uploaded message:

  • None - no canned ACL is set on the object.
  • Private.
  • Public Read.
  • Public Read Write.
  • Authenticated Read.
  • Log Delivery Write.
  • Bucket Owner Read.
  • Bucket Owner Full Control.
Content Type Optionally sets the Content-Type header on the uploaded message (for example, text/plain, application/json). A message property may be used here by prefixing the name of the message property with $.

Content Encoding

 Optionally sets the Content-Encoding header on the uploaded message (for example, gzip). A message property may be used here by prefixing the name of the message property with $.

Custom Metadata

Enables custom metadata to be set on the uploaded message using either message properties or literal values via the Custom Metadata dialog:

Metadata Name is the name of the metadata attribute on S3 (without the x-amz-meta- prefix) and is case insensitive. Value can be either a literal value, or a message property (the name of the message property prefixed with $).
Connection Timeout (ms) The connection timeout, in milliseconds, to use when attempting to connect to Amazon S3.
Read Timeout (ms) The read timeout, in milliseconds, to use when waiting for a response from Amazon S3.