# AWS S3

## Creating a connection

Telmai can be setup to read files directly from your S3 bucket. This requires read access to your S3 bucket. Please add the following permissions to the S3 bucket for the IAM user whose credentials (key and secret) will be used:

1. s3:GetBucketLocation
2. s3:ListBucket
3. s3:GetObject

Once the permissions are granted, proceed to the Telmai UI and enter the required information:

* **AWS** **Key:** Your AWS access key.
* **AWS** **Secret Key:** Your AWS secret access key.
* **Region:** The AWS region where your S3 bucket is located.
* **Bucket**: The name of your S3 bucket.

<figure><img src="/files/EAaEegfGk91nP8uxUpNJ" alt=""><figcaption></figcaption></figure>

## Connecting an asset

Once a connection is defined, you can start using it to create assets. To create assets, you will need:

* **Path:** The full path to the file in the bucket or the full path of the folder containing all files to be scanned. If specifying a folder, ensure all files have the same extension (e.g., .csv, .json, .parquet).
* **File Type:** Please refer to [Supported File Types](/telmai/connect-to-data/supported-file-types.md).
* **Delimiter (Optional for CSV type):** Choose the delimiter used in your files (e.g., comma, tab, space).

<figure><img src="/files/10FJakmbdi8PFSWljltz" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.telm.ai/telmai/connect-to-data/data-connections/aws-s3.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
