> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# Amazon S3 connector

- Connector: `appmixer.aws.s3`
- Version: 2.2.2
- Components: 14 (5 triggers, 9 actions)

Amazon S3 or Amazon Simple Storage Service is a service offered by Amazon Web Services (AWS) that provides object storage through a web service interface.

- Connector page: <https://connectors.appmixer.com/connector/appmixer.aws.s3/2.2.2>
- Source code: <https://github.com/clientIO/appmixer-connectors/tree/dev/src/appmixer/aws/s3>
- Download package: <https://connectors.appmixer.com/connector/appmixer.aws.s3/2.2.2/download>

## Authentication

**Type:** API Key

**Fields:**

- `Access Key Id` (text): Your AWS access key ID
- `Secret Key` (text): Your AWS secret access key

## Triggers (5)

- [Deleted Bucket](https://connectors.appmixer.com/connector/appmixer.aws.s3/2.2.2/component/appmixer.aws.s3.DeletedBucket.md) (`appmixer.aws.s3.DeletedBucket`): This trigger fires every time new bucket is deleted on AWS S3.
- [Deleted Object](https://connectors.appmixer.com/connector/appmixer.aws.s3/2.2.2/component/appmixer.aws.s3.DeletedObject.md) (`appmixer.aws.s3.DeletedObject`): This trigger fires every time an object is deleted.
- [New Bucket](https://connectors.appmixer.com/connector/appmixer.aws.s3/2.2.2/component/appmixer.aws.s3.NewBucket.md) (`appmixer.aws.s3.NewBucket`): This trigger fires every time new bucket is created on AWS S3.
- [New Object](https://connectors.appmixer.com/connector/appmixer.aws.s3/2.2.2/component/appmixer.aws.s3.NewObject.md) (`appmixer.aws.s3.NewObject`): This trigger fires every time new object is created with POST, Copy and CompleteMultipartUpload operations.
- [Updated Object](https://connectors.appmixer.com/connector/appmixer.aws.s3/2.2.2/component/appmixer.aws.s3.UpdatedObject.md) (`appmixer.aws.s3.UpdatedObject`): This trigger fires every time object is created with PUT operation.

## Actions (9)

- [Create Bucket](https://connectors.appmixer.com/connector/appmixer.aws.s3/2.2.2/component/appmixer.aws.s3.CreateBucket.md) (`appmixer.aws.s3.CreateBucket`): Create bucket on AWS S3.
- [Delete Bucket](https://connectors.appmixer.com/connector/appmixer.aws.s3/2.2.2/component/appmixer.aws.s3.DeleteBucket.md) (`appmixer.aws.s3.DeleteBucket`): Delete bucket from AWS S3.
- [Delete Object](https://connectors.appmixer.com/connector/appmixer.aws.s3/2.2.2/component/appmixer.aws.s3.DeleteObject.md) (`appmixer.aws.s3.DeleteObject`): Delete object from bucket.
- [Get File Object](https://connectors.appmixer.com/connector/appmixer.aws.s3/2.2.2/component/appmixer.aws.s3.GetFileObject.md) (`appmixer.aws.s3.GetFileObject`): Get specific object from S3 bucket as a file. With this component the object size is not limited.
- [Get Object](https://connectors.appmixer.com/connector/appmixer.aws.s3/2.2.2/component/appmixer.aws.s3.GetObject.md) (`appmixer.aws.s3.GetObject`): Get specific object from S3 bucket. Do not use this component for large files (more than 2MB), use GetFileObject instead.
- [Get Signed Url](https://connectors.appmixer.com/connector/appmixer.aws.s3/2.2.2/component/appmixer.aws.s3.GetSignedUrl.md) (`appmixer.aws.s3.GetSignedUrl`): Get a signed URL for an S3 object.
- [List Buckets](https://connectors.appmixer.com/connector/appmixer.aws.s3/2.2.2/component/appmixer.aws.s3.ListBuckets.md) (`appmixer.aws.s3.ListBuckets`): Return list of buckets created on AWS S3.
- [Put Content](https://connectors.appmixer.com/connector/appmixer.aws.s3/2.2.2/component/appmixer.aws.s3.PutContent.md) (`appmixer.aws.s3.PutContent`): Put object (utf8 content and a mime type) to bucket.
- [Put Object](https://connectors.appmixer.com/connector/appmixer.aws.s3/2.2.2/component/appmixer.aws.s3.PutObject.md) (`appmixer.aws.s3.PutObject`): Upload object to bucket.

## Changelog

### 2.2.2

- Security: fast-xml-parser (used by the AWS SDK XML parser) is overridden to 5.12.0 (quadratic CPU on unterminated stop-node tags, GHSA-474x-hrwr-fgx4).

### 2.2.1

- Security: fast-xml-parser (used by the AWS SDK XML parser) is overridden to 5.11.2 (entity encoding bypass and entity-expansion DoS advisories).

### 2.2.0

- Added test() (Flow Test Mode) to S3 event triggers: NewObject, UpdatedObject, DeletedObject. Builds a representative event record from the most-recently-modified object in the bucket (read-only).

### 2.1.0

- Added test() (Flow Test Mode) to polling triggers: NewBucket, DeletedBucket.

### 2.0.0

- Breaking change (Will require re-authentication): Updated AWS SDK to v3.

### 1.1.0

- Modernized PutObject and PutContent components to use AWS SDK native upload method instead of deprecated s3-upload-stream library.
- Made ACL parameter optional in PutObject and PutContent components to support S3 buckets with ACLs disabled (AWS best practice).

### 1.0.6

- Added validation for required fields in components.

### 1.0.5

- Added support for KMS encryption and trusted account IDs in S3 triggers. In order to start using it with existing buckets, you need to stop and start the triggers again. Otherwise, the SNS topic configuration won't be updated.

### 1.0.4

- Connecting to S3 no longer requires the `s3:ListAllMyBuckets` permission.
- Bucket name in all components can now be specified as a string. The previous behavior remains: If the account has s3:ListAllMyBuckets permission, the bucket name can also be selected from a list of buckets.

### 1.0.3

- Fixed a bug with initializing the SNS and S3 clients for triggers.
- Fixed S3.NewObject, S3.DeletedObject and S3.UpdatedObject for non-versioned buckets and also object keys with spaces.

### 1.0.2

- ListRegions auxiliary component added.

### 1.0.0

- Initial version
