In this doc, we will cover how to setup a Connection to an AWS S3 bucket.


  • Access credentials
  • Data location on AWS S3
  • Data Schema (column names and column type)

Create new S3 connection

Figure 1Figure 1

Figure 1

Figure 2Figure 2

Figure 2

In Figure 2:

  • Bucket (optional): The bucket name, such as ascend-io-sample-read-data.
  • Connection Name (required): The name to identify this connection with, such as Amazon S3 Sample Read S3.
  • S3 API Endpoint (optional): This is for endpoint which is not S3 but S3 compatible.
  • S3 Region (optional): The region name, such as us-west-2.
  • Required Credentials (Optional): If de-selected, only the publicly accessible buckets can be accessed.
  • Choose Credentials (Required): Credentials to use for connecting to S3 if Required Credentials checkbox is selected.
Figure 3Figure 3

Figure 3

Create new credentials if Required Credentials checkbox was selected and you do not want to select from the already created ones. (Figure 3)

Figure 4Figure 4

Figure 4

You can also choose to Edit an existing credentials by clicking the EDIT button next to each credentials. (Figure 4)

Here's an example S3 policy configuration for this IAM user to create a read connector for data within the bucket s3://ascend-io-playground-bucket/:

    "Version": "2012-10-17",
    "Statement": [
            "Effect": "Allow",
            "Action": [
            "Resource": [

Testing and Creating the Connection

Figure 5Figure 5

Figure 5

(Figure 5) Use TEST CONNECTION button to check whether all S3 permissions are correctly configured If SUCCESS, click CREATE AND USE CONNECTION.

Updated 15 days ago


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.