S3

This guide shows you how to create an S3 Connection in Ascend.

Prerequisites

• Ascend Project
• Ascend Workspace
• Credentials for your AWS account
  • Access Key: The AWS access key to use for the S3 Connection.
  • Secret Access Key: The secret access key associated with the access key.

Create a S3 Connection

From your workspace Super Graph view, follow these steps:

Form

1. Create a Connection by either:
   • Clicking the + button next to Connections in the left Build panel
   
   • Right-clicking in the Super Graph and selecting Create Connection
   
2. Enter a descriptive name like `read_s3`
3. Select S3 from the available options
4. Fill in the required fields (and any optional fields as needed)
5. Click Save at the bottom to create your Connection

Files panel

1. Open the Files panel in the top left
2. Right-click the Connections directory and select New File

3. Give your file a descriptive name like `read_s3.yaml`

For complete configuration options, see our Connection reference guide.

Example

Use the following YAML template for your S3 Connection. Customize the highlighted values with your specific Connection details:

/my_project/connections/s3_connection.yaml

connection:
  s3:
    root: <root_path_to_bucket>
    aws_access_key_id: ${vaults.<your_vault>.<access_key>}
    aws_secret_access_key: ${vaults.<your_vault>.<secret_access_key>}

🎉 Congratulations, you just set up an S3 Connection in Ascend!