AWS S3

The AWS S3 connector stores files in AWS buckets that you can retrieve later. For example, consider a scenario where you create an entry in the Contentstack CMS. You can create a trigger that activates when you create a new entry and the backup of the created entry gets stored in the AWS bucket. With the AWS S3 Connector, you can fetch the details of all the files and also delete an existing object from your AWS bucket.

Prerequisites

To use the AWS S3 connector, you first need to add your AWS S3 account. To do so, follow the steps given below:

Connect your AWS S3 Account to Automate

1. Click Configure Action Step from the left navigation panel.
2. Click Action Step to configure third-party services.
3. Within the Configure Action Step, click the AWS S3 connector.
   
4. Under Choose an Action tab, select any one action from the list. Here, we are selecting the Create a New Object action.
   
5. On the Configure Action page, click the + Add New Account button to add your AWS S3 account.
   
6. In the Authorize modal, enter a Title, enter the Access Key, Secret Key, and the Region details. You can generate the Access and Secret Key by navigating through Security credentials > Access Keys > Create New Access Key in your AWS account.

   

   Additional Resource: For more information, refer to the Managing access keys for IAM users document.

7. Then click Authorize.
   

This sets up your AWS S3 account for the AWS S3 action connector.

Set up the AWS S3 Connector

Perform the following steps to set up the AWS S3 connector:

1. From the left navigation panel, click Configure Action Step.
2. Then, click Action Step to configure third-party services.
3. Within the Configure Action Step, click the AWS S3 connector.
   

   Note: You can sort and search the connector(s) based on the filter.

4. Under Choose an Action, you will see three actions: Create a New Object, Delete an Object, and Get All Files.
   

Once done, you can go ahead and set up your AWS S3 connector.

Create a New Object

This action lets you create a new object in the AWS S3 bucket.

1. Under Choose an Action tab, select the Create a New Object action.
2. On the Create a New Object Configure Action page, enter the details given below:
   1. Click + Add New Account button to connect your AWS account as shown in the Connect your AWS S3 Account to Automate step.
   2. You can select the AWS Bucket Name from the Lookup list that appears when you click the textbox. The lookup drop-down loads the buckets already defined and present in your AWS S3 account.
   3. Enter the File Name (for example, File01) or/and any value from the values list.
   4. In the Source drop-down, select the Source of the upload (Content or File URL) and the Input Value for each source.
      
   5. Click the Show Optional Fields toggle button to enter the text for the Tags and Metadata optional fields.
      
      
3. Click Proceed.
4. Check if the details are correct. If yes, click Test Action.
   
5. Once set, click Save and Exit.
   
6. Log into your AWS account and see the list of files in the bucket. In the AWS account’s bucket, you can see the created file.
7. Download the file and open it. You can see the content stored in the file.
   

Delete an Object

This action lets you delete an existing object from the AWS S3 bucket.

1. Under Choose an Action tab, select the Delete an Object action.
2. On the Delete an Object Configure Action page, enter the details given below:
   1. Click + Add New Account button to connect your AWS S3 account as shown in the Connect your AWS S3 Account to Automate step.
   2. You can select the AWS Bucket Name from the Lookup list. The drop-down loads the buckets already defined and present in your AWS S3 account.
   3. Select the File Name from the Lookup drop-down. You can select multiple files to delete.
      
3. Click Proceed.
4. Click the Test Action button to test the configured action.
   
5. Once set, click Save and Exit.
   

Get All Files

This action lets you fetch the details of all the files from the AWS S3 bucket.

1. Under Choose an Action tab, select the Get All Files action.
2. On the Get All Files Configure Action page, enter the details given below:
   1. Click + Add New Account button to connect your AWS S3 account as shown in the Connect your AWS S3 Account to Automate step.
   2. Select the AWS Bucket Name from the Lookup list. The drop-down loads the buckets already defined and present in your AWS S3 account.
   3. Optionally, enable the Show Optional Fields toggle button to display the Folder Name field. You can select the folder to fetch all the associated files.

      Note: If you do not select any folder name, all the files available in the selected AWS S3 bucket will be fetched.

      
3. Click Proceed.
4. Click the Test Action button to test the configured action.
   
5. Once set, click Save and Exit.
   

This sets up your AWS S3 action connector.