Skip to main content
Version: 3.0.0

Create an S3 Connection

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 new S3 Connection

Begin from your workspace Super Graph view. Follow these steps to create your connection:

  1. To start creating a connection, either:
    • Click the + button next to Connections in the left Build panel
    • add_connection
    • Or right-click anywhere in the Super Graph and hover over Create Connection
    • menu
  2. Name your connection `read_s3`
  3. Select S3 from the available options
  4. Complete the required form fields (along with any desired optional fields)
  5. form
  6. Scroll to the bottom and click Save to create your Connection

To learn more about the different options for Connections, check out our 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>}