# Amazon S3 connection #

To access your data in Amazon S3, create a connection asset for it\.

Amazon S3 (Amazon Simple Storage Service) is a service that is offered by Amazon Web Services (AWS) that provides object storage through a web service interface\.

For other types of S3\-compliant connections, you can use the [Generic S3 connection](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/conn-generics3.html)\.

## Create a connection to Amazon S3 ##

To create the connection asset, you need these connection details:

<!-- <ul> -->

 *  **Bucket**: Bucket name that contains the files\. If your AWS credentials have permissions to list buckets and access all buckets, then you only need to supply the credentials\. If your credentials don't have the privilege to list buckets and can only access a particular bucket, then you need to specify the bucket\.
 *  **Endpoint URL**: Use for an AWS GovCloud instance\. Include the region code\. For example, `https://s3.<region-code>.amazonaws.com`\. For the list of region codes, see [AWS service endpoints](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints)\.
 *  **Region**: Amazon Web Services (AWS) region\. If you specify an Endpoint URL that is not for the AWS default region (us\-west\-2), then you should also enter a value for Region\.

<!-- </ul> -->

Select **Server proxy** to access the Amazon S3 data source through a proxy server\. Depending on its setup, a proxy server can provide load balancing, increased security, and privacy\. The proxy server settings are independent of the authentication credentials and the personal or shared credentials selection\.

<!-- <ul> -->

 *  **Proxy host**: The proxy URL\. For example, `https://proxy.example.com`\.
 *  **Proxy port number**: The port number to connect to the proxy server\. For example, `8080` or `8443`\.
 *  The **Proxy username** and **Proxy password** fields are optional\.

<!-- </ul> -->

### Credentials ###

The combination of **Access key** and **Secret key** is the minimum credentials\.  

If the Amazon S3 account owner has set up temporary credentials or a Role ARN (Amazon Resource Name), enter the values provided by the Amazon S3 account owner for the applicable authentication combination:

<!-- <ul> -->

 *  **Access key**, **Secret key**, and **Session token**
 *  **Access key**, **Secret key**, **Role ARN**, **Role session name**, and optional **Duration seconds**
 *  **Access key**, **Secret key**, **Role ARN**, **Role session name**, **External ID**, and optional **Duration seconds**

<!-- </ul> -->

For setup instructions for the Amazon S3 account owner, see [Setting up temporary credentials or a Role ARN for Amazon S3](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/conn-az3-tempcreds.html)\.

### Choose the method for creating a connection based on where you are in the platform ###

**In a project** : Click **Assets > New asset > Connect to a data source**\. See [Adding a connection to a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/create-conn.html)\.

**In a deployment space** : Click **Add to space > Connection**\. See [Adding connections to a deployment space](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/ml-space-add-assets.html)\.

**In the Platform assets catalog** : Click **New connection**\. See [Adding platform connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/platform-conn.html)\.

### Next step: Add data assets from the connection ###

<!-- <ul> -->

 *  See [Add data from a connection in a project](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/connected-data.html)\.

<!-- </ul> -->

## Where you can use this connection ##

You can use Amazon S3 connections in the following workspaces and tools:

**Projects**

<!-- <ul> -->

 *  Data Refinery
 *  Decision Optimization
 *  Notebooks\. Click **Read data** on the **Code snippets** pane to get the connection credentials and load the data into a data structure\. See [Load data from data source connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/analyze-data/load-and-access-data.html#conns)\.
 *  SPSS Modeler
 *  Synthetic Data Generator

<!-- </ul> -->

**Catalogs**

<!-- <ul> -->

 *  Platform assets catalog

<!-- </ul> -->

## Amazon S3 setup ##

See the [Amazon Simple Storage Service User Guide](https://docs.aws.amazon.com/AmazonS3/latest/userguide/setting-up-s3.html) for the setup steps\.

## Restriction ##

Folders cannot be named with the slash symbol (`/`) because the slash symbol is a delimiter for the file structure\.

## Supported file types ##

The Amazon S3 connection supports these file types: Avro, CSV, Delimited text, Excel, JSON, ORC, Parquet, SAS, SAV, SHP, and XML\.

## Learn more ##

[Amazon S3 documentation](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html)

**Related connection**: [Generic S3 connection](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/conn-generics3.html)

**Parent topic**: [Supported connections](https://dataplatform.cloud.ibm.com/docs/content/wsj/manage-data/conn_types.html)

<!-- </article "role="article" "> -->