cs-icon.svg

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.

Set Up AWS S3 Connector

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

  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.
    Select_the_Connector_S3.png
  4. Under Choose an Action tab, you will see two actions: Create New Object and Delete an Object.

    Let’s look at each of them in detail.

  5. Create New Object

    1. Select the Create New Object action.
      Create_New_Object_Action.png
    2. Click the + Add New Account button to add your AWS account (see screenshot in next step).
      Add_New_Account.png
    3. 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.
    4. 4.Generate_Access_Key.jpg

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

      Then, click Authorize.
      Authorize_button
    5. On the Configure Action page, you need to enter the details:
      1. You can select the AWS Bucket Name from the Lookup list that appears when you click the textbox. The lookup dropdown loads the buckets already defined and present in your AWS account.
      2. Enter the File Name (for example, File:01) or/and any value from the values list.
      3. In the Source dropdown, select the Source of the upload (Content or File URL) and the Input Value for each source. 
        Binary_File.png
      4. Click the Show optional fields toggle button to enter the text for the Tags and Metadata optional fields.
        Show_Optional_Fields.png
    6. Click Proceed.
    7. Check if the details are correct. If yes, click Test Action.
      Test_Action.png
    8. Once set, click Save and Exit.
    9. 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.
      Third-Party-Fiel.png
    10. Download the file and open it. You can see the content stored in the file.
      10.Download_File.png

    Delete an Object

    1. Select the Delete an Object action.
      Select_Action.png
    2. Click the + Add New Account button to add your AWS account (see screenshot in next step).
      Add_New_Account.png
    3. 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.
    4. 4.Generate_Access_Key.jpg

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

      Then, click Authorize.
      Authorize_button
    5. On the Configure Action page, you need to enter the details:
      1. You can select the AWS Bucket Name from the Lookup list. The drop-down loads the buckets already defined and present in your AWS account.
      2. Select the File Name from the Lookup dropdown. 
        Select_Different_Fields.png
      3. Click the Show optional fields toggle button to enter the Version ID for the object you want to delete.
        Show_Optional_Fields.png
    6. Click Proceed.
    7. Check if the details are correct. If yes, click Test Action.
      Test_Action.png
    8. Once set, click Save and Exit.
      Save_Exit.png

This sets up your AWS S3 action connector.

Was this article helpful?
^