Overview
Quickly export one or more files from an Amazon S3 bucket. Once the files have downloaded, transfer them to another service or run another Task against the data.
Variables
|
Name |
Reference |
Type |
Required |
Default |
Options |
Description |
|---|---|---|---|---|---|---|
|
Bucket Name |
S3_BUCKET_NAME |
Alphanumeric |
✅ |
None |
- |
The target S3 bucket the target file is stored in. |
|
S3 Folder Name |
S3_SOURCE_FOLDER_NAME |
Alphanumeric |
➖ |
None |
- |
Name of the folder where the file is stored in the S3 Bucket. If left blank, looks in the root directory. |
|
S3 File Name Match Type |
S3_SOURCE_FILE_NAME_MATCH_TYPE |
Select |
✅ |
exact_match |
Exact Match: exact_match
|
Determines if the text in "S3 File Name" will look for one file with exact match, or multiple files using regex. |
|
S3 File Name |
S3_SOURCE_FILE_NAME |
Alphanumeric |
✅ |
None |
- |
Name of the target file in the S3 bucket. Can be regex if "Match Type" is set accordingly. |
|
Workflows Folder Name |
S3_DESTINATION_FOLDER_NAME |
Alphanumeric |
➖ |
None |
- |
Folder where the file(s) should be downloaded on Workflows. Leaving blank will place the file in the home directory. |
|
Workflows File Name |
S3_DESTINATION_FILE_NAME |
Alphanumeric |
➖ |
None |
- |
What to name the file(s) being downloaded on Workflows. If left blank, defaults to the original file name(s). |
|
Access Key ID |
AWS_ACCESS_KEY_ID |
Password |
✅ |
None |
- |
The access key ID for programmatic IAM user used to download the file. See Authorization documentation for more information. |
|
Secret Access Key |
AWS_SECRET_ACCESS_KEY |
Password |
✅ |
None |
- |
The secret access key for programmatic IAM user used to download the file. See Authorization documentation for more information. |
|
Region |
AWS_DEFAULT_REGION |
Select |
✅ |
us-east-2 |
us-east-2
|
The AWS region for the S3 bucket and IAM user. |
YAML
Below is the YAML template
source:
template: Amazon S3 - Download Files to Workflows
inputs:
S3_BUCKET_NAME:
S3_SOURCE_FOLDER_NAME:
S3_SOURCE_FILE_NAME_MATCH_TYPE: exact_match
S3_SOURCE_FILE_NAME:
S3_DESTINATION_FOLDER_NAME:
S3_DESTINATION_FILE_NAME:
AWS_ACCESS_KEY_ID:
AWS_SECRET_ACCESS_KEY:
AWS_DEFAULT_REGION: us-east-2
type: TEMPLATE
guardrails:
retry_count: 1
retry_wait: 0h0m0s
runtime_cutoff: 1h0m0s
exclude_exit_code_ranges:
- 10
- 14
- 101
- 102
- 204
- 205
- 206