Amazon S3 (Amazon Simple Storage Service) is a service offered by Amazon Web Services (AWS) that provides object storage through a web service interface. Amazon S3 manages data with an object storage architecture that aims to provide scalability, high availability, and low latency with high durability.
There are many advantages of Amazon S3:
Provides a unified interface REST/SOAP to uniformly access any data
Data stored in S3 is the object name (key), and the data (value)
Large file capability, up to 5TB for a single file
High speed. Up to 3500 PUT/COPY/POST/DELETE or 5500 GET/HEAD per second per bucket
Capable of version and authority control
Capable of data lifecycle management
In ILLA’s 1.40 Version, we started to support S3. The ILLA S3 Resource can connect to Amazon S3, Upcloud, Digital Ocean Spaces, Wasabi, DreamObjects, MinIO, and any other S3 provider. Below, you will see examples of connecting to your S3 provider and issuing List, Create, Read, and Delete actions.
Configure S3 Resource
The S3 Resource requires the following information to establish a connection:
Amazon S3 Bucket Region
Amazon Access Key ID
Amazon Secret Key
For Amazon S3, you can find your Access Key and Secret Key using the following guide: Accessing AWS using your AWS credentials
And the following optional information:
Bucket name( used to specify the bucket )
Custom S3 endpoint ( used to connect to other non-S3 services, like Digital Ocean Spaces, Wasabi, and so on )
Configure actions
List all objects in a bucket
This action lists the files in the bucket. It will return an array of objects, each including at least one objectKey property.
This action contains the following optional information:
Bucket name: This can be left out if you have filled in the bucket name when configuring the S3 resource. If not, this is required.
Prefix to filter results: To narrow your query to return only files that begin with your specified prefix.
Delimiter: Used to group object keys.
Generate Signed URL: If YES, the action will return a signed URL.
Expiry Duration of Signed URL(Minutes): To set the expiry duration of the signed URL.
Max keys: To set the maximum number of keys returned in the response.
Read an object
This action lists an array of objects, including objectData property. It contains the following optional information:
Bucket name
Object key
Download an object
This action will automatically download the file which matches the object key. It contains the following optional information:
Bucket name
Object key
Delete an object
This action will delete the file which matches the object key. It contains the following optional information:
Bucket name
Object key
Delete multiple objects
This action will delete multiple files which match the object keys. It contains the following optional information:
Bucket name
Object key list: a list of object keys to delete.
Upload data
This action allows users to upload a file to an S3 bucket. It contains the following information:
Bucket name
Content-type: text/plain, image/bmp, application/pdf, and so on.
Upload object name: to override the file name.
Upload data: base64 encoded data.
Upload multiple data
This action allows users to upload multiple files to the S3 bucket. It contains the following information:
Bucket name
Content-type
Upload object name list: a list of file names.
Upload data list: a list of base64 encoded data.
You can check ILLA’s website here at: illacloud.com
GitHub page: github.com/illacloud/illa-builder
Join Discord community: discord.com/invite/illacloud