Expose files from an AWS S3 bucket as an API


Restlet Cloud features a Wrapper File Store for Amazon AWS S3 buckets. The S3 Wrapper lets you serve and store files from existing S3 buckets through a web API.

This guide does not explain how to configure AWS S3, but simply lists the information you will need to collect from your AWS administrator in order to configure the Restlet Cloud S3 Wrapper.


To follow this tutorial, you will need:

  • a web browser,
  • 20 minutes of your time,
  • your AWS access key ID and secret access key to be able to use your AWS S3 account.

1Create your S3 File Store Wrapper

Click on the +File Store button, select "AWS S3" from the Type drop-down menu, and give your store a name. In this example we named our store "myAWSS3Wrapper".

Create AWS Store

2Configure your S3 File Store Wrapper

Click on the Settings tab. From the Security section, select AWS Account.

Settings tab

Enter your Access Key ID and Secret Access Key and click on the Test button.

3Import a bucket

In the Imports section, click on the Add button. From the Bucket drop-down menu, select the bucket you want to import and click on the Import bucket button.

Import bucket

Click on the Folders tab and on the Add folders button to create the associated folders.

Add folders

If your bucket contains several root folders, associated folders are created for each of them. You can then explore the folders individually by clicking on them.

Click on the Deploy button.

4Create and invoke your web API

Once your File Store has been deployed, you can simply export it as a new web API via the cog button or import it from an existing web API. For more details on how to do this, please check out our tutorials.

Congratulations on completing this tutorial! If you have questions or suggestions, feel free to contact the Help Desk.