Amazon S3 Connector

This node configures the connection information that will be used to connect to Amazon S3. Using this connection the other KNIME remote file handling nodes such as Excel Reader and Excel Writer can download and upload files from and to Amazon S3.

For further documentation please take a look at the AWS Documentation.

Path syntax: Paths for Amazon S3 are specified with a UNIX-like syntax, /mybucket/myfolder/myfile. An absolute for S3 consists of:

  1. A leading slash ("/").
  2. Followed by the name of a bucket ("mybucket" in the above example), followed by a slash.
  3. Followed by the name of an object within the bucket ("myfolder/myfile" in the above example).

URI formats: When you apply the Path to URI node to paths coming from this connector, you can create URIs with the following formats:

  1. Presigned https:// URLs which contain credentials, that allow to access files for a certain amount of time (see AWS documentation).
  2. s3:// URLs to access Amazon S3 with the aws command line interface, or inside Hadoop environments.



Working directory
Specifies the working directory using the path syntax explained above. The working directory must be specified as an absolute path. A working directory allows downstream nodes to access files/folders using relative paths, i.e. paths that do not have a leading slash. If not specified, the default working directory is "/".
Normalize paths
Determines if the path normalization should be applied. Path normalization eliminates redundant components of a path like, e.g. /a/../b/./c" can be normalized to "/b/c". When these redundant components like "../" or "." are part of an existing object, then normalization must be deactivated in order to access them properly.


Read/write timeout in seconds
The socket read/write timeout. For further details see the S3 documentation.
Server-side encryption (SSE)
If selected, all data written to S3 will be encrypted with Server-side encryption (SSE) using SSE-S3, SSE-KMS or SSE-C.
Use default AWS managed key
If SSE-KMS is selected as the SSE method, then this option specifies whether or not to encrypt data with the default AWS managed CMK.
KMS key id
If SSE-KMS is selected as the SSE method and the default AWS managed CMK should not be used, then this option allows to choose the KMS key with which to encrypt data written to S3. Click on List keys to fetch the list of available keys (requires permissions kms:ListKeys, kms:DescribeKey and optionally kms:ListAliases).
Customer key
If SSE-C is selected as the SSE method it is necessary to provide an encryption key. There are multiple ways the key could be provided. The base64 encoded key could be entered directly or provided via credentials variable using the encoded key as password (username can be anything or left empty). The third way is to select a file that contains exactly 32 bytes (256 bit) that should be used as key.

Input Ports

Port object containing the AWS connection information.
A file system connection to read/write the customer key, when SSE-C encryption mode is enabled.

Output Ports

S3 File System Connection


This node has no views




You want to see the source code for this node? Click the following button and we’ll use our super-powers to find it for you.